Files
haskell.nix/docs/tutorials/building-package-from-stackage-hackage.md
T
Toon Nolten 5c4a0de2a1 Minor documentation fixes (#722)
* Make the haskell.nix import in the examples explicit

The examples used `import ./. {}` without explaining the commands should
be run from the haskell.nix repo root. To avoid confusion like this I
added fetching a tarball of the repo. This is less efficient when run
from the repo but works when run from anywhere and makes it clear we're
importing haskell.nix.

Added a couple urls and removed the urls on the lens component so as not
to confuse components with packages.

* Fix rephrase

The phrasing was left in a partially-rewritten state.

* Change wording and fix typo

* Minor fixes for consistency
2020-06-23 08:10:41 +10:00

2.1 KiB

Build a specific package from Hackage or Stackage

From a Stackage snapshot

To build a package, say lens, from a Stackage snapshot, say lts-13.28, you could run:

nix build '(with import <nixpkgs> (import (builtins.fetchTarball "https://github.com/input-output-hk/haskell.nix/archive/master.tar.gz")).nixpkgsArgs; haskell-nix.snapshots."lts-13.28").lens.components.library'

This would build the (public) library component of the lens package as fixed by the lts-13.28 stackage snapshot. Nightly snapshots like nightly-2020-06-21 are also available.

A specific version from Hackage

To build any package from hackage, say lens, at any version, say 4.17.1, you could run:

nix build '(with import <nixpkgs> (import (builtins.fetchTarball "https://github.com/input-output-hk/haskell.nix/archive/master.tar.gz")).nixpkgsArgs; (haskell-nix.hackage-package { name = "lens"; version = "4.17.1"; })).components.library'

This would build the (public) library component of the lens-4.17.1 package from hackage.

Pinning hackage index

The dependencies would be resolved against the most recent hackage-index-state which comes with your haskell.nix checkout via the hackage.nix pin. A specific one can be specified as well:

nix build '(with import <nixpkgs> (import (builtins.fetchTarball "https://github.com/input-output-hk/haskell.nix/archive/master.tar.gz")).nixpkgsArgs; (haskell-nix.hackage-package { name = "lens"; version = "4.17.1"; index-state = "2019-07-14T00:00:00Z"; })).components.library'

This would use the hackage index as of 2019-07-14T00:00:00Z to produce a build plan for the lens-4.17.1 package.