The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::Radio::Location::SUPL::MainLoop - Net::DBus::Reactor wrapper for SUPL Tests

DESCRIPTION

This package wraps Net::DBus::Reactor for controlled D-Bus objects and test instances. I/O handles of controlled objects are added to the watch list of Net::DBus::Reactor on adding and remove on removing of objects.

METHODS

new

Instantiates new Net::Radio::Location::SUPL::MainLoop. Thus it's a singleton, always the same instance is returned. The behavior in multi-threaded programs is undefined.

add

  Net::Radio::Location::SUPL::MainLoop->add($obj);

Adds a new object to be controlled.

If the added object wants to be triggered when a handle is ready for read ($obj->can("trigger_read")), the appropriate handle is passed to Net::DBus::Reactor/METHODS method of net::DBus::Reactor.

remove

  Net::Radio::Location::SUPL::MainLoop->remove($obj);

Removes an object from the list of controlled objects.

If the added object wants to be triggered when a handle is ready for read ($obj->can("trigger_read")), the appropriate handle is passed to Net::DBus::Reactor/METHODS method of net::DBus::Reactor.

When the last object is removed, the reactor is shut down.

run

Start's the main loop via Net::DBus::Reactor.

When Net::Radio::Location::SUPL::MainLoop hasn't been instantiated or no objects are controlled, it dies with exception.

BUGS

Please report any bugs or feature requests to bug-supl-test at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=SUPL-Test. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

If you think you've found a bug then please read "How to Report Bugs Effectively" by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Net::Radio::Location::SUPL::Test

You can also look for information at:

Where can I go for help with a concrete version?

Bugs and feature requests are accepted against the latest version only. To get patches for earlier versions, you need to get an agreement with a developer of your choice - who may or not report the issue and a suggested fix upstream (depends on the license you have chosen).

Business support and maintenance

For business support you can contact Jens via his CPAN email address rehsackATcpan.org. Please keep in mind that business support is neither available for free nor are you eligible to receive any support based on the license distributed with this package.

ACKNOWLEDGEMENTS

AUTHOR

Jens Rehsack, <rehsack at cpan.org>

LICENSE AND COPYRIGHT

Copyright 2012 Jens Rehsack.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

2 POD Errors

The following errors were encountered while parsing the POD:

Around line 55:

alternative text 'Net::DBus::Reactor/METHODS' contains non-escaped | or /

Around line 96:

alternative text 'Net::DBus::Reactor/METHODS' contains non-escaped | or /