1XXX(3)                User Contributed Perl Documentation               XXX(3)
2
3
4

NAME

6       XXX - See Your Data in the Nude
7

SYNOPSIS

9           use XXX;
10           XXX my $dog = Dog->new({has => ['fleas', 'style']});
11           my $dog = XXX Dog->new({has => ['fleas', 'style']});
12           my $dog = Dog->new(XXX {has => ['fleas', 'style']});
13           my $dog = Dog->new({XXX has => ['fleas', 'style']});
14           my $dog = Dog->new({has => XXX ['fleas', 'style']});
15           my $dog = Dog->new({has => [XXX 'fleas', 'style']});
16

DESCRIPTION

18       XXX.pm exports a function called XXX that you can put just about
19       anywhere
20           in your Perl code to make it die with a YAML dump of the arguments
21       to
22           its right.
23
24       The charm of XXX-debugging is that it is easy to type, rarely requires
25       parens and stands out visually so that you remember to remove it.
26
27       XXX.pm also exports WWW, YYY and ZZZ which do similar debugging things.
28

FUNCTIONS

30       WWW WWW will warn a dump of its arguments, and then return the original
31           arguments.  This means you can stick it in the middle of
32           expressions.
33
34           NOTE: If you use WWW with Test::More, it will "diag()" rather than
35           "warn()".
36
37           mnemonic: W for warn
38
39       XXX XXX will die with a dump of its arguments.
40
41           mnemonic: XXX == Death, Nudity
42
43       YYY YYY will print a dump of its arguments, and then return the
44           original arguments. This means you can stick it in the middle of
45           expressions.
46
47           NOTE: If you use YYY with Test::More, it will "note()" rather than
48                 "print()".
49
50           mnemonic: YYY == Why Why Why??? or YAML YAML YAML
51
52       ZZZ ZZZ will Carp::confess a dump of its arguments.
53
54           mnemonic: You should confess all your sins before you sleep.
55           zzzzzzzz
56

CONFIGURATION

58       By default, XXX uses YAML.pm to dump your data. You can change this
59       like so:
60
61           use XXX -with => 'Data::Dumper';
62           use XXX -with => 'Data::Dump';
63           use XXX -with => 'Data::Dump::Color';
64           use XXX -with => 'YAML::XS';
65           use XXX -with => 'YAML::SomeOtherYamlModule';
66           use XXX -with => 'JSON::Color';
67           use XXX -with => 'JSON::SomeOtherJsonModule';
68
69       Only modules with names beginning with 'YAML' or 'JSON', and the
70       Data::Dumper, Data::Dump, and Data::Dump::Color modules are supported.
71
72       If you need to load XXX with "require", you can set the dumper module
73       with the $XXX::DumpModule global variable.
74
75           require XXX;
76           $XXX::DumpModule = 'YAML::Syck';
77
78           XXX::XXX($variable);
79

STACK TRACE LEVEL

81       If you call a debugging function that calls XXX for you, XXX will print
82       the wrong file and line number. To force XXX to skip a package in the
83       call stack, just define the "XXX_skip" constant like this:
84
85           package MyDebugger;
86           use constant XXX_skip => 1;
87           sub debug {
88               require XXX;
89               XXX::XXX(@_);
90           }
91
92       Now calls to MyDebugger::debug will print the file name you called it
93       from, not from MyDebugger itself.
94

AUTHOR

96       Ingy döt Net <ingy@cpan.org>
97

99       Copyright 2006-2014. Ingy döt Net.
100
101       This program is free software; you can redistribute it and/or modify it
102       under the same terms as Perl itself.
103
104       See <http://www.perl.com/perl/misc/Artistic.html>
105
106
107
108perl v5.28.0                      2017-01-05                            XXX(3)
Impressum