go-nix - Nix experiments written in go

STATUS: experimental

This repository holds a bunch of experiments written in Go.

cmd/gonix

A command line entrypoint called gonix, currently implementing the nar {cat,dump-path,ls} and fast-build commands.

Also implements fast-build which reads JSON eval jobs from stdin (as produced by nix-eval-jobs), builds them in parallel via the Nix daemon socket, and streams build results as JSON to stdout.

Commands are not meant to be 100% compatible with their Nix counterparts, but are documented in the --help output.

pkg/derivation

A parser for Nix .drv files. Functions to calculate derivation paths and output hashes.

pkg/derivation/store

A Structure to hold derivation graphs.

pkg/nixhash

Methods to serialize and deserialize some of the hashes used in nix code and .narinfo files.

pkg/nar

A Nix ARchive (NAR) file Reader and Writer, with an interface similar to archive/tar from the stdlib, as well as a DumpPath method, which will assemble a NAR representation of a local file system path.

pkg/nar/ls

A parser for .ls files (providing an index for .nar files)

pkg/nar/narinfo

A parser and generator for .narinfo files.

pkg/nixbase32

An implementation of the slightly odd "base32" encoding that's used in Nix, providing some of the functions in encoding/base32.Encoding.

pkg/storepath

A parser and regexes for Nix Store Paths.

pkg/storepath/references

A Nix Store path reference scanner.

pkg/sqlite

A collection of interfaces and utilities for writing to and querying various sqlite databases that Nix uses.

pkg/sqlite/binary_cache_v6

SQLC generated code for querying the Nar Info Disk Cache, typically located at $XDG_CACHE_HOME/nix/binary-cache-v6.sqlite.

pkg/sqlite/eval_cache_v5

SQLC generated code for querying an instance of the Eval Cache, typically located at $XDG_CACHE_HOME/nix/eval-cache-v5/*.sqlite.

pkg/sqlite/fetcher_cache_v2

SQLC generated code for querying the fetcher cache, typically located in $XDG_CACHE_HOME/nix/fetcher-cache-v2.sqlite.

pkg/sqlite/nix_v10

SQLC generated code for querying the main Nix database, typically located in /nix/var/nix/db.sqlite.

pkg/daemon

A client for the Nix daemon worker protocol, communicating over a Unix domain socket. Supports protocol versions 1.23 through 1.38 and covers query, store, build, and GC operations.

pkg/wire

Methods to parse and produce fields used in the low-level Nix wire protocol.