1Test::Run::CmdLine(3) User Contributed Perl DocumentationTest::Run::CmdLine(3)
2
6 Test::Run::CmdLine - Analyze tests from the command line using
7 Test::Run
8
10 use Test::Run::CmdLine;
11 my $tester = Test::Run::CmdLine->new(
13 {
14 'test_files' => ["t/one.t", "t/two.t"],
15 },
16 );
17 $tester->run();
19
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 Other named arguments are:
26 backend_params
28 This is a hash of named parameters to be passed to the backend
29 class (derived from Test::Run::Obj.)
30 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 $tester->run()
36 Actually runs the tests on the command line.
37 TODO : Write more.
39 BUILD
41 For Moose.
42
44 The following environment variables (%ENV) affect the behaviour of
45 Test::Run::CmdLine:
46 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 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 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 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 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 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 HARNESS_PERL_SWITCHES
77 Specifies the 'Switches' variable of Test::Run::Obj. This allows
78 specifying more switches to the Perl interpreter.
79 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 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
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 $self->private_backend_args()
97 Calculates the get_backend_args()-specific arguments for this class.
98 $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 $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 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 $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 $self->add_to_backend_plugins($plugin)
118 Appends a plugin to the plugins list. Useful in front-end plug-ins.
119
121 Shlomi Fish, <http://www.shlomifish.org/> .
122
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
131 You can find documentation for this module with the perldoc command.
132 perldoc Test::Run::CmdLine
134 You can also look for information at:
136 · AnnoCPAN: Annotated CPAN documentation
138 <http://annocpan.org/dist/Test::Run::CmdLine>
140 · CPAN Ratings
142 <http://cpanratings.perl.org/d/Test::Run::CmdLine>
144 · RT: CPAN's request tracker
146 <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test::Run::CmdLine>
148 · Search CPAN
150 <http://search.cpan.org/dist/Test::Run::CmdLine/>
152
154 The latest source of Test::Run::CmdLine is available from the Test::Run
155 BerliOS Subversion repository:
156 <https://svn.berlios.de/svnroot/repos/web-cpan/Test-Harness-NG/>
158
161 Copyright 2005 Shlomi Fish, all rights reserved.
162 This program is released under the MIT X11 License.
164perl v5.30.0 2019-07-26 Test::Run::CmdLine(3)