diff options
| author | Luke Shumaker <lukeshu@sbcglobal.net> | 2016-03-01 19:15:29 -0500 |
|---|---|---|
| committer | Luke Shumaker <lukeshu@sbcglobal.net> | 2016-03-01 19:15:29 -0500 |
| commit | c83d2b58e1776982a7ce45009fb373ec5702c521 (patch) | |
| tree | 5e6cae25f11846392936895f2c2a8ca019c21bbb /HACKING/testing.md | |
| parent | 47004c9601147b4c5c55c2bd6401bda8b6be0406 (diff) | |
improve HACKING documentation
Diffstat (limited to 'HACKING/testing.md')
| -rw-r--r-- | HACKING/testing.md | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/HACKING/testing.md b/HACKING/testing.md new file mode 100644 index 0000000..8dee485 --- /dev/null +++ b/HACKING/testing.md @@ -0,0 +1,18 @@ +Testing +======= + +Please write unit tests for new things. Tests can be run with `make +check`, which just runs `./testenv roundup` in the `test/` directory. +Relatedly, you need the `roundup` (the `sh-roundup` package on +Parabola) tool to run the tests. `./testenv` can be given +`--no-network` and/or `--no-sudo` to dissable tests that require those +things. Make can be made to pass those things in by setting +`TESTENVFLAGS`. If you don't dissable either, I *strongly* recommend +setting TMPDIR to somewhere on a btrfs partition before running the +tests; otherwise the chroot tests will take forever. I mean, they +already take long on btrfs, but without it... _dang_. + +I also recommend having the `haveged` daemon running. That's good +general advice, but also: some of the tests make GPG keys, this +"should" take on the order of 1 second, but can take several minutes +if you don't have `haveged` running. |