IO::Async::LoopTests

Section: User Contributed Perl Documentation (3pm)
Updated: 2018-04-19
Page Index
 

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 test

 

FUNCTIONS

 

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 "Test::More::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  

child

Tests the Loop's support for watching child processes by PID  

control

Tests that the "run", "stop", "loop_once" and "loop_forever" methods behave correctly  

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>


 

Index

NAME
SYNOPSIS
DESCRIPTION
TIMING
FUNCTIONS
run_tests
TEST SUITES
io
timer
signal
idle
child
control
AUTHOR