Python bindings for Nix using CFFI

Maintainer status: maintained, experimental.

Compatibility: Requires Nix 2.22

Try in a REPL!

$ nix develop fusiled/python-nix#env
$ python
>>> import nix
>>> nix.eval("1+1")
<Nix: 2>

Example

import nix

# Load the nixpkgs repository
pkgs = nix.getenv().nimport(nix.lookup_path("<nixpkgs>"))({})

# Get the hello package and override its name
hello2 = pkgs.hello.overrideAttrs(lambda o: {
  "pname": str(o.pname) + "-test"
})

# Build the package
hello2.build()

Development

Using Nix

A development environment is available in the provided Nix flake. Once in the development environment, run buildFFI.py to test your changes.

$ nix develop .#
$ cd src
$ python buildFFI.py
$ python
>>> import nix

Unit-testing

From the project root folder run python -m unittest

Add to your project

Because this package uses CFFI, it requires a bit more setup than a typical Python package.

To install this package, you will need:

• gcc
• pkg-config

and Nix 2.22 that can be caught by pkg-config.

You can build it and give it to pkg-config by running:

$ export PKG_CONFIG_PATH="$(nix build github:fusiled/python-nix#default.dev --no-link --print-out-paths)/lib/pkgconfig"

You can install using pip:

$ pip install git+https://github.com/fusiled/python-nix.git