NAME

       gem2deb-test-runner - runs test suite contained in Debian Ruby packages

SYNOPSIS

       gem2deb-test-runner [OPTIONS]

DESCRIPTION

       gem2deb-test-runner runs the tests shipped inside a source Debian Ruby package. The way the tests are run
       is configured in one of the three files: debian/ruby-test-files.yaml, debian/ruby-tests.rake,
       debian/ruby-tests.rb. See the FILES section in dh_ruby(1) for details.

       If called without argument in the root of the source package after the package is built and installed
       under debian/package_name, then the tests will be run using the files of the package installed under
       debian/package_name. This call is part of the dh_ruby(1) sequence when building a Ruby package with
       gem2deb.

       If the option --autopkgtest is used, the package needs to be installed on the system. gem2deb-test-runner
       will not try to load files under debian/ and will move away temporarily the lib/ and ext/ directory to
       ensure the test suite is run against the installed package. This is used in the context of automatic as-
       installed package testing, through the autopkgtest framework.

OPTIONS

       --autopkgtest
           Run  the  tests  against  the installed package for automatic as-installed package testing. Useful in
           conjunction with adt-run(1).

       -c, --check-dependencies
           Before running the tests, checks whether all dependencies of the package, as declared in the Rubygems
           metadata, are present. Makes the program exit with a  non-zero  status  code  (i.e.  fails)  if  they
           aren't.

           If you want to check dependencies during the build, you can add something like this to debian/rules:

       -d, --check-dependencies-only
           Exit  after  checking  dependencies,  i.e.  only check dependencies, and don't run any tests. Implies
           --check-dependencies.

ENVIRONMENT

       GEM2DEB_TEST_RUNNER
           Used  to  pass  options  to  gem2deb-test-runner  via  the  environment.   For   example,   to   make
           gem2deb-test-runner   check  dependencies  during  package  build,  you  can  add  the  following  to
           debian/rules:

               export GEM2DEB_TEST_RUNNER = --check-dependencies

SEE ALSO

       dh_ruby(1), gem2deb(1)

                                                   2018-03-22                             GEM2DEB-TEST-RUNNER(1)