/ 
TestRail-API-0.050
River stage zero No dependents
/ TestRail::Bin::BulkMarkResults

NAME

TestRail::Bin::BulkMarkResults - Bulk mark entire runs/plans (or groups of tests therein) as the provided status.

VERSION

version 0.050

DESCRIPTION

Sometimes it is useful to mark entire runs of tests when, for example, a prerequisite test in a sequence invalidates all further tests. For example, if a binary produced for test fails to run at all, more detailed testing will be impossible; it would save time to just mark everything as blocked.

Can be used as the modulino TestRail::Bin::BulkMarkResults. Has a single 'run' function which accepts a hash with the 'args' parameter being the array of arguments.

USAGE

testrail-bulk-mark-results [OPTIONS] status [reason]

require `which testrail-bulk-mark-results`;
TestRail::Bin::BulkMarkResults::run('args' => \@args);

PARAMETERS:

MANDATORY PARAMETERS

    --apiurl : full URL to get to TestRail index document

    --password : Your TestRail Password, or a valid API key (TestRail 4.2 and above).

    --user : Your TestRail User Name.

    -j --project : desired project name.

    -r --run : desired run name.

All mandatory options not passed with the above switches, or in your ~/.testrailrc will be prompted for.

SEMI-OPTIONAL PARAMETERS

    -p --plan : desired plan name. Required if the run passed is a child of a plan.

    -e --encoding : Character encoding of arguments. Defaults to UTF-8. See Encode::Supported for supported encodings.

OPTIONAL PARAMETERS

    -c --config : configuration name to filter plans in run. Can be passed multiple times.

    -s --status : only mark tests already marked as [status] in testrail. Can be passed multiple times.

    -a --assignedto : only mark tests assigned to user. Can be passed multiple times.

CONFIGURATION FILE

In your \$HOME, (or the current directory, if your system has no concept of a home directory) put a file called .testrailrc with key=value syntax separated by newlines. Valid Keys are the same as documented by App::Prove::Plugin::TestRail. All options specified thereby are overridden by passing the command-line switches above.

MISCELLANEOUS OPTIONS:

    --help : show this output

SPECIAL THANKS

Thanks to cPanel Inc, for graciously funding the creation of this distribution.

AUTHOR

George S. Baugh <teodesian@cpan.org>

SOURCE

The development version is on github at https://github.com/teodesian/TestRail-Perl and may be cloned from git://github.com/teodesian/TestRail-Perl.git

COPYRIGHT AND LICENSE

This software is copyright (c) 2021 by George S. Baugh.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.