Devel-ModuleBreaker
-------------------

Extensions to the Perl debugger that make it easy
to set breakpoints over all subroutines in a
namespace, in a source file, or in the collection
of all known subs simultaneously.

The distribution contains three mutually incompatible
packages,  Devel::ModuleBreaker, Devel::FileBreaker,
and Devel::SubBreaker. To use these modules,
invoke perl with the appropraite -d:xxxBreaker argument.

Devel::ModuleBreaker  puts a breakpoint at the start
of every subroutine in one or more specified namespaces

    $ perl -d:ModuleBreaker=module1,module2 script_to_debug.pl

Devel::FileBreaker  puts a breakpoint at the start of
every subroutine in source files that match any of the
given regular expressions

    $ perl -d:FileBreaker=file1,file2 script_to_debug.pl

Devel::SubBreaker  puts a breakpoint at the start of
every subroutine whose fully qualified subroutine name
matches any of the given regular expressions

    $ perl -d:SubBreaker=pattern1,pattern2 script_to_debug.pl

After setting its breakpoints, each of these packages
then turns over control to the regular perl debugger.


This distribution was inspired by a questions on StackOverflow:
    https://stackoverflow.com/questions/48229672


INSTALLATION

To install this module, follow the usual recipe:

        perl Makefile.PL
        make
        make test
        make install

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this distribution
with the `perldoc` command.

    perldoc Devel::ModuleBreaker

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Devel-ModuleBreaker

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Devel-ModuleBreaker

    CPAN Ratings
        http://cpanratings.perl.org/d/Devel-ModuleBreaker

    Search CPAN
        http://search.cpan.org/dist/Devel-ModuleBreaker/


LICENSE AND COPYRIGHT

Copyright (C) 2018 Marty O'Brien

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.