יובל קוג'מן (Yuval Kogman) > Devel-Events-0.08 > Devel::Events::Generator::Require

Download:
Devel-Events-0.08.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  3
Open  0
View/Report Bugs
Source  

NAME ^

Devel::Events::Generator::Require - Event generator for loading of code using require.

SYNOPSIS ^

        use Devel::Events::Generator::Require;

        my $g = Devel::Events::Generator::Require->new( handler => $h );

        $g->enable();

        # all calls to require() will generate a try_require and a require_finished event

        $g->disable();

        # events disabled

DESCRIPTION ^

This generator allows instrumentation of module/file loading via require. This includes use statements.

EVENTS ^

try_require

Fired before require actually happens.

file

The file that require was given.

Note that when doing <require Foo::Bar>, the parameter passed into CORE::require is actually <Foo/Bar.pm>, and not the module name.

require_finished

Fired at the end of every require, successful and unsuccessful.

file

The file that require was given.

matched_file

The entry of file in %INC.

error

The load error, if any.

return_value

The value returend by the file. This is always a scalar.

METHODS ^

enable

Make this instance the enabled one (disabling any other instance which is enabled).

This only applies to the object_bless method.

disable

Disable this instance. Will stop generating object_bless events. =item try_require

Generates the try_require event.

require_finished

Generates the require_finished event.

syntax highlighting: