aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.envrc3
-rw-r--r--README.org23
2 files changed, 26 insertions, 0 deletions
diff --git a/.envrc b/.envrc
new file mode 100644
index 0000000..6783103
--- /dev/null
+++ b/.envrc
@@ -0,0 +1,3 @@
+SEARCH_PATHS="$(./guix/pre-inst-env guix environment --ad-hoc ruby ruby-rails --search-paths)"
+
+eval "$SEARCH_PATHS"
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..9442d67
--- /dev/null
+++ b/README.org
@@ -0,0 +1,23 @@
+* Rails, GNU Guix demo
+
+This repository is a really quick example of how to use Ruby on Rails
+with GNU Guix. Most Ruby on Rails applications will probably use a
+combination of Rubygems and Bundler to manage some of the
+dependencies, but it's possible to substitute Guix packages for
+Bundler, to gain some of the advantages of working with GNU Guix.
+
+To try this out, you'll need to:
+
+ - ~git submodule update --init~
+ - Setup the guix submodule, some instructions here:
+ https://www.gnu.org/software/guix/manual/en/guix.html#Building-from-Git
+ - Use =direnv= to setup the environment correctly, or run:
+ ~./guix/pre-inst-env guix environment --ad-hoc ruby ruby-rails~
+ - Then run ~rails s~ from =testapp=
+
+Once Ruby on Rails support is in Guix properly (rather than a branch),
+this should hopefully be easier. This bug [1] tracks the overall
+progress, but other bugs are used for subsets of the patches. If you
+have any problems, email mailto:mail@cbaines.net.
+
+1: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=30689