OLD | NEW |
(Empty) | |
| 1 # -*- coding: utf-8 -*- |
| 2 # |
| 3 # =================================================================== |
| 4 # The contents of this file are dedicated to the public domain. To |
| 5 # the extent that dedication to the public domain is not available, |
| 6 # everyone is granted a worldwide, perpetual, royalty-free, |
| 7 # non-exclusive license to exercise all rights associated with the |
| 8 # contents of this file for any purpose whatsoever. |
| 9 # No rights are reserved. |
| 10 # |
| 11 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
| 12 # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
| 13 # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
| 14 # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS |
| 15 # BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
| 16 # ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN |
| 17 # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
| 18 # SOFTWARE. |
| 19 # =================================================================== |
| 20 |
| 21 """SHA-512 cryptographic hash algorithm. |
| 22 |
| 23 SHA-512 belongs to the SHA-2_ family of cryptographic hashes. |
| 24 It produces the 512 bit digest of a message. |
| 25 |
| 26 >>> from Crypto.Hash import SHA512 |
| 27 >>> |
| 28 >>> h = SHA512.new() |
| 29 >>> h.update(b'Hello') |
| 30 >>> print h.hexdigest() |
| 31 |
| 32 *SHA* stands for Secure Hash Algorithm. |
| 33 |
| 34 .. _SHA-2: http://csrc.nist.gov/publications/fips/fips180-2/fips180-2.pdf |
| 35 """ |
| 36 |
| 37 _revision__ = "$Id$" |
| 38 |
| 39 __all__ = ['new', 'digest_size', 'SHA512Hash' ] |
| 40 |
| 41 from Crypto.Util.py3compat import * |
| 42 from Crypto.Hash.hashalgo import HashAlgo |
| 43 |
| 44 try: |
| 45 import hashlib |
| 46 hashFactory = hashlib.sha512 |
| 47 |
| 48 except ImportError: |
| 49 from Crypto.Hash import _SHA512 |
| 50 hashFactory = _SHA512 |
| 51 |
| 52 class SHA512Hash(HashAlgo): |
| 53 """Class that implements a SHA-512 hash |
| 54 |
| 55 :undocumented: block_size |
| 56 """ |
| 57 |
| 58 #: ASN.1 Object identifier (OID):: |
| 59 #: |
| 60 #: id-sha512 OBJECT IDENTIFIER ::= { |
| 61 #: joint-iso-itu-t(2) |
| 62 #: country(16) us(840) organization(1) gov(101) csor(3) nistalgorithm(4
) hashalgs(2) 3 |
| 63 #: } |
| 64 #: |
| 65 #: This value uniquely identifies the SHA-512 algorithm. |
| 66 oid = b('\x06\x09\x60\x86\x48\x01\x65\x03\x04\x02\x03') |
| 67 |
| 68 digest_size = 64 |
| 69 block_size = 128 |
| 70 |
| 71 def __init__(self, data=None): |
| 72 HashAlgo.__init__(self, hashFactory, data) |
| 73 |
| 74 def new(self, data=None): |
| 75 return SHA512Hash(data) |
| 76 |
| 77 def new(data=None): |
| 78 """Return a fresh instance of the hash object. |
| 79 |
| 80 :Parameters: |
| 81 data : byte string |
| 82 The very first chunk of the message to hash. |
| 83 It is equivalent to an early call to `SHA512Hash.update()`. |
| 84 Optional. |
| 85 |
| 86 :Return: A `SHA512Hash` object |
| 87 """ |
| 88 return SHA512Hash().new(data) |
| 89 |
| 90 #: The size of the resulting hash in bytes. |
| 91 digest_size = SHA512Hash.digest_size |
| 92 |
| 93 #: The internal block size of the hash algorithm in bytes. |
| 94 block_size = SHA512Hash.block_size |
| 95 |
OLD | NEW |