doc/testers: testVersion -> testers.testVersion, add example

This commit is contained in:
Ivar Scholten 2022-09-11 19:50:54 +02:00
parent 2eafac6d06
commit 6c40872147
No known key found for this signature in database
GPG Key ID: E22887AD87C33E3C

View File

@ -14,19 +14,25 @@ for example when using an 'old' hash in a fixed-output derivation.
Examples: Examples:
```nix ```nix
passthru.tests.version = testVersion { package = hello; }; passthru.tests.version = testers.testVersion { package = hello; };
passthru.tests.version = testVersion { passthru.tests.version = testers.testVersion {
package = seaweedfs; package = seaweedfs;
command = "weed version"; command = "weed version";
}; };
passthru.tests.version = testVersion { passthru.tests.version = testers.testVersion {
package = key; package = key;
command = "KeY --help"; command = "KeY --help";
# Wrong '2.5' version in the code. Drop on next version. # Wrong '2.5' version in the code. Drop on next version.
version = "2.5"; version = "2.5";
}; };
passthru.tests.version = testers.testVersion {
package = ghr;
# The output needs to contain the 'version' string without any prefix or suffix.
version = "v${version}";
};
``` ```
## `testEqualDerivation` {#tester-testEqualDerivation} ## `testEqualDerivation` {#tester-testEqualDerivation}
@ -42,7 +48,7 @@ Otherwise, the build log explains the difference via `nix-diff`.
Example: Example:
```nix ```nix
testEqualDerivation testers.testEqualDerivation
"The hello package must stay the same when enabling checks." "The hello package must stay the same when enabling checks."
hello hello
(hello.overrideAttrs(o: { doCheck = true; })) (hello.overrideAttrs(o: { doCheck = true; }))
@ -73,7 +79,7 @@ fixed output derivation.
Example: Example:
```nix ```nix
tests.fetchgit = invalidateFetcherByDrvHash fetchgit { tests.fetchgit = testers.invalidateFetcherByDrvHash fetchgit {
name = "nix-source"; name = "nix-source";
url = "https://github.com/NixOS/nix"; url = "https://github.com/NixOS/nix";
rev = "9d9dbe6ed05854e03811c361a3380e09183f4f4a"; rev = "9d9dbe6ed05854e03811c361a3380e09183f4f4a";