|
1 | 1 | # go-nix - Nix experiments written in go |
2 | 2 |
|
3 | | -*STATUS*: experimental |
| 3 | +_STATUS_: experimental |
4 | 4 |
|
5 | 5 | This repository holds a bunch of experiments written in Go. |
6 | 6 |
|
7 | 7 | ## `cmd/gonix` |
| 8 | + |
8 | 9 | A command line entrypoint called `gonix`, currently implementing the nar |
9 | 10 | {cat,dump-path,ls} commands. |
10 | 11 |
|
11 | 12 | They're not meant to be 100% compatible, but are documented in the `--help` |
12 | 13 | output. |
13 | 14 |
|
14 | 15 | ## `pkg/derivation` |
| 16 | + |
15 | 17 | A parser for Nix `.drv` files. |
16 | 18 | Functions to calculate derivation paths and output hashes. |
17 | 19 |
|
18 | 20 | ## `pkg/derivation/store` |
| 21 | + |
19 | 22 | A Structure to hold derivation graphs. |
20 | 23 |
|
21 | 24 | ## `pkg/hash` |
| 25 | + |
22 | 26 | Methods to serialize and deserialize some of the hashes used in nix code and |
23 | 27 | `.narinfo` files. |
24 | 28 |
|
25 | 29 | ## `pkg/nar` |
| 30 | + |
26 | 31 | A Nix ARchive (NAR) file Reader and Writer, with an interface similar to |
27 | 32 | `archive/tar` from the stdlib, as well as a `DumpPath` method, which |
28 | 33 | will assemble a NAR representation of a local file system path. |
29 | 34 |
|
30 | 35 | ## `pkg/nar/ls` |
| 36 | + |
31 | 37 | A parser for .ls files (providing an index for .nar files) |
32 | 38 |
|
33 | 39 | ## `pkg/nar/narinfo` |
| 40 | + |
34 | 41 | A parser and generator for `.narinfo` files. |
35 | 42 |
|
36 | 43 | ## `pkg/nixbase32` |
| 44 | + |
37 | 45 | An implementation of the slightly odd "base32" encoding that's used in Nix, |
38 | 46 | providing some of the functions in `encoding/base32.Encoding`. |
39 | 47 |
|
40 | 48 | ## `pkg/storepath` |
| 49 | + |
41 | 50 | A parser and regexes for Nix Store Paths. |
42 | 51 |
|
43 | 52 | ## `pkg/storepath/references` |
| 53 | + |
44 | 54 | A Nix Store path reference scanner. |
45 | 55 |
|
| 56 | +## `pkg/sqlite` |
| 57 | + |
| 58 | +A collection of interfaces and utilities for writing to and querying various `sqlite` databases that Nix uses. |
| 59 | + |
| 60 | +[sqlc]: https://github.com/sqlc-dev/sqlc |
| 61 | + |
| 62 | +## `pkg/sqlite/binary_cache_v6` |
| 63 | + |
| 64 | +[SQLC] generated code for querying the Nar Info Disk Cache, typically located at `$XDG_CACHE_HOME/nix/binary-cache-v6.sqlite`. |
| 65 | + |
| 66 | +## `pkg/sqlite/eval_cache_v5` |
| 67 | + |
| 68 | +[SQLC] generated code for querying an instance of the Eval Cache, typically located at `$XDG_CACHE_HOME/nix/eval-cache-v5/*.sqlite`. |
| 69 | + |
| 70 | +## `pkg/sqlite/fetcher_cache_v2` |
| 71 | + |
| 72 | +[SQLC] generated code for querying the fetcher cache, typically located in `$XDG_CACHE_HOME/nix/fetcher-cache-v2.sqlite`. |
| 73 | + |
| 74 | +## `pkg/sqlite/nix_v10` |
| 75 | + |
| 76 | +[SQLC] generated code for querying the main Nix database, typically located in `/nix/var/nix/db.sqlite`. |
| 77 | + |
46 | 78 | ## `pkg/wire` |
| 79 | + |
47 | 80 | Methods to parse and produce fields used in the low-level Nix wire protocol. |
0 commit comments