Skip to content

constructor

django_spire.contrib.constructor

__all__ = ['BaseConstructor', 'BaseDjangoModelConstructor', 'ConstructorException'] module-attribute

ConstructorException

Bases: DjangoSpireException

BaseDjangoModelConstructor

Bases: BaseConstructor[TypeDjangoModel], ABC, Generic[TypeDjangoModel]

Source code in django_spire/contrib/constructor/constructor.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
def __init__(self, obj: Any = None):
    self._obj_type_name: str = str(
        list(self.__class__.__annotations__.values())[0]
    ).split('.')[-1]

    if obj is None:
        return

    self._obj_mro_type_names = [cls.__name__ for cls in obj.__class__.__mro__]

    if not self._obj_type_name in self._obj_mro_type_names:
        raise ConstructorException(
            f'{self.__class__.__name__} was instantiated with obj type "{obj.__class__.__name__}" and failed as it was expecting "{self._obj_type_name}".'
        )

    self._obj_type: type[TypeAny] = obj.__class__

    if self._obj_type is None or self._obj_type is ...:
        raise ConstructorException(
            f'{self.__class__.__name__} top class attribute must have an annotated type.')

    self.obj: TypeAny = obj

    if ABC not in self.__class__.__bases__:
        if not self._obj_is_valid:
            raise ConstructorException(f'{self._obj_type_name} failed to validate on {self.__class__.__name__}')

    self.__post_init__()

model_obj_is_created property

model_obj_is_new property

obj_class property

BaseConstructor

Bases: ABC, Generic[TypeAny]

Source code in django_spire/contrib/constructor/constructor.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
def __init__(self, obj: Any = None):
    self._obj_type_name: str = str(
        list(self.__class__.__annotations__.values())[0]
    ).split('.')[-1]

    if obj is None:
        return

    self._obj_mro_type_names = [cls.__name__ for cls in obj.__class__.__mro__]

    if not self._obj_type_name in self._obj_mro_type_names:
        raise ConstructorException(
            f'{self.__class__.__name__} was instantiated with obj type "{obj.__class__.__name__}" and failed as it was expecting "{self._obj_type_name}".'
        )

    self._obj_type: type[TypeAny] = obj.__class__

    if self._obj_type is None or self._obj_type is ...:
        raise ConstructorException(
            f'{self.__class__.__name__} top class attribute must have an annotated type.')

    self.obj: TypeAny = obj

    if ABC not in self.__class__.__bases__:
        if not self._obj_is_valid:
            raise ConstructorException(f'{self._obj_type_name} failed to validate on {self.__class__.__name__}')

    self.__post_init__()

obj = obj instance-attribute

obj_class property

__init_subclass__

Source code in django_spire/contrib/constructor/constructor.py 
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
def __init_subclass__(cls):
    super().__init_subclass__()

    if ABC not in cls.__bases__:
        if 'obj' not in cls.__annotations__:
            raise ConstructorException(
                f'{cls.__name__} must have an "obj" attribute annotated with a type.')

        # Typing Does not work properly for services if you override __get__ in the BaseService class.
        # This is a workaround and should be fixed in future versions of the python lsp.
        def __get__(self, instance, owner):

            if instance is None:
                target: cls | Any = owner()
            else:
                target: cls | Any = instance

            if issubclass(target.__class__, BaseConstructor):

                self._validate_base_service_target_or_error(target)

                return cls(getattr(target, 'obj'))

            return cls(target)

        setattr(cls, '__get__', __get__)

__post_init__

Source code in django_spire/contrib/constructor/constructor.py 
72
73
def __post_init__(self):
    pass