If you have ruby installed in /usr/bin/ruby, and also have Test::WWW::Mechanize installed, you can cd into examples/ (the directory where this README lives) and run the following command after installing the runtests utility:
/usr/bin/ruby
Test::WWW::Mechanize
examples/
runtests
examples $ runtests --exec ./my_exec t -v - < test_urls.txt t/10-stuff..............Failed 1/6 tests (less 2 skipped tests: 3 okay) (1 test unexpectedly succeeded) t/ruby..................ok http://www.google.com/....ok http://www.yahoo.com/.....ok Test Summary Report ------------------- t/10-stuff.t (Wstat: 256 Tests: 6 Failed: 1) Failed tests: 2 TODO passed: 6 uests skipped: 3-4 Files=4, Tests=10, 3 wallclock secs ( 0.92 cusr + 0.23 csys = 1.15 CPU)
The my_exec is a Perl program which tells the test harness how to execute any tests it encounters.
my_exec
The t argument tells it to search in the t/ directory for any tests. One of the tests it finds is written in Ruby, but the my_exec program tells it how to run this test. If you have Ruby installed but the test fails, try changing the path. If you don't have Ruby installed, you can simply comment out those lines in my_exec, but the test will fail.
t
t/
The - tells runtests to read from STDIN and test_urls.txt is merely a list of URLs we wish to test.
-
STDIN
test_urls.txt
See the documentation for runtests and TAP::Harness for more information about how to use this.
TAP::Harness
The -v tells the harness to run in verbose mode.
-v
The tprove* harnesses in the examples/bin/ directory are deprecated in favor of the new runtests/TAP::Harness tools. They are left in primary for curiosity sake, though you may find the tprove_gtk one useful as a reference for how to create a GUI interface for TAP::Parser.
tprove*
examples/bin/
tprove_gtk
TAP::Parser
Instead, simple override the desired methods in TAP::Harness to create your own custom test harness. Don't like how the summary report is formatted? Just override the &TAP::Harness::summary method and use your new subclass:
&TAP::Harness::summary
runtests --harness TAP::Harness::MyHarness
To install Test::Harness, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::Harness
CPAN shell
perl -MCPAN -e shell install Test::Harness
For more information on module installation, please visit the detailed CPAN module installation guide.