View on
MetaCPAN
search.cpan.org is shutting down
For details read Perl NOC. After June 25th this page will redirect to MetaCPAN.org
Karen Etheridge > Devel-Events > Devel::Events::Generator::Require

Download:
Devel-Events-0.09.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  3
Open  1
View/Report Bugs
Module Version: 0.09   Source  

NAME ^

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

VERSION ^

version 0.09

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.

syntax highlighting: