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.

SUPPORT

Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-Events> (or bug-Devel-Events@rt.cpan.org <mailto:bug-Devel-Events@rt.cpan.org>).

AUTHOR

XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENCE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.