/ 
DB-Pluggable-1.100851
River stage one • 3 direct dependents • 3 total dependents
/ DB::Pluggable::TypeAhead

NAME

DB::Pluggable::TypeAhead - Debugger plugin to add type-ahead

VERSION

version 1.100851

SYNOPSIS

$ cat ~/.perldb

use DB::Pluggable;
use YAML;

$DB::PluginHandler = DB::Pluggable->new(config => Load <<EOYAML);
global:
  log:
    level: error

plugins:
  - module: TypeAhead
    config:
        type: 
            - '{l'
            - 'c'
    ifenv: DBTYPEAHEAD
EOYAML

$DB::PluginHandler->run;

DESCRIPTION

If you use the debugger a lot, you might find that you enter the same commands after starting the debugger. For example, suppose that you usually want to list the next window of lines before the debugger prompt - so you would enter {l - and that you usually have a breakpoint when running the debugger - so you would enter c. So you could use a plugin configuration as shown in the synopsis.

If you want to control whether this typeahead is applied, you can use the optional ifenv configuration key. If specified, its value is taken to be the name of an environment variable. When the plugin runs, the typeahead will only be applied if that environment variable has a true value.

So to continue the example from the synopsis, if you wanted to enable the typeahead, you would run your program like this:

DBTYPEAHEAD=1 perl -d ...

The inspiration for this plugin came from Ovid's blog post at http://blogs.perl.org/users/ovid/2010/02/easier-test-debugging.html.

METHODS

register

Registers the hooks.

afterinit

Hook handler for the db.afterinit hook.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=DB-Pluggable.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/DB-Pluggable/.

The development version lives at http://github.com/hanekomu/DB-Pluggable/. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHOR

Marcel Gruenauer <marcel@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2008 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.