maleo-metadata-client 0.0.20__py3-none-any.whl → 0.0.22__py3-none-any.whl

maleo/metadata/client/manager.py

@@ -4,6 +4,7 @@ from .services.blood_type import BloodTypeClientService
 from .services.gender import GenderClientService
 from .services.medical_role import MedicalRoleClientService
 from .services.medical_service import MedicalServiceClientService
+from .services.organization_role import OrganizationRoleClientService
 from .services.organization_type import OrganizationTypeClientService
 from .services.service import ServiceClientService
 from .services.system_role import SystemRoleClientService
@@ -44,6 +45,14 @@ class MaleoMetadataClientManager(MaleoClientManager[MaleoMetadataClientConfig]):
             private_key=self._private_key,
             redis=self._redis,
         )
+        self.organization_role = OrganizationRoleClientService(
+            application_context=self._application_context,
+            config=self._config,
+            logger=self._logger,
+            http_client_manager=self._http_client_manager,
+            private_key=self._private_key,
+            redis=self._redis,
+        )
         self.organization_type = OrganizationTypeClientService(
             application_context=self._application_context,
             config=self._config,

maleo/metadata/client/services/organization_role.py

@@ -0,0 +1,304 @@
+import json
+from copy import deepcopy
+from datetime import datetime, timezone
+from typing import Literal, overload
+from uuid import UUID
+from maleo.client.maleo.config import MaleoMetadataClientConfig
+from maleo.client.maleo.service import MaleoClientService
+from maleo.database.enums import Connection
+from maleo.database.utils import build_cache_key
+from maleo.enums.cardinality import Cardinality
+from maleo.enums.connection import Header
+from maleo.logging.enums import Level
+from maleo.metadata.constants.organization_role import ORGANIZATION_ROLE_RESOURCE
+from maleo.metadata.schemas.organization_role import (
+    ReadMultipleParameter,
+    ReadSingleParameter,
+    StandardOrganizationRoleSchema,
+    FullOrganizationRoleSchema,
+)
+from maleo.metadata.enums.organization_role import Granularity, IdentifierType
+from maleo.metadata.utils.organization_role import get_schema_model
+from maleo.schemas.connection import ConnectionContext
+from maleo.schemas.exception.factory import Factory as MaleoExceptionFactory
+from maleo.schemas.operation.action.resource import ReadResourceOperationAction
+from maleo.schemas.operation.enums import OperationType, Target
+from maleo.schemas.operation.mixins import Timestamp
+from maleo.schemas.operation.resource import (
+    ReadMultipleResourceOperation,
+    ReadSingleResourceOperation,
+)
+from maleo.schemas.pagination import StrictPagination
+from maleo.schemas.response import (
+    MultipleDataResponse,
+    ReadMultipleDataResponse,
+    SingleDataResponse,
+    ReadSingleDataResponse,
+)
+from maleo.schemas.security.authorization import (
+    OptAnyAuthorization,
+    AnyAuthorization,
+    Factory as AuthorizationFactory,
+)
+from maleo.schemas.security.impersonation import OptImpersonation
+from maleo.types.dict import OptStrToStrDict
+from maleo.utils.merger import merge_dicts
+
+
+class OrganizationRoleClientService(MaleoClientService[MaleoMetadataClientConfig]):
+    resource = ORGANIZATION_ROLE_RESOURCE
+
+    @overload
+    async def read(
+        self,
+        cardinality: Literal[Cardinality.MULTIPLE],
+        granularity: Literal[Granularity.STANDARD],
+        *,
+        operation_id: UUID,
+        resource_operation_action: ReadResourceOperationAction,
+        connection_context: ConnectionContext,
+        authorization: AnyAuthorization,
+        impersonation: OptImpersonation = None,
+        parameters: ReadMultipleParameter,
+        headers: OptStrToStrDict = None,
+    ) -> ReadMultipleDataResponse[StandardOrganizationRoleSchema, StrictPagination, None]: ...
+    @overload
+    async def read(
+        self,
+        cardinality: Literal[Cardinality.MULTIPLE],
+        granularity: Literal[Granularity.FULL],
+        *,
+        operation_id: UUID,
+        resource_operation_action: ReadResourceOperationAction,
+        connection_context: ConnectionContext,
+        authorization: AnyAuthorization,
+        impersonation: OptImpersonation = None,
+        parameters: ReadMultipleParameter,
+        headers: OptStrToStrDict = None,
+    ) -> ReadMultipleDataResponse[FullOrganizationRoleSchema, StrictPagination, None]: ...
+    @overload
+    async def read(
+        self,
+        cardinality: Literal[Cardinality.SINGLE],
+        granularity: Literal[Granularity.STANDARD],
+        *,
+        operation_id: UUID,
+        resource_operation_action: ReadResourceOperationAction,
+        connection_context: ConnectionContext,
+        authorization: AnyAuthorization,
+        impersonation: OptImpersonation = None,
+        parameters: ReadSingleParameter,
+        headers: OptStrToStrDict = None,
+    ) -> ReadSingleDataResponse[StandardOrganizationRoleSchema, None]: ...
+    @overload
+    async def read(
+        self,
+        cardinality: Literal[Cardinality.SINGLE],
+        granularity: Literal[Granularity.FULL],
+        *,
+        operation_id: UUID,
+        resource_operation_action: ReadResourceOperationAction,
+        connection_context: ConnectionContext,
+        authorization: AnyAuthorization,
+        impersonation: OptImpersonation = None,
+        parameters: ReadSingleParameter,
+        headers: OptStrToStrDict = None,
+    ) -> ReadSingleDataResponse[FullOrganizationRoleSchema, None]: ...
+    async def read(
+        self,
+        cardinality: Cardinality,
+        granularity: Granularity,
+        *,
+        operation_id: UUID,
+        resource_operation_action: ReadResourceOperationAction,
+        connection_context: ConnectionContext,
+        authorization: OptAnyAuthorization = None,
+        impersonation: OptImpersonation = None,
+        parameters: ReadMultipleParameter | ReadSingleParameter,
+        headers: OptStrToStrDict = None,
+    ) -> (
+        ReadMultipleDataResponse[StandardOrganizationRoleSchema, StrictPagination, None]
+        | ReadMultipleDataResponse[FullOrganizationRoleSchema, StrictPagination, None]
+        | ReadSingleDataResponse[StandardOrganizationRoleSchema, None]
+        | ReadSingleDataResponse[FullOrganizationRoleSchema, None]
+    ):
+        redis_client = self._redis.manager.client.get(Connection.ASYNC)
+        data_model_cls = get_schema_model(granularity)
+
+        executed_at = datetime.now(tz=timezone.utc)
+
+        # Define arguments being used in this function
+        positional_arguments = [cardinality, granularity]
+        keyword_arguments = {
+            "authorization": (
+                authorization.model_dump(mode="json")
+                if authorization is not None
+                else None
+            ),
+            "parameters": parameters.model_dump(mode="json"),
+        }
+
+        # Define full function string
+        ext = f"({json.dumps(positional_arguments)}|{json.dumps(keyword_arguments)})"
+
+        # Define full cache_key
+        cache_key = build_cache_key(ext, namespace=self._namespace)
+
+        if parameters.use_cache:
+            # Initialize cache operation context
+            operation_context = deepcopy(self._operation_context)
+            operation_context.target.type = Target.CACHE
+
+            redis_response_str = await redis_client.get(cache_key)
+
+            if redis_response_str is not None:
+                operation_timestamp = Timestamp.completed_now(executed_at)
+                if cardinality is Cardinality.MULTIPLE:
+                    response = ReadMultipleDataResponse[
+                        data_model_cls, StrictPagination, None
+                    ].model_validate_json(redis_response_str)
+                    ReadMultipleResourceOperation[
+                        data_model_cls, StrictPagination, None
+                    ](
+                        application_context=self._application_context,
+                        id=operation_id,
+                        context=operation_context,
+                        action=resource_operation_action,
+                        resource=self.resource,
+                        timestamp=operation_timestamp,
+                        summary=f"Successfully retrieved {cardinality} {granularity} organization roles from cache",
+                        connection_context=connection_context,
+                        authentication=None,
+                        authorization=authorization,
+                        impersonation=impersonation,
+                        response=response,
+                    ).log(
+                        self._logger, Level.INFO
+                    )
+                elif cardinality is Cardinality.SINGLE:
+                    response = ReadSingleDataResponse[
+                        data_model_cls, None
+                    ].model_validate_json(redis_response_str)
+                    ReadSingleResourceOperation[data_model_cls, None](
+                        application_context=self._application_context,
+                        id=operation_id,
+                        context=operation_context,
+                        action=resource_operation_action,
+                        resource=self.resource,
+                        timestamp=operation_timestamp,
+                        summary=f"Successfully retrieved {cardinality} {granularity} organization role from cache",
+                        connection_context=connection_context,
+                        authentication=None,
+                        authorization=authorization,
+                        impersonation=impersonation,
+                        response=response,
+                    ).log(self._logger, Level.INFO)
+
+                return response  # type: ignore
+
+        operation_context = deepcopy(self._operation_context)
+        operation_context.target.type = Target.MICROSERVICE
+
+        async with self._http_client_manager.get() as http_client:
+            base_headers = {
+                Header.CONTENT_TYPE.value: "application/json",
+                Header.X_OPERATION_ID.value: str(operation_id),
+            }
+            if impersonation is not None:
+                base_headers[Header.X_USER_ID.value] = str(impersonation.user_id)
+                if impersonation.organization_id is not None:
+                    base_headers[Header.X_ORGANIZATION_ID.value] = str(
+                        impersonation.organization_id
+                    )
+
+            if headers is not None:
+                headers = merge_dicts(base_headers, headers)
+            else:
+                headers = base_headers
+
+            if authorization is not None:
+                auth = AuthorizationFactory.httpx_auth(
+                    scheme=authorization.scheme, authorization=authorization.credentials
+                )
+            else:
+                auth = None
+
+            if isinstance(parameters, ReadMultipleParameter):
+                url = f"{self._config.url}/v1/{self.resource.identifiers[-1].slug}/"
+            elif isinstance(parameters, ReadSingleParameter):
+                if parameters.identifier_type is IdentifierType.ID:
+                    url = f"{self._config.url}/v1/{self.resource.identifiers[-1].slug}/{parameters.identifier_value}"
+                else:
+                    url = f"{self._config.url}/v1/{self.resource.identifiers[-1].slug}/{parameters.identifier_type}/{parameters.identifier_value}"
+
+            params = parameters.to_query_params()
+
+            response = await http_client.get(
+                url, params=params, headers=headers, auth=auth
+            )
+
+            operation_timestamp = Timestamp.completed_now(executed_at)
+
+            if response.is_error:
+                raise MaleoExceptionFactory.from_httpx(
+                    response,
+                    operation_type=OperationType.REQUEST,
+                    application_context=self._application_context,
+                    operation_id=operation_id,
+                    operation_context=operation_context,
+                    operation_action=resource_operation_action,
+                    operation_timestamp=operation_timestamp,
+                    connection_context=connection_context,
+                    authentication=None,
+                    authorization=authorization,
+                    impersonation=impersonation,
+                    logger=self._logger,
+                )
+
+            if isinstance(parameters, ReadMultipleParameter):
+                validated_response = MultipleDataResponse[
+                    data_model_cls, StrictPagination, None
+                ].model_validate(response.json())
+                service_response = ReadMultipleDataResponse[
+                    data_model_cls, StrictPagination, None
+                ].new(
+                    data=validated_response.data,
+                    pagination=validated_response.pagination,
+                )
+                ReadMultipleResourceOperation[data_model_cls, StrictPagination, None](
+                    application_context=self._application_context,
+                    id=operation_id,
+                    context=operation_context,
+                    action=resource_operation_action,
+                    resource=ORGANIZATION_ROLE_RESOURCE,
+                    timestamp=operation_timestamp,
+                    summary=f"Successfully retrieved multiple {granularity} organization roles from microservice",
+                    connection_context=connection_context,
+                    authentication=None,
+                    authorization=authorization,
+                    impersonation=impersonation,
+                    response=service_response,
+                ).log(self._logger, Level.INFO)
+            elif isinstance(parameters, ReadSingleParameter):
+                validated_response = SingleDataResponse[
+                    data_model_cls, None
+                ].model_validate(response.json())
+                service_response = ReadSingleDataResponse[data_model_cls, None].new(
+                    data=validated_response.data,
+                )
+                ReadSingleResourceOperation[data_model_cls, None](
+                    application_context=self._application_context,
+                    id=operation_id,
+                    context=operation_context,
+                    action=resource_operation_action,
+                    resource=ORGANIZATION_ROLE_RESOURCE,
+                    timestamp=operation_timestamp,
+                    summary=f"Successfully retrieved single {granularity} organization role from microservice",
+                    connection_context=connection_context,
+                    authentication=None,
+                    authorization=authorization,
+                    impersonation=impersonation,
+                    response=service_response,
+                ).log(self._logger, Level.INFO)
+
+            return service_response  # type: ignore

{maleo_metadata_client-0.0.20.dist-info → maleo_metadata_client-0.0.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo-metadata-client
-Version: 0.0.20
+Version: 0.0.22
 Summary: MaleoMetadata client package
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT
@@ -17,72 +17,71 @@ Requires-Dist: cachetools>=6.2.1
 Requires-Dist: certifi>=2025.10.5
 Requires-Dist: cffi>=2.0.0
 Requires-Dist: cfgv>=3.4.0
-Requires-Dist: charset-normalizer>=3.4.3
+Requires-Dist: charset-normalizer>=3.4.4
 Requires-Dist: click>=8.3.0
 Requires-Dist: colorama>=0.4.6
-Requires-Dist: cryptography>=46.0.2
+Requires-Dist: cryptography>=46.0.3
 Requires-Dist: distlib>=0.4.0
 Requires-Dist: dnspython>=2.8.0
-Requires-Dist: elastic-transport>=9.1.0
+Requires-Dist: elastic-transport>=9.2.0
 Requires-Dist: elasticsearch>=9.1.1
-Requires-Dist: fastapi>=0.119.0
+Requires-Dist: fastapi>=0.119.1
 Requires-Dist: filelock>=3.20.0
-Requires-Dist: google-api-core>=2.26.0
+Requires-Dist: google-api-core>=2.27.0
 Requires-Dist: google-auth>=2.41.1
-Requires-Dist: google-cloud-appengine-logging>=1.6.2
-Requires-Dist: google-cloud-audit-log>=0.3.3
+Requires-Dist: google-cloud-appengine-logging>=1.7.0
+Requires-Dist: google-cloud-audit-log>=0.4.0
 Requires-Dist: google-cloud-core>=2.4.3
 Requires-Dist: google-cloud-logging>=3.12.1
 Requires-Dist: google-cloud-pubsub>=2.31.1
-Requires-Dist: google-cloud-secret-manager>=2.24.0
+Requires-Dist: google-cloud-secret-manager>=2.25.0
 Requires-Dist: google-cloud-storage>=3.4.1
 Requires-Dist: google-crc32c>=1.7.1
 Requires-Dist: google-resumable-media>=2.7.2
-Requires-Dist: googleapis-common-protos>=1.70.0
+Requires-Dist: googleapis-common-protos>=1.71.0
 Requires-Dist: greenlet>=3.2.4
-Requires-Dist: grpc-google-iam-v1>=0.14.2
-Requires-Dist: grpcio>=1.75.1
-Requires-Dist: grpcio-status>=1.75.1
+Requires-Dist: grpc-google-iam-v1>=0.14.3
+Requires-Dist: grpcio>=1.76.0
+Requires-Dist: grpcio-status>=1.76.0
 Requires-Dist: h11>=0.16.0
 Requires-Dist: httpcore>=1.0.9
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: identify>=2.6.15
 Requires-Dist: idna>=3.11
 Requires-Dist: importlib_metadata>=8.7.0
-Requires-Dist: iniconfig>=2.1.0
-Requires-Dist: maleo-client>=0.0.10
-Requires-Dist: maleo-crypto>=0.0.40
-Requires-Dist: maleo-database>=0.1.50
-Requires-Dist: maleo-enums>=0.0.40
-Requires-Dist: maleo-google>=0.1.20
-Requires-Dist: maleo-infra>=0.1.50
-Requires-Dist: maleo-logging>=0.0.40
-Requires-Dist: maleo-managers>=0.0.92
-Requires-Dist: maleo-metadata>=0.3.50
-Requires-Dist: maleo-middlewares>=0.1.20
-Requires-Dist: maleo-schemas>=0.1.50
-Requires-Dist: maleo-soma>=0.2.10
-Requires-Dist: maleo-types>=0.0.20
-Requires-Dist: maleo-utils>=0.0.40
+Requires-Dist: iniconfig>=2.3.0
+Requires-Dist: maleo-client>=0.0.14
+Requires-Dist: maleo-crypto>=0.0.44
+Requires-Dist: maleo-database>=0.1.54
+Requires-Dist: maleo-enums>=0.0.44
+Requires-Dist: maleo-google>=0.1.24
+Requires-Dist: maleo-infra>=0.1.54
+Requires-Dist: maleo-logging>=0.0.44
+Requires-Dist: maleo-metadata>=0.3.58
+Requires-Dist: maleo-middlewares>=0.1.24
+Requires-Dist: maleo-schemas>=0.1.54
+Requires-Dist: maleo-soma>=0.2.14
+Requires-Dist: maleo-types>=0.0.24
+Requires-Dist: maleo-utils>=0.0.44
 Requires-Dist: motor>=3.7.1
 Requires-Dist: mypy_extensions>=1.1.0
 Requires-Dist: nodeenv>=1.9.1
-Requires-Dist: opentelemetry-api>=1.37.0
-Requires-Dist: opentelemetry-sdk>=1.37.0
-Requires-Dist: opentelemetry-semantic-conventions>=0.58b0
+Requires-Dist: opentelemetry-api>=1.38.0
+Requires-Dist: opentelemetry-sdk>=1.38.0
+Requires-Dist: opentelemetry-semantic-conventions>=0.59b0
 Requires-Dist: packaging>=25.0
 Requires-Dist: pathspec>=0.12.1
 Requires-Dist: platformdirs>=4.5.0
 Requires-Dist: pluggy>=1.6.0
 Requires-Dist: pre_commit>=4.3.0
 Requires-Dist: proto-plus>=1.26.1
-Requires-Dist: protobuf>=6.32.1
-Requires-Dist: psutil>=7.1.0
+Requires-Dist: protobuf>=6.33.0
+Requires-Dist: psutil>=7.1.1
 Requires-Dist: pyasn1>=0.6.1
 Requires-Dist: pyasn1_modules>=0.4.2
 Requires-Dist: pycparser>=2.23
 Requires-Dist: pycryptodome>=3.23.0
-Requires-Dist: pydantic>=2.12.2
+Requires-Dist: pydantic>=2.12.3
 Requires-Dist: pydantic-settings>=2.11.0
 Requires-Dist: pydantic_core>=2.41.4
 Requires-Dist: Pygments>=2.19.2
@@ -91,9 +90,9 @@ Requires-Dist: pymongo>=4.15.3
 Requires-Dist: pytest>=8.4.2
 Requires-Dist: python-dateutil>=2.9.0.post0
 Requires-Dist: python-dotenv>=1.1.1
-Requires-Dist: pytokens>=0.1.10
+Requires-Dist: pytokens>=0.2.0
 Requires-Dist: PyYAML>=6.0.3
-Requires-Dist: redis>=6.4.0
+Requires-Dist: redis>=7.0.0
 Requires-Dist: requests>=2.32.5
 Requires-Dist: rsa>=4.9.1
 Requires-Dist: six>=1.17.0

{maleo_metadata_client-0.0.20.dist-info → maleo_metadata_client-0.0.22.dist-info}/RECORD

@@ -1,16 +1,17 @@
 maleo/metadata/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-maleo/metadata/client/manager.py,sha256=u8TgKlG5nGjGIwB8rrw4f2LkqV3h26_Tsak9F5b2TqE,3263
+maleo/metadata/client/manager.py,sha256=61HxzVwVjHmiYw7FufDP4gjsztdgqRCDuKJ_o9UEyyY,3665
 maleo/metadata/client/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 maleo/metadata/client/services/blood_type.py,sha256=3iDtiwK8GVU7XP8r0_CJ3PugA_6IZdby8H0cObjuoFc,13404
 maleo/metadata/client/services/gender.py,sha256=ymoQFu5mn_Ie9BEp589m5VH1BEjr9tR6NexAD_gtJiI,13323
 maleo/metadata/client/services/medical_role.py,sha256=np5L0EZZESQ2uPnw11lxVfVrm1BBcP7LoBMfD0omJLo,15345
 maleo/metadata/client/services/medical_service.py,sha256=ICimER6wdhAFn4D27cKQGq2AZywnx18KY83_sLqSRuc,13533
+maleo/metadata/client/services/organization_role.py,sha256=cjVvkiYqC38NTUJFXH2-tKWwTEGF_KBxY4rs3ym5CSQ,13565
 maleo/metadata/client/services/organization_type.py,sha256=UDOx7pROtgXrvBgoR5Cd2ZwF7QzxTcI5XCj-ztW-3pc,13593
 maleo/metadata/client/services/service.py,sha256=wkabWNpzrWbhZtZhTxXhklpmmFfkBpvEKUU1hLhvMUI,13346
 maleo/metadata/client/services/system_role.py,sha256=IG_h2fy_tOI_HvacVdQ7oIsFcvn0R04FbvckXQoxd_w,13427
 maleo/metadata/client/services/user_type.py,sha256=9qLyyfujoCJhH5lCNza1UDC0tRE88xS8krTjl5U0UuY,13311
-maleo_metadata_client-0.0.20.dist-info/licenses/LICENSE,sha256=aftGsecnk7TWVX-7KW94FqK4Syy6YSZ8PZEF7EcIp3M,2621
-maleo_metadata_client-0.0.20.dist-info/METADATA,sha256=6-stLdFv64YdW9de993E5IzWQLtAqHMong8U0YqjIcg,4377
-maleo_metadata_client-0.0.20.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-maleo_metadata_client-0.0.20.dist-info/top_level.txt,sha256=3Tpd1siVsfYoeI9FEOJNYnffx_shzZ3wsPpTvz5bljc,6
-maleo_metadata_client-0.0.20.dist-info/RECORD,,
+maleo_metadata_client-0.0.22.dist-info/licenses/LICENSE,sha256=aftGsecnk7TWVX-7KW94FqK4Syy6YSZ8PZEF7EcIp3M,2621
+maleo_metadata_client-0.0.22.dist-info/METADATA,sha256=lcYlDY7OIWLJ-vDjqPwpx0p0HbuDFGrTJrCNXfvLpRI,4338
+maleo_metadata_client-0.0.22.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+maleo_metadata_client-0.0.22.dist-info/top_level.txt,sha256=3Tpd1siVsfYoeI9FEOJNYnffx_shzZ3wsPpTvz5bljc,6
+maleo_metadata_client-0.0.22.dist-info/RECORD,,