NAME

POE::Watcher::Wheel - watch a POE::Wheel rather than reinvent it

SYNOPSIS

# Note, this is not a complete program.
# See the distribution's examples directory.

my $wheel :Req = POE::Watcher::Wheel->new(
	wheel_class => "POE::Wheel::Run",
	wheel_parameters => {
		Program => "...",
		StdoutMethod
TODO - Finish.

DESCRIPTION

TODO - Write.

PUBLIC METHODS

new wheel_class => NAME, wheel_parameters => HASHREF

Create a new POE::Watcher::Wheel, encapsulating a CLASS_NAME type of wheel object. The wheel is constructed using WHEEL_PARAMS, which are translated into POE::Wheel parameters and passed to the wheel's constructor.

The CLASS_NAME wheel should be loaded ahead of time.

Since POE::Watcher classes invoke callbacks rather than emit events, use /.*Method$/ parameters wherever you would normally use /.*Event$/ parameters in the Wheel constructor. The SYNOPSIS might shed some light on this if it were complete.

Destroy this object to cancel it.

BUGS

See http://thirdlobe.com/projects/poe-stage/report/1 for known issues. See http://thirdlobe.com/projects/poe-stage/newticket to report one.

POE::Stage is too young for production use. For example, its syntax is still changing. You probably know what you don't like, or what you need that isn't included, so consider fixing or adding that, or at least discussing it with the people on POE's mailing list or IRC channel. Your feedback and contributions will bring POE::Stage closer to usability. We appreciate it.

SEE ALSO

POE::Watcher describes concepts that are common to all POE::Watcher classes. It's required reading in order to understand fully what's going on.

AUTHORS

Rocco Caputo <rcaputo@cpan.org>.

LICENSE

POE::Watcher::Input is Copyright 2005-2006 by Rocco Caputo. All rights are reserved. You may use, modify, and/or distribute this module under the same terms as Perl itself.