View on
MetaCPAN
Karen Etheridge > Devel-Events > Devel::Events::Generator::LineTrace

Download:
Devel-Events-0.09.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

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

NAME ^

Devel::Events::Generator::LineTrace - Generate executing_line events using the perl debugger api

VERSION ^

version 0.09

SYNOPSIS ^

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

        $g->enable();

        # every line of code will fire an event until

        $g->disable();

DESCRIPTION ^

This Devel::Events generator will fire line tracing events using DB::DB, a perl debugger hook.

Only one instance may be enabled at a given time. Use Devel::Events::Handler::Multiplex to deliver events to multiple handlers.

EVENTS ^

executing_line

When the generator is enabled, this event will fire for every line of code just before it is executed.

Lines in a package starting with Devel::Events:: will not be reported.

package

The package the line is in.

file

The file of the line being executed.

line

The line number of the line being executed.

METHODS ^

enable

Enable this generator instance, disabling any other instance of Devel::Events::Generator::LineTrace.

disable

Stop firing events.

line

Called by DB::DB. Used to generate the event.

CAVEATS ^

Apparently this must be run under perl -d. This is very strange, since Devel::Events::Generator::SubTrace doesn't need the -d flag set.

The Enbugger module can help overcome this limitation.

SEE ALSO ^

perldebguts, Devel::LineTrace, DB, Devel::ebug, perl5db.pl

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: