mirror of
https://github.com/simplex-chat/haskell.nix.git
synced 2026-06-03 09:17:32 +00:00
Toon Nolten
5c4a0de2a1
* 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
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
|
|
# 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:
|
|
```bash
|
|
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:
|
|
```bash
|
|
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:
|
|
```bash
|
|
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.
|
|
|
|
[Stackage]: https://stackage.org
|
|
[Hackage]: https://hackage.haskell.org
|
|
[hackage.nix]: https://github.com/input-output-hk/hackage.nix
|
|
[haskell.nix]: https://github.com/input-output-hk/haskell.nix
|
|
[lts-13.28]: https://www.stackage.org/lts-13.28
|
|
[lens]: https://hackage.haskell.org/package/lens
|
|
[lens-4.17.1]: https://hackage.haskell.org/package/lens-4.17.1
|
|
[hackage-index-state]: https://github.com/input-output-hk/hackage.nix/blob/master/index-state-hashes.nix
|