.. _ref_commands_test:

test
====

Run charm tests in different back-ends.

This command will run charm test suites using the spread tool. For further
information, see the spread documentation: https://github.com/snapcore/spread


Usage
-----

:command:`charmcraft test [options] <tasks>`

Required
--------

``tasks``
   Spread tasks to run, in backend:system:suite/task:variant format. All fields are optional.

Options
-------

``--debug``
   Shell into the environment if the build fails.
``--list``
   Just show the list of jobs that would run.
``--shell``
   Shell into the environment in lieu of the step to run.
``--shell-after``
   Shell into the environment after the step has run.

Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.