maleo-identity 0.0.85__py3-none-any.whl → 0.1.24__py3-none-any.whl

maleo/identity/schemas/patient.py

@@ -0,0 +1,349 @@
+from datetime import date
+from pydantic import BaseModel, Field
+from typing import Annotated, Generic, Literal, TypeVar, overload
+from uuid import UUID
+from maleo.enums.identity import (
+    OptBloodType,
+    BloodTypeMixin,
+    OptListOfBloodTypes,
+    BloodTypesMixin,
+    OptRhesus,
+    RhesusMixin,
+    OptListOfRhesuses,
+    RhesusesMixin,
+    Gender,
+    OptGender,
+    GenderMixin,
+    OptListOfGenders,
+    GendersMixin,
+)
+from maleo.enums.status import (
+    ListOfDataStatuses,
+    FULL_DATA_STATUSES,
+)
+from maleo.schemas.mixins.filter import convert as convert_filter
+from maleo.schemas.mixins.identity import (
+    IdentifierMixin,
+    Ids,
+    UUIDs,
+    FullNames,
+    DateOfBirth,
+    IntUserId,
+    IntUserIds,
+    IntOrganizationId,
+    IntOrganizationIds,
+)
+from maleo.schemas.mixins.sort import convert as convert_sort
+from maleo.schemas.operation.enums import ResourceOperationStatusUpdateType
+from maleo.schemas.parameter import (
+    ReadSingleParameter as BaseReadSingleParameter,
+    ReadPaginatedMultipleParameter,
+    StatusUpdateParameter as BaseStatusUpdateParameter,
+    DeleteSingleParameter as BaseDeleteSingleParameter,
+)
+from maleo.types.datetime import OptDate
+from maleo.types.dict import StrToAnyDict
+from maleo.types.integer import OptListOfInts
+from maleo.types.string import OptStr, OptListOfStrs
+from maleo.types.uuid import OptListOfUUIDs
+from ..enums.patient import IdentifierType, OptListOfExpandableFields
+from ..mixins.common import IdCard, FullName, PlaceOfBirth
+from ..mixins.patient import PatientIdentity, PatientIdentifier, Expand
+from ..types.patient import IdentifierValueType
+
+
+class StandardCreateData(
+    RhesusMixin[OptRhesus],
+    BloodTypeMixin[OptBloodType],
+    GenderMixin[Gender],
+    DateOfBirth[date],
+    PlaceOfBirth[OptStr],
+    FullName[str],
+    PatientIdentity,
+):
+    pass
+
+
+class FullCreateData(
+    StandardCreateData,
+    IntOrganizationId[int],
+):
+    pass
+
+
+class CreateParameter(Expand, FullCreateData, IntUserId[int]):
+    pass
+
+
+class ReadMultipleParameter(
+    Expand,
+    ReadPaginatedMultipleParameter,
+    RhesusesMixin[OptListOfRhesuses],
+    BloodTypesMixin[OptListOfBloodTypes],
+    GendersMixin[OptListOfGenders],
+    FullNames[OptListOfStrs],
+    IntOrganizationIds[OptListOfInts],
+    IntUserIds[OptListOfInts],
+    UUIDs[OptListOfUUIDs],
+    Ids[OptListOfInts],
+):
+    ids: Annotated[OptListOfInts, Field(None, description="Ids")] = None
+    uuids: Annotated[OptListOfUUIDs, Field(None, description="UUIDs")] = None
+    user_ids: Annotated[OptListOfInts, Field(None, description="User's IDs")] = None
+    organization_ids: Annotated[
+        OptListOfInts, Field(None, description="Organization's IDs")
+    ] = None
+    full_names: Annotated[OptListOfStrs, Field(None, description="Full Names")] = None
+    genders: Annotated[OptListOfGenders, Field(None, description="Genders")] = None
+    blood_types: Annotated[
+        OptListOfBloodTypes, Field(None, description="Blood Types")
+    ] = None
+    rhesuses: Annotated[OptListOfRhesuses, Field(None, description="Rhesuses")] = None
+
+    @property
+    def _query_param_fields(self) -> set[str]:
+        return {
+            "ids",
+            "uuids",
+            "statuses",
+            "user_ids",
+            "organization_ids",
+            "full_names",
+            "genders",
+            "blood_types",
+            "rhesuses",
+            "search",
+            "page",
+            "limit",
+            "use_cache",
+            "expand",
+        }
+
+    def to_query_params(self) -> StrToAnyDict:
+        params = self.model_dump(
+            mode="json", include=self._query_param_fields, exclude_none=True
+        )
+        params["filters"] = convert_filter(self.date_filters)
+        params["sorts"] = convert_sort(self.sort_columns)
+        params = {k: v for k, v in params.items()}
+        return params
+
+
+class ReadSingleParameter(Expand, BaseReadSingleParameter[PatientIdentifier]):
+    @classmethod
+    def from_identifier(
+        cls,
+        identifier: PatientIdentifier,
+        statuses: ListOfDataStatuses = FULL_DATA_STATUSES,
+        use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
+    ) -> "ReadSingleParameter":
+        return cls(
+            identifier=identifier, statuses=statuses, use_cache=use_cache, expand=expand
+        )
+
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.ID],
+        identifier_value: int,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
+    ) -> "ReadSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.UUID],
+        identifier_value: UUID,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
+    ) -> "ReadSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
+    ) -> "ReadSingleParameter": ...
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
+    ) -> "ReadSingleParameter":
+        return cls(
+            identifier=PatientIdentifier(
+                type=identifier_type,
+                value=identifier_value,
+            ),
+            statuses=statuses,
+            use_cache=use_cache,
+            expand=expand,
+        )
+
+    def to_query_params(self) -> StrToAnyDict:
+        return self.model_dump(
+            mode="json", include={"statuses", "use_cache", "expand"}, exclude_none=True
+        )
+
+
+class FullUpdateData(
+    RhesusMixin[OptRhesus],
+    BloodTypeMixin[OptBloodType],
+    GenderMixin[Gender],
+    DateOfBirth[date],
+    PlaceOfBirth[OptStr],
+    FullName[str],
+    PatientIdentity,
+    IdCard[OptStr],
+):
+    pass
+
+
+class PartialUpdateData(
+    RhesusMixin[OptRhesus],
+    BloodTypeMixin[OptBloodType],
+    GenderMixin[OptGender],
+    DateOfBirth[OptDate],
+    PlaceOfBirth[OptStr],
+    FullName[OptStr],
+    PatientIdentity,
+    IdCard[OptStr],
+):
+    pass
+
+
+UpdateDataT = TypeVar("UpdateDataT", FullUpdateData, PartialUpdateData)
+
+
+class UpdateDataMixin(BaseModel, Generic[UpdateDataT]):
+    data: UpdateDataT = Field(..., description="Update data")
+
+
+class UpdateParameter(
+    Expand,
+    UpdateDataMixin[UpdateDataT],
+    IdentifierMixin[PatientIdentifier],
+    Generic[UpdateDataT],
+):
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.ID],
+        identifier_value: int,
+        data: UpdateDataT,
+        expand: OptListOfExpandableFields = None,
+    ) -> "UpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.UUID],
+        identifier_value: UUID,
+        data: UpdateDataT,
+        expand: OptListOfExpandableFields = None,
+    ) -> "UpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        data: UpdateDataT,
+        expand: OptListOfExpandableFields = None,
+    ) -> "UpdateParameter": ...
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        data: UpdateDataT,
+        expand: OptListOfExpandableFields = None,
+    ) -> "UpdateParameter":
+        return cls(
+            identifier=PatientIdentifier(type=identifier_type, value=identifier_value),
+            data=data,
+            expand=expand,
+        )
+
+
+class StatusUpdateParameter(
+    Expand,
+    BaseStatusUpdateParameter[PatientIdentifier],
+):
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.ID],
+        identifier_value: int,
+        type: ResourceOperationStatusUpdateType,
+        expand: OptListOfExpandableFields = None,
+    ) -> "StatusUpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.UUID],
+        identifier_value: UUID,
+        type: ResourceOperationStatusUpdateType,
+        expand: OptListOfExpandableFields = None,
+    ) -> "StatusUpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        type: ResourceOperationStatusUpdateType,
+        expand: OptListOfExpandableFields = None,
+    ) -> "StatusUpdateParameter": ...
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        type: ResourceOperationStatusUpdateType,
+        expand: OptListOfExpandableFields = None,
+    ) -> "StatusUpdateParameter":
+        return cls(
+            identifier=PatientIdentifier(type=identifier_type, value=identifier_value),
+            type=type,
+            expand=expand,
+        )
+
+
+class DeleteSingleParameter(BaseDeleteSingleParameter[PatientIdentifier]):
+    @overload
+    @classmethod
+    def new(
+        cls, identifier_type: Literal[IdentifierType.ID], identifier_value: int
+    ) -> "DeleteSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls, identifier_type: Literal[IdentifierType.UUID], identifier_value: UUID
+    ) -> "DeleteSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls, identifier_type: IdentifierType, identifier_value: IdentifierValueType
+    ) -> "DeleteSingleParameter": ...
+    @classmethod
+    def new(
+        cls, identifier_type: IdentifierType, identifier_value: IdentifierValueType
+    ) -> "DeleteSingleParameter":
+        return cls(
+            identifier=PatientIdentifier(type=identifier_type, value=identifier_value)
+        )

maleo/identity/schemas/user.py

@@ -0,0 +1,318 @@
+from pydantic import BaseModel, Field
+from typing import Annotated, Generic, Literal, TypeVar, overload
+from uuid import UUID
+from maleo.enums.status import (
+    ListOfDataStatuses,
+    FULL_DATA_STATUSES,
+)
+from maleo.enums.user import (
+    UserType,
+    OptUserType,
+    FullUserTypeMixin,
+    OptListOfUserTypes,
+    FullUserTypesMixin,
+)
+from maleo.schemas.mixins.filter import convert as convert_filter
+from maleo.schemas.mixins.identity import (
+    IdentifierMixin,
+    Ids,
+    UUIDs,
+    IntOrganizationIds,
+)
+from maleo.schemas.mixins.sort import convert as convert_sort
+from maleo.schemas.operation.enums import ResourceOperationStatusUpdateType
+from maleo.schemas.parameter import (
+    ReadSingleParameter as BaseReadSingleParameter,
+    ReadPaginatedMultipleParameter,
+    StatusUpdateParameter as BaseStatusUpdateParameter,
+    DeleteSingleParameter as BaseDeleteSingleParameter,
+)
+from maleo.types.dict import StrToAnyDict
+from maleo.types.integer import OptListOfInts
+from maleo.types.string import OptStr, OptListOfStrs
+from maleo.types.uuid import OptListOfUUIDs
+from ..enums.user import IdentifierType
+from ..mixins.user import (
+    Username,
+    Usernames,
+    Email,
+    Emails,
+    Phone,
+    Phones,
+    UserIdentifier,
+)
+from ..types.user import IdentifierValueType
+
+
+class CreateParameter(
+    Phone[str], Email[str], Username[str], FullUserTypeMixin[UserType]
+):
+    pass
+
+
+class ReadMultipleParameter(
+    ReadPaginatedMultipleParameter,
+    Phones[OptListOfStrs],
+    Emails[OptListOfStrs],
+    Usernames[OptListOfStrs],
+    FullUserTypesMixin[OptListOfUserTypes],
+    UUIDs[OptListOfUUIDs],
+    Ids[OptListOfInts],
+    IntOrganizationIds[OptListOfInts],
+):
+    organization_ids: Annotated[
+        OptListOfInts, Field(None, description="Organization's IDs")
+    ] = None
+    ids: Annotated[OptListOfInts, Field(None, description="Ids")] = None
+    uuids: Annotated[OptListOfUUIDs, Field(None, description="UUIDs")] = None
+    user_types: Annotated[OptListOfUserTypes, Field(None, description="User Types")] = (
+        None
+    )
+    usernames: Annotated[OptListOfStrs, Field(None, description="User's Usernames")] = (
+        None
+    )
+    emails: Annotated[OptListOfStrs, Field(None, description="User's Emails")] = None
+    phones: Annotated[OptListOfStrs, Field(None, description="User's Phones")] = None
+
+    @property
+    def _query_param_fields(self) -> set[str]:
+        return {
+            "organization_ids",
+            "ids",
+            "uuids",
+            "statuses",
+            "user_types",
+            "usernames",
+            "emails",
+            "phones",
+            "search",
+            "page",
+            "limit",
+            "use_cache",
+        }
+
+    def to_query_params(self) -> StrToAnyDict:
+        params = self.model_dump(
+            mode="json", include=self._query_param_fields, exclude_none=True
+        )
+        params["filters"] = convert_filter(self.date_filters)
+        params["sorts"] = convert_sort(self.sort_columns)
+        params = {k: v for k, v in params.items()}
+        return params
+
+
+class ReadSingleParameter(BaseReadSingleParameter[UserIdentifier]):
+    @classmethod
+    def from_identifier(
+        cls,
+        identifier: UserIdentifier,
+        statuses: ListOfDataStatuses = FULL_DATA_STATUSES,
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter":
+        return cls(identifier=identifier, statuses=statuses, use_cache=use_cache)
+
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.ID],
+        identifier_value: int,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.UUID],
+        identifier_value: UUID,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.USERNAME, IdentifierType.EMAIL],
+        identifier_value: str,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter": ...
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter":
+        return cls(
+            identifier=UserIdentifier(
+                type=identifier_type,
+                value=identifier_value,
+            ),
+            statuses=statuses,
+            use_cache=use_cache,
+        )
+
+    def to_query_params(self) -> StrToAnyDict:
+        return self.model_dump(
+            mode="json", include={"statuses", "use_cache"}, exclude_none=True
+        )
+
+
+class PasswordUpdateData(BaseModel):
+    old: Annotated[str, Field(..., description="Old Password", max_length=255)]
+    old_confirmation: Annotated[
+        str, Field(..., description="Old Password Confirmation", max_length=255)
+    ]
+    new: Annotated[str, Field(..., description="New Password", max_length=255)]
+
+
+class FullUpdateData(
+    Phone[str], Email[str], Username[str], FullUserTypeMixin[UserType]
+):
+    pass
+
+
+class PartialUpdateData(
+    Phone[OptStr], Email[OptStr], Username[OptStr], FullUserTypeMixin[OptUserType]
+):
+    pass
+
+
+UpdateDataT = TypeVar("UpdateDataT", FullUpdateData, PartialUpdateData)
+
+
+class UpdateDataMixin(BaseModel, Generic[UpdateDataT]):
+    data: UpdateDataT = Field(..., description="Update data")
+
+
+class UpdateParameter(
+    UpdateDataMixin[UpdateDataT],
+    IdentifierMixin[UserIdentifier],
+    Generic[UpdateDataT],
+):
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.ID],
+        identifier_value: int,
+        data: UpdateDataT,
+    ) -> "UpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.UUID],
+        identifier_value: UUID,
+        data: UpdateDataT,
+    ) -> "UpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.USERNAME, IdentifierType.EMAIL],
+        identifier_value: str,
+        data: UpdateDataT,
+    ) -> "UpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        data: UpdateDataT,
+    ) -> "UpdateParameter": ...
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        data: UpdateDataT,
+    ) -> "UpdateParameter":
+        return cls(
+            identifier=UserIdentifier(type=identifier_type, value=identifier_value),
+            data=data,
+        )
+
+
+class StatusUpdateParameter(
+    BaseStatusUpdateParameter[UserIdentifier],
+):
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.ID],
+        identifier_value: int,
+        type: ResourceOperationStatusUpdateType,
+    ) -> "StatusUpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.UUID],
+        identifier_value: UUID,
+        type: ResourceOperationStatusUpdateType,
+    ) -> "StatusUpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.USERNAME, IdentifierType.EMAIL],
+        identifier_value: str,
+        type: ResourceOperationStatusUpdateType,
+    ) -> "StatusUpdateParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        type: ResourceOperationStatusUpdateType,
+    ) -> "StatusUpdateParameter": ...
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        type: ResourceOperationStatusUpdateType,
+    ) -> "StatusUpdateParameter":
+        return cls(
+            identifier=UserIdentifier(type=identifier_type, value=identifier_value),
+            type=type,
+        )
+
+
+class DeleteSingleParameter(BaseDeleteSingleParameter[UserIdentifier]):
+    @overload
+    @classmethod
+    def new(
+        cls, identifier_type: Literal[IdentifierType.ID], identifier_value: int
+    ) -> "DeleteSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls, identifier_type: Literal[IdentifierType.UUID], identifier_value: UUID
+    ) -> "DeleteSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: Literal[IdentifierType.USERNAME, IdentifierType.EMAIL],
+        identifier_value: str,
+    ) -> "DeleteSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls, identifier_type: IdentifierType, identifier_value: IdentifierValueType
+    ) -> "DeleteSingleParameter": ...
+    @classmethod
+    def new(
+        cls, identifier_type: IdentifierType, identifier_value: IdentifierValueType
+    ) -> "DeleteSingleParameter":
+        return cls(
+            identifier=UserIdentifier(type=identifier_type, value=identifier_value)
+        )