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.