1
1
Fork 0
mirror of https://github.com/NixOS/nix.git synced 2025-11-12 13:36:02 +01:00
nix/doc/manual/src/contributing
John Ericson f7f37035c8 Move tests to separate directories, and document
Today, with the tests inside a `tests` intermingled with the
corresponding library's source code, we have a few problems:

- We have to be careful that wildcards don't end up with tests being
  built as part of Nix proper, or test headers being installed as part
  of Nix proper.

- Tests in libraries but not executables is not right:

  - It means each executable runs the previous unit tests again, because
    it needs the libraries.

  - It doesn't work right on Windows, which doesn't want you to load a
    DLL just for the side global variable . It could be made to work
    with the dlopen equivalent, but that's gross!

This reorg solves these problems.

There is a remaining problem which is that sibbling headers (like
`hash.hh` the test header vs `hash.hh` the main `libnixutil` header) end
up shadowing each other. This PR doesn't solve that. That is left as
future work for a future PR.

Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>

(cherry picked from commit 91b6833686)
(cherry picked from commit a61e42adb5)
2023-12-01 13:05:03 -05:00
..
cli-guideline.md doc/cli-guideline: Improve examples 2023-02-28 16:35:47 +01:00
contributing.md Switch away from classification as Tier1-3 2020-12-08 11:59:23 +01:00
cxx.md Split out worker protocol template definitions from declarations 2023-06-19 11:45:59 -04:00
experimental-features.md Single page for experimental feature descriptions 2023-04-09 11:01:23 -04:00
hacking.md fix broken links (#8722) 2023-07-20 17:58:14 +02:00
testing.md Move tests to separate directories, and document 2023-12-01 13:05:03 -05:00