value-object-pattern 0.5.0__tar.gz → 0.6.1__tar.gz

{value_object_pattern-0.5.0 → value_object_pattern-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: value-object-pattern
-Version: 0.5.0
+Version: 0.6.1
 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-0.5.0 → value_object_pattern-0.6.1}/pyproject.toml

@@ -63,7 +63,7 @@ release = ['build>=1.2.2', 'python-semantic-release>=10.0.2']
 test = [
     'pytest>=8.0.0',
     'pytest-randomly>=3.0.0',
-    'object-mother-pattern>=2.1.0',
+    'object-mother-pattern>=3.0.0',
     { include-group = 'coverage' },
 ]
 types = ['types-python-dateutil>=2.9.0.20241206']

{value_object_pattern-0.5.0 → value_object_pattern-0.6.1}/value_object_pattern/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '0.5.0'
+__version__ = '0.6.1'
 
 from .decorators import process, validation
 from .models import EnumerationValueObject, ValueObject

{value_object_pattern-0.5.0 → value_object_pattern-0.6.1}/value_object_pattern/usables/__init__.py

@@ -11,7 +11,9 @@ from .primitives import (
     LowercaseStringValueObject,
     NegativeFloatValueObject,
     NegativeIntegerValueObject,
+    NoneValueObject,
     NotEmptyStringValueObject,
+    NotNoneValueObject,
     OddIntegerValueObject,
     PositiveFloatValueObject,
     PositiveIntegerValueObject,
@@ -37,8 +39,10 @@ __all__ = (
     'LowercaseStringValueObject',
     'NegativeFloatValueObject',
     'NegativeIntegerValueObject',
+    'NoneValueObject',
     'NotEmptyStringValueObject',
     'NotEmptyStringValueObject',
+    'NotNoneValueObject',
     'OddIntegerValueObject',
     'PositiveFloatValueObject',
     'PositiveIntegerValueObject',

{value_object_pattern-0.5.0 → value_object_pattern-0.6.1}/value_object_pattern/usables/primitives/__init__.py

@@ -8,6 +8,7 @@ from .integer import (
     OddIntegerValueObject,
     PositiveIntegerValueObject,
 )
+from .none import NoneValueObject, NotNoneValueObject
 from .string import (
     AlphaStringValueObject,
     AlphanumericStringValueObject,
@@ -33,7 +34,9 @@ __all__ = (
     'LowercaseStringValueObject',
     'NegativeFloatValueObject',
     'NegativeIntegerValueObject',
+    'NoneValueObject',
     'NotEmptyStringValueObject',
+    'NotNoneValueObject',
     'OddIntegerValueObject',
     'PositiveFloatValueObject',
     'PositiveIntegerValueObject',

value_object_pattern-0.6.1/value_object_pattern/usables/primitives/none/__init__.py

@@ -0,0 +1,7 @@
+from .none_value_object import NoneValueObject
+from .not_none_value_object import NotNoneValueObject
+
+__all__ = (
+    'NoneValueObject',
+    'NotNoneValueObject',
+)

value_object_pattern-0.6.1/value_object_pattern/usables/primitives/none/none_value_object.py

@@ -0,0 +1,50 @@
+"""
+NoneValueObject value object.
+"""
+
+from typing import Any, NoReturn
+
+from value_object_pattern.decorators import validation
+from value_object_pattern.models import ValueObject
+
+
+class NoneValueObject(ValueObject[None]):
+    """
+    NoneValueObject value object ensures the provided value is None.
+
+    Example:
+    ```python
+    from value_object_pattern.usables import NoneValueObject
+
+    none = NoneValueObject(value=None)
+
+    print(repr(none))
+    # >>> NoneValueObject(value=None)
+    ```
+    """
+
+    @validation(order=0)
+    def _ensure_value_is_none(self, value: None) -> None:
+        """
+        Ensures the value object `value` is None.
+
+        Args:
+            value (None): The provided value.
+
+        Raises:
+            TypeError: If the `value` is not None.
+        """
+        if value is not None:
+            self._raise_value_is_not_none(value=value)
+
+    def _raise_value_is_not_none(self, value: Any) -> NoReturn:
+        """
+        Raises a TypeError if the value object `value` is not None.
+
+        Args:
+            value (Any): The provided value.
+
+        Raises:
+            TypeError: If the `value` is not None.
+        """
+        raise TypeError(f'NoneValueObject value <<<{value}>>> must be None. Got <<<{type(value).__name__}>>> type.')  # noqa: E501  # fmt: skip

value_object_pattern-0.6.1/value_object_pattern/usables/primitives/none/not_none_value_object.py

@@ -0,0 +1,50 @@
+"""
+NotNoneValueObject value object.
+"""
+
+from typing import Any, NoReturn
+
+from value_object_pattern.decorators import validation
+from value_object_pattern.models import ValueObject
+
+
+class NotNoneValueObject(ValueObject[Any]):
+    """
+    NotNoneValueObject value object ensures the provided value is not None.
+
+    Example:
+    ```python
+    from value_object_pattern.usables import NotNoneValueObject
+
+    none = NotNoneValueObject(value='test')
+
+    print(repr(none))
+    # >>> NotNoneValueObject(value=test)
+    ```
+    """
+
+    @validation(order=0)
+    def _ensure_value_is_not_none(self, value: Any) -> None:
+        """
+        Ensures the value object `value` is not None.
+
+        Args:
+            value (Any): The provided value.
+
+        Raises:
+            TypeError: If the `value` is None.
+        """
+        if value is None:
+            self._raise_value_is_not_none(value=value)
+
+    def _raise_value_is_not_none(self, value: Any) -> NoReturn:
+        """
+        Raises a TypeError if the value object `value` is None.
+
+        Args:
+            value (Any): The provided value.
+
+        Raises:
+            TypeError: If the `value` is None.
+        """
+        raise TypeError(f'NotNoneValueObject value <<<{value}>>> must be not None.')