autobox::dump(3pm) [debian man page]

autobox::dump(3pm)					User Contributed Perl Documentation					autobox::dump(3pm)

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.

perl v5.10.1							    2009-04-26							autobox::dump(3pm)

Moose::Autobox(3)					User Contributed Perl Documentation					 Moose::Autobox(3)

NAME

       Moose::Autobox - Autoboxed wrappers for Native Perl datatypes

SYNOPOSIS

	 use Moose::Autobox;

	 print 'Print squares from 1 to 10 : ';
	 print [ 1 .. 10 ]->map(sub { $_ * $_ })->join(', ');

DESCRIPTION

       Moose::Autobox provides an implementation of SCALAR, ARRAY, HASH & CODE for use with autobox. It does this using a hierarchy of roles in a
       manner similar to what Perl 6 might do. This module, like Class::MOP and Moose, was inspired by my work on the Perl 6 Object Space, and the
       'core types' implemented there.

   A quick word about autobox
       The autobox module provides the ability for calling 'methods' on normal Perl values like Scalars, Arrays, Hashes and Code references. This
       gives the illusion that Perl's types are first-class objects. However, this is only an illusion, albeit a very nice one.  I created this
       module because autobox itself does not actually provide an implementation for the Perl types but instead only provides the 'hooks' for
       others to add implementation too.

   Is this for real? or just play?
       Several people are using this module in serious applications and it seems to be quite stable. The underlying technologies of autobox and
       Moose::Role are also considered stable. There is some performance hit, but as I am fond of saying, nothing in life is free.  Note that this
       hit only applies to the use of methods on native Perl values, not the mere act of loading this module in your namespace.

       If you have any questions regarding this module, either email me, or stop by #moose on irc.perl.org and ask around.

   Adding additional methods
       Moose::Autobox asks autobox to use the Moose::Autobox::* namespace prefix so as to avoid stepping on the toes of other autobox modules.
       This means that if you want to add methods to a particular perl type (i.e. - monkeypatch), then you must do this:

	 sub Moose::Autobox::SCALAR::bar { 42 }

       instead of this:

	 sub SCALAR::bar { 42 }

       as you would with vanilla autobox.

METHODS

       mixin_additional_role ($type, $role)
	   This will mixin an additional $role into a certain $type. The types can be SCALAR, ARRAY, HASH or CODE.

	   This can be used to add additional methods to the types, see the examples/units/ directory for some examples.

TODO

       More docs
       More tests

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to
       cpan-RT.

AUTHOR

       Stevan Little <stevan@iinteractive.com>

       with contributions from:

       Anders (Debolaz) Nor Berle

       Matt (mst) Trout

       renormalist

COPYRIGHT AND LICENSE

       Copyright 2006-2008 by Infinity Interactive, Inc.

       <http://www.iinteractive.com>

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

perl v5.18.2							    2013-10-27							 Moose::Autobox(3)