File: README

package info (click to toggle)
libdata-peek-perl 0.54-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 768 kB
  • sloc: perl: 785; makefile: 8
file content (64 lines) | stat: -rw-r--r-- 1,745 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
=head1 NAME

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

=head1 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.

=head1 PREREQUISITES

Perl 5.8.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, C<export NO_SV_PEEK=1> will make the
build and test pass (I hope)

=head1 INSTALLATION

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

Recent changes can be (re)viewed in the public GIT repository at
https://github.com/Tux/Data-Peek

Feel free to clone your own copy:

 $ git clone https://github.com/Tux/Data-Peek Data-Peek

or get it as a tgz:

 $ wget --output-document=Data-Peek-git.tgz \
        https://github.com/Tux/Data-Peek/archive/master.tar.gz

=head1 AUTHOR

H.Merijn Brand <hmbrand@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (c) 2008-2026 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.

=cut