value-object-pattern 1.16.0__tar.gz → 1.18.0__tar.gz

{value_object_pattern-1.16.0 → value_object_pattern-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: value-object-pattern
-Version: 1.16.0
+Version: 1.18.0
 Summary: The Value Object Pattern is a Python package that streamlines the creation and management of value objects in your projects.
 Project-URL: Homepage, https://github.com/adriamontoto/value-object-pattern
 Project-URL: Repository, https://github.com/adriamontoto/value-object-pattern
@@ -17,6 +17,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: python-dateutil>=2.9.0

{value_object_pattern-1.16.0 → value_object_pattern-1.18.0}/pyproject.toml

@@ -26,6 +26,7 @@ classifiers = [
     'Programming Language :: Python :: 3.11',
     'Programming Language :: Python :: 3.12',
     'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3.14',
 ]
 keywords = [
     'python',

{value_object_pattern-1.16.0 → value_object_pattern-1.18.0}/value_object_pattern/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.16.0'
+__version__ = '1.18.0'
 
 from .decorators import process, validation
 from .models import BaseModel, EnumerationValueObject, ValueObject

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/__init__.py

@@ -0,0 +1,37 @@
+from .uuid import (
+    StringUuidV1ValueObject,
+    StringUuidV3ValueObject,
+    StringUuidV4ValueObject,
+    StringUuidV5ValueObject,
+    StringUuidV6ValueObject,
+    StringUuidV7ValueObject,
+    StringUuidV8ValueObject,
+    StringUuidValueObject,
+    UuidV1ValueObject,
+    UuidV3ValueObject,
+    UuidV4ValueObject,
+    UuidV5ValueObject,
+    UuidV6ValueObject,
+    UuidV7ValueObject,
+    UuidV8ValueObject,
+    UuidValueObject,
+)
+
+__all__ = (
+    'StringUuidV1ValueObject',
+    'StringUuidV3ValueObject',
+    'StringUuidV4ValueObject',
+    'StringUuidV5ValueObject',
+    'StringUuidV6ValueObject',
+    'StringUuidV7ValueObject',
+    'StringUuidV8ValueObject',
+    'StringUuidValueObject',
+    'UuidV1ValueObject',
+    'UuidV3ValueObject',
+    'UuidV4ValueObject',
+    'UuidV5ValueObject',
+    'UuidV6ValueObject',
+    'UuidV7ValueObject',
+    'UuidV8ValueObject',
+    'UuidValueObject',
+)

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/__init__.py

@@ -0,0 +1,35 @@
+from .string_uuid_v1_value_object import StringUuidV1ValueObject
+from .string_uuid_v3_value_object import StringUuidV3ValueObject
+from .string_uuid_v4_value_object import StringUuidV4ValueObject
+from .string_uuid_v5_value_object import StringUuidV5ValueObject
+from .string_uuid_v6_value_object import StringUuidV6ValueObject
+from .string_uuid_v7_value_object import StringUuidV7ValueObject
+from .string_uuid_v8_value_object import StringUuidV8ValueObject
+from .string_uuid_value_object import StringUuidValueObject
+from .uuid_v1_value_object import UuidV1ValueObject
+from .uuid_v3_value_object import UuidV3ValueObject
+from .uuid_v4_value_object import UuidV4ValueObject
+from .uuid_v5_value_object import UuidV5ValueObject
+from .uuid_v6_value_object import UuidV6ValueObject
+from .uuid_v7_value_object import UuidV7ValueObject
+from .uuid_v8_value_object import UuidV8ValueObject
+from .uuid_value_object import UuidValueObject
+
+__all__ = (
+    'StringUuidV1ValueObject',
+    'StringUuidV3ValueObject',
+    'StringUuidV4ValueObject',
+    'StringUuidV5ValueObject',
+    'StringUuidV6ValueObject',
+    'StringUuidV7ValueObject',
+    'StringUuidV8ValueObject',
+    'StringUuidValueObject',
+    'UuidV1ValueObject',
+    'UuidV3ValueObject',
+    'UuidV4ValueObject',
+    'UuidV5ValueObject',
+    'UuidV6ValueObject',
+    'UuidV7ValueObject',
+    'UuidV8ValueObject',
+    'UuidValueObject',
+)

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/string_uuid_v1_value_object.py

@@ -0,0 +1,52 @@
+"""
+StringUuidV1ValueObject value object.
+"""
+
+from typing import NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .string_uuid_value_object import StringUuidValueObject
+
+
+class StringUuidV1ValueObject(StringUuidValueObject):
+    """
+    StringUuidV1ValueObject value object ensures the provided value is a valid UUID version 1.
+
+    Example:
+    ```python
+    from value_object_pattern.usables.identifiers import StringUuidV1ValueObject
+
+    uuid = StringUuidV1ValueObject(value='53734b8c-d517-11f0-a57a-452bbcae0235')
+    print(repr(uuid))
+    # >>> StringUuidV1ValueObject(value=53734b8c-d517-11f0-a57a-452bbcae0235)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid1(self, value: str) -> None:
+        """
+        Ensures the value object `value` is a UUID version 1.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 1.
+        """
+        uuid_object = UUID(value)
+        if uuid_object.version != 1:
+            self._raise_value_is_not_uuid1(value=value)
+
+    def _raise_value_is_not_uuid1(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 1.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 1.
+        """
+        raise ValueError(f'StringUuidV1ValueObject value <<<{value}>>> must be a UUID version 1. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/string_uuid_v3_value_object.py

@@ -0,0 +1,52 @@
+"""
+StringUuidV3ValueObject value object.
+"""
+
+from typing import NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .string_uuid_value_object import StringUuidValueObject
+
+
+class StringUuidV3ValueObject(StringUuidValueObject):
+    """
+    StringUuidV3ValueObject value object ensures the provided value is a valid UUID version 3.
+
+    Example:
+    ```python
+    from value_object_pattern.usables.identifiers import StringUuidV3ValueObject
+
+    uuid = StringUuidV3ValueObject(value='9073926b-929f-31c2-abc9-fad77ae3e8eb')
+    print(repr(uuid))
+    # >>> StringUuidV3ValueObject(value=9073926b-929f-31c2-abc9-fad77ae3e8eb)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid3(self, value: str) -> None:
+        """
+        Ensures the value object `value` is a UUID version 3.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 3.
+        """
+        uuid_object = UUID(value)
+        if uuid_object.version != 3:
+            self._raise_value_is_not_uuid3(value=value)
+
+    def _raise_value_is_not_uuid3(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 3.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 3.
+        """
+        raise ValueError(f'StringUuidV3ValueObject value <<<{value}>>> must be a UUID version 3. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

{value_object_pattern-1.16.0 → value_object_pattern-1.18.0}/value_object_pattern/usables/identifiers/uuid/string_uuid_v4_value_object.py

@@ -18,10 +18,9 @@ class StringUuidV4ValueObject(StringUuidValueObject):
     ```python
     from value_object_pattern.usables.identifiers import StringUuidV4ValueObject
 
-    uuid = StringUuidV4ValueObject(value='9908bb2d-54b4-426f-bef0-b09aa978ed21')
-
+    uuid = StringUuidV4ValueObject(value='3e9e0f3a-64a3-474f-9127-368e723f389f')
     print(repr(uuid))
-    # >>> StringUuidV4ValueObject(value=9908bb2d-54b4-426f-bef0-b09aa978ed21)
+    # >>> StringUuidV4ValueObject(value=3e9e0f3a-64a3-474f-9127-368e723f389f)
     ```
     """
 
@@ -36,7 +35,7 @@ class StringUuidV4ValueObject(StringUuidValueObject):
         Raises:
             ValueError: If the `value` is not a UUID version 4.
         """
-        uuid_object = UUID(hex=value)
+        uuid_object = UUID(value)
         if uuid_object.version != 4:
             self._raise_value_is_not_uuid4(value=value)
 
@@ -50,4 +49,4 @@ class StringUuidV4ValueObject(StringUuidValueObject):
         Raises:
             ValueError: If the `value` is not a UUID version 4.
         """
-        raise ValueError(f'StringUuidV4ValueObject value <<<{value}>>> must be a UUID version 4. Got version <<<{UUID(hex=value).version}>>>.')  # noqa: E501  # fmt: skip
+        raise ValueError(f'StringUuidV4ValueObject value <<<{value}>>> must be a UUID version 4. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/string_uuid_v5_value_object.py

@@ -0,0 +1,52 @@
+"""
+StringUuidV5ValueObject value object.
+"""
+
+from typing import NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .string_uuid_value_object import StringUuidValueObject
+
+
+class StringUuidV5ValueObject(StringUuidValueObject):
+    """
+    StringUuidV5ValueObject value object ensures the provided value is a valid UUID version 5.
+
+    Example:
+    ```python
+    from value_object_pattern.usables.identifiers import StringUuidV5ValueObject
+
+    uuid = StringUuidV5ValueObject(value='cfbff0d1-9375-5685-968c-48ce8b15ae17')
+    print(repr(uuid))
+    # >>> StringUuidV5ValueObject(value=cfbff0d1-9375-5685-968c-48ce8b15ae17)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid5(self, value: str) -> None:
+        """
+        Ensures the value object `value` is a UUID version 5.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 5.
+        """
+        uuid_object = UUID(value)
+        if uuid_object.version != 5:
+            self._raise_value_is_not_uuid5(value=value)
+
+    def _raise_value_is_not_uuid5(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 5.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 5.
+        """
+        raise ValueError(f'StringUuidV5ValueObject value <<<{value}>>> must be a UUID version 5. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/string_uuid_v6_value_object.py

@@ -0,0 +1,53 @@
+"""
+StringUuidV6ValueObject value object.
+"""
+
+from typing import NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .string_uuid_value_object import StringUuidValueObject
+
+
+class StringUuidV6ValueObject(StringUuidValueObject):
+    """
+    StringUuidV6ValueObject value object ensures the provided value is a valid UUID version 6.
+
+    Example:
+    ```python
+    from value_object_pattern.usables.identifiers import StringUuidV6ValueObject
+
+    uuid = StringUuidV6ValueObject(value='1f0d455c-76e5-6210-b032-46ef6b2a93e1')
+
+    print(repr(uuid))
+    # >>> StringUuidV6ValueObject(value=1f0d455c-76e5-6210-b032-46ef6b2a93e1)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid6(self, value: str) -> None:
+        """
+        Ensures the value object `value` is a UUID version 6.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 6.
+        """
+        uuid_object = UUID(value)
+        if uuid_object.version != 6:
+            self._raise_value_is_not_uuid6(value=value)
+
+    def _raise_value_is_not_uuid6(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 6.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 6.
+        """
+        raise ValueError(f'StringUuidV6ValueObject value <<<{value}>>> must be a UUID version 6. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/string_uuid_v7_value_object.py

@@ -0,0 +1,52 @@
+"""
+StringUuidV7ValueObject value object.
+"""
+
+from typing import NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .string_uuid_value_object import StringUuidValueObject
+
+
+class StringUuidV7ValueObject(StringUuidValueObject):
+    """
+    StringUuidV7ValueObject value object ensures the provided value is a valid UUID version 7.
+
+    Example:
+    ```python
+    from value_object_pattern.usables.identifiers import StringUuidV7ValueObject
+
+    uuid = StringUuidV7ValueObject(value='019afedd-025c-7f00-b22f-796d93c9b9cb')
+    print(repr(uuid))
+    # >>> StringUuidV7ValueObject(value=019afedd-025c-7f00-b22f-796d93c9b9cb)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid7(self, value: str) -> None:
+        """
+        Ensures the value object `value` is a UUID version 7.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 7.
+        """
+        uuid_object = UUID(value)
+        if uuid_object.version != 7:
+            self._raise_value_is_not_uuid7(value=value)
+
+    def _raise_value_is_not_uuid7(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 7.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 7.
+        """
+        raise ValueError(f'StringUuidV7ValueObject value <<<{value}>>> must be a UUID version 7. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/string_uuid_v8_value_object.py

@@ -0,0 +1,53 @@
+"""
+StringUuidV8ValueObject value object.
+"""
+
+from typing import NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .string_uuid_value_object import StringUuidValueObject
+
+
+class StringUuidV8ValueObject(StringUuidValueObject):
+    """
+    StringUuidV8ValueObject value object ensures the provided value is a valid UUID version 8.
+
+    Example:
+    ```python
+    from value_object_pattern.usables.identifiers import StringUuidV8ValueObject
+
+    uuid = StringUuidV8ValueObject(value='1f6b82d1-1a39-4607-8a28-4dd1453104d3')
+
+    print(repr(uuid))
+    # >>> StringUuidV8ValueObject(value=1f6b82d1-1a39-4607-8a28-4dd1453104d3)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid8(self, value: str) -> None:
+        """
+        Ensures the value object `value` is a UUID version 8.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 8.
+        """
+        uuid_object = UUID(value)
+        if uuid_object.version != 8:
+            self._raise_value_is_not_uuid8(value=value)
+
+    def _raise_value_is_not_uuid8(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 8.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 8.
+        """
+        raise ValueError(f'StringUuidV8ValueObject value <<<{value}>>> must be a UUID version 8. Got version <<<{UUID(value).version}>>>.')  # noqa: E501  # fmt: skip

{value_object_pattern-1.16.0 → value_object_pattern-1.18.0}/value_object_pattern/usables/identifiers/uuid/string_uuid_value_object.py

@@ -17,10 +17,9 @@ class StringUuidValueObject(NotEmptyStringValueObject, TrimmedStringValueObject)
     ```python
     from value_object_pattern.usables.identifiers import StringUuidValueObject
 
-    uuid = StringUuidValueObject(value='9908bb2d-54b4-426f-bef0-b09aa978ed21')
-
+    uuid = StringUuidValueObject(value='3e9e0f3a-64a3-474f-9127-368e723f389f')
     print(repr(uuid))
-    # >>> StringUuidValueObject(value=9908bb2d-54b4-426f-bef0-b09aa978ed21)
+    # >>> StringUuidValueObject(value=3e9e0f3a-64a3-474f-9127-368e723f389f)
     ```
     """
 
@@ -49,7 +48,7 @@ class StringUuidValueObject(NotEmptyStringValueObject, TrimmedStringValueObject)
             ValueError: If the `value` is not a UUID.
         """
         try:
-            UUID(hex=value)
+            UUID(value)
 
         except ValueError:
             self._raise_value_is_not_uuid(value=value)

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/uuid_v1_value_object.py

@@ -0,0 +1,53 @@
+"""
+UuidV1ValueObject value object.
+"""
+
+from typing import Any, NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .uuid_value_object import UuidValueObject
+
+
+class UuidV1ValueObject(UuidValueObject):
+    """
+    UuidV1ValueObject value object ensures the provided value is a valid UUID version 1.
+
+    Example:
+    ```python
+    from uuid import uuid1
+
+    from value_object_pattern.usables.identifiers import UuidV1ValueObject
+
+    uuid = UuidV1ValueObject(value=uuid1())
+    print(repr(uuid))
+    # >>> UuidV1ValueObject(value=26afb422-824d-11f0-9bbf-325096b39f47)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid1(self, value: UUID) -> None:
+        """
+        Ensures the value object `value` is a UUID version 1.
+
+        Args:
+            value (UUID): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 1.
+        """
+        if value.version != 1:
+            self._raise_value_is_not_uuid1(value=value)
+
+    def _raise_value_is_not_uuid1(self, value: Any) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 1.
+
+        Args:
+            value (Any): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 1.
+        """
+        raise ValueError(f'UuidV1ValueObject value <<<{value}>>> must be a UUID version 1. Got version <<<{value.version}>>>.')  # noqa: E501  # fmt: skip

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/uuid_v3_value_object.py

@@ -0,0 +1,53 @@
+"""
+UuidV3ValueObject value object.
+"""
+
+from typing import Any, NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .uuid_value_object import UuidValueObject
+
+
+class UuidV3ValueObject(UuidValueObject):
+    """
+    UuidV3ValueObject value object ensures the provided value is a valid UUID version 3.
+
+    Example:
+    ```python
+    from uuid import NAMESPACE_DNS, uuid3
+
+    from value_object_pattern.usables.identifiers import UuidV3ValueObject
+
+    uuid = UuidV3ValueObject(value=uuid3(namespace=NAMESPACE_DNS, name='example.com'))
+    print(repr(uuid))
+    # >>> UuidV3ValueObject(value=9073926b-929f-31c2-abc9-fad77ae3e8eb)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid3(self, value: UUID) -> None:
+        """
+        Ensures the value object `value` is a UUID version 3.
+
+        Args:
+            value (UUID): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 3.
+        """
+        if value.version != 3:
+            self._raise_value_is_not_uuid3(value=value)
+
+    def _raise_value_is_not_uuid3(self, value: Any) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 3.
+
+        Args:
+            value (Any): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 3.
+        """
+        raise ValueError(f'UuidV3ValueObject value <<<{value}>>> must be a UUID version 3. Got version <<<{value.version}>>>.')  # noqa: E501  # fmt: skip

{value_object_pattern-1.16.0 → value_object_pattern-1.18.0}/value_object_pattern/usables/identifiers/uuid/uuid_v4_value_object.py

@@ -21,9 +21,8 @@ class UuidV4ValueObject(UuidValueObject):
     from value_object_pattern.usables.identifiers import UuidV4ValueObject
 
     uuid = UuidV4ValueObject(value=uuid4())
-
     print(repr(uuid))
-    # >>> UuidV4ValueObject(value=9908bb2d-54b4-426f-bef0-b09aa978ed21)
+    # >>> UuidV4ValueObject(value=3e9e0f3a-64a3-474f-9127-368e723f389f)
     ```
     """
 

value_object_pattern-1.18.0/value_object_pattern/usables/identifiers/uuid/uuid_v5_value_object.py

@@ -0,0 +1,53 @@
+"""
+UuidV5ValueObject value object.
+"""
+
+from typing import Any, NoReturn
+from uuid import UUID
+
+from value_object_pattern.decorators import validation
+
+from .uuid_value_object import UuidValueObject
+
+
+class UuidV5ValueObject(UuidValueObject):
+    """
+    UuidV5ValueObject value object ensures the provided value is a valid UUID version 5.
+
+    Example:
+    ```python
+    from uuid import NAMESPACE_DNS, uuid5
+
+    from value_object_pattern.usables.identifiers import UuidV5ValueObject
+
+    uuid = UuidV5ValueObject(value=uuid5(namespace=NAMESPACE_DNS, name='example.com'))
+    print(repr(uuid))
+    # >>> UuidV5ValueObject(value=cfbff0d1-9375-5685-968c-48ce8b15ae17)
+    ```
+    """
+
+    @validation(order=1)
+    def _ensure_value_is_uuid5(self, value: UUID) -> None:
+        """
+        Ensures the value object `value` is a UUID version 5.
+
+        Args:
+            value (UUID): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 5.
+        """
+        if value.version != 5:
+            self._raise_value_is_not_uuid5(value=value)
+
+    def _raise_value_is_not_uuid5(self, value: Any) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is not a UUID version 5.
+
+        Args:
+            value (Any): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not a UUID version 5.
+        """
+        raise ValueError(f'UuidV5ValueObject value <<<{value}>>> must be a UUID version 5. Got version <<<{value.version}>>>.')  # noqa: E501  # fmt: skip