value-object-pattern 1.22.1__tar.gz → 1.24.0__tar.gz

{value_object_pattern-1.22.1 → value_object_pattern-1.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: value-object-pattern
-Version: 1.22.1
+Version: 1.24.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.22.1 → value_object_pattern-1.24.0}/value_object_pattern/__init__.py

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

{value_object_pattern-1.22.1 → value_object_pattern-1.24.0}/value_object_pattern/models/base_model.py

@@ -242,7 +242,23 @@ class BaseModel(ABC):
 
         Example:
         ```python
-        # TODO:
+        from copy import copy
+
+        from value_object_pattern import BaseModel
+
+
+        class User(BaseModel):
+            def __init__(self, tags: list[str]) -> None:
+                self.tags = tags
+
+
+        user = User(tags=['admin'])
+        clone = copy(user)
+
+        print(clone is user)
+        print(clone.tags is user.tags)
+        # >>> False
+        # >>> True
         ```
         """
         cls = self.__class__
@@ -264,7 +280,23 @@ class BaseModel(ABC):
 
         Example:
         ```python
-        # TODO:
+        from copy import deepcopy
+
+        from value_object_pattern import BaseModel
+
+
+        class User(BaseModel):
+            def __init__(self, tags: list[str]) -> None:
+                self.tags = tags
+
+
+        user = User(tags=['admin'])
+        clone = deepcopy(user)
+
+        print(clone is user)
+        print(clone.tags is user.tags)
+        # >>> False
+        # >>> False
         ```
         """
         if id(self) in memo:

{value_object_pattern-1.22.1 → value_object_pattern-1.24.0}/value_object_pattern/models/collections/dict_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, Generic, ItemsView, KeysView, NoReturn, TypeVar, Union, ValuesView, get_args, get_origin
+from typing import Any, Generic, ItemsView, KeysView, NoReturn, Self, TypeVar, Union, ValuesView, get_args, get_origin
 
 from value_object_pattern.decorators import validation
 from value_object_pattern.models import BaseModel, ValueObject
@@ -525,6 +525,59 @@ class DictValueObject(ValueObject[dict[K, V]], Generic[K, V]):  # noqa: UP046
 
         return str(type).replace('typing.', '')
 
+    @classmethod
+    def from_primitives(cls, value: dict[Any, Any]) -> Self:
+        """
+        Creates a DictValueObject from a dictionary of primitives.
+
+        Args:
+            value (dict[Any, Any]): The dictionary of primitives.
+
+        Returns:
+            Self: The created DictValueObject.
+        """
+        items: dict[Any, Any] = {}
+
+        for key, item in value.items():
+            primitive_key = cls._convert_from_primitives(value=key, expected_type=cls._key_type)
+            primitive_value = cls._convert_from_primitives(value=item, expected_type=cls._value_type)
+            items[primitive_key] = primitive_value
+
+        return cls(value=items)
+
+    @classmethod
+    def _convert_from_primitives(cls, *, value: Any, expected_type: Any) -> Any:
+        """
+        Converts a primitive value to the expected type.
+
+        Args:
+            value (Any): The primitive value to convert.
+            expected_type (Any): The expected type.
+
+        Returns:
+            Any: The converted value.
+        """
+        if expected_type is Any:
+            return value
+
+        origin = get_origin(tp=expected_type)
+        if origin in (Union, UnionType):
+            return value
+
+        if hasattr(expected_type, 'from_primitives'):
+            return expected_type.from_primitives(value)
+
+        if isclass(expected_type) and issubclass(expected_type, Enum):
+            if isinstance(value, expected_type):
+                return value
+
+            return expected_type(value)
+
+        if hasattr(expected_type, 'value'):
+            return expected_type(value=value)
+
+        return value
+
     def to_primitives(self) -> dict[Any, Any]:  # noqa: C901
         """
         Returns the dictionary as a dictionary of primitives, recursively converting each key and value.

{value_object_pattern-1.22.1 → value_object_pattern-1.24.0}/value_object_pattern/models/value_object.py

@@ -256,7 +256,22 @@ class ValueObject(ABC, Generic[T]):  # noqa: UP046
 
         Example:
         ```python
-        # TODO:
+        from copy import copy
+
+        from value_object_pattern import ValueObject
+
+
+        class IntegerValueObject(ValueObject[int]):
+            pass
+
+
+        value_object = IntegerValueObject(value=7)
+        clone = copy(value_object)
+
+        print(clone is value_object)
+        print(clone == value_object)
+        # >>> False
+        # >>> True
         ```
         """
         return self.__class__(
@@ -277,7 +292,22 @@ class ValueObject(ABC, Generic[T]):  # noqa: UP046
 
         Example:
         ```python
-        # TODO:
+        from copy import deepcopy
+
+        from value_object_pattern import ValueObject
+
+
+        class ListValueObject(ValueObject[list[int]]):
+            pass
+
+
+        value_object = ListValueObject(value=[1, 2])
+        clone = deepcopy(value_object)
+
+        print(clone is value_object)
+        print(clone.value is value_object.value)
+        # >>> False
+        # >>> False
         ```
         """
         if id(self) in memo:

{value_object_pattern-1.22.1 → value_object_pattern-1.24.0}/value_object_pattern/usables/identifiers/__init__.py

@@ -1,3 +1,4 @@
+from .strict_string_identifier_value_object import StrictStringIdentifierValueObject
 from .uuid import (
     StringUuidV1ValueObject,
     StringUuidV3ValueObject,
@@ -18,6 +19,7 @@ from .uuid import (
 )
 
 __all__ = (
+    'StrictStringIdentifierValueObject',
     'StringUuidV1ValueObject',
     'StringUuidV3ValueObject',
     'StringUuidV4ValueObject',

value_object_pattern-1.24.0/value_object_pattern/usables/identifiers/strict_string_identifier_value_object.py

@@ -0,0 +1,45 @@
+"""
+StrictStringIdentifierValueObject value object.
+"""
+
+from re import Pattern, compile as re_compile
+from typing import NoReturn
+
+from value_object_pattern.decorators import validation
+from value_object_pattern.usables import NotEmptyStringValueObject, TrimmedStringValueObject
+
+
+class StrictStringIdentifierValueObject(NotEmptyStringValueObject, TrimmedStringValueObject):
+    """
+    StrictStringIdentifierValueObject ensures the provided value is a strict identifier string.
+
+    The allowed characters are lower-case letters (`a-z`), digits (`0-9`), and hyphen (`-`).
+    """
+
+    _VALIDATION_REGEX: Pattern[str] = re_compile(pattern=r'[a-z0-9-]+')
+
+    @validation(order=0)
+    def _ensure_value_follows_validation_regex(self, value: str) -> None:
+        """
+        Ensures the value object `value` only contains allowed characters.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` contains disallowed characters.
+        """
+        if not self._VALIDATION_REGEX.fullmatch(string=value):
+            self._raise_value_contains_invalid_characters(value=value)
+
+    def _raise_value_contains_invalid_characters(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` contains invalid characters.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` contains invalid characters.
+        """
+        raise ValueError(f'StrictStringIdentifierValueObject value <<<{value}>>> contains invalid characters. Only a-z, 0-9, and - are allowed.')  # noqa: E501  # fmt: skip

{value_object_pattern-1.22.1 → value_object_pattern-1.24.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-12-09T16:29:57.669510+00:00
+# This file was automatically updated using "update_lists.py" on 2026-02-15T03:55:23.881612+00:00
 
 aaa
 aarp
@@ -487,7 +487,6 @@ godaddy
 gold
 goldpoint
 golf
-goo
 goodyear
 goog
 google
@@ -1251,7 +1250,6 @@ windows
 wine
 winners
 wme
-wolterskluwer
 woodside
 work
 works