NAME
Devel::Events::Generator::LineTrace - Generate executing_line events using the perl debugger api
VERSION
version 0.10
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.