value-object-pattern 1.27.0__tar.gz → 1.28.0__tar.gz

{value_object_pattern-1.27.0 → value_object_pattern-1.28.0}/PKG-INFO

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

@@ -50,7 +50,6 @@ Issues = 'https://github.com/adriamontoto/value-object-pattern/issues'
 
 
 [dependency-groups]
-audit = ['pip-audit>=2.9.0']
 coverage = ['coverage[toml]>=7.0.0', 'smokeshow>=0.5.0']
 develop = ['pre-commit>=3.0.0']
 format = ['ruff>=0.11.10']
@@ -69,7 +68,6 @@ test = [
 ]
 types = ['types-python-dateutil>=2.9.0.20241206']
 all = [
-    { include-group = 'audit' },
     { include-group = 'coverage' },
     { include-group = 'develop' },
     { include-group = 'format' },

{value_object_pattern-1.27.0 → value_object_pattern-1.28.0}/value_object_pattern/__init__.py

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

{value_object_pattern-1.27.0 → value_object_pattern-1.28.0}/value_object_pattern/usables/__init__.py

@@ -19,6 +19,7 @@ from .primitives import (
     NotEmptyStringValueObject,
     NotNoneValueObject,
     OddIntegerValueObject,
+    PascalCaseStringValueObject,
     PositiveFloatValueObject,
     PositiveIntegerValueObject,
     PositiveOrZeroFloatValueObject,
@@ -55,6 +56,7 @@ __all__ = (
     'NotEmptyStringValueObject',
     'NotNoneValueObject',
     'OddIntegerValueObject',
+    'PascalCaseStringValueObject',
     'PositiveFloatValueObject',
     'PositiveIntegerValueObject',
     'PositiveOrZeroFloatValueObject',

{value_object_pattern-1.27.0 → value_object_pattern-1.28.0}/value_object_pattern/usables/internet/utils/tld_domains.txt

@@ -1,4 +1,4 @@
-# This file was automatically updated using "update_lists.py" on 2026-02-15T03:55:23.881612+00:00
+# This file was automatically updated using "update_lists.py" on 2026-04-19T04:07:29.141154+00:00
 
 aaa
 aarp
@@ -742,6 +742,7 @@ meme
 memorial
 men
 menu
+merck
 merckmsd
 mg
 mh

{value_object_pattern-1.27.0 → value_object_pattern-1.28.0}/value_object_pattern/usables/primitives/__init__.py

@@ -25,6 +25,7 @@ from .string import (
     KebabCaseStringValueObject,
     LowercaseStringValueObject,
     NotEmptyStringValueObject,
+    PascalCaseStringValueObject,
     PrintableStringValueObject,
     ScreamingSnakeCaseStringValueObject,
     SnakeCaseStringValueObject,
@@ -54,6 +55,7 @@ __all__ = (
     'NotEmptyStringValueObject',
     'NotNoneValueObject',
     'OddIntegerValueObject',
+    'PascalCaseStringValueObject',
     'PositiveFloatValueObject',
     'PositiveIntegerValueObject',
     'PositiveOrZeroFloatValueObject',

{value_object_pattern-1.27.0 → value_object_pattern-1.28.0}/value_object_pattern/usables/primitives/string/__init__.py

@@ -5,6 +5,7 @@ from .digit_value_object import DigitStringValueObject
 from .kebab_case_string_value_object import KebabCaseStringValueObject
 from .lowercase_string_value_object import LowercaseStringValueObject
 from .non_empty_string_value_object import NotEmptyStringValueObject
+from .pascal_case_string_value_object import PascalCaseStringValueObject
 from .printable_string_value_object import PrintableStringValueObject
 from .screaming_snake_case_string_value_object import ScreamingSnakeCaseStringValueObject
 from .snake_case_string_value_object import SnakeCaseStringValueObject
@@ -20,6 +21,7 @@ __all__ = (
     'KebabCaseStringValueObject',
     'LowercaseStringValueObject',
     'NotEmptyStringValueObject',
+    'PascalCaseStringValueObject',
     'PrintableStringValueObject',
     'ScreamingSnakeCaseStringValueObject',
     'SnakeCaseStringValueObject',

value_object_pattern-1.28.0/value_object_pattern/usables/primitives/string/pascal_case_string_value_object.py

@@ -0,0 +1,55 @@
+"""
+PascalCaseStringValueObject value object.
+"""
+
+from re import Pattern, compile as re_compile
+from typing import NoReturn
+
+from value_object_pattern.decorators import validation
+
+from .non_empty_string_value_object import NotEmptyStringValueObject
+from .trimmed_string_value_object import TrimmedStringValueObject
+
+
+class PascalCaseStringValueObject(NotEmptyStringValueObject, TrimmedStringValueObject):
+    """
+    PascalCaseStringValueObject value object ensures the provided value is PascalCase.
+
+    Example:
+    ```python
+    from value_object_pattern.usables import PascalCaseStringValueObject
+
+    string = PascalCaseStringValueObject(value='Abcd1234Word')
+
+    print(repr(string))
+    # >>> PascalCaseStringValueObject(value='Abcd1234Word')
+    ```
+    """
+
+    _VALIDATION_REGEX: Pattern[str] = re_compile(pattern=r'^[A-Z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$')
+
+    @validation(order=0)
+    def _ensure_value_is_pascal_case(self, value: str) -> None:
+        """
+        Ensures the value object `value` is PascalCase.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not PascalCase.
+        """
+        if not self._VALIDATION_REGEX.fullmatch(string=value):
+            self._raise_value_is_not_pascal_case(value=value)
+
+    def _raise_value_is_not_pascal_case(self, value: str) -> NoReturn:
+        """
+        Raises a ValueError if the value object `value` is PascalCase.
+
+        Args:
+            value (str): The provided value.
+
+        Raises:
+            ValueError: If the `value` is not PascalCase.
+        """
+        raise ValueError(f'PascalCaseStringValueObject value <<<{value}>>> has invalid format. Only PascalCase strings starting with an uppercase letter and continuing with alphanumeric words are allowed.')  # noqa: E501  # fmt: skip