YAML Runner
===========

If there is a running web service that needs to be tested and
creating a test loader with :meth:`~gabbi.driver.build_tests` is
either inconvenient or overkill it is possible to run YAML test
files directly from the command line with the console-script
``gabbi-run``. It accepts YAML on ``stdin``, generates and runs
tests and outputs a summary of the results.

The provided YAML may not use custom :doc:`fixtures` but otherwise
uses the default :doc:`format`. :doc:`host` information is either
expressed directly in the YAML file or provided on the command
line::

    gabbi-run [host[:port]] < /my/test.yaml

To facilitate using the same tests against the same application mounted
in different locations in a WSGI server, a `prefix` may be provided
as a second argument::

    gabbi-run host[:port] [prefix] < /my/test.yaml

The value of prefix will be prepended to the path portion of URLs that
are not fully qualified.