1Data::Dump::Color(3) User Contributed Perl Documentation Data::Dump::Color(3)
2
6 Data::Dump::Color - Like Data::Dump, but with color
7
9 This document describes version 0.249 of Data::Dump::Color (from Perl
10 distribution Data-Dump-Color), released on 2023-02-03.
11
13 Use it like you would Data::Dump, e.g.:
14 use Data::Dump::Color; dd localtime;
16
18 Sample screenshots:
19 This module aims to be a drop-in replacement for Data::Dump. It adds
21 colors to dumps. It also adds various visual aids in the comments, e.g.
22 array/hash index, depth indicator, and so on.
23 For more information, see Data::Dump. This documentation explains
25 what's different between this module and Data::Dump.
26
28 By default Data::Dump::Color shows array index or hash pair sequence in
29 comments for visual aid, e.g.:
30 [
32 "this", # [0]
33 "is", # [1]
34 "a", # [2]
35 "5-element", # [3]
36 "array", # [4]
37 {
38 0 => "with", # .{0}
39 1 => "an", # .{1}
40 2 => "extra", # .{2}
41 3 => "hash", # .{3}
42 4 => "at", # .{4}
43 5 => "the", # .{5}
44 16 => "end", # .{6}
45 }, # [5]
46 ]
47 "[]" and "{}" brackets will indicate whether they are indexes to an
49 array or a hash. The dot prefixes will mark depth level.
50 To turn this off, set $INDEX to 0:
52 [
54 "this",
55 "is",
56 "a",
57 "5-element",
58 "array",
59 {
60 0 => "with",
61 1 => "an",
62 2 => "extra",
63 3 => "hash",
64 4 => "at",
65 5 => "the",
66 16 => "end",
67 },
68 ]
69
71 "$Data::Dump::*" package variables from Data::Dump, like
72 $Data::Dump::TRY_BASE64, etc are now in the "Data::Dump::Color"
73 namespace, e.g. $Data::Dump::Color::TRY_BASE64, etc.
74 Additional variables include:
76 $COLOR => BOOL (default: undef)
78 Whether to force-enable or disable color. If unset, color output
79 will be determined from "NO_COLOR", "COLOR" environment variables,
80 or whether running in interactive terminal (when "-t STDOUT" is
81 true).
82 $COLOR_THEME => str
84 Select a color theme, which is a module under
85 "ColorTheme::Data::Dump::Color::" or "ColorTheme::" namespace
86 (with/without the namespace prefix). For example: "Default256",
87 "Bright".
88 $INDEX => BOOL (default: 1)
90 Whether to add array/hash index visual aid.
91 $LENTHRESHOLD => int (default: 500)
93 Add string length visual aid for hash key/hash value/array element
94 if length is at least this value.
95
97 Only "dd" and "ddx" are exported by default.
98 dd
100 ddx
101 dump
103 How do I turn off index comments?
104 Set $Data::Dump::Color::INDEX to 0.
105 How do I turn off colors?
107 Well, colors is sort of the point of this module. But if you want to
108 turn it off, you can set environment COLOR to 0, or
109 $Data::Dump::Color::COLOR to 0.
110 How do I customize colors?
112 Create a color theme and give it a name under
113 "ColorTheme::Data::Dump::Color::*". See an existing color theme for
114 example, e.g. ColorTheme::Data::Dump::Color::Default256.
115
117 DATA_DUMP_COLOR_THEME
118 Set color theme. Name will be searched under
119 "ColorTheme::Data::Dump::Color::*" or "ColorTheme::*".
120 NO_COLOR
122 Can be used to disable color. Takes precedence over the "COLOR"
123 environment. See <https://no-color.org> for more details.
124 COLOR
126 If set, then will force color output on or off. By default, will only
127 output color when in interactive terminal. This is consulted when
128 $COLOR is not set.
129
131 Please visit the project's homepage at
132 <https://metacpan.org/release/Data-Dump-Color>.
133
135 Source repository is at
136 <https://github.com/perlancar/perl-Data-Dump-Color>.
137
139 Data::Dump, JSON::Color, YAML::Tiny::Color
140
142 perlancar <perlancar@cpan.org>
143
145 • Scott Baker <bakerscot@cpan.org>
146 • Steven Haryanto <stevenharyanto@gmail.com>
148
150 To contribute, you can send patches by email/via RT, or send pull
151 requests on GitHub.
152 Most of the time, you don't need to build the distribution yourself.
154 You can simply modify the code, then test via:
155 % prove -l
157 If you want to build the distribution (e.g. to try to install it
159 locally on your system), you can install Dist::Zilla,
160 Dist::Zilla::PluginBundle::Author::PERLANCAR,
161 Pod::Weaver::PluginBundle::Author::PERLANCAR, and sometimes one or two
162 other Dist::Zilla- and/or Pod::Weaver plugins. Any additional steps
163 required beyond that are considered a bug and can be reported to me.
164
166 This software is copyright (c) 2023, 2021, 2018, 2014, 2013, 2012 by
167 perlancar <perlancar@cpan.org>.
168 This is free software; you can redistribute it and/or modify it under
170 the same terms as the Perl 5 programming language system itself.
171
173 Please report any bugs or feature requests on the bugtracker website
174 <https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Dump-Color>
175 When submitting a bug or request, please include a test-file or a patch
177 to an existing test-file that illustrates the bug or desired feature.
178perl v5.36.0 2023-02-05 Data::Dump::Color(3)