2014-08-24 17:18:18 +00:00
|
|
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
|
|
version="5.0"
|
2015-04-21 06:27:40 +00:00
|
|
|
|
xml:id="sec-running-nixos-tests-interactively">
|
2018-05-01 23:57:09 +00:00
|
|
|
|
<title>Running Tests</title>
|
2014-08-24 17:18:18 +00:00
|
|
|
|
|
2018-05-01 23:57:09 +00:00
|
|
|
|
<para>
|
|
|
|
|
|
You can run tests using <command>nix-build</command>. For example, to run the
|
|
|
|
|
|
test
|
|
|
|
|
|
<filename
|
2014-08-24 17:18:18 +00:00
|
|
|
|
xlink:href="https://github.com/NixOS/nixpkgs/blob/master/nixos/tests/login.nix">login.nix</filename>,
|
2018-05-01 23:57:09 +00:00
|
|
|
|
you just do:
|
2014-08-24 17:18:18 +00:00
|
|
|
|
<screen>
|
|
|
|
|
|
$ nix-build '<nixpkgs/nixos/tests/login.nix>'
|
|
|
|
|
|
</screen>
|
2018-05-01 23:57:09 +00:00
|
|
|
|
or, if you don’t want to rely on <envar>NIX_PATH</envar>:
|
2014-08-24 17:18:18 +00:00
|
|
|
|
<screen>
|
|
|
|
|
|
$ cd /my/nixpkgs/nixos/tests
|
|
|
|
|
|
$ nix-build login.nix
|
|
|
|
|
|
…
|
|
|
|
|
|
running the VM test script
|
|
|
|
|
|
machine: QEMU running (pid 8841)
|
|
|
|
|
|
…
|
|
|
|
|
|
6 out of 6 tests succeeded
|
|
|
|
|
|
</screen>
|
2018-05-01 23:57:09 +00:00
|
|
|
|
After building/downloading all required dependencies, this will perform a
|
|
|
|
|
|
build that starts a QEMU/KVM virtual machine containing a NixOS system. The
|
|
|
|
|
|
virtual machine mounts the Nix store of the host; this makes VM creation very
|
|
|
|
|
|
fast, as no disk image needs to be created. Afterwards, you can view a
|
|
|
|
|
|
pretty-printed log of the test:
|
2014-08-24 17:18:18 +00:00
|
|
|
|
<screen>
|
|
|
|
|
|
$ firefox result/log.html
|
|
|
|
|
|
</screen>
|
2018-05-01 23:57:09 +00:00
|
|
|
|
</para>
|
2014-11-27 18:01:34 +00:00
|
|
|
|
</section>
|
