File Coverage

blib/lib/Net/Radio/oFono/Manager.pm

Criterion	Covered	Total	%
statement	10	12	83.3
branch			n/a
condition			n/a
subroutine	4	4	100.0
pod			n/a
total	14	16	87.5

package Net::Radio::oFono::Manager;

use 5.010;
use strict;
use warnings;

=head1 NAME

Net::Radio::oFono::Manager - access to oFono's Manager objects

=cut

our $VERSION = '0.001';

use Net::Radio::oFono::Roles::Manager qw(Modem);    # injects GetModem(s) etc.
use base
  qw(Net::Radio::oFono::Helpers::EventMgr Net::Radio::oFono::Roles::RemoteObj Net::Radio::oFono::Roles::Manager);

use Net::DBus qw(:typing);

=head1 SYNOPSIS

Provides access to oFono's Modem Manager object (org.ofono.Manager interface).

  use Net::Radio::oFono::Manager;
  ...
  my $manager = Net::Radio::oFono::Manager->new(
    ON_MODEM_ADDED   => \&on_modem_added,
    ON_MODEM_REMOVED => \&on_modem_removed,
  );

Usually L does all of it for you, including modem
management and interface instantiation.

=head1 INHERITANCE

  Net::Radio::oFono::Manager
  ISA Net::Radio::oFono::Helpers::EventMgr
  DOES Net::Radio::oFono::Roles::RemoteObj
  DOES Net::Radio::oFono::Roles::Manager

=head1 METHODS

=head2 new(;%events)

Instantiates new modem manager.

=cut

sub new
{
    my ( $class, %events ) = @_;

    my $self = $class->SUPER::new(%events);

    bless( $self, $class );

    $self->_init();

    return $self;
}

=head2 init()

Initialized RemoteObj and Manager roles.

=cut

sub _init
{
    my $self = $_[0];

    # initialize roles
    $self->Net::Radio::oFono::Roles::RemoteObj::_init( "/", "org.ofono.Manager" );
    $self->Net::Radio::oFono::Roles::Manager::_init();

    return;
}

sub DESTROY
{
    my $self = $_[0];

    # destroy roles
    $self->Net::Radio::oFono::Roles::Manager::DESTROY();
    $self->Net::Radio::oFono::Roles::RemoteObj::DESTROY();

    # destroy base class
    $self->Net::Radio::oFono::Helpers::EventMgr::DESTROY();

    return;
}

=head2 GetModems(;$force)

Alias for L.

=head2 GetModem($object_path;$force)

Alias for L.

=cut

=head1 BUGS

Please report any bugs or feature requests to C, or through
the web interface at L.  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:
L.

=head1 SUPPORT

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

    perldoc Net::Radio::oFono

You can also look for information at:

=over 4

=item * RT: CPAN's request tracker (report bugs here)

L

If you think you've found a bug then please read "How to Report Bugs
Effectively" by Simon Tatham:
L.

=item * AnnoCPAN: Annotated CPAN documentation

L

=item * CPAN Ratings

L

=item * Search CPAN

L

=back

=head2 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).

=head2 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.

=head1 ACKNOWLEDGEMENTS

At first the guys from the oFono-Team shall be named: Marcel Holtmann and
Denis Kenzior, the maintainers and all the people named in ofono/AUTHORS.
Without their effort, there would no need for a Net::Radio::oFono module.

Further, Peter "ribasushi" Rabbitson helped a lot by providing hints
and support how to make this API accessor a valuable CPAN module.

=head1 AUTHOR

Jens Rehsack, C<<  >>

=head1 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.


=cut

1;