Devel::Events::Generator::LineTrace(3)

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 <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
יובל קוג'מן (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.