NAME

Data::Peek - A collection of low-level debug functions

Description

Modified and extended wrapper functions to make debugging more pleasurable.

DDumper () is a wrapper around Data::Dumper with always sorted keys. The output is however reflowed and not parsable anymore (in most cases) as the quotation around the keys is removed.

DDump () is a wrapper around perl's core function sv_dump (), which should enable you to use the output instead of the default behavior that only prints to STDERR.

DPeek () is a wrapper around internals Perl_sv_peek

DDump_IO () is a wrapper around perl's core function do_sv_dump (), which acts like sv_dump (), but to a PerlIO stream, which is only available in perl 5.8 and higher.

PREREQUISITES

Perl 5.6.0 and up. Some versions of perl on some operating system(s) might not have exported the internals (yet). This module won't build then.

If you run a perl that did not export Perl_sv_peek (), DPeek will not be available. If you happen to encounter that problem, most likely on Windows or AIX, export NO_SV_PEEK=1 will make the build and test pass (I hope)

INSTALLATION

$ perl Makefile.PL
$ make
$ make test
$ make install

Recent changes can be (re)viewed in the public GIT repository at http://repo.or.cz/w/Data-Peek.git

Feel free to clone your own copy:

$ git clone http://repo.or.cz/r/Data-Peek.git Data-Peek

or get it as a tgz:

 $ wget --output-document=Data-Peek-git.tgz \
	   'http://repo.or.cz/w/Data-Peek.git?a=snapshot;sf=tgz'

AUTHOR

H.Merijn Brand <h.m.brand@xs4all.nl>

COPYRIGHT AND LICENSE

Copyright (c) 2008-2010 H.Merijn Brand. All rights reserved.

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