libnix: Bindings to the nix package manager

[ foreign, gpl, library, nix ] [ Propose Tags ]

Use the nix package manager from Haskell. All modules are designed to be imported qualified.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.2.0.0, 0.2.0.1, 0.3.0.0, 0.4.0.1, 0.4.1.0
Change log CHANGELOG.md
Dependencies aeson (>=1.0.0.0), base (>=4.9 && <5.0), bytestring, deepseq, errors (>=2.2.0), filepath, mtl, process, text [details]
License GPL-3.0-only
Author Profpatsch
Maintainer mail@profpatsch.de
Category Foreign, Nix
Home page https://github.com/Profpatsch/libnix-haskell#readme
Bug tracker https://github.com/Profpatsch/libnix-haskell/issues
Source repo head: git clone https://github.com/Profpatsch/libnix-haskell
Uploaded by Profpatsch at 2021-11-19T18:53:36Z
Distributions NixOS:0.4.1.0
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 1667 total (28 in the last 30 days)
Rating 1.75 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
All reported builds failed as of 2021-11-19 [all 1 reports]

Readme for libnix-0.4.0.1

[back to package description]

libnix

Haskell bindings to the nix package manager

This project aims to provide an interface to call nix functionality from the safe haven that is Haskell. As much type safety as possible should be guaranteed to the user.

The project consists of two broad steps:

  1. bindings to the command line tools
  2. bindings to the nix libraries themselves

At the moment, an beta version of 1. is implemented, together with a small number of tests to check for possible changes in the interface, which consists mainly of three functions:

parseNixExpr :: Text                 -> NixAction ParseError NixExpr
instantiate  :: NixExpr              -> NixAction InstantiateError (StorePath Derivation)
realize      :: StorePath Derivation -> NixAction RealizeError (StorePath Realized)

which do what you’d expect; and two helper functions

eval             :: NixExpr -> NixAction InstantiateError ()
parseInstRealize :: Text    -> NixAction NixError (StorePath Realized)

where parseInstRealize performs all three steps at once.

Nix Prefetch Wrappers

We implement an additional module that creates nicely typed wrappers for nix-prefetch-X tools, please see the module documentation what is supported exactly.

url :: UrlOptions -> NixAction PrefetchError (Sha256, StorePath Realized)
git :: GitOptions -> NixAction PrefetchError GitOutput

C++ bindings

The second steps would be to directly bind into the C++ library. That could either mean writing a C wrapper and using Haskell’s native FFI, or generating bindings with Hoppy, which we’d prefer. Hoppy would need to be able to handle C++ exceptions first, though.

Other nix libraries on hackage

  • cabal2nix: the executable at the base of nix haskell support
  • language-nix: library cabal2nix uses to generate its nix files
  • hnix: a project to implement the nix expression language in haskell
  • nix-eval: runtime eval of Haskell code using nix
  • simple-nix: looks like a nix parser, but not entirely sure

It doesn’t look like the scope of libnix collides with any of these packages.