value-object-pattern 1.31.0__tar.gz → 1.32.0__tar.gz

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: value-object-pattern
-Version: 1.31.0
+Version: 1.32.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

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.31.0'
+__version__ = '1.32.0'
 
 from .decorators import process, validation
 from .models import BaseModel, EnumerationValueObject, UnionValueObject, ValueObject

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/models/collections/dict_value_object.py

@@ -25,6 +25,7 @@ from typing import (
     TypeVar,
     Union,
     ValuesView,
+    cast,
     get_args,
     get_origin,
 )
@@ -644,6 +645,9 @@ class DictValueObject(ValueObject[dict[K, V]], Generic[K, V]):  # noqa: UP046
         Returns:
             Self: The created DictValueObject.
 
+        Raises:
+            TypeError: If the `value` is not a dict.
+
         Example:
         ```python
         from value_object_pattern.models import ValueObject
@@ -663,6 +667,9 @@ class DictValueObject(ValueObject[dict[K, V]], Generic[K, V]):  # noqa: UP046
         # >>> {'john': 30, 'jane': 25}
         ```
         """
+        if not isinstance(cast(Any, value), dict):
+            return cls(value=value)
+
         dictionary: dict[Any, Any] = {}
 
         for key, item in value.items():

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/models/collections/list_value_object.py

@@ -15,7 +15,7 @@ from collections.abc import Iterator
 from enum import Enum
 from inspect import isclass
 from types import UnionType
-from typing import Any, ClassVar, Generic, NoReturn, Self, TypeVar, Union, get_args, get_origin
+from typing import Any, ClassVar, Generic, NoReturn, Self, TypeVar, Union, cast, get_args, get_origin
 
 from value_object_pattern.decorators import validation
 from value_object_pattern.models import BaseModel, ValueObject
@@ -878,6 +878,9 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         # >>> [10, 20, 30]
         ```
         """
+        if not isinstance(cast(Any, value), list):
+            return cls(value=value)
+
         return cls(value=[from_primitive(value=item, expected_type=cls._type) for item in value])
 
     def to_primitives(self) -> list[Any]:

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/models/union_value_object.py

@@ -264,10 +264,11 @@ class UnionValueObject(ValueObject[T], Generic[T]):  # noqa: UP046
             except Exception as error:
                 last_error = error
 
-        if last_error is not None:
-            raise TypeError(f'UnionValueObject value <<<{value}>>> must be of type <<<{self._type_label()}>>> type. Got <<<{type(value).__name__}>>> type.') from last_error  # noqa: E501  # fmt: skip
+        try:
+            self._raise_value_is_not_of_type(value=value)
 
-        self._raise_value_is_not_of_type(value=value)
+        except Exception as error:
+            raise error from last_error
 
     def _unwrap_candidate_value(self, *, value: Any, unwrap_enum: bool = True) -> Any:
         """

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/usables/__init__.py

@@ -1,6 +1,7 @@
 from .primitives import (
     AlphaStringValueObject,
     AlphanumericStringValueObject,
+    Base64StringValueObject,
     BooleanValueObject,
     BytesValueObject,
     CamelCaseStringValueObject,
@@ -37,6 +38,7 @@ from .primitives import (
 __all__ = (
     'AlphaStringValueObject',
     'AlphanumericStringValueObject',
+    'Base64StringValueObject',
     'BooleanValueObject',
     'BytesValueObject',
     'CamelCaseStringValueObject',

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/usables/primitives/__init__.py

@@ -20,6 +20,7 @@ from .none import NoneValueObject, NotNoneValueObject
 from .string import (
     AlphaStringValueObject,
     AlphanumericStringValueObject,
+    Base64StringValueObject,
     CamelCaseStringValueObject,
     DigitStringValueObject,
     KebabCaseStringValueObject,
@@ -38,6 +39,7 @@ from .string import (
 __all__ = (
     'AlphaStringValueObject',
     'AlphanumericStringValueObject',
+    'Base64StringValueObject',
     'BooleanValueObject',
     'BytesValueObject',
     'CamelCaseStringValueObject',

{value_object_pattern-1.31.0 → value_object_pattern-1.32.0}/value_object_pattern/usables/primitives/string/__init__.py

@@ -1,5 +1,6 @@
 from .alpha_value_object import AlphaStringValueObject
 from .alphanumeric_value_object import AlphanumericStringValueObject
+from .base64_value_object import Base64StringValueObject
 from .camel_case_string_value_object import CamelCaseStringValueObject
 from .digit_value_object import DigitStringValueObject
 from .kebab_case_string_value_object import KebabCaseStringValueObject
@@ -17,6 +18,7 @@ from .uppercase_string_value_object import UppercaseStringValueObject
 __all__ = (
     'AlphaStringValueObject',
     'AlphanumericStringValueObject',
+    'Base64StringValueObject',
     'CamelCaseStringValueObject',
     'DigitStringValueObject',
     'KebabCaseStringValueObject',

value_object_pattern-1.32.0/value_object_pattern/usables/primitives/string/base64_value_object.py

@@ -0,0 +1,60 @@
+"""
+Base64StringValueObject value object.
+"""
+
+from base64 import b64decode, b64encode
+from binascii import Error
+from typing import NoReturn
+
+from value_object_pattern.decorators import validation
+
+from .trimmed_string_value_object import TrimmedStringValueObject
+
+
+class Base64StringValueObject(TrimmedStringValueObject):
+    """
+    Ensure the provided value is canonical standard Base64. The empty string is accepted as the Base64 encoding of
+    empty bytes.
+
+    Example:
+    ```python
+    from value_object_pattern.usables import Base64StringValueObject
+
+    string = Base64StringValueObject(value='aGVsbG8gd29ybGQ=')
+
+    print(repr(string))
+    # >>> Base64StringValueObject(value='aGVsbG8gd29ybGQ=')
+    ```
+    """
+
+    @validation(order=0)
+    def _ensure_value_is_base64(self, value: str) -> None:
+        """
+        Ensure the value is canonical standard Base64.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the value is not canonical standard Base64.
+        """
+        try:
+            decoded_value = b64decode(s=value, validate=True)
+
+        except (Error, ValueError):
+            self._raise_value_is_not_base64(value=value)
+
+        if b64encode(s=decoded_value).decode() != value:
+            self._raise_value_is_not_base64(value=value)
+
+    def _raise_value_is_not_base64(self, value: str) -> NoReturn:
+        """
+        Raise a ValueError when the value is not canonical standard Base64.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: Always raised because the value is not canonical standard Base64.
+        """
+        raise ValueError(f'Base64StringValueObject value <<<{value}>>> must be canonical standard Base64.')