Nixpkgs/Patching Nixpkgs: Difference between revisions
m Formatting |
Add more versatile way of using applyPatches. |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
Sometimes it may be required to patch | Sometimes it may be required to patch a copy of Nixpkgs directly, rather than use an overlay to patch an individual package. One scenario of where this might happen is if Nixpkgs doesn't contain a change you need, but you find some | ||
existing PR that has yet to be merged, and so want to leverage those changes prior to them being merged. | existing PR that has yet to be merged, and so want to leverage those changes prior to them being merged. | ||
For the sake of example, let's say you are using the software package Ghidra, and the latest version available on | For the sake of example, let's say you are using the software package Ghidra, and the latest version available on | ||
Nixpkgs unstable is [https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=ghidra Ghidra 11.1.2]. | |||
You know that the Ghidra developers have recently released 11.2, and want to use it before it's in | You know that the Ghidra developers have recently released 11.2, and want to use it before it's in Nixpkgs. You could try to create an overlay and manually update the package, but maybe in the process you realize it is not a | ||
trivial update. You may find there is already a pending PR to | trivial update. You may find there is already a pending PR to Nixpkgs with the updated version and | ||
changes you want, such as [https://github.com/NixOS/nixpkgs/pull/344917 this] PR introducing Ghidra 11.2. If you didn't | changes you want, such as [https://github.com/NixOS/nixpkgs/pull/344917 this] PR introducing Ghidra 11.2. If you didn't | ||
want to wait for this PR to be merged into | want to wait for this PR to be merged into Nixpkgs, you could apply the PR patch directly to your Nixpkgs instead. Which we will do below. | ||
There are of course other reasons you may wish to use a patched | There are of course other reasons you may wish to use a patched Nixpkgs and the method applies to any of those cases. | ||
First you will need to apply the | First you will need to apply the Nixpkgs PR patch to some copy of Nixpkgs. In this example we will assume a Flake (<code>flake.nix</code>) that has an input <code>nixpkgs-unstable</code> pointing to <code>nixos-unstable</code>: | ||
<syntaxHighlight lang=nix> | <syntaxHighlight lang=nix> | ||
inputs = { | inputs = { | ||
# ... | |||
nixpkgs-unstable.url = "github:NixOS/nixpkgs/nixos-unstable"; | |||
# ... | |||
}; | }; | ||
</syntaxHighlight> | </syntaxHighlight> | ||
| Line 28: | Line 28: | ||
redirect to https://patch-diff.githubusercontent.com/raw/NixOS/nixpkgs/pull/344917.patch. We can use the latter. | redirect to https://patch-diff.githubusercontent.com/raw/NixOS/nixpkgs/pull/344917.patch. We can use the latter. | ||
< | <syntaxhighlight lang="nix"> | ||
let | |||
nixpkgs-unstable' = | |||
((import nixpkgs-unstable { | |||
system = "x86_64-linux"; | |||
}).applyPatches | |||
{ | |||
name = "nixpkgs-unstable-patched"; | |||
src = inputs.nixpkgs-unstable; | |||
patches = [ | |||
(builtins.fetchurl { | |||
url = "https://patch-diff.githubusercontent.com/raw/NixOS/nixpkgs/pull/344917.patch"; | |||
sha256 = "sha256-aws9J5ZNUyz4Z2RqPVEovBTNng4AdhzS03Bqg8jejWQ="; | |||
}) | |||
]; | |||
}).src; | |||
patched-lib = nixpkgs-unstable'.lib; | |||
pkgs-unstable = import nixpkgs-unstable' { | |||
system = "x86_64-linux"; | |||
}; | |||
</ | # ... | ||
</syntaxhighlight> | |||
In the above example we create a derivation with the patch applied, called <code> | In the above example we create a derivation with the patch applied, called <code>nixpkgs-unstable'</code>. Pay attention we take the <code>src</code> attribute to get back the top-level nixpkgs. We can then access <code>lib</code> functions normally. We then import that new | ||
derivation which we assign to <code>pkgs-unstable</code>. Now we can use <code>pkgs-unstable</code> to access the | derivation which we assign to <code>pkgs-unstable</code>. Now we can use <code>pkgs-unstable</code> to access the | ||
Ghidra 11.2 package, as well as any other packages normally available in nixpkgs. | Ghidra 11.2 package, as well as any other packages normally available in nixpkgs. | ||
| Line 58: | Line 59: | ||
The following are resources that go into more depth on this topic. | The following are resources that go into more depth on this topic. | ||
* [https://ertt.ca/nix/patch-nixpkgs/ Patching <nixpkgs>] | |||