value-object-pattern 0.9.2__tar.gz → 0.9.3__tar.gz

{value_object_pattern-0.9.2 → value_object_pattern-0.9.3}/PKG-INFO

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

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

{value_object_pattern-0.9.2 → value_object_pattern-0.9.3}/value_object_pattern/models/base_model.py

@@ -11,6 +11,7 @@ else:
 
 from abc import ABC, abstractmethod
 from enum import Enum
+from inspect import Parameter, _empty, signature
 from typing import Any, NoReturn, Self
 
 from .value_object import ValueObject
@@ -267,6 +268,7 @@ class BaseModel(ABC):
 
         Raises:
             TypeError: If the `primitives` is not a dictionary of strings.
+            ValueError: If the `primitives` does not have all the required attributes.
 
         Returns:
             Self: Instance of the class.
@@ -297,6 +299,14 @@ class BaseModel(ABC):
         if not isinstance(primitives, dict) or not all(isinstance(key, str) for key in primitives):  # type: ignore[redundant-expr]
             cls._raise_value_is_not_dict_of_strings(value=primitives)
 
+        constructor_signature = signature(obj=cls.__init__)
+        parameters: dict[str, Parameter] = {parameter.name: parameter for parameter in constructor_signature.parameters.values() if parameter.name != 'self'}  # noqa: E501  # fmt: skip
+        missing = {name for name, parameter in parameters.items() if parameter.default is _empty and name not in primitives}  # noqa: E501  # fmt: skip
+        extra = set(primitives) - parameters.keys()
+
+        if missing or extra:
+            cls._raise_value_constructor_parameters_mismatch(primitives=set(primitives), missing=missing, extra=extra)
+
         return cls(**primitives)
 
     @classmethod
@@ -312,6 +322,30 @@ class BaseModel(ABC):
         """
         raise TypeError(f'{cls.__name__} primitives <<<{value}>>> must be a dictionary of strings. Got <<<{type(value).__name__}>>> type.')  # noqa: E501  # fmt: skip
 
+    @classmethod
+    def _raise_value_constructor_parameters_mismatch(
+        cls,
+        primitives: set[str],
+        missing: set[str],
+        extra: set[str],
+    ) -> NoReturn:
+        """
+        Raises a ValueError if the value object constructor parameters do not match the provided primitives.
+
+        Args:
+            primitives (set[str]): Set of primitives keys. Only the keys are used to not expose private attributes.
+            missing (set[str]): Set of missing parameters.
+            extra (set[str]): Set of extra parameters.
+
+        Raises:
+            ValueError: If the constructor parameters do not match the provided primitives.
+        """
+        primitives_names = ', '.join(sorted(primitives))
+        missing_names = ', '.join(sorted(missing))
+        extra_names = ', '.join(sorted(extra))
+
+        raise ValueError(f'{cls.__name__} primitives <<<{primitives_names}>>> must contain all constructor parameters. Missing parameters: <<<{missing_names}>> and extra parameters: <<<{extra_names}>>>.')  # noqa: E501  # fmt: skip
+
     def to_primitives(self) -> dict[str, Any]:
         """
         Returns the class as a dictionary of its primitives. Private attributes that start with "__" are not included,