NAME

       autobox::dump - human/perl readable strings from the results of an EXPR

VERSION

       Version 20090426.1746

SYNOPSIS

       The autobox::dump pragma adds, via the autobox pragma, a method to normal expression (such
       as scalars, arrays, hashes, math, literals, etc.)  that produces a human/perl readable
       representation of the value of that expression.

           use autobox::dump;

           my $foo = "foo";
           print $foo->perl;   # "foo";

           print +(5*6)->perl; # 30;

           my @a = (1..3);

           print @a->perl;
           # [
           #  1,
           #  2,
           #  3
           # ];

           print {a=>1, b=>2}->perl;
           # {
           #  "a" => 1,
           #  "b" => 2
           # };

           sub func {
               my ($x, $y) = @_;
               return $x + $y;
           }

           my $func = \&func;
           print $func->perl;
           #sub {
           #    BEGIN {
           #        $^H{'autobox_scope'} = q(154456408);
           #        $^H{'autobox'} = q(HASH(0x93a3e00));
           #        $^H{'autobox_leave'} = q(Scope::Guard=ARRAY(0x9435078));
           #    }
           #    my($x, $y) = @_;
           #    return $x + $y;
           #}

           You can set Data::Dumper options by passing either arrayrefs of option
           and value pairs or just keys (in which case the option will be set to
           1).  The default options are C<qw/Indent Terse Useqq Sortkeys Deparse/>.

           print ["a", 0, 1]->perl([Indent => 3], [Varname => "a"], qw/Useqq/);
           #$a1 = [
           #        #0
           #        "a",
           #        #1
           #        0,
           #        #2
           #        1
           #      ];

           You can also call the class method ->options to set a different default.

           #set Indent to 0, but leave the rest of the options
           autobox::dump->options([Indent => 0], qw/Terse Useqq Sortkeys Deparse/);

           print ["a", 0, 1]->perl; #["a",0,1]

AUTHOR

       Chas. J Owens IV, "<chas.owens at gmail.com>"

BUGS

       Has all the issues autobox has.

       Has all the issues Data::Dumper has.

       This pragma errs on the side of human readable to the detriment of Perl readable.  In
       particular it uses the terse and deparse options of Data::Dumper by default.  These
       options may create code that cannot be eval'ed.  For best eval results, set options to
       "qw/Purity/".  Note, this turns off coderef dumping.

       Please report any bugs or feature requests to http://github.com/cowens/autobox-dump/issues

SUPPORT

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

           perldoc autobox::dump

ACKNOWLEDGEMENTS

       Michael Schwern for starting the perl5i pragma which prompted me to add a feature I wanted
       to autobox.

COPYRIGHT & LICENSE

       Copyright 2009 Chas. J Owens IV, all rights reserved.

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