NAME

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

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