Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  TEST::ABLE::PLANNER (3)

.ds Aq ’


Test::Able::Planner - Planning role



This role represents the core of the planning support in Test::Able.

The vast majority of the time all that’s necessary, in terms of planning, is to set the plans at the method level. For a more thorough explanation of how planning in Test::Able works read on.

In order to facilitate planning there’s a hierarchy of plans. That hierarchy is as follows: test-related methods, test objects, test runner object, and Test::Builder. The sum of all the constituent method plans make up the object plan. The sum of all the constituent object plans make up the runner object plan. And the runner object plan gets added to Test::Builder’s plan.

Its possible to set a method’s plan at any time. To make this possible the object and runner object plans are cleared when a method plan is set. Then, the runner object’s plan gets recalculated, at the latest, when it needs to add to Test::Builder’s plan.

At the moment Test::Builder does not support deferred planning. Until such time as Test::Builder supports it Test::Able emulates it as best it can for its own purposes.

If Test::Builder’s plan is set to a numeric value then Test::Able will not touch it. If Test::Builder’s plan is no_plan then Test::Able will persuade Test::Builder to do deferred planning with what it thinks is the plan.

Note that as a convenience, if Test::Builder’s plan is not declared by the time Test::Able’s run_tests() is called the plan will be set to no_plan.


builder The Test::Builder instance.
plan Test plan similar to Test::Builder’s.
runner_plan The plan that the test runner object manages. This is the top level plan that all other plans are aggregated into.
last_runner_plan Used by the test runner object in calculating Test::Builder’s plan.


Justin DeVuyst,


Copyright 2009 by Justin DeVuyst.

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 TEST::ABLE::PLANNER (3) 2010-11-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.