git-annex/doc/git-annex-test.mdwn
Joey Hess 025c18128b
test: Added --jobs option
Default to the number of CPU cores, which seems about optimal
on my laptop. Using one more saves me 2 seconds actually.

Better packing of workers improves speed significantly.

In 2 tests runs, I saw segfaulting workers despite my attempt
to work around that issue. So detect when a worker does, and re-run it.

Removed installSignalHandlers again, because I was seeing an
error "lost signal due to full pipe", which I guess was somehow caused
by using it.

Sponsored-by: Dartmouth College's Datalad project
2022-03-16 14:42:07 -04:00

43 lines
906 B
Markdown

# NAME
git-annex test - run built-in test suite
# SYNOPSIS
git annex test
# DESCRIPTION
This runs git-annex's built-in test suite.
The test suite runs in the `.t` subdirectory of the current directory.
It can be useful to run the test suite on different filesystems,
or to verify your local installation of git-annex.
# OPTIONS
There are several options, provided by Haskell's tasty test
framework. Pass --help for details about those.
* `--jobs=N` `-JN`
How many tests to run in parallel. The default is "cpus", which will
runs one job per CPU core.
* `--keep-failures`
When there are test failures, leave the `.t` directory populated with
repositories that demonstate the failures, for later analysis.
# SEE ALSO
[[git-annex]](1)
[[git-annex-testremote]](1)
# AUTHOR
Joey Hess <id@joeyh.name>
Warning: Automatically converted into a man page by mdwn2man. Edit with care.