X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FData%2FDumper%2FConcise.pm;h=cecc57cd51c8550cb5b3958b8477101f47c5d29a;hb=0c34910f8af24932e33d5b7d3b25080d9d13f8d0;hp=7c603959cf9941d96beb56752438fe7860e40ca5;hpb=3d4be272352a0ce54b8f9bbe159cfc29bc4ab779;p=p5sagit%2FData-Dumper-Concise.git diff --git a/lib/Data/Dumper/Concise.pm b/lib/Data/Dumper/Concise.pm index 7c60395..cecc57c 100644 --- a/lib/Data/Dumper/Concise.pm +++ b/lib/Data/Dumper/Concise.pm @@ -2,7 +2,7 @@ package Data::Dumper::Concise; use 5.006; -$VERSION = '1.001'; +$VERSION = '2.000'; require Exporter; require Data::Dumper; @@ -11,16 +11,10 @@ BEGIN { @ISA = qw(Exporter) } @EXPORT = qw(Dumper); -my $USAGE = 'Dumper() to get an object or Dumper($ref) to dump a reference please'; - sub Dumper { - die $USAGE if @_ > 1; my $dd = Data::Dumper->new([]); $dd->Terse(1)->Indent(1)->Useqq(1)->Deparse(1)->Quotekeys(0)->Sortkeys(1); - return $dd unless @_; - my $ref = $_[0]; - die $USAGE unless ref($ref); - return $dd->Values([ $ref ])->Dump; + return $dd->Values([ @_ ])->Dump; } =head1 NAME @@ -46,20 +40,6 @@ is equivalent to: warn Dumper($var); } -whereas - - my $dd = Dumper; - -is equivalent to: - - my $dd = Data::Dumper->new([]) - ->Terse(1) - ->Indent(1) - ->Useqq(1) - ->Deparse(1) - ->Quotekeys(0) - ->Sortkeys(1); - So for the structure: { foo => "bar\nbaz", quux => sub { "fleem" } }; @@ -88,8 +68,7 @@ instead of the default Data::Dumper output: =head1 DESCRIPTION This module always exports a single function, Dumper, which can be called -with a single reference value to dump that value or with no arguments to -return the Data::Dumper object it's created. +with an array of values to dump those values. It exists, fundamentally, as a convenient way to reproduce a set of Dumper options that we've found ourselves using across large numbers of applications, @@ -115,6 +94,14 @@ Yes, we know. Consider this module in the ::Tiny spirit and feel free to write a Data::Dumper::Concise::ButWithExtraTwiddlyBits if it makes you happy. Then tell us so we can add it to the see also section. +=head1 SUGARY SYNTAX + +This package also provides: + +L - provides Dwarn and DwarnS convenience functions + +L - shorter form for Data::Dumper::Concise::Sugar + =head1 SEE ALSO We use for some purposes, and dearly love, the following alternatives: @@ -127,15 +114,15 @@ L - no, really. If it's just plain data, JSON is a great option. =head1 AUTHOR -Matt S. Trout +mst - Matt S. Trout =head1 CONTRIBUTORS -None required yet. Maybe this module is perfect (hahahahaha ...). +frew - Arthur Axel "fREW" Schmidt =head1 COPYRIGHT -Copyright (c) 2009 the Data::Dumper::Concise L and L +Copyright (c) 2010 the Data::Dumper::Concise L and L as listed above. =head1 LICENSE