NAME
    Safe::Caller - A nicer interface to caller() with code execution
    restriction

SYNOPSIS
     use Safe::Caller;

     $safe = Safe::Caller->new;

     package Foo;

     foo();

     sub foo { bar() }

     sub bar {
         print $safe->{sub}->();
         if ($safe->called_from_sub('Foo::foo')) { # do stuff }
     }

DESCRIPTION
CONSTRUCTOR
  new
     $safe = Safe::Caller->new(2);

    Supplying how many frames to go back while running "caller" in perlfunc
    is optional. By default (if no suitable value is supplied) 2 will be
    assumed. The default will be shared among all method calls (accessors &
    verification routines); the accessors may optionally accept a frame as
    parameter, whereas verification routines ("called_from_*()") don't.

METHODS
  Accessors
     $safe->{pkg}->();
     $safe->{file}->();
     $safe->{line}->();
     $safe->{sub}->();
     $safe->{hasargs}->();
     $safe->{wantarray}->();
     $safe->{evaltext}->();
     $safe->{is_require}->();
     $safe->{hints}->();
     $safe->{bitmask}->();

    See "caller" in perlfunc for the values they are supposed to return.

  called_from_pkg
    Checks whether the current sub was called within the appropriate
    package.

     $safe->called_from_pkg('main');

    Returns 1 on success, 0 on failure.

  called_from_file
    Checks whether the current sub was called by the appropriate file.

     $safe->called_from_file('foobar.pl');

    Returns 1 on success, 0 on failure.

  called_from_line
    Checks whether the current sub was called on the appropriate line.

     $safe->called_from_line(13);

    Returns 1 on success, 0 on failure.

  called_from_sub
    Checks whether the current sub was called by the appropriate subroutine.

     $safe->called_from_sub('foo');

    Returns 1 on success, 0 on failure.

SEE ALSO
    "caller" in perlfunc

AUTHOR
    Steven Schubiger <schubiger@cpan.org>

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

    See <http://www.perl.com/perl/misc/Artistic.html>