diff options
author | Artturin <Artturin@artturin.com> | 2022-04-20 21:26:52 +0300 |
---|---|---|
committer | Artturin <Artturin@artturin.com> | 2022-04-22 16:24:29 +0300 |
commit | 41808d42d21f685e3fd3cdb2c9f04082f0818e30 (patch) | |
tree | 1606cea05ceeca8bc6fa0884a5566a27c9581035 /doc/builders/special/invalidateFetcherByDrvHash.section.md | |
parent | 3cc2e86bab4dcfa1abc7c835fae6336b068cd77e (diff) | |
download | nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.tar nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.tar.gz nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.tar.bz2 nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.tar.lz nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.tar.xz nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.tar.zst nixpkgs-41808d42d21f685e3fd3cdb2c9f04082f0818e30.zip |
doc: move testers to their own chapter
Diffstat (limited to 'doc/builders/special/invalidateFetcherByDrvHash.section.md')
-rw-r--r-- | doc/builders/special/invalidateFetcherByDrvHash.section.md | 31 |
1 files changed, 0 insertions, 31 deletions
diff --git a/doc/builders/special/invalidateFetcherByDrvHash.section.md b/doc/builders/special/invalidateFetcherByDrvHash.section.md deleted file mode 100644 index 7c2f03a64b7..00000000000 --- a/doc/builders/special/invalidateFetcherByDrvHash.section.md +++ /dev/null @@ -1,31 +0,0 @@ - -## `invalidateFetcherByDrvHash` {#sec-pkgs-invalidateFetcherByDrvHash} - -Use the derivation hash to invalidate the output via name, for testing. - -Type: `(a@{ name, ... } -> Derivation) -> a -> Derivation` - -Normally, fixed output derivations can and should be cached by their output -hash only, but for testing we want to re-fetch everytime the fetcher changes. - -Changes to the fetcher become apparent in the drvPath, which is a hash of -how to fetch, rather than a fixed store path. -By inserting this hash into the name, we can make sure to re-run the fetcher -every time the fetcher changes. - -This relies on the assumption that Nix isn't clever enough to reuse its -database of local store contents to optimize fetching. - -You might notice that the "salted" name derives from the normal invocation, -not the final derivation. `invalidateFetcherByDrvHash` has to invoke the fetcher -function twice: once to get a derivation hash, and again to produce the final -fixed output derivation. - -Example: - - tests.fetchgit = invalidateFetcherByDrvHash fetchgit { - name = "nix-source"; - url = "https://github.com/NixOS/nix"; - rev = "9d9dbe6ed05854e03811c361a3380e09183f4f4a"; - sha256 = "sha256-7DszvbCNTjpzGRmpIVAWXk20P0/XTrWZ79KSOGLrUWY="; - }; |