Initial Commit

database/perl/vendor/lib/Crypt/Digest/BLAKE2b_256.pm

@@ -0,0 +1,225 @@
+package Crypt::Digest::BLAKE2b_256;
+
+### BEWARE - GENERATED FILE, DO NOT EDIT MANUALLY!
+
+use strict;
+use warnings;
+our $VERSION = '0.069';
+
+use base qw(Crypt::Digest Exporter);
+our %EXPORT_TAGS = ( all => [qw( blake2b_256 blake2b_256_hex blake2b_256_b64 blake2b_256_b64u blake2b_256_file blake2b_256_file_hex blake2b_256_file_b64 blake2b_256_file_b64u )] );
+our @EXPORT_OK = ( @{ $EXPORT_TAGS{'all'} } );
+our @EXPORT = qw();
+
+use Carp;
+$Carp::Internal{(__PACKAGE__)}++;
+use Crypt::Digest;
+
+sub hashsize                { Crypt::Digest::hashsize('BLAKE2b_256')             }
+sub blake2b_256             { Crypt::Digest::digest_data('BLAKE2b_256', @_)      }
+sub blake2b_256_hex         { Crypt::Digest::digest_data_hex('BLAKE2b_256', @_)  }
+sub blake2b_256_b64         { Crypt::Digest::digest_data_b64('BLAKE2b_256', @_)  }
+sub blake2b_256_b64u        { Crypt::Digest::digest_data_b64u('BLAKE2b_256', @_) }
+sub blake2b_256_file        { Crypt::Digest::digest_file('BLAKE2b_256', @_)      }
+sub blake2b_256_file_hex    { Crypt::Digest::digest_file_hex('BLAKE2b_256', @_)  }
+sub blake2b_256_file_b64    { Crypt::Digest::digest_file_b64('BLAKE2b_256', @_)  }
+sub blake2b_256_file_b64u   { Crypt::Digest::digest_file_b64u('BLAKE2b_256', @_) }
+
+1;
+
+=pod
+
+=head1 NAME
+
+Crypt::Digest::BLAKE2b_256 - Hash function BLAKE2b [size: 256 bits]
+
+=head1 SYNOPSIS
+
+   ### Functional interface:
+   use Crypt::Digest::BLAKE2b_256 qw( blake2b_256 blake2b_256_hex blake2b_256_b64 blake2b_256_b64u
+                                blake2b_256_file blake2b_256_file_hex blake2b_256_file_b64 blake2b_256_file_b64u );
+
+   # calculate digest from string/buffer
+   $blake2b_256_raw  = blake2b_256('data string');
+   $blake2b_256_hex  = blake2b_256_hex('data string');
+   $blake2b_256_b64  = blake2b_256_b64('data string');
+   $blake2b_256_b64u = blake2b_256_b64u('data string');
+   # calculate digest from file
+   $blake2b_256_raw  = blake2b_256_file('filename.dat');
+   $blake2b_256_hex  = blake2b_256_file_hex('filename.dat');
+   $blake2b_256_b64  = blake2b_256_file_b64('filename.dat');
+   $blake2b_256_b64u = blake2b_256_file_b64u('filename.dat');
+   # calculate digest from filehandle
+   $blake2b_256_raw  = blake2b_256_file(*FILEHANDLE);
+   $blake2b_256_hex  = blake2b_256_file_hex(*FILEHANDLE);
+   $blake2b_256_b64  = blake2b_256_file_b64(*FILEHANDLE);
+   $blake2b_256_b64u = blake2b_256_file_b64u(*FILEHANDLE);
+
+   ### OO interface:
+   use Crypt::Digest::BLAKE2b_256;
+
+   $d = Crypt::Digest::BLAKE2b_256->new;
+   $d->add('any data');
+   $d->addfile('filename.dat');
+   $d->addfile(*FILEHANDLE);
+   $result_raw  = $d->digest;     # raw bytes
+   $result_hex  = $d->hexdigest;  # hexadecimal form
+   $result_b64  = $d->b64digest;  # Base64 form
+   $result_b64u = $d->b64udigest; # Base64 URL Safe form
+
+=head1 DESCRIPTION
+
+Provides an interface to the BLAKE2b_256 digest algorithm.
+
+=head1 EXPORT
+
+Nothing is exported by default.
+
+You can export selected functions:
+
+  use Crypt::Digest::BLAKE2b_256 qw(blake2b_256 blake2b_256_hex blake2b_256_b64 blake2b_256_b64u
+                                      blake2b_256_file blake2b_256_file_hex blake2b_256_file_b64 blake2b_256_file_b64u);
+
+Or all of them at once:
+
+  use Crypt::Digest::BLAKE2b_256 ':all';
+
+=head1 FUNCTIONS
+
+=head2 blake2b_256
+
+Logically joins all arguments into a single string, and returns its BLAKE2b_256 digest encoded as a binary string.
+
+ $blake2b_256_raw = blake2b_256('data string');
+ #or
+ $blake2b_256_raw = blake2b_256('any data', 'more data', 'even more data');
+
+=head2 blake2b_256_hex
+
+Logically joins all arguments into a single string, and returns its BLAKE2b_256 digest encoded as a hexadecimal string.
+
+ $blake2b_256_hex = blake2b_256_hex('data string');
+ #or
+ $blake2b_256_hex = blake2b_256_hex('any data', 'more data', 'even more data');
+
+=head2 blake2b_256_b64
+
+Logically joins all arguments into a single string, and returns its BLAKE2b_256 digest encoded as a Base64 string, B<with> trailing '=' padding.
+
+ $blake2b_256_b64 = blake2b_256_b64('data string');
+ #or
+ $blake2b_256_b64 = blake2b_256_b64('any data', 'more data', 'even more data');
+
+=head2 blake2b_256_b64u
+
+Logically joins all arguments into a single string, and returns its BLAKE2b_256 digest encoded as a Base64 URL Safe string (see RFC 4648 section 5).
+
+ $blake2b_256_b64url = blake2b_256_b64u('data string');
+ #or
+ $blake2b_256_b64url = blake2b_256_b64u('any data', 'more data', 'even more data');
+
+=head2 blake2b_256_file
+
+Reads file (defined by filename or filehandle) content, and returns its BLAKE2b_256 digest encoded as a binary string.
+
+ $blake2b_256_raw = blake2b_256_file('filename.dat');
+ #or
+ $blake2b_256_raw = blake2b_256_file(*FILEHANDLE);
+
+=head2 blake2b_256_file_hex
+
+Reads file (defined by filename or filehandle) content, and returns its BLAKE2b_256 digest encoded as a hexadecimal string.
+
+ $blake2b_256_hex = blake2b_256_file_hex('filename.dat');
+ #or
+ $blake2b_256_hex = blake2b_256_file_hex(*FILEHANDLE);
+
+B<BEWARE:> You have to make sure that the filehandle is in binary mode before you pass it as argument to the addfile() method.
+
+=head2 blake2b_256_file_b64
+
+Reads file (defined by filename or filehandle) content, and returns its BLAKE2b_256 digest encoded as a Base64 string, B<with> trailing '=' padding.
+
+ $blake2b_256_b64 = blake2b_256_file_b64('filename.dat');
+ #or
+ $blake2b_256_b64 = blake2b_256_file_b64(*FILEHANDLE);
+
+=head2 blake2b_256_file_b64u
+
+Reads file (defined by filename or filehandle) content, and returns its BLAKE2b_256 digest encoded as a Base64 URL Safe string (see RFC 4648 section 5).
+
+ $blake2b_256_b64url = blake2b_256_file_b64u('filename.dat');
+ #or
+ $blake2b_256_b64url = blake2b_256_file_b64u(*FILEHANDLE);
+
+=head1 METHODS
+
+The OO interface provides the same set of functions as L<Crypt::Digest>.
+
+=head2 new
+
+ $d = Crypt::Digest::BLAKE2b_256->new();
+
+=head2 clone
+
+ $d->clone();
+
+=head2 reset
+
+ $d->reset();
+
+=head2 add
+
+ $d->add('any data');
+ #or
+ $d->add('any data', 'more data', 'even more data');
+
+=head2 addfile
+
+ $d->addfile('filename.dat');
+ #or
+ $d->addfile(*FILEHANDLE);
+
+=head2 add_bits
+
+ $d->add_bits($bit_string);   # e.g. $d->add_bits("111100001010");
+ #or
+ $d->add_bits($data, $nbits); # e.g. $d->add_bits("\xF0\xA0", 16);
+
+=head2 hashsize
+
+ $d->hashsize;
+ #or
+ Crypt::Digest::BLAKE2b_256->hashsize();
+ #or
+ Crypt::Digest::BLAKE2b_256::hashsize();
+
+=head2 digest
+
+ $result_raw = $d->digest();
+
+=head2 hexdigest
+
+ $result_hex = $d->hexdigest();
+
+=head2 b64digest
+
+ $result_b64 = $d->b64digest();
+
+=head2 b64udigest
+
+ $result_b64url = $d->b64udigest();
+
+=head1 SEE ALSO
+
+=over
+
+=item * L<CryptX|CryptX>, L<Crypt::Digest>
+
+=item * L<https://blake2.net/>
+
+=item * L<https://tools.ietf.org/html/rfc7693>
+
+=back
+
+=cut