NAME

Devel::FileBreaker - set breakpoints in all subroutines in one or more files

VERSION

0.03

SYNOPSIS

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

DESCRPITION

Devel::FileBreaker seeks to simplify the process of settings breakpoints in a collection of subroutines in a Perl source file or set of files.

This module was inspired by a StackOverflow question.

USAGE

To use this module, pass this command-line argument to perl

-d:FileBreaker=pattern[,pattern2[,...]]

where pattern, pattern2, etc. are any valid perl regular expressions. In the CHECK phase of the program, a breakpoint will be set at the start of any subroutine defined in a file name (given by the values of %DB::sub) that matches one of the given regular expressions. This includes any anonymous subroutines defined in the files that are known at compile time.

EXAMPLES

• Set a breakpoint in all subs in the module Floop::Blert and all Floop::Blert submodules:

  perl -d:FileBreaker=Floop/Blert ...

• Set a breakpoint in all subs just in module Floop::Blert:

  perl -d:FileBreaker=Floop/Blert.pm ...

• Set a breakpoint in every known subroutine:

  perl -d:FileBreaker=^ ...

• Set a breakpoint in all subroutines from one of your subdirectories

  perl -d:FileBreaker=$HOME/site_perl/mylib ...

SUPPORT

This module is part of the Devel::ModuleBreaker distribution. See Devel::ModuleBreaker for support information about this module.

SEE ALSO

Devel::ModuleBreaker, Devel::SubBreaker

AUTHOR

Marty O'Brien, <mob at cpan.org>

LICENSE AND COPYRIGHT

Copyright 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.

See http://dev.perl.org/licenses/ for more information.