]> git.scottworley.com Git - pinch/blame - README
Don't leave old channels laying around
[pinch] / README
CommitLineData
fd9d5da1
SW
1# Deprecated
2
3Now that [flakes][https://nixos.wiki/wiki/Flakes] are more or less ready for
4general use, this is mostly of historical interest.
5
6
597bd03a
SW
7# Pinch
8
9PIN CHannels - a simple drop-in replacement for `nix-channel --update`.
10
11Example usage, being invoked on the example "channels" file included here:
12
13 $ python3 pinch.py pin channels
14 $ python3 pinch.py update channels
15
16
17The first "pin" command will add these fields to the file:
18
19 [nixos]
20 channel_url = https://channels.nixos.org/nixos-20.03
21 git_repo = https://github.com/NixOS/nixpkgs.git
22 git_ref = nixos-20.03
23 +release_name = nixos-20.03beta1155.29eddfc36d7
24 +tarball_url = https://releases.nixos.org/nixos/20.03/nixos-20.03beta1155.29eddfc36d7/nixexprs.tar.xz
25 +tarball_sha256 = 9c1d182af2af64e5e8799e256a4a6dc1fed324ba06cb5f76c938dc63b64f0959
26 +git_revision = 29eddfc36d720dcc4822581175217543b387b1e8
27
28 [nixos-hardware]
29 git_repo = https://github.com/NixOS/nixos-hardware.git
30 git_ref = master
31 +release_name = nixos-hardware.git-1585241157-edb7199b5c4
32 +git_revision = edb7199b5c4f1db34a7253d4cabf6cf690521a92
33
34The second "update" command applies these changes to your nix channels, like `nix-channel --update` does.
35
c36b350d
SW
36### Feature comparison
37
38| Feature | nix-channel | [require.nix][] | [niv][] | [flakes][] | pinch |
39| ---------------------------- | :---------: | :-------------: | :-----: | :--------: | :---: |
40| Same version across machines | - | yes | yes | yes | yes |
41| Verifies hashes | - | ? | yes | yes | yes |
42| Fetch from git | - | ? | yes | yes | yes |
43| Fetch from git with ssh key | - | ? | yes | yes? | yes |
44| command_not_found_handle | yes | ? | - | yes | yes |
45| Verifies tarball == git repo | - | - | - | - | yes |
46| Rejects force pushes | - | - | - | - | yes |
fd9d5da1 47| Ready to use today | yes | - | yes | yes | yes |
c36b350d
SW
48
49[require.nix]: https://www.youtube.com/watch?v=DHOLjsyXPtM
50[niv]: https://github.com/nmattia/niv
51[flakes]: https://github.com/nixos/rfcs/pull/49