NAME

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

VERSION

version 0.10

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.

SUPPORT

Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-Events> (or bug-Devel-Events@rt.cpan.org <mailto:bug-Devel-Events@rt.cpan.org>).

AUTHOR

יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENCE

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