diff options
Diffstat (limited to 'lib/Crypto/Hash/SHA512.py')
-rw-r--r-- | lib/Crypto/Hash/SHA512.py | 84 |
1 files changed, 61 insertions, 23 deletions
diff --git a/lib/Crypto/Hash/SHA512.py b/lib/Crypto/Hash/SHA512.py index 182ec74..d57548d 100644 --- a/lib/Crypto/Hash/SHA512.py +++ b/lib/Crypto/Hash/SHA512.py @@ -18,31 +18,28 @@ # SOFTWARE. # =================================================================== -# Just use the SHA module from the Python standard library +"""SHA-512 cryptographic hash algorithm. -__revision__ = "$Id$" +SHA-512 belongs to the SHA-2_ family of cryptographic hashes. +It produces the 512 bit digest of a message. -__all__ = ['new', 'digest_size'] + >>> from Crypto.Hash import SHA512 + >>> + >>> h = SHA512.new() + >>> h.update(b'Hello') + >>> print h.hexdigest() -from Crypto.Util.wrapper import Wrapper -from Crypto.Util.py3compat import * +*SHA* stands for Secure Hash Algorithm. -# The OID for SHA-512 is: -# -# id-sha512 OBJECT IDENTIFIER ::= { -# joint-iso-itu-t(2) -# country(16) us(840) organization(1) gov(101) csor(3) -# nistalgorithm(4) hashalgs(2) 3 -# } -oid = b('\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x03') - -def new(data=b("")): - obj = Wrapper(hashFactory, data) - obj.oid = oid - obj.new = globals()['new'] - if not hasattr(obj, 'digest_size'): - obj.digest_size = digest_size - return obj +.. _SHA-2: http://csrc.nist.gov/publications/fips/fips180-2/fips180-2.pdf +""" + +_revision__ = "$Id$" + +__all__ = ['new', 'digest_size', 'SHA512Hash' ] + +from Crypto.Util.py3compat import * +from Crypto.Hash.hashalgo import HashAlgo try: import hashlib @@ -52,6 +49,47 @@ except ImportError: from Crypto.Hash import _SHA512 hashFactory = _SHA512 -digest_size = 64 -block_size = 128 +class SHA512Hash(HashAlgo): + """Class that implements a SHA-512 hash + + :undocumented: block_size + """ + + #: ASN.1 Object identifier (OID):: + #: + #: id-sha512 OBJECT IDENTIFIER ::= { + #: joint-iso-itu-t(2) + #: country(16) us(840) organization(1) gov(101) csor(3) nistalgorithm(4) hashalgs(2) 3 + #: } + #: + #: This value uniquely identifies the SHA-512 algorithm. + oid = b('\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x03') + + digest_size = 64 + block_size = 128 + + def __init__(self, data=None): + HashAlgo.__init__(self, hashFactory, data) + + def new(self, data=None): + return SHA512Hash(data) + +def new(data=None): + """Return a fresh instance of the hash object. + + :Parameters: + data : byte string + The very first chunk of the message to hash. + It is equivalent to an early call to `SHA512Hash.update()`. + Optional. + + :Return: A `SHA512Hash` object + """ + return SHA512Hash().new(data) + +#: The size of the resulting hash in bytes. +digest_size = SHA512Hash.digest_size + +#: The internal block size of the hash algorithm in bytes. +block_size = SHA512Hash.block_size |