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 /pkgs/build-support/testers/default.nix | |
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 'pkgs/build-support/testers/default.nix')
-rw-r--r-- | pkgs/build-support/testers/default.nix | 41 |
1 files changed, 1 insertions, 40 deletions
diff --git a/pkgs/build-support/testers/default.nix b/pkgs/build-support/testers/default.nix index e5a8dbc7960..8b79843b833 100644 --- a/pkgs/build-support/testers/default.nix +++ b/pkgs/build-support/testers/default.nix @@ -1,47 +1,8 @@ { pkgs, lib, callPackage, runCommand }: +# Documentation is in doc/builders/testers.chapter.md { - - /* Checks that two packages produce the exact same build instructions. - - This can be used to make sure that a certain difference of configuration, - such as the presence of an overlay does not cause a cache miss. - - When the derivations are equal, the return value is an empty file. - Otherwise, the build log explains the difference via `nix-diff`. - - Example: - - testEqualDerivation - "The hello package must stay the same when enabling checks." - hello - (hello.overrideAttrs(o: { doCheck = true; })) - */ testEqualDerivation = callPackage ./test-equal-derivation.nix { }; - /* Checks the command output contains the specified version - - Although simplistic, this test assures that the main program - can run. While there's no substitute for a real test case, - it does catch dynamic linking errors and such. It also provides - some protection against accidentally building the wrong version, - for example when using an 'old' hash in a fixed-output derivation. - - Examples: - - passthru.tests.version = testVersion { package = hello; }; - - passthru.tests.version = testVersion { - package = seaweedfs; - command = "weed version"; - }; - - passthru.tests.version = testVersion { - package = key; - command = "KeY --help"; - # Wrong '2.5' version in the code. Drop on next version. - version = "2.5"; - }; - */ testVersion = { package, command ? "${package.meta.mainProgram or package.pname or package.name} --version", |