projects / pinch / blame
| Commit | Line | Data |
|---|---|---|
| fd9d5da1 SW |
1 | # Deprecated |
| 2 | ||
| 2ff7a17c | 3 | Now that [flakes](https://nixos.wiki/wiki/Flakes) are more or less ready for |
| fd9d5da1 SW |
4 | general use, this is mostly of historical interest. |
| 5 | ||
| 6 | ||
| 597bd03a SW |
7 | # Pinch |
| 8 | ||
| 9 | PIN CHannels - a simple drop-in replacement for `nix-channel --update`. | |
| 10 | ||
| 11 | Example 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 | ||
| 17 | The 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 | ||
| 34 | The 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 |