Marcel Grünauer > DB-Pluggable-1.101051 > DB::Pluggable::TypeAhead

Download:
DB-Pluggable-1.101051.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.101051   Source  

NAME ^

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

VERSION ^

version 1.101051

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.

syntax highlighting: