GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DATA::DUMPER::CONCISE (3)

.ds Aq ’

NAME

Data::Dumper::Concise - Less indentation and newlines plus sub deparsing

CONTENTS

SYNOPSIS



  use Data::Dumper::Concise;

  warn Dumper($var);



is equivalent to:



  use Data::Dumper;
  {
    local $Data::Dumper::Terse = 1;
    local $Data::Dumper::Indent = 1;
    local $Data::Dumper::Useqq = 1;
    local $Data::Dumper::Deparse = 1;
    local $Data::Dumper::Quotekeys = 0;
    local $Data::Dumper::Sortkeys = 1;
    warn Dumper($var);
  }



So for the structure:



  { foo => "bar\nbaz", quux => sub { "fleem" } };



Data::Dumper::Concise will give you:



  {
    foo => "bar\nbaz",
    quux => sub {
        use warnings;
        use strict refs;
        fleem;
    }
  }



instead of the default Data::Dumper output:



  $VAR1 = {
   quux => sub { "DUMMY" },
   foo => bar
  baz
  };



(note the tab indentation, oh joy ...)

If you need to get the underlying Dumper object just call DumperObject.

Also try out DumperF which takes a CodeRef as the first argument to format the output. For example:



  use Data::Dumper::Concise;

  warn DumperF { "result: $_[0] result2: $_[1]" } $foo, $bar;



Which is the same as:



  warn result:  . Dumper($foo) .  result2:  . Dumper($bar);



DESCRIPTION

This module always exports a single function, Dumper, which can be called 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, primarily for debugging output.

The principle guiding theme is all the concision you can get while still having a useful dump and not doing anything cleverer than setting Data::Dumper options - it’s been pointed out to us that Data::Dump::Streamer can produce shorter output with less lines of code. We know. This is simpler and we’ve never seen it segfault. But for complex/weird structures, it generally rocks. You should use it as well, when Concise is underkill. We do.

Why is deparsing on when the aim is concision? Because you often want to know what subroutine refs you have when debugging and because if you were planning to eval this back in you probably wanted to remove subrefs first and add them back in a custom way anyway. Note that this -does- force using the pure perl Dumper rather than the XS one, but I’ve never in my life seen Data::Dumper show up in a profile so who cares?.

BUT BUT BUT ...

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.

SUGARY SYNTAX

This package also provides:

Data::Dumper::Concise::Sugar - provides Dwarn and DwarnS convenience functions

Devel::Dwarn - shorter form for Data::Dumper::Concise::Sugar

SEE ALSO

We use for some purposes, and dearly love, the following alternatives:

Data::Dump - prettiness oriented but not amazingly configurable

Data::Dump::Streamer - brilliant. beautiful. insane. extensive. excessive. try it.

JSON::XS - no, really. If it’s just plain data, JSON is a great option.

AUTHOR

mst - Matt S. Trout <mst@shadowcat.co.uk>

CONTRIBUTORS

frew - Arthur Axel fREW Schmidt <frioux@gmail.com>

COPYRIGHT

Copyright (c) 2010 the Data::Dumper::Concise AUTHOR and CONTRIBUTORS as listed above.

LICENSE

This library is free software and may be distributed under the same terms as perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DATA::DUMPER::CONCISE (3) 2014-03-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.