stackage2nix: Convert Stack files into Nix build instructions.

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Warnings:

No 'description' field.
Exposed modules use unallocated top-level names: Runner Stack

[Skip to Readme]

Properties

Versions	0.3.0, 0.3.0, 0.4.0, 0.5.0, 0.6.0, 0.6.1, 0.7.0, 0.7.1, 0.7.2
Change log	CHANGELOG.md
Dependencies	aeson, base (>4.7 && <5), bytestring, Cabal (>1.24), cabal2nix (>=2.5), containers, deepseq, distribution-nixpkgs (>=1.1), exceptions (>0.8), filepath, gitlib (>3), gitlib-libgit2 (>3), hopenssl (>2.2), inflections, language-nix, lens, network-uri, optparse-applicative, pretty, QuickCheck, stackage-curator (>=0.15), stackage2nix, text, unordered-containers, yaml [details]
License	BSD-3-Clause
Author	Dmitry Bushev , Benno Fünfstück
Maintainer	bushevdv@gmail.com
Category	Distribution, Nix
Home page	https://github.com/4e6/stackage2nix#readme
Source repo	head: git clone https://github.com/4e6/stackage2nix
Uploaded	by typeable at 2017-08-29T10:21:27Z

Modules

[Index]

Distribution
- Nixpkgs
  - Haskell
Language
- Nix
  - Language.Nix.FilePath
Runner
- Runner.Cli
Stack
- Stack.Config
  - Stack.Config.TH
  - Stack.Config.Yaml
- Stack.Types

Downloads

stackage2nix-0.3.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

mniip, typeable, dbushev

For package maintainers and hackage trustees

edit package information

Readme for stackage2nix-0.3.0

[back to package description]

stackage2nix

stackage2nix converts a Stack file into a Nix Haskell packages set. It creates LTS Stackage packages set, and applies appropriate overrides on top of it.

stackage2nix \
  --lts-haskell "$LTS_HASKELL_REPO" \
  --all-cabal-hashes "$ALL_CABAL_HASHES_REPO" \
  .

stackage2nix has three required arguments:

--lts-haskell - path to fpco/lts-haskell
--all-cabal-hashes - path to commercialhaskell/all-cabal-hashes checked out to hackage branch
. - path to stack.yaml file or directory

Produced Nix derivation split on following files:

packages.nix - Base Stackage packages set
configuration-packages.nix - Compiler configuration
default.nix - Final Haskell packages set with all overrides applied

A particular package from result Haskell packages set can be built with:

nix-build -A <package-name>

Runtime dependencies

nix-env is required to be on PATH by the distribution-nixpkgs dependency
nix-prefetch-git is required on PATH if you have git dependencies in stack.yaml

Override result derivation

Complex projects may require some extra customization. Snippet override.nix below shows a minimal example of how to apply additional overrides on top of Haskell packages set produced by stackage2nix.

with import <nixpkgs> {};
with pkgs.haskell.lib;
let haskellPackages = import ./. {};
in haskellPackages.override {
  overrides = self: super: {
    stackage2nix = disableSharedExecutables super.stackage2nix;
  };
}

nix-build -A stackage2nix override.nix

For more complex overrides and detailed information on how to work with Haskell packages in Nix, see Nixpkgs manual User’s Guide to the Haskell Infrastructure

Examples

For other examples of stackage2nix usage, see 4e6/stackage2nix-examples repository. It verifies stackage2nix by running it on different public projects.