1Test::Run::CmdLine(3) User Contributed Perl DocumentationTest::Run::CmdLine(3)
2
3
4

NAME

6       Test::Run::CmdLine - Analyze tests from the command line using
7       Test::Run
8

SYNOPSIS

10           use Test::Run::CmdLine;
11
12           my $tester = Test::Run::CmdLine->new(
13               {
14                   'test_files' => ["t/one.t", "t/two.t"],
15               },
16           );
17
18           $tester->run();
19

Interface Functions

21   $tester = Test::Run::CmdLine->new({'test_files' => \@test_files, ....});
22       Initializes a new testing front end. "test_files" is a named argument
23       that contains the files to test.
24
25       Other named arguments are:
26
27       backend_params
28           This is a hash of named parameters to be passed to the backend
29           class (derived from Test::Run::Obj.)
30
31       driver_class
32           This is the backend class that will be instantiated and used to
33           perform the processing. Defaults to Test::Run::Obj.
34
35   $tester->run()
36       Actually runs the tests on the command line.
37
38       TODO : Write more.
39
40   BUILD
41       For Moose.
42

Environment Variables

44       The following environment variables (%ENV) affect the behaviour of
45       Test::Run::CmdLine:
46
47       HARNESS_COLUMNS
48           This determines the width of the terminal (sets 'Columns') in
49           Test::Run::Obj). If not specified, it will be determined according
50           to the "COLUMNS" environment variable, that is normally specified
51           by the terminal.
52
53       HARNESS_DEBUG
54           Triggers the 'Debug' option in Test::Run::Obj. Meaning, it will
55           print debugging information about itself as it runs the tests.
56
57       HARNESS_FILELEAK_IN_DIR
58           This variable points to a directory that will be monitored. After
59           each test file, the module will check if new files appeared in the
60           direcotry and report them.
61
62           It is advisable to give an absolute path here. If it is relative,
63           it would be relative to the current working directory when
64           "$tester->run()" was called.
65
66       HARNESS_NOTTY
67           Triggers the 'NoTty' option in Test::Run::Obj. Meaning, it causes
68           Test::Run::CmdLine not to treat STDOUT as if it were a console. In
69           this case, it will not emit more frequent progress reports using
70           carriage returns ("\r"s).
71
72       HARNESS_PERL
73           Specifies the 'Test_Interpreter' variable of Test::Run::Obj. This
74           allows specifying a different Perl interprter to use besides $^X.
75
76       HARNESS_PERL_SWITCHES
77           Specifies the 'Switches' variable of Test::Run::Obj. This allows
78           specifying more switches to the Perl interpreter.
79
80       HARNESS_TIMER
81           This variable triggers the 'Timer' option in Test::Run::Obj. What
82           it does is causes the time that took for tests to run to be
83           displayed.
84
85       HARNESS_VERBOSE
86           Triggers the 'Verbose' option in Test::Run::Obj. Meaning, it emits
87           the standard output of the test files while they are processed.
88

Internal Functions

90   my $args_array_ref = $tester->get_backend_args()
91       Calculate and retrieve the arguments for the backend class (that
92       inherits from Test::Run::Obj) as a single array reference. Currently it
93       appends the arguments of get_backend_env_args() to that of
94       get_backend_init_args().
95
96   $self->private_backend_args()
97       Calculates the get_backend_args()-specific arguments for this class.
98
99   $tester->get_backend_env_args()
100       Calculate the arguments for the backend class, that originated from the
101       environment (%ENV), and puts them in "$tester-"backend_env_args()>
102
103   $self->private_direct_backend_env_mapping()
104       The return value of this method is collected from every class, and
105       adapted to the direct backend environment mapping.
106
107   my $args_array_ref = $tester->get_backend_init_args()
108       Calculate and return the arguments for the backend class, that
109       originated from the arguments passed to the (front-end) object from its
110       constructor.
111
112   $self->private_backend_plugins()
113       Calculates the backend plugins specific for this class. They will be
114       collected to formulate a list of plugins that will be
115       "add_to_backend_plugins()"'ed.
116
117   $self->add_to_backend_plugins($plugin)
118       Appends a plugin to the plugins list. Useful in front-end plug-ins.
119

AUTHORS

121       Shlomi Fish, <http://www.shlomifish.org/> .
122

BUGS

124       Please report any bugs or feature requests to
125       "bug-test-run-cmdline@rt.cpan.org", or through the web interface at
126       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Run-CmdLine>.  I
127       will be notified, and then you'll automatically be notified of progress
128       on your bug as I make changes.
129

SUPPORT

131       You can find documentation for this module with the perldoc command.
132
133           perldoc Test::Run::CmdLine
134
135       You can also look for information at:
136
137       •   CPAN Ratings
138
139           <http://cpanratings.perl.org/d/Test::Run::CmdLine>
140
141       •   RT: CPAN's request tracker
142
143           <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test::Run::CmdLine>
144
145       •   Search CPAN
146
147           <http://search.cpan.org/dist/Test::Run::CmdLine/>
148

SOURCE AVAILABILITY

150       The latest source of Test::Run::CmdLine is available from the Test::Run
151       BerliOS Subversion repository:
152
153       <https://svn.berlios.de/svnroot/repos/web-cpan/Test-Harness-NG/>
154

ACKNOWLEDGEMENTS

157       Copyright 2005 Shlomi Fish, all rights reserved.
158
159       This program is released under the MIT X11 License.
160
161
162
163perl v5.32.1                      2021-01-27             Test::Run::CmdLine(3)
Impressum