NAME

DD - Dump data structure for debugging

VERSION

This document describes version 0.002 of DD (from Perl distribution DD), released on 2019-08-01.

SYNOPSIS

In your code:

use DD; # exports dd() and dmp()
...
dd $data; # prints data to STDOUT
...
my $foo = dd $data; # prints data to STDOUT, also returns it so $foo gets assigned

On the command-line:

% perl -MDD -E'...; dd $data; ...'

DESCRIPTION

DD is a module with a short name you can use for debugging. It provides dd() which dumps data structure to STDOUT, as well as return the original data so you can insert dd in the middle of expressions.

DD can use several kinds of backends. The default is Data::Dump which is chosen because it's a mature module and produces visually nice dumps for debugging. You can also use these other backends:

  • Data::Dumper

  • Data::Dump::Color

    Optional dependency.

  • Data::Dmp

    Optional dependency.

PACKAGE VARIABLES

$BACKEND

The backend to use. The default is to use PERL_DD_BACKEND environment variable or "Data::Dump" as the fallback default.

FUNCTIONS

dd

dmp

ENVIRONMENT

PERL_DD_BACKEND

Can be used to set the default backend.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/DD.

SOURCE

Source repository is at https://github.com/perlancar/perl-DD.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=DD

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

XXX - basically the same thing but with a different name and defaults. I happen to use "XXX" to mark todo items in source code, so I prefer DD instead.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019, 2017 by perlancar@cpan.org.

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