NAME
IO::Async::LoopTests - acceptance testing for IO::Async::Loop subclasses
SYNOPSIS
use IO::Async::LoopTests;
run_tests( 'IO::Async::Loop::Shiney', 'io' );DESCRIPTION
This module contains a collection of test functions for running acceptance tests on IO::Async::Loop subclasses. It is provided as a facility for authors of such subclasses to ensure that the code conforms to the Loop API required by IO::Async.
TIMING
Certain tests require the use of timers or timed delays. Normally these are counted in units of seconds. By setting the environment variable TEST_QUICK_TIMERS to some true value, these timers run 10 times quicker, being measured in units of 0.1 seconds instead. This value may be useful when running the tests interactively, to avoid them taking too long. The slower timers are preferred on automated smoke-testing machines, to help guard against false negatives reported simply because of scheduling delays or high system load while testing.
$ TEST_QUICK_TIMERS=1 ./Build testFUNCTIONS
run_tests
run_tests( $class, @tests );Runs a test or collection of tests against the loop subclass given. The class being tested is loaded by this function; the containing script does not need to require or use it first.
This function runs plan to output its expected test count; the containing script should not do this.
TEST SUITES
The following test suite names exist, to be passed as a name in the @tests argument to run_tests:
io
Tests the Loop's ability to watch filehandles for IO readiness
timer
Tests the Loop's ability to handle timer events
signal
Tests the Loop's ability to watch POSIX signals
idle
Tests the Loop's support for idle handlers
process
Tests the Loop's support for watching child processes by PID
(Previously called child)
control
Tests that the run, stop, loop_once and loop_forever methods behave correctly
metrics
Tests that metrics are generated appropriately using Metrics::Any.
AUTHOR
Paul Evans <leonerd@leonerd.org.uk>