NAME Data::Dump::Partial - Dump data structure compactly and potentially partially VERSION version 0.02 SYNOPSIS use Data::Dump::Partial qw(dump_partial dumpp); dump_partial([1, "some long string", 3, 4, 5, 6, 7]); # prints something like: [1, "some long st...", 3, 4, 5, ...] # specify options dump_partial($data, $more_data, {max_total_len => 50, max_keys => 4}); DESCRIPTION FUNCTIONS dump_partial(..., $opts) Dump one more data structures compactly and potentially partially. Uses Data::Dump::Filtered as the backend. By compactly, it means all indents and comments and newlines are removed, so the output all fits in one line. By partially, it means only a certain number of scalar length, array elements, hash keys are showed. $opts is a hashref, optional only when there is one data to dump, with the following known keys: * max_total_len => NUM Total length of output before it gets truncated with an ellipsis. Default is 80. * max_len => NUM Maximum length of a scalar (string, etc) to show before the rest get truncated with an ellipsis. Default is 32. * max_keys => NUM Number of key pairs of a hash to show before the rest get truncated with an ellipsis. Default is 5. * max_elems => NUM Number of elements of an array to show before the rest get truncated with an ellipsis. Default is 5. * precious_keys => [KEY, ...] Never truncate these keys (even if it results in max_keys limit being exceeded). * worthless_keys => [KEY, ...] When needing to truncate hash keys, search for these first. * hide_keys => [KEY, ...] Always truncate these hash keys, no matter what. This is actually also implemented by Data::Dump::Filtered. * dd_filter => \&sub If you have other Data::Dump::Filtered filter you want to execute, you can pass it here. dumpp An alias for dump_filtered(). FAQ What is the point/purpose of this module? Sometimes you want to dump a data structure, but need it to be short, more than need it to be complete, for example when logging to log files or database. Is the dump result eval()-able? Will the dump result eval() to produce the original data? Sometimes it is/will, sometimes it does/will not if it gets truncated. SEE ALSO Data::Dump::Filtered AUTHOR Steven Haryanto COPYRIGHT AND LICENSE This software is copyright (c) 2010 by Steven Haryanto. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.