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

NAME

Sub::Inspector - get infomation (prototype, attributes, name, etc) from a subroutine reference

SYNOPSIS

    use Sub::Inspector;
    use File::Spec;

    my $code = File::Spec->can('canonpath');

    print Sub::Inspector->file($code); #=> '/Users/Cside/perl5/ ...'
    print Sub::Inspector->line($code); #=> 71
    print Sub::Inspector->name($code); #=> 'canonpath'
    print Sub::Inspector->dump($code); #=> 'sub { my ($self, $path) = @_; ...'

    sub has_proto (&;@) {}
    sub has_attrs :method :lvalue {}

    print Sub::Inspector->proto(\&has_proto); #=> '&;@'
    print Sub::Inspector->attrs(\&has_attrs); #=> ('method', 'lvalue')


    # OO-Style

    my $inspector = Sub::Inspector->new($code);

    print $inspector->file; #=> '/Users/Cside/perl5/ ...'
    print $inspector->line; #=> 71
    print $inspector->name; #=> 'canonpath'

DESCRIPTION

This module enable to get metadata (prototype, attributes, method name, etc) from a coderef. We can get them by the buit-in module, B.pm. However, it is a bit difficult to memorize how to use it.

Functions

NOTE: You can call each method whether as instance method or as class method.

$inspector->file
$inspector->line
$inspector->name
$inspector->proto

alias: prototype

$inspector->attrs

alias: attributes

$inspector->dump

alias: as_string

SEE ALSO

B
B::Deparser

AUTHOR

Hiroki Honda (Cside) <cside.story [at] gmail.com>

LICENSE AND COPYRIGHT

Copyright (c) Hiroki Honda.

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