Idris2/tests/templates/with-ipkg/notes.md
2023-09-07 14:57:22 +01:00

17 lines
1006 B
Markdown

## Description
Template for tests that requires a package file.
### Mandatory steps
* Create a new subdirectory for the tests. Try to adhere to the naming scheme of existing tests.
* Update the `tests/Main.idr`, adding the new subdirectory to the lists of tests.
* The `testutils.sh` script defines the `idris2` name binding, and some testing utility functions.
* Automate deletion of any temporary files created by your test. This prevents inconsistencies between runs. The `build`
directory is deleted automatically by `testutils.sh`.
* If the tests open a REPL session, remember to put a quit command, `:q`in the input file.
* The files named `run`, `expected`, `output` are reserved by the test runner, do not overwrite them by running the test.
### Optional steps
* The expected file can be updated for the first time manually, or by running the test, after updating `tests/Main.idr`,
with `make test only="testdir/testname000"` (substitute the only arguments with the subdirectory of the test).