value-object-pattern 1.17.0__tar.gz → 1.19.0__tar.gz

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: value-object-pattern
-Version: 1.17.0
+Version: 1.19.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.17.0 → value_object_pattern-1.19.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.17.0 → value_object_pattern-1.19.0}/value_object_pattern/__init__.py

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

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/models/collections/list_value_object.py

@@ -14,7 +14,8 @@ else:
 from collections.abc import Iterator
 from enum import Enum
 from inspect import isclass
-from typing import Any, Generic, NoReturn, TypeVar, get_args, get_origin
+from types import UnionType
+from typing import Any, Generic, NoReturn, TypeVar, Union, get_args, get_origin
 
 from value_object_pattern.decorators import validation
 from value_object_pattern.models import BaseModel, ValueObject
@@ -312,7 +313,23 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         if self._type is Any:
             return
 
-        expected_type = get_origin(tp=self._type) or self._type
+        origin = get_origin(tp=self._type)
+        if origin in (Union, UnionType):
+            allowed_types: list[type[Any] | UnionType] = []
+            for allowed in get_args(self._type):
+                if allowed is Any:
+                    return
+
+                allowed_origin = get_origin(tp=allowed)
+                allowed_types.append(allowed_origin or allowed)
+
+            for item in value:
+                if not any(isinstance(item, allowed) for allowed in allowed_types):
+                    self._raise_value_is_not_of_type(value=item)
+
+            return
+
+        expected_type = origin or self._type
         for item in value:
             if not isinstance(item, expected_type):
                 self._raise_value_is_not_of_type(value=item)
@@ -327,7 +344,7 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         Raises:
             TypeError: If the `value` is not of type `T`.
         """
-        raise TypeError(f'ListValueObject value <<<{value}>>> must be of type <<<{self._type.__name__}>>> type. Got <<<{type(value).__name__}>>> type.')  # noqa: E501  # fmt: skip
+        raise TypeError(f'ListValueObject value <<<{value}>>> must be of type <<<{self._type_label()}>>> type. Got <<<{type(value).__name__}>>> type.')  # fmt: skip  # noqa: E501
 
     def is_empty(self) -> bool:
         """
@@ -359,6 +376,9 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         Args:
             item (T): The item to add.
 
+        Raises:
+            TypeError: If the item is not of type T.
+
         Returns:
             ListValueObject[T]: A new ListValueObject with the item added.
 
@@ -388,6 +408,9 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         Args:
             item (Any): The primitives item to convert and add.
 
+        Raises:
+            TypeError: If the item is not of type T.
+
         Returns:
             ListValueObject[T]: A new ListValueObject with the item added.
 
@@ -424,6 +447,9 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         Args:
             items (list[T]): The items to add.
 
+        Raises:
+            TypeError: If the items are not of the correct type.
+
         Returns:
             ListValueObject[T]: A new ListValueObject with the items added.
 
@@ -453,6 +479,9 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         Args:
             items (list[Any]): The primitive items to convert and add.
 
+        Raises:
+            TypeError: If the items are not of the correct type.
+
         Returns:
             ListValueObject[T]: A new ListValueObject with the items added.
 
@@ -663,11 +692,47 @@ class ListValueObject(ValueObject[list[T]], Generic[T]):  # noqa: UP046
         if hasattr(self._type, 'from_primitives'):
             return self._type.from_primitives(value)  # type: ignore[no-any-return]
 
+        if get_origin(tp=self._type) in (Union, UnionType):
+            return value  # type: ignore[no-any-return]
+
         if hasattr(self._type, 'value'):
             return self._type(value=value)  # type: ignore[no-any-return]
 
         return value  # type: ignore[no-any-return]
 
+    def _type_label(self) -> str:
+        """
+        Returns a readable label for the configured type, including unions.
+
+        Returns:
+            str: The type label.
+        """
+        origin = get_origin(tp=self._type)
+        if origin in (Union, UnionType):
+            parts = [self._format_single_type(type=type) for type in get_args(self._type)]
+            return ' | '.join(parts)
+
+        return self._format_single_type(type=self._type)
+
+    @staticmethod
+    def _format_single_type(*, type: Any) -> str:
+        """
+        Formats a single type for error messages.
+
+        Args:
+            type (Any): The type to format.
+
+        Returns:
+            str: The formatted type.
+        """
+        if type is Any:
+            return 'Any'
+
+        if hasattr(type, '__name__'):
+            return type.__name__  # type: ignore[no-any-return]
+
+        return str(type).replace('typing.', '')
+
     @classmethod
     def from_primitives(cls, value: list[Any]) -> ListValueObject[T]:
         """

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/models/enumeration_value_object.py

@@ -96,11 +96,11 @@ class EnumerationValueObject(ValueObject[Any | E], Generic[E]):  # noqa: UP046
         if isinstance(value, self._enumeration):
             return value
 
-        for member in self._enumeration:
+        for member in self._enumeration:  # pragma: no cover
             if member.value == value:
                 return member
 
-        self._raise_value_is_not_from_enumeration(value=value)
+        self._raise_value_is_not_from_enumeration(value=value)  # pragma: no cover
 
     @validation(order=0)
     def _ensure_value_is_from_enumeration(self, value: Any | E) -> None:

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/usables/identifiers/uuid/string_uuid_v8_value_object.py

@@ -3,8 +3,7 @@ StringUuidV8ValueObject value object.
 """
 
 from typing import NoReturn
-
-from uuid6 import UUID
+from uuid import UUID
 
 from value_object_pattern.decorators import validation
 

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/usables/identifiers/uuid/uuid_v7_value_object.py

@@ -16,7 +16,7 @@ class UuidV7ValueObject(UuidValueObject):
 
     Example:
     ```python
-    from uuid6 import uuid7
+    from uuid import uuid7
 
     from value_object_pattern.usables.identifiers import UuidV7ValueObject
 

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/usables/identifiers/uuid/uuid_v8_value_object.py

@@ -16,7 +16,7 @@ class UuidV8ValueObject(UuidValueObject):
 
     Example:
     ```python
-    from uuid6 import uuid8
+    from uuid import uuid8
 
     from value_object_pattern.usables.identifiers import UuidV8ValueObject
 

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/usables/internet/utils/aws_regions.txt

@@ -1,4 +1,4 @@
-# This file was automatically updated using "update_lists.py" on 2025-04-13T18:00:09.855219+00:00
+# This file was automatically updated using "update_lists.py" on 2025-12-09T16:29:57.625046+00:00
 
 us-east-1
 us-east-2
@@ -11,10 +11,12 @@ ap-southeast-3
 ap-southeast-5
 ap-southeast-4
 ap-south-1
+ap-southeast-6
 ap-northeast-3
 ap-northeast-2
 ap-southeast-1
 ap-southeast-2
+ap-east-2
 ap-southeast-7
 ap-northeast-1
 ca-central-1

{value_object_pattern-1.17.0 → value_object_pattern-1.19.0}/value_object_pattern/usables/internet/utils/tld_domains.txt

@@ -1,4 +1,4 @@
-# This file was automatically updated using "update_lists.py" on 2025-04-13T18:00:10.014595+00:00
+# This file was automatically updated using "update_lists.py" on 2025-12-09T16:29:57.669510+00:00
 
 aaa
 aarp
@@ -119,7 +119,6 @@ be
 beats
 beauty
 beer
-bentley
 berlin
 best
 bestbuy
@@ -346,7 +345,6 @@ download
 drive
 dtv
 dubai
-dunlop
 dupont
 durban
 dvag
@@ -659,7 +657,6 @@ la
 lacaixa
 lamborghini
 lamer
-lancaster
 land
 landrover
 lanxess
@@ -915,7 +912,6 @@ politie
 porn
 post
 pr
-pramerica
 praxi
 press
 prime
@@ -949,7 +945,6 @@ realtor
 realty
 recipes
 red
-redstone
 redumbrella
 rehab
 reise