stack2nix
About
stack2nix
automates conversion from Stack configuration file to Nix expressions. The purpose is to map stack.yaml one-to-one into Nix expressions.
stack2nix
high-level workflow:
- Generate stackage snapshot to determine complete fixed version list of packages based on resolver
- apply any additional configuration (local packages, extra dependencies, etc) from
stack.yaml
- generate complete list of dependencies to Nix expressions, replacing upstream
hackage-packages.nix
Installation
There are two options. The first - using Nix is recommended. If there are difficulties please file an issue.
Nix (recommended)
- Install Nix.
- Clone this repo.
- Run
nix-build
to build.
Stack + Nix
- Install Nix.
- Clone this repo.
- Run
stack install --nix
to install.
Usage
Nix expressions generated by stack2nix require NixOS 17.09 or later.
Local Packages
Sometimes it’s convenient to build local Haskell packages. Assuming the current directory is a locally maintained fork of Pandoc:
$ stack2nix . > default.nix
$ nix-build -A pandoc
Remote Packages
Stack2nix can generate a nix expressions for Haskell packages hosted in git repositories.
$ stack2nix --revision 242e2a064f6a32b22e1599bbfe72e64d7b6203b8 https://github.com/jgm/pandoc.git > demo.nix
$ nix-build -A pandoc demo.nix
Testing
Run ./scripts/travis.sh
to build and test.