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 (or bug-Devel-Events@rt.cpan.org).

AUTHOR

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

COPYRIGHT AND LICENCE

This software is copyright (c) 2007 by יובל קוג'מן (Yuval Kogman).

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