Michael A. Nachbaur


a8it - Story-test testcase script automation runner


 a8it [-c <config>] [-b <base fixture class>] [-r <test root>] [<file>...]

 Use `perldoc a8it' for more help documentation.


a8it is the command-line utility for Test::A8N, which allows you to run automated story test cases to perform system and live-site automation checks for quality assurance and test purposes.

This utility can be run in a number of fashions, each targeted at your specific use


-c | --config <filename>

The filename where your automation configuration data is stored. Defaults to ~/.a8rc.

-b | --fixture_base <base>

The Perl base class to use for your test case fixtures

-r | --file_root <path>

The path or directory where your test cases live under.

-t | --tag <tag>

The name of a tag that you wish to search for to limit which test cases you run. You can specify this command multiple times to indicate multiple tags, or you can separate them by commas. For instance:

    a8it -t smoke -t email
    a8it -t smoke,email

Additionally, if a tag begins with a bang (!) then it is considered a tag exclusion. In this case, only cases that do not contain the tag will be run. For example:

    a8it -t smoke -t !manual

will run all smoke tests that do not have the "manual" tag.

-i | --id <testcase id<gt>

If you wish to run a single testcase within a test file, you can specify its ID on this argument, and only tests with that ID in the test file will be run. If multiple files are specified, it will only search in the first filename for this ID.

-e | --extension <extension>

This permits you to customize which extension, or extensions, you wish to run within the file_root. It defaults to st and tc.

-l | --list

List the test files and case IDs that will be run, but don't actually run the tests.

-v | --verbose

Enable verbose mode

-h | --help

Basic help usage


Test::A8N, Test::FITesque


Michael Nachbaur <mike@nachbaur.com>, Scott McWhirter <konobi@cpan.org>


This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of Perl 5 you may have available.


Copyright (C) 2008 Sophos, Plc.