feat: add SHA-3 family hash algorithms

Add SHA-3 hash algorithms to the Algorithm enum:
- SHA3-224, SHA3-256, SHA3-384, SHA3-512
- SHAKE128, SHAKE256 (variable-length XOF)

Updated hash() method to handle SHAKE algorithms that require
a length parameter for hexdigest().

All algorithms are available in Python 3.6+ hashlib, compatible
with mimesis's Python >=3.10 requirement.

Author: rodrigo.nogueira

CHANGELOG.rst

@@ -1,8 +1,9 @@
 Version 19.1.0
 --------------
 
-- Added support for E.164 phone number formatting to the ``Person`` provider’s ``phone_number()`` method.
+- Added support for E.164 phone number formatting to the ``Person`` provider's ``phone_number()`` method.
 - Added ``secondary_address()`` method to the ``Address`` provider.
+- Add SHA-3 family hash algorithms (``SHA3_224``, ``SHA3_256``, ``SHA3_384``, ``SHA3_512``, ``SHAKE128``, ``SHAKE256``) to the ``Algorithm`` enum.
 
 Version 19.0.0
 --------------
@@ -15,6 +16,8 @@ Version 19.0.0
 - Add ``SchemaBuilder`` for generating relational data.
 - Add ``ip_v4_cidr()``, ``ip_v6_cidr()`` and ``cloud_region()`` methods for the ``Internet`` provider.
 
+
+
 Version 18.0.0
 --------------
 

mimesis/enums.py

@@ -178,6 +178,12 @@ class Algorithm(Enum):
     SHA512 = "sha512"
     BLAKE2B = "blake2b"
     BLAKE2S = "blake2s"
+    SHA3_224 = "sha3_224"
+    SHA3_256 = "sha3_256"
+    SHA3_384 = "sha3_384"
+    SHA3_512 = "sha3_512"
+    SHAKE128 = "shake_128"
+    SHAKE256 = "shake_256"
 
 
 class TLDType(Enum):

mimesis/providers/cryptographic.py

@@ -48,6 +48,8 @@ def hash(self, algorithm: Algorithm | None = None) -> str:  # noqa: A003
         key = self.validate_enum(algorithm, Algorithm)
         func = getattr(hashlib, key)
         value = func(self.uuid().encode())
+        if key in ("shake_128", "shake_256"):
+            return str(value.hexdigest(32))
         return str(value.hexdigest())
 
     def token_bytes(self, entropy: int = 32) -> bytes:

tests/test_providers/test_universal/test_cryptographic.py

@@ -39,6 +39,12 @@ def test_uuid(self, crypto):
             (Algorithm.SHA512, 128),
             (Algorithm.BLAKE2S, 64),
             (Algorithm.BLAKE2B, 128),
+            (Algorithm.SHA3_224, 56),
+            (Algorithm.SHA3_256, 64),
+            (Algorithm.SHA3_384, 96),
+            (Algorithm.SHA3_512, 128),
+            (Algorithm.SHAKE128, 64),
+            (Algorithm.SHAKE256, 64),
         ],
     )
     def test_hash(self, crypto, algorithm, length):