SNMP::Info::MRO(3p)

NAME
SNMP::Info::MRO - Method resolution introspection for SNMP::Info

SYNOPSIS
 use SNMP::Info::MRO;
 use Data::Printer;

 # SNMP::Info::MRO::print_* functions
 SNMP::Info::MRO::print_superclasses ('SNMP::Info::Layer3::Juniper');

 # print output using Data::Printer for other functions
 my $buff = SNMP::Info::MRO::all_methods('SNMP::Info::Layer3::Juniper');
 p $buff;

DESCRIPTION
This is a set of helpers to show where a given method in SNMP::Info has been implemented, and which implementation is being used at runtime.

The following distributions are required to run this code:

•   PPI

•   Class::ISA

•   Module::Info

•   Module::Load

FUNCTIONS
None of the functions are exported. For all helper functions, you can pass either the name of a Perl module, or an object instance of SNMP::Info.

all_methods( $module )
    Returns the location of methods defined in $module and all its ancestor classes (superclasses), either as Perl subroutines or via %GLOBALS or %FUNCS configuration. The data structure looks like:

     {
       method_name => {
         globals => [
           [ Package::Name        => 'mib_leaf.0' ],
           [ Other::Package::Name => '1.3.6.1.4.1.9.2.1.58.0' ],
         ],
       },
       other_method_name => [
         subs => [
           'Package::Name',
         ],
         funcs => [
           [ Package::Name => 'mib_leaf_name' ],
         ],
       ],
     }

    It should be noted that the order of method resolution in SNMP::Info is to first look for a defined subroutine (this is done by Perl), then the AUTOLOAD sequence will search for a definition in %GLOBALS followed by %FUNCS.

    The defining class or module at runtime is always the first entry in the list, if it exists:

     $data->{method_name}->{subs}->[0]
       if exists $data->{method_name}->{subs};

subroutines( $module )
    Returns the set of subroutines defined in $module and all its ancestor classes (superclasses). The data structure looks like:

     {
       method_name => [
         'Package::Name',
         'Other::Package::Name',
       ],
       other_method_name => [
         'Package::Name',
       ],
     }

    Should a subroutine have been defined more than once, the defining classes are listed in reverse order, such that the definition used at runtime is always:

     $data->{method_name}->[0];

globals( $module || $object )
    Returns a data structure showing how SNMP::Info will resolve MIB Leaf Nodes configured through the %GLOBALS hashes in $module.

    The data structure looks like:

     {
       method_name => [
         [ Package::Name        => 'mib_leaf_name' ],
         [ Other::Package::Name => '1.3.6.1.4.1.9.2.1.58.0' ],
       ],
       other_method_name => [
         [ Package::Name => 'mib_leaf.0' ],
       ],
     }

    Where a method has been defined in different packages, then they are listed in reverse order, such that the mapping used by SNMP::Info is always:

     $data->{method_name}->[0];

funcs( $module || $object )
    Returns a data structure showing how SNMP::Info will resolve MIB Tables configured through the %FUNCS hashes in $module.

    See "GLOBALS" in SNMP::Info::Layer3 for further detail.

munge( $module || $object )
    Returns a data structure showing the subroutines used for munging returned values for any method defined in %FUNCS or %GLOBALS.

    The data structure looks like:

     {
       method_name => [
         [ Package::Name        => '&subroutine' ],
         [ Other::Package::Name => '&Other::Package::subroutine' ],
       ],
       other_method_name => [
         [ Package::Name => '&subroutine' ],
       ],
     }

    Where a mapping has been defined in different packages, then they are listed in reverse order, such that the munge subroutine used by SNMP::Info is always:

     $data->{method_name}->[0];

file( $module )
    Returns the filename from which Perl will load the given module.

superclasses( $class || $object )
    Returns the list (in order) of the names of classes Perl will search to find methods for this SNMP::Info class or object instance.

    Note this requires the Class::ISA distribution to be installed.

print_globals( $module || $object )
    Pretty print the output of globals().

print_funcs( $module || $object )
    Pretty print the output of funcs().

print_munge( $module || $object )
    Pretty print the output of munge().

print_superclasses( $class || $object )
    Pretty print the output of superclasses().

AUTHOR
Oliver Gorwits <oliver@cpan.org>

COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by The SNMP::Info Project.

 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are met:
 #
 #    * Redistributions of source code must retain the above copyright notice,
 #      this list of conditions and the following disclaimer.
 #    * Redistributions in binary form must reproduce the above copyright
 #      notice, this list of conditions and the following disclaimer in the
 #      documentation and/or other materials provided with the distribution.
 #    * Neither the name of the University of California, Santa Cruz nor the
 #      names of its contributors may be used to endorse or promote products
 #      derived from this software without specific prior written permission.
 #
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
 # LIABLE FOR # ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 # POSSIBILITY OF SUCH DAMAGE.