1git-annex-test(1)           General Commands Manual          git-annex-test(1)
2
3
4

NAME

6       git-annex-test - run built-in test suite
7

SYNOPSIS

9       git annex test
10

DESCRIPTION

12       This runs git-annex's built-in test suite.
13
14       The test suite runs in the .t subdirectory of the current directory.
15
16       It  can be useful to run the test suite on different filesystems, or to
17       verify your local installation of git-annex.
18

OPTIONS

20       There are several options, provided by Haskell's tasty test  framework.
21       Pass --help for details about those.
22
23       --jobs=N -JN
24              How  many tests to run in parallel. The default is "cpus", which
25              will runs one job per CPU core.
26
27       --keep-failures
28              When there are test failures, leave the .t  directory  populated
29              with repositories that demonstate the failures, for later analy‐
30              sis.
31
32       --test-git-config name=value
33              The test suite prevents git from reading any  git  configuration
34              files.   Usually  it is a good idea to run the test suite with a
35              standard git configuration. However, this option can  be  useful
36              to  see  what effect a git configuration setting has on the test
37              suite.
38
39              Some configuration settings will break the test suite,  in  ways
40              that  are  due  to  a  bug in git-annex. But it is possible that
41              changing a configuration can find a legitimate bug in git-annex.
42
43              One valid use of this is to change  a  git  configuration  to  a
44              value  that is planned to be the new default in a future version
45              of git.
46
47       --test-debug
48              Normally output of commands run by the test suite is hidden,  so
49              even when annex.debug or --debug is enabled, it will not be dis‐
50              played.  This option makes the full output of  commands  run  by
51              the  test  suite  be displayed. It also makes the test suite run
52              git-annex with --debug.
53
54              It's a good idea to use -J1 in combinaton with  this,  otherwise
55              the output of concurrent tests will be mixed together.
56

SEE ALSO

58       git-annex(1)
59
60       git-annex-testremote(1)
61

AUTHOR

63       Joey Hess <id@joeyh.name>
64
65                                                             git-annex-test(1)
Impressum