summary refs log tree commit diff
path: root/lib/tests/misc.nix
diff options
context:
space:
mode:
authorRobert Hensing <roberth@users.noreply.github.com>2023-07-19 16:34:36 +0200
committerGitHub <noreply@github.com>2023-07-19 16:34:36 +0200
commit0665253b864c4b725c19337b2b1971158f55b16f (patch)
treef4cc62995896cecf412e63daab21ee12ef7829f8 /lib/tests/misc.nix
parentda865b2b9e32d94f33c6862465bfa0e2f132a87e (diff)
parent581d7c88bea4216fb47c2a98f38af59f2d14485d (diff)
downloadnixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.tar
nixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.tar.gz
nixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.tar.bz2
nixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.tar.lz
nixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.tar.xz
nixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.tar.zst
nixpkgs-0665253b864c4b725c19337b2b1971158f55b16f.zip
Merge pull request #244044 from tweag/lib-readme
Create a Readme in `lib`
Diffstat (limited to 'lib/tests/misc.nix')
-rw-r--r--lib/tests/misc.nix18
1 files changed, 15 insertions, 3 deletions
diff --git a/lib/tests/misc.nix b/lib/tests/misc.nix
index 86861695460..56bf31ea5da 100644
--- a/lib/tests/misc.nix
+++ b/lib/tests/misc.nix
@@ -1,6 +1,18 @@
-# to run these tests:
-# nix-instantiate --eval --strict nixpkgs/lib/tests/misc.nix
-# if the resulting list is empty, all tests passed
+/*
+Nix evaluation tests for various lib functions.
+
+Since these tests are implemented with Nix evaluation, error checking is limited to what `builtins.tryEval` can detect, which is `throw`'s and `abort`'s, without error messages.
+If you need to test error messages or more complex evaluations, see ./modules.sh, ./sources.sh or ./filesystem.sh as examples.
+
+To run these tests:
+
+  [nixpkgs]$ nix-instantiate --eval --strict lib/tests/misc.nix
+
+If the resulting list is empty, all tests passed.
+Alternatively, to run all `lib` tests:
+
+  [nixpkgs]$ nix-build lib/tests/release.nix
+*/
 with import ../default.nix;
 
 let