# YAML Runner

If there is a running web service that needs to be tested and creating a test loader with `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 Fixtures but otherwise uses the default Test Format. Target Host information is either expressed directly in the YAML file or provided on the command line:

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

or:

    gabbi-run http://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

or in the target URL:

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

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

If a `-x` or `--failfast` argument is provided then `gabbi-run` will exit after the first test failure.