NAME

Data::Printer::Filter::Digest - pretty-printing MD5, SHA and many other digests

SYNOPSIS

In your ".dataprinter" file:

    filters = Digest

You may also setup the look and feel with the following options:

    filter_digest.show_class_name = 0
    filter_digest.show_reset      = 1

    # you can even customize your themes:
    colors.digest = #27ac3c

That's it!

DESCRIPTION

This is a filter plugin for Data::Printer. It filters through several message digest objects and displays their current value in hexadecimal format as a string.

Parsed Modules

Any module that inherits from Digest::base. The following ones are actively supported:

Digest::Adler32
Digest::MD2
Digest::MD4
Digest::MD5
Digest::SHA
Digest::SHA1
Digest::Whirlpool

If you have any suggestions for more modules or better output, please let us know.

Extra Options

Aside from the display color, there are a few other options to be customized via the "filter_digest" option key:

show_class_name

If set to true (the default) the class name will be displayed right next to the hexadecimal digest.

show_reset

If set to true (the default), the filter will add a "[reset]" tag after dumping an empty digest object. See the rationale below.

Note on dumping Digest::* objects

The digest operation is effectively a destructive, read-once operation. Once it has been performed, most Digest::* objects are automatically reset and can be used to calculate another digest value.

This behaviour - or, rather, forgetting about this behaviour - is a common source of issues when working with Digests.

This Data::Printer filter will not destroy your object. Instead, we work on a cloned version to display the hexdigest, leaving your original object untouched.