maleo-identity 0.0.96__py3-none-any.whl → 0.0.99__py3-none-any.whl

maleo/identity/schemas/user_organization_role.py

@@ -0,0 +1,181 @@
+from pydantic import BaseModel, Field
+from typing import Generic, Literal, Tuple, TypeVar, overload
+from uuid import UUID
+from maleo.enums.organization import (
+    OrganizationRole,
+    OptOrganizationRole,
+    FullOrganizationRoleMixin,
+    OptListOfOrganizationRoles,
+    FullOrganizationRolesMixin,
+)
+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 (
+    IdentifierTypeValue,
+    Ids,
+    UUIDs,
+    IntUserId,
+    IntUserIds,
+    IntOrganizationId,
+    IntOrganizationIds,
+)
+from maleo.schemas.mixins.sort import convert as convert_sort
+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 OptInt, OptListOfInts
+from maleo.types.uuid import OptListOfUUIDs
+from ..enums.user_organization_role import IdentifierType
+from ..types.user_organization_role import IdentifierValueType
+
+
+class CreateParameter(
+    FullOrganizationRoleMixin[OrganizationRole],
+    IntOrganizationId[int],
+    IntUserId[int],
+):
+    pass
+
+
+class ReadMultipleParameter(
+    ReadPaginatedMultipleParameter,
+    FullOrganizationRolesMixin[OptListOfOrganizationRoles],
+    IntOrganizationIds[OptListOfInts],
+    IntUserIds[OptListOfInts],
+    UUIDs[OptListOfUUIDs],
+    Ids[OptListOfInts],
+):
+    @property
+    def _query_param_fields(self) -> set[str]:
+        return {
+            "ids",
+            "uuids",
+            "statuses",
+            "user_ids",
+            "organization_ids",
+            "organization_roles",
+            "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[IdentifierType, IdentifierValueType]):
+    @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.COMPOSITE],
+        identifier_value: Tuple[int, int, OrganizationRole],
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        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_type=identifier_type,
+            identifier_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 FullUpdateData(
+    FullOrganizationRoleMixin[OrganizationRole],
+    IntOrganizationId[int],
+    IntUserId[int],
+):
+    pass
+
+
+class PartialUpdateData(
+    FullOrganizationRoleMixin[OptOrganizationRole],
+    IntOrganizationId[OptInt],
+    IntUserId[OptInt],
+):
+    pass
+
+
+UpdateDataT = TypeVar("UpdateDataT", FullUpdateData, PartialUpdateData)
+
+
+class UpdateDataMixin(BaseModel, Generic[UpdateDataT]):
+    data: UpdateDataT = Field(..., description="Update data")
+
+
+class UpdateParameter(
+    UpdateDataMixin[UpdateDataT],
+    IdentifierTypeValue[
+        IdentifierType,
+        IdentifierValueType,
+    ],
+    Generic[UpdateDataT],
+):
+    pass
+
+
+class StatusUpdateParameter(
+    BaseStatusUpdateParameter[IdentifierType, IdentifierValueType],
+):
+    pass
+
+
+class DeleteSingleParameter(
+    BaseDeleteSingleParameter[IdentifierType, IdentifierValueType]
+):
+    pass

maleo/identity/schemas/user_profile.py

@@ -1,13 +1,29 @@
 from pydantic import BaseModel, Field
-from typing import Generic, Literal, TypeVar, overload
+from typing import Annotated, Generic, Literal, TypeVar, overload
 from uuid import UUID
-from maleo.enums.identity import OptBloodType, BloodTypeMixin, OptGender, GenderMixin
+from maleo.enums.identity import (
+    OptBloodType,
+    BloodTypeMixin,
+    OptListOfBloodTypes,
+    BloodTypesMixin,
+    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 IdentifierTypeValue, Ids, UUIDs, IntUserId
+from maleo.schemas.mixins.identity import (
+    IdentifierTypeValue,
+    Ids,
+    UUIDs,
+    IntUserId,
+    IntOrganizationIds,
+    BirthDate,
+)
 from maleo.schemas.mixins.sort import convert as convert_sort
 from maleo.schemas.parameter import (
     ReadSingleParameter as BaseReadSingleParameter,
@@ -20,22 +36,29 @@ from maleo.types.dict import StrToAnyDict
 from maleo.types.integer import OptListOfInts
 from maleo.types.string import OptStr
 from maleo.types.uuid import OptListOfUUIDs
-from ..enums.user_profile import IdentifierType
-from ..mixins.user_profile import (
+from ..enums.user_profile import IdentifierType, OptListOfExpandableFields
+from ..mixins.common import (
     IdCard,
+    FullName,
+    BirthPlace,
+)
+from ..mixins.user_profile import (
     LeadingTitle,
     FirstName,
     MiddleName,
     LastName,
     EndingTitle,
-    FullName,
-    BirthPlace,
-    BirthDate,
     AvatarName,
 )
 from ..types.user_profile import IdentifierValueType
 
 
+class Expand(BaseModel):
+    expand: Annotated[
+        OptListOfExpandableFields, Field(None, description="Expand", min_length=1)
+    ] = None
+
+
 class CoreCreateData(
     BloodTypeMixin[OptBloodType],
     GenderMixin[OptGender],
@@ -76,21 +99,47 @@ class InsertData(
     pass
 
 
+class CreateParameter(
+    AvatarName[str],
+    BloodTypeMixin[OptBloodType],
+    GenderMixin[OptGender],
+    BirthDate[OptDate],
+    BirthPlace[OptStr],
+    FullName[str],
+    EndingTitle[OptStr],
+    LastName[str],
+    MiddleName[OptStr],
+    FirstName[str],
+    LeadingTitle[OptStr],
+    IdCard[OptStr],
+    IntUserId[int],
+):
+    pass
+
+
 class ReadMultipleParameter(
+    Expand,
     ReadPaginatedMultipleParameter,
+    BloodTypesMixin[OptListOfBloodTypes],
+    GendersMixin[OptListOfGenders],
     UUIDs[OptListOfUUIDs],
     Ids[OptListOfInts],
+    IntOrganizationIds[OptListOfInts],
 ):
     @property
     def _query_param_fields(self) -> set[str]:
         return {
+            "organization_ids",
             "ids",
             "uuids",
             "statuses",
+            "genders",
+            "blood_types",
             "search",
             "page",
             "limit",
             "use_cache",
+            "expand",
         }
 
     def to_query_params(self) -> StrToAnyDict:
@@ -103,7 +152,9 @@ class ReadMultipleParameter(
         return params
 
 
-class ReadSingleParameter(BaseReadSingleParameter[IdentifierType, IdentifierValueType]):
+class ReadSingleParameter(
+    Expand, BaseReadSingleParameter[IdentifierType, IdentifierValueType]
+):
     @overload
     @classmethod
     def new(
@@ -112,6 +163,7 @@ class ReadSingleParameter(BaseReadSingleParameter[IdentifierType, IdentifierValu
         identifier_value: int,
         statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
         use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
     ) -> "ReadSingleParameter": ...
     @overload
     @classmethod
@@ -121,6 +173,7 @@ class ReadSingleParameter(BaseReadSingleParameter[IdentifierType, IdentifierValu
         identifier_value: UUID,
         statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
         use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
     ) -> "ReadSingleParameter": ...
     @overload
     @classmethod
@@ -130,6 +183,7 @@ class ReadSingleParameter(BaseReadSingleParameter[IdentifierType, IdentifierValu
         identifier_value: str,
         statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
         use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
     ) -> "ReadSingleParameter": ...
     @classmethod
     def new(
@@ -138,17 +192,19 @@ class ReadSingleParameter(BaseReadSingleParameter[IdentifierType, IdentifierValu
         identifier_value: IdentifierValueType,
         statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
         use_cache: bool = True,
+        expand: OptListOfExpandableFields = None,
     ) -> "ReadSingleParameter":
         return cls(
             identifier_type=identifier_type,
             identifier_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"}, exclude_none=True
+            mode="json", include={"statuses", "use_cache", "expand"}, exclude_none=True
         )
 
 
@@ -190,6 +246,7 @@ class UpdateDataMixin(BaseModel, Generic[UpdateDataT]):
 
 
 class UpdateParameter(
+    Expand,
     UpdateDataMixin[UpdateDataT],
     IdentifierTypeValue[
         IdentifierType,
@@ -201,6 +258,7 @@ class UpdateParameter(
 
 
 class StatusUpdateParameter(
+    Expand,
     BaseStatusUpdateParameter[IdentifierType, IdentifierValueType],
 ):
     pass

maleo/identity/schemas/user_system_role.py

@@ -0,0 +1,174 @@
+from pydantic import BaseModel, Field
+from typing import Generic, Literal, Tuple, TypeVar, overload
+from uuid import UUID
+from maleo.enums.system import (
+    SystemRole,
+    OptSystemRole,
+    FullSystemRoleMixin,
+    OptListOfSystemRoles,
+    FullSystemRolesMixin,
+)
+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 (
+    IdentifierTypeValue,
+    Ids,
+    UUIDs,
+    IntUserId,
+    IntUserIds,
+)
+from maleo.schemas.mixins.sort import convert as convert_sort
+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 OptInt, OptListOfInts
+from maleo.types.uuid import OptListOfUUIDs
+from ..enums.user_system_role import IdentifierType
+from ..types.user_system_role import IdentifierValueType
+
+
+class CreateParameter(
+    FullSystemRoleMixin[SystemRole],
+    IntUserId[int],
+):
+    pass
+
+
+class ReadMultipleParameter(
+    ReadPaginatedMultipleParameter,
+    FullSystemRolesMixin[OptListOfSystemRoles],
+    IntUserIds[OptListOfInts],
+    UUIDs[OptListOfUUIDs],
+    Ids[OptListOfInts],
+):
+    @property
+    def _query_param_fields(self) -> set[str]:
+        return {
+            "ids",
+            "uuids",
+            "statuses",
+            "user_ids",
+            "system_roles",
+            "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[IdentifierType, IdentifierValueType]):
+    @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.COMPOSITE],
+        identifier_value: Tuple[int, SystemRole],
+        statuses: ListOfDataStatuses = list(FULL_DATA_STATUSES),
+        use_cache: bool = True,
+    ) -> "ReadSingleParameter": ...
+    @overload
+    @classmethod
+    def new(
+        cls,
+        identifier_type: IdentifierType,
+        identifier_value: IdentifierValueType,
+        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_type=identifier_type,
+            identifier_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 FullUpdateData(
+    FullSystemRoleMixin[SystemRole],
+    IntUserId[int],
+):
+    pass
+
+
+class PartialUpdateData(
+    FullSystemRoleMixin[OptSystemRole],
+    IntUserId[OptInt],
+):
+    pass
+
+
+UpdateDataT = TypeVar("UpdateDataT", FullUpdateData, PartialUpdateData)
+
+
+class UpdateDataMixin(BaseModel, Generic[UpdateDataT]):
+    data: UpdateDataT = Field(..., description="Update data")
+
+
+class UpdateParameter(
+    UpdateDataMixin[UpdateDataT],
+    IdentifierTypeValue[
+        IdentifierType,
+        IdentifierValueType,
+    ],
+    Generic[UpdateDataT],
+):
+    pass
+
+
+class StatusUpdateParameter(
+    BaseStatusUpdateParameter[IdentifierType, IdentifierValueType],
+):
+    pass
+
+
+class DeleteSingleParameter(
+    BaseDeleteSingleParameter[IdentifierType, IdentifierValueType]
+):
+    pass

maleo/identity/types/api_key.py

@@ -0,0 +1,7 @@
+from typing import Tuple
+from uuid import UUID
+from maleo.types.integer import OptInt
+
+
+CompositeIdentifier = Tuple[int, OptInt]
+IdentifierValueType = int | UUID | str | CompositeIdentifier

maleo/identity/types/organization.py

@@ -1,5 +1,4 @@
-from typing import Union
 from uuid import UUID
 
 
-IdentifierValueType = Union[int, UUID, str]
+IdentifierValueType = int | UUID | str

maleo/identity/types/organization_registration_code.py

@@ -1,5 +1,4 @@
-from typing import Union
 from uuid import UUID
 
 
-IdentifierValueType = Union[int, UUID, str]
+IdentifierValueType = int | UUID | str

maleo/identity/types/organization_relation.py

@@ -0,0 +1,7 @@
+from typing import Tuple
+from uuid import UUID
+from maleo.enums.organization import OrganizationRelation
+
+
+CompositeIdentifier = Tuple[int, int, OrganizationRelation]
+IdentifierValueType = int | UUID | CompositeIdentifier

maleo/identity/types/patient.py

@@ -0,0 +1,4 @@
+from uuid import UUID
+
+
+IdentifierValueType = int | UUID | str

maleo/identity/types/user.py

@@ -1,5 +1,4 @@
-from typing import Union
 from uuid import UUID
 
 
-IdentifierValueType = Union[int, UUID, str]
+IdentifierValueType = int | UUID | str

maleo/identity/types/user_medical_role.py

@@ -0,0 +1,7 @@
+from typing import Tuple
+from uuid import UUID
+from maleo.enums.medical import MedicalRole
+
+
+CompositeIdentifier = Tuple[int, int, MedicalRole]
+IdentifierValueType = int | UUID | CompositeIdentifier

maleo/identity/types/user_organization_role.py

@@ -0,0 +1,7 @@
+from typing import Tuple
+from uuid import UUID
+from maleo.enums.organization import OrganizationRole
+
+
+CompositeIdentifier = Tuple[int, int, OrganizationRole]
+IdentifierValueType = int | UUID | CompositeIdentifier

maleo/identity/types/user_profile.py

@@ -1,5 +1,4 @@
-from typing import Union
 from uuid import UUID
 
 
-IdentifierValueType = Union[int, UUID, str]
+IdentifierValueType = int | UUID | str

maleo/identity/types/user_system_role.py

@@ -0,0 +1,7 @@
+from typing import Tuple
+from uuid import UUID
+from maleo.enums.system import SystemRole
+
+
+CompositeIdentifier = Tuple[int, SystemRole]
+IdentifierValueType = int | UUID | CompositeIdentifier