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.

       --test-git-config name=value
              The  test  suite prevents git from reading any git configuration files.  Usually it
              is a good idea to run the test suite with a standard  git  configuration.  However,
              this option can be useful to see what effect a git configuration setting has on the
              test suite.

              Some configuration settings will break the test suite, in ways that are  due  to  a
              bug  in  git-annex.  But  it  is  possible that changing a configuration can find a
              legitimate bug in git-annex.

              One valid use of this is to change a git configuration to a value that  is  planned
              to be the new default in a future version of git.

              Also,  some  things  can  only  be  tested  with  a git configuration. For example,
              annex.shared-sop-command has to be set for  the  test  suite  to  test  using  that
              command.

       --test-debug
              Normally  output  of  commands  run  by  the  test  suite  is  hidden, so even when
              annex.debug or --debug is enabled, it will not be displayed.  This option makes the
              full  output of commands run by the test suite be displayed. It also makes the test
              suite run git-annex with --debug.

              It's a good idea to use -J1 in  combinaton  with  this,  otherwise  the  output  of
              concurrent tests will be mixed together.

SEE ALSO

       git-annex(1)

       git-annex-testremote(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                git-annex-test(1)