NAME

       lift - Run a Lift test suite

SYNOPSIS

       lift [OPTION]... [TEST]...

DESCRIPTION

       The  lift  command runs all or parts of a Lift test suite.  By default, with no option, lift run all test
       it discovers in the current directory and its sub-directories.

       Lift stands for Lift Integration-Functional Testing.

OPTIONS

       -h, --help
              Show an help message and exit.

       -V, --version
              Show the lift version.

       -q, --quiet
              Do not print the output of tests as they run.

       -d, --detailed-summary
              Print the output of failed tests in the final summary.

       -n, --no-color
              Disable colored output.  Maybe useful, for example if colors interfere with your term.

       --regex
              Process TEST strings as standard Python regex.  See below for more information.

       --no-upper-inheritance
              Do not load remotes/environment from upper level lift.yaml files.  By default, lift will look  for
              lift.yaml  files  in upper level folders in order to find settings to inherit for the current test
              file.  This option disable this behaviour and consider the current test directory as a  top  level
              one.

       --put-remotes-in-environment
              All  defined  remotes  will be passed as environment variables to tests.  Variables will be in the
              following form: LIFT_REMOTE_remotename=login:password@host. Note that the password (along with the
              ":" separator) will not be there if it was not defined in the first place.  SECURITY  WARNING:  Do
              not  use this option if some of your binary tests can not be trusted to keep these credentials for
              themselves.

       -f FOLDER, --folder FOLDER
              Specify the root folder in which tests will be looked for.  By default, use  the  current  working
              directory.

       -r REMOTE, --remote REMOTE
              Define  a  remote.  The  value should be in the following form: REMOTENAME=USERNAME:PASSWORD@HOST.
              Note that the PASSWORD field (along with the ":" separator) is optional if SSH keys  are  properly
              set.  This option can be used multiple times to define multiple remotes.  Remotes defined via this
              option supersede those defined via lift.yaml files.

       --with-xunit
              Provide test results in the standard XUnit XML format.

       --xunit-file XUNIT_FILE
              Specify the path of the XML file to store the XUnit report in.  The default  is  lift.xml  in  the
              current working directory.

RUN SPECIFIC TESTS

       You can select specific tests to run directly on the command line.  You can use the test string format as
       found in the normal lift output, ie. "FOLDER/TEST_NAME".

       If  you  set  the  "--regex"  option,  expressions will be matched as standard Python regex. For example,
       ".*foo" will match all tests containing the word "foo".

       See http://docs.python.org/library/re.html for more information on the Python regex syntax.

SEE ALSO

       For the test suite definition, see lift.yaml (1)

AUTHOR

       Written an maintained by Nicolas Delvaux <contact@nicolas-delvaux.org>

COPYRIGHT

       GPL2+

2.5.0                                              2016-09-25                                            LIFT(1)