]> git.scottworley.com Git - pinch/blame - README
Don't depend upon xdg
[pinch] / README
CommitLineData
597bd03a
SW
1# Pinch
2
3PIN CHannels - a simple drop-in replacement for `nix-channel --update`.
4
5Example usage, being invoked on the example "channels" file included here:
6
7 $ python3 pinch.py pin channels
8 $ python3 pinch.py update channels
9
10
11The first "pin" command will add these fields to the file:
12
13 [nixos]
14 channel_url = https://channels.nixos.org/nixos-20.03
15 git_repo = https://github.com/NixOS/nixpkgs.git
16 git_ref = nixos-20.03
17 +release_name = nixos-20.03beta1155.29eddfc36d7
18 +tarball_url = https://releases.nixos.org/nixos/20.03/nixos-20.03beta1155.29eddfc36d7/nixexprs.tar.xz
19 +tarball_sha256 = 9c1d182af2af64e5e8799e256a4a6dc1fed324ba06cb5f76c938dc63b64f0959
20 +git_revision = 29eddfc36d720dcc4822581175217543b387b1e8
21
22 [nixos-hardware]
23 git_repo = https://github.com/NixOS/nixos-hardware.git
24 git_ref = master
25 +release_name = nixos-hardware.git-1585241157-edb7199b5c4
26 +git_revision = edb7199b5c4f1db34a7253d4cabf6cf690521a92
27
28The second "update" command applies these changes to your nix channels, like `nix-channel --update` does.
29
30Advantages over nix-channel:
31
32 * Deploy the exact same channel content to multiple machines.
33 * Store your pin file in revision control for more powerful rollback mechanism than `nix-channel --rollback`.
34 * Chanel contents are verified by hash before being installed.