X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FData%2FDumper%2FConcise.pm;h=0ec1961dea2829ab26fbb7af48a2c741f381a41a;hb=refs%2Ftags%2Fv2.012;hp=66ab409bf9919168c5f2ac356180a14d553e0cb4;hpb=739397239c2f69a006bfcaa8a6d418c611cd34b8;p=p5sagit%2FData-Dumper-Concise.git diff --git a/lib/Data/Dumper/Concise.pm b/lib/Data/Dumper/Concise.pm index 66ab409..0ec1961 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.000'; +$VERSION = '2.012'; 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" } }; @@ -78,8 +58,8 @@ Data::Dumper::Concise will give you: instead of the default Data::Dumper output: $VAR1 = { - 'quux' => sub { "DUMMY" }, - 'foo' => 'bar + 'quux' => sub { "DUMMY" }, + 'foo' => 'bar baz' }; @@ -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