NAME

DB::Pluggable::Dumper - Add 'xx' dumper to debugger

VERSION

Version 0.01

SYNOPSIS

In your $HOME/.perldb:

#!/usr/bin/env perl

use DB::Pluggable;
use YAML;

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

plugins:
  - module: Dumper
END

$DB::PluginHandler->run;

DESCRIPTION

This module adds the xx command to the debugger. It's like the x command, but outputs pretty Data::Dumper format. Here's the output of a data structure with 'x':

auto(-2)  DB<2> x $before
0  HASH(0x100e7e8f0)
   'aref' => ARRAY(0x1009000d8)
      0  1
      1  2
      2  4
   'guess' => CODE(0x100829568)
      -> &main::testit in run.pl:3-6
   'uno' => HASH(0x100803108)
      'this' => 'that'
      'what?' => HASH(0x100e3d508)
         'this' => 'them'

Here's the same data structure with 'xx':

auto(-1)  DB<3> xx $after
{
  aref => [
    1,
    2,
    4
  ],
  guess => sub {
      my $x = shift @_;
      return $x + 1;
  },
  uno => {
    this => "that",
    "what?" => {
      this => "them"
    }
  }
}

Which would you rather debug?

TODO

• Add support for Data::Dump::Streamer.

• Push the eval hack back into DB::Pluggable.

• Allow control over dumper configuration.

SEE ALSO

• DB::Pluggable

  Marcel Grünauer wrote this to add plugin support to the Perl debugger. Has DB::Pluggable::BreakOnTestNumber and DB::Pluggable::TypeAhead included.

• DB::Pluggable::StackTraceAsHTML

  Adds a 'Th' command to the debugger. Opens up a strack trace in your browswer, complete with lexicals.

NOTE

This code is an awful hack because the perl debugger (perl5db.pl) is an awful hack. My apologies.

AUTHOR

Curtis "Ovid" Poe, <ovid at cpan.org>

BUGS

Please report any bugs or feature requests to bug-db-pluggable-dumper at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DB-Pluggable-Dumper. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc DB::Pluggable::Dumper

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=DB-Pluggable-Dumper

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/DB-Pluggable-Dumper

• CPAN Ratings

  http://cpanratings.perl.org/d/DB-Pluggable-Dumper

• Search CPAN

  http://search.cpan.org/dist/DB-Pluggable-Dumper/

ACKNOWLEDGEMENTS

• Marcel Grünauer (for DB::Pluggable)

• Matt Trout (for Data::Dumper::Concise)

• Vienna.pm, for sponsoring the 2010 Perl QA Hackathon

COPYRIGHT & LICENSE

Copyright 2010 Curtis "Ovid" Poe, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm DB::Pluggable::Dumper

perl -MCPAN -e shell
install DB::Pluggable::Dumper