NAME

CGI::Ex::Dump - A debug utility

SYNOPSIS

  use CGI::Ex::Dump; # auto imports dex, dex_warn, dex_text and others

  my $hash = {
    foo => ['a', 'b', 'Foo','a', 'b', 'Foo','a', 'b', 'Foo','a'],
  };

  dex $hash; # or dex_warn $hash;

  dex;

  dex "hi";

  dex $hash, "hi", $hash;

  dex \@INC; # print to STDOUT, or format for web if $ENV{REQUEST_METHOD}

  dex_warn \@INC;  # same as dex but to STDOUT

  print FOO dex_text \@INC; # same as dex but return dump

  # ALSO #

  use CGI::Ex::Dump qw(debug);
  
  debug; # same as dex

DESCRIPTION

Uses the base Data::Dumper of the distribution and gives it nicer formatting - and allows for calling just about anytime during execution.

Calling &CGI::Ex::set_deparse() will allow for dumped output of subroutines if available.

perl -e 'use CGI::Ex::Dump; dex "foo";'

See also Data::Dumper.

Setting any of the Data::Dumper globals will alter the output.

SUBROUTINES

dex, debug

Prints out pretty output to STDOUT. Formatted for the web if on the web.

dex_warn

Prints to STDERR.

dex_text

Return the text as a scalar.

ctrace

Caller trace returned as an arrayref. Suitable for use like "debug ctrace". This does require at least perl 5.8.0's Carp.

on, off

Turns calls to routines on or off. Default is to be on.

LICENSE

This module may distributed under the same terms as Perl itself.

AUTHORS

Paul Seamons <perl at seamons dot com>