summary refs log tree commit diff
path: root/doc/languages-frameworks/ruby.xml
diff options
context:
space:
mode:
authorVladimír Čunát <vcunat@gmail.com>2015-12-19 16:04:36 +0100
committerVladimír Čunát <vcunat@gmail.com>2015-12-19 16:08:00 +0100
commitef21e5ee60272df6cb3a9e3ffb7982199051d13e (patch)
treeed15f984ead47cb332956c237503a1e22bdb51a0 /doc/languages-frameworks/ruby.xml
parentaf6732e5037ef81479f2dfd5e48921b380a80b7a (diff)
downloadnixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.tar
nixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.tar.gz
nixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.tar.bz2
nixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.tar.lz
nixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.tar.xz
nixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.tar.zst
nixpkgs-ef21e5ee60272df6cb3a9e3ffb7982199051d13e.zip
nixpkgs manual: split languages into separate files
There's no change in content except for amending the title of the
section to mention "frameworks", as e.g. I don't consider Qt a language,
and it's likely there will be more of similar cases in future.

To be certain, I checked diff of the generated HTMLs.
Diffstat (limited to 'doc/languages-frameworks/ruby.xml')
-rw-r--r--doc/languages-frameworks/ruby.xml46
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/languages-frameworks/ruby.xml b/doc/languages-frameworks/ruby.xml
new file mode 100644
index 00000000000..a2b4475a4a5
--- /dev/null
+++ b/doc/languages-frameworks/ruby.xml
@@ -0,0 +1,46 @@
+<section xmlns="http://docbook.org/ns/docbook"
+         xmlns:xlink="http://www.w3.org/1999/xlink"
+         xml:id="sec-language-ruby">
+
+<title>Ruby</title>
+
+  <para>There currently is support to bundle applications that are packaged as Ruby gems. The utility "bundix" allows you to write a <filename>Gemfile</filename>, let bundler create a <filename>Gemfile.lock</filename>, and then convert
+  this into a nix expression that contains all Gem dependencies automatically.</para>
+
+  <para>For example, to package sensu, we did:</para>
+
+<screen>
+<![CDATA[$ cd pkgs/servers/monitoring
+$ mkdir sensu
+$ cat > Gemfile
+source 'https://rubygems.org'
+gem 'sensu'
+$ bundler package --path /tmp/vendor/bundle
+$ $(nix-build '<nixpkgs>' -A bundix)/bin/bundix
+$ cat > default.nix
+{ lib, bundlerEnv, ruby }:
+
+bundlerEnv {
+  name = "sensu-0.17.1";
+
+  inherit ruby;
+  gemfile = ./Gemfile;
+  lockfile = ./Gemfile.lock;
+  gemset = ./gemset.nix;
+
+  meta = with lib; {
+    description = "A monitoring framework that aims to be simple, malleable,
+and scalable.";
+    homepage    = http://sensuapp.org/;
+    license     = with licenses; mit;
+    maintainers = with maintainers; [ theuni ];
+    platforms   = platforms.unix;
+  };
+}]]>
+</screen>
+
+<para>Please check in the <filename>Gemfile</filename>, <filename>Gemfile.lock</filename> and the <filename>gemset.nix</filename> so future updates can be run easily.
+</para>
+
+</section>
+