DB::Pluggable
version 1.12
$ cat ~/.perldb use DB::Pluggable; DB::Pluggable->run_with_config(\<<EOINI) [BreakOnTestNumber] [TypeAhead] type = {l type = c ifenv = DBTYPEAHEAD [StackTraceAsHTML] [DataPrinter] EOINI Then: $ perl -d foo.pl
This class adds plugin support to the Perl debugger. It is based on Brickyard, so see its documentation for details.
You need to have a ~/.perldb file (see perldebug for details) that invokes the plugin mechanism.
~/.perldb
Plugins should live in the DB::Pluggable::Plugin:: namespace, like DB::Pluggable::Plugin::BreakOnTestNumber does.
DB::Pluggable::Plugin::
DB::Pluggable - Add plugin support for the Perl debugger
Convenience class method to create, initialize and run the plugin system with the given configuration file or scalar reference.
Like the method with the same name in Brickyard.
Tells the debugger to call DB::watchfunction(), which in turn calls the watchfunction() method of all plugins that consume the -WatchFunction role.
DB::watchfunction()
watchfunction()
-WatchFunction
This method just calls the initialize() method of all plugins that consume the -Initializer role.
initialize()
-Initializer
This class is very much in beta, so it's more like a proof of concept. Therefore, not all roles - which more or less correspond to plugin phases - imaginable have been added, only the ones to make this demo work. If you want more roles or if the current roles don't work for you, let me know.
The following roles exist:
See DB::Pluggable::Role::Initializer.
See DB::Pluggable::Role::WatchFunction.
-AfterInit
See DB::Pluggable::Role::AfterInit.
-Eval
See DB::Pluggable::Role::Eval. The debugger's eval() function is overridden so we can make it pluggable. Each plugin will get a chance to inspect the command line, which is the last line in $DB::evalarg and act on it. The plugin can return a code reference which will be executed after the original DB::eval() function has finished. Using the code reference you can undo any temporary changes you might have introduced to make your command work.
eval()
$DB::evalarg
DB::eval()
Marcel Gruenauer <marcel@cpan.org>
Currently maintained by Keith Carangelo <mail@kcaran.com>
The following copyright notice applies to all the files provided in this distribution, including binary files, unless explicitly noted otherwise.
This software is copyright (c) 2008-2011 by Marcel Gruenauer.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Keith Carangelo <mail@kcaran.com>
This software is copyright (c) 2008 by Marcel Gruenauer <marcel@cpan.org>.
To install DB::Pluggable, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DB::Pluggable
CPAN shell
perl -MCPAN -e shell install DB::Pluggable
For more information on module installation, please visit the detailed CPAN module installation guide.