NAME

       Data::Printer::Filter::Digest - pretty-printing MD5, SHA and friends

SYNOPSIS

       In your program:

         use Data::Printer filters => {
           -external => [ 'Digest' ],
         };

       or, in your ".dataprinter" file:

         {
           filters => {
              -external => [ 'Digest' ],
           },
         };

       You can also setup color and display details:

         use Data::Printer
             filters => {
                 -external => [ 'Digest' ],
             },
             color   => {
                 digest => 'bright_green',
             }
             digest => {
                 show_class_name => 0,  # default.
                 show_reset      => 1,  # default.
             },
         };

DESCRIPTION

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

   Parsed Modules
       •   Digest::Adler32

       •   Digest::MD2

       •   Digest::MD4

       •   Digest::MD5

       •   Digest::SHA

       •   Digest::SHA1

       •   Digest::Whirlpool

       •   Digest::Haval256

       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
       "digest" option key:

       show_class_name

       Set this to true to display the class name right next to the hexadecimal digest. Default
       is 0 (false).

       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.

       As another debugging convenience for developers, since the empty object will produce a
       digest even after being used, this filter adds by default a "[reset]" tag to indicate that
       the object is empty, in a 'reset' state - i.e. its hexdigest is the same as the hexdigest
       of a new, empty object of that same class.

SEE ALSO

       Data::Printer