Skip to content

Latest commit

 

History

History
109 lines (81 loc) · 3.23 KB

README.md

File metadata and controls

109 lines (81 loc) · 3.23 KB

About

Bundix makes it easy to package your Bundler-enabled Ruby applications with the Nix package manager.

Installation

Installing from this repo:

nix-env -iA bundix

Please note that in order to actually use this gem you must have Nix installed.

Basic Usage

I recommend first reading the nixpkgs manual entry for Ruby as this README might become outdated, it's a short read right now, so you won't regret it.

  1. Making a gemset.nix

    Change to your project's directory and run this:

    bundix -l
    

    This will generate a gemset.nix file that you then can use in your bundlerEnv expression like this:

  2. Using nix-shell

    To try your package in nix-shell, create a default.nix like this:

    with (import <nixpkgs> {});
    let
      gems = bundlerEnv {
        name = "your-package";
        inherit ruby;
        gemdir = ./.;
      };
    in stdenv.mkDerivation {
      name = "your-package";
      buildInputs = [gems ruby];
    }

    and then simply run nix-shell.

  3. Proper packages

    To make a package for nixpkgs, you can try something like this:

    { stdenv, bundlerEnv, ruby }:
    let
      gems = bundlerEnv {
        name = "your-package";
        inherit ruby;
        gemdir  = ./.;
      };
    in stdenv.mkDerivation {
      name = "your-package";
      src = ./.;
      buildInputs = [gems ruby];
      installPhase = ''
        mkdir -p $out
        cp -r $src $out
      '';
    }

How & Why

I'd usually just tell you to read the code yourself, but the big picture is that bundix tries to fetch a hash for each of your bundle dependencies and store them all together in a format that Nix can understand and is then used by bundlerEnv.

I wrote this new version of bundix because I became frustrated with the poor performance of the old bundix, and wanted to save both time and bandwidth, as well as learn more about Nix.

For each gem, it first tries to look for an existing gem in the bundler cache (usually generated via bundle package), and if that fails it goes through each remote and tries to fetch the gem from there. If the remote happens to be rubygems.org we ask the API first for a hash of the gem, and then ask the Nix store whether we have this version already. Only if that also fails do we download the gem.

As an added bonus I also implemented parsing the gemset.nix if it already exists, and get hashes from there directly, that way updating an existing gemset.nix only takes a few seconds.

The output from bundix should be as stable as possible, to make auditing diffs easier, that's why I also implemented a pretty printer for the gemset.nix.

I hope you enjoy using bundix as much as I do, and if you don't, let me know.

Closing words

For any questions or suggestions, please file an issue on Github or ask in #nixos on Freenode.

Big thanks go out to Charles Strahan for his awesome work bringing Ruby to Nix, zimbatm for being a good rubber duck and tester, and Alexander Flatter for the original bundix. I couldn't have done this without you guys.