nixos-config/tests/README.adoc

= Tests
:toc:


Yes, tests!
Because apparently, letting desktop users BE the developers of their own operating system is such as a GOOOOOOOOD idea...

Anyways, as part of cosplaying of a wannabe developer, we have tests for the major components of this NixOS configuration including the link:../lib[custom library], link:../modules/nixos[our custom NixOS modules], link:../modules/home-manager[custom home-manager modules], and so on.

Each of the test suite follows how the upstream does their tests.
For example, our home-manager module tests just copies what the upstream is doing.

You should be able to test them with the following command:

[source, shell]
----
# These commands assume you're in the project root.

# This test is for home-manager module tests because it is using nix-lib-nmt
# which is only working in pure mode.
nix-shell --pure ./tests/modules/home-manager -A list

# This is for the library.
nix eval -f ./tests lib
----
docs: add tests README 2024-03-09 02:39:35 +00:00			`= Tests`
			`:toc:`


			`Yes, tests!`
tests: update README and attrset Even if the home-manager test is pretty useless with the new Nix CLI since it only works on `nix-shell` but could be handy at some point. 2024-06-10 09:09:32 +00:00			`Because apparently, letting desktop users BE the developers of their own operating system is such as a GOOOOOOOOD idea...`

			`Anyways, as part of cosplaying of a wannabe developer, we have tests for the major components of this NixOS configuration including the link:../lib[custom library], link:../modules/nixos[our custom NixOS modules], link:../modules/home-manager[custom home-manager modules], and so on.`
docs: add tests README 2024-03-09 02:39:35 +00:00
			`Each of the test suite follows how the upstream does their tests.`
			`For example, our home-manager module tests just copies what the upstream is doing.`

			`You should be able to test them with the following command:`

			`[source, shell]`
			`----`
			`# These commands assume you're in the project root.`

tests: update README and attrset Even if the home-manager test is pretty useless with the new Nix CLI since it only works on `nix-shell` but could be handy at some point. 2024-06-10 09:09:32 +00:00			`# This test is for home-manager module tests because it is using nix-lib-nmt`
			`# which is only working in pure mode.`
docs: add tests README 2024-03-09 02:39:35 +00:00			`nix-shell --pure ./tests/modules/home-manager -A list`

			`# This is for the library.`
			`nix eval -f ./tests lib`
			`----`