value-object-pattern 0.5.0__py3-none-any.whl → 0.6.1__py3-none-any.whl

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/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/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/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/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/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.')

{value_object_pattern-0.5.0.dist-info → value_object_pattern-0.6.1.dist-info}/METADATA

@@ -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.dist-info → value_object_pattern-0.6.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-value_object_pattern/__init__.py,sha256=-eQ-LpAiKLoF5jLg7DGL_FL-k-ZO3Jlp7XBdn616kCI,220
+value_object_pattern/__init__.py,sha256=Bp3AFvKPZftaFpFvFlNy9HsSuLiKjbTi8AfM2-b5lFs,220
 value_object_pattern/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 value_object_pattern/decorators/__init__.py,sha256=Ze0c0z3x5sdmV-KB7nljPsybpoTXAgjJDGfR8FCIxUQ,138
 value_object_pattern/decorators/value_object_process.py,sha256=Q_0w26XolcfZOE6avveA5OGs1yIMNAVC_AxsBV8F5D0,2621
@@ -6,7 +6,7 @@ value_object_pattern/decorators/value_object_validation.py,sha256=ENAQuOLalc-dDz
 value_object_pattern/models/__init__.py,sha256=1BsXKFnX_0EufuHurfgdpbMUvnrjF8HLz46saTcmNr4,163
 value_object_pattern/models/enumeration_value_object.py,sha256=6ih7GlohDcA3Lknk6SaIsve2Udaco8iHTPkRCrhvYJo,4886
 value_object_pattern/models/value_object.py,sha256=-xXCk_qwCj_VBIzNJfUflM4vD7M0bicJdlprFYh2_Uw,13627
-value_object_pattern/usables/__init__.py,sha256=LsHh5uSECizrDXPogZC3zRMzcBIBPyiWXpqSrG2qHrg,1483
+value_object_pattern/usables/__init__.py,sha256=-VuuKrTyD8X0ImNexe3S6zcrf24o17_p1ghdb9bEyqs,1577
 value_object_pattern/usables/dates/__init__.py,sha256=fGcL0u-dpxruMAWP-As1-ZUr-982SK1vb3sjnYyJh5g,382
 value_object_pattern/usables/dates/date/__init__.py,sha256=rSifr41n8gmqW80e0Ygzoj221dpVsZy7m4TecC_VJus,174
 value_object_pattern/usables/dates/date/date_value_object.py,sha256=f2JuxEJlZaMRMPq53qtDnFLxNC-uJLZJwt31_lVetqo,5054
@@ -38,7 +38,7 @@ value_object_pattern/usables/internet/uri/http_https_url_value_object.py,sha256=
 value_object_pattern/usables/internet/uri/http_url_value_object.py,sha256=nU1IjKRmYAV2JWe-Fvji_PGti5qM540OWHf_qtDLiGw,1033
 value_object_pattern/usables/internet/uri/https_url_value_object.py,sha256=SpbIvKHn2kgXVSsxpa7dk5FEr7RwDsgjpSGqPfxl7rU,1048
 value_object_pattern/usables/internet/uri/url_value_object.py,sha256=03jHtGBCPjqhbGkSXtb8qoIv5QUF3ze-cC27-kEIWqA,12419
-value_object_pattern/usables/primitives/__init__.py,sha256=j4AatSdlRIUyQlwZuKMtGhtzgTI4F3lQXw1cC38--2w,1304
+value_object_pattern/usables/primitives/__init__.py,sha256=qA0M7r8cFRbe-eX756KYmHKp8OAaGVBqdDVAQeWYKzo,1407
 value_object_pattern/usables/primitives/boolean/__init__.py,sha256=WhOVH2JAoQnhevx9pW1OsJh-nUF9qKpB4ZGybfSI0U4,237
 value_object_pattern/usables/primitives/boolean/boolean_value_object.py,sha256=CV8UWwQwxcMXOPfuWouePA2ce17_t0S6YxE3gH8mVj8,1380
 value_object_pattern/usables/primitives/boolean/false_value_object.py,sha256=bQRyyjYrjcAXTlStiJSC2aKpTUFWG3foASOfkMk3Kwo,1264
@@ -55,6 +55,9 @@ value_object_pattern/usables/primitives/integer/integer_value_object.py,sha256=J
 value_object_pattern/usables/primitives/integer/negative_integer_value_object.py,sha256=2dYhMs421Oxmt73Hmd8wa2_Er9fNTlGdiuLtf3JasNM,1410
 value_object_pattern/usables/primitives/integer/odd_integer_value_object.py,sha256=fiFJlPJf4aG9CDfyUpxkGqsBPMQuRQuKA7bAZUDz8Fo,1345
 value_object_pattern/usables/primitives/integer/positive_integer_value_object.py,sha256=PDaGwCnGWnARbrYfCIHcLFKJAqSQ90A_8q-6HG91L0I,1432
+value_object_pattern/usables/primitives/none/__init__.py,sha256=2dTbYS2HgP5AO6ps3HzzYmpM2zteLl0wzrmtpA0mxcw,165
+value_object_pattern/usables/primitives/none/none_value_object.py,sha256=Wjg8rojYjoYL30fZVGzFA1E68fuDA0n5v-rCUFWDXqQ,1308
+value_object_pattern/usables/primitives/none/not_none_value_object.py,sha256=8DC8ezGrm9K1aPbhXzjsbb90dzYoOA3mkqvYYorlzSQ,1262
 value_object_pattern/usables/primitives/string/__init__.py,sha256=exdLDLKtfF4QNl5XdA916JqJd-5whAVDQfQcrRrDTzc,879
 value_object_pattern/usables/primitives/string/alpha_value_object.py,sha256=-wB24ZG3LlZjKmlVZt3tfkTeDeFqdlV9cGmYpVkYgKc,1383
 value_object_pattern/usables/primitives/string/alphanumeric_value_object.py,sha256=rXDAgezOC57hPcIcZWmsleIuWPh5XNvjjr7vi02kwUw,1503
@@ -65,7 +68,7 @@ value_object_pattern/usables/primitives/string/printable_string_value_object.py,
 value_object_pattern/usables/primitives/string/string_value_object.py,sha256=6u98oMzz5qsVNEWna-UpziDmzFhaLFW7J5NBoJnbKWk,1370
 value_object_pattern/usables/primitives/string/trimmed_string_value_object.py,sha256=WMp4IBA74cEli-N_9Q7qU_oMszHtk5tgCr6o2y99HMs,1435
 value_object_pattern/usables/primitives/string/uppercase_string_value_object.py,sha256=yZajkdq09zb56_UHs4nc0sIeTV4K74ek26JcoHYhM64,1457
-value_object_pattern-0.5.0.dist-info/METADATA,sha256=0BdI5ht5bc2zuT_53nZAyC565OA99ZP5ccRUnR7Izm4,4018
-value_object_pattern-0.5.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-value_object_pattern-0.5.0.dist-info/licenses/LICENSE.md,sha256=6E0wpVdiB-k3oJ9cvVG9BPZ07yIevD3IuOECHKveFkM,1076
-value_object_pattern-0.5.0.dist-info/RECORD,,
+value_object_pattern-0.6.1.dist-info/METADATA,sha256=uv6h4WL2OfJLCw9QwC1aJv4jXds6UAA1hDEEfHYADF0,4018
+value_object_pattern-0.6.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+value_object_pattern-0.6.1.dist-info/licenses/LICENSE.md,sha256=6E0wpVdiB-k3oJ9cvVG9BPZ07yIevD3IuOECHKveFkM,1076
+value_object_pattern-0.6.1.dist-info/RECORD,,