maleo-foundation 0.1.35__py3-none-any.whl → 0.1.37__py3-none-any.whl

maleo_foundation/managers/db.py

@@ -5,17 +5,16 @@ from sqlalchemy.engine import Engine, create_engine
 from sqlalchemy.exc import SQLAlchemyError
 from sqlalchemy.ext.declarative import DeclarativeMeta
 from sqlalchemy.orm import sessionmaker, Session, declarative_base
-from typing import Generator, Optional, Type
+from typing import Generator
 from maleo_foundation.types import BaseTypes
-from maleo_foundation.utils.logger import BaseLogger
-from maleo_foundation.db.table import BaseTable
+from maleo_foundation.utils.logging import ServiceLogger
 
 class MetadataManager:
     Base:DeclarativeMeta = declarative_base()
     metadata:MetaData = Base.metadata
 
 class SessionManager:
-    def __init__(self, logger:BaseLogger, engine:Engine):
+    def __init__(self, logger:ServiceLogger, engine:Engine):
         self._logger = logger
         self._logger.info("Initializing SessionMaker")
         self._sessionmaker:sessionmaker[Session] = sessionmaker(bind=engine, expire_on_commit=False)
@@ -62,7 +61,7 @@ class DatabaseManager:
     def __init__(
         self,
         metadata:MetaData,
-        logger:BaseLogger,
+        logger:ServiceLogger,
         url:BaseTypes.OptionalString = None
     ):
         self._metadata = metadata #* Define database metadata

maleo_foundation/managers/service.py

@@ -1,6 +1,5 @@
 import json
 import os
-import uvicorn
 from fastapi import FastAPI, APIRouter
 from fastapi.exceptions import RequestValidationError
 from starlette.exceptions import HTTPException
@@ -21,7 +20,7 @@ from maleo_foundation.middlewares.base import RequestProcessor
 from maleo_foundation.services.token import BaseTokenService
 from maleo_foundation.types import BaseTypes
 from maleo_foundation.utils.exceptions import BaseExceptions
-from maleo_foundation.utils.keyloader import load_key
+from maleo_foundation.utils.keyloader import BaseKeyLoaders
 from maleo_foundation.utils.logging import GoogleCloudLogging, ServiceLogger, MiddlewareLogger
 
 class LogConfig(BaseModel):
@@ -295,14 +294,14 @@ class ServiceManager:
     def _parse_keys(self) -> None:
         #* Parse private key
         key_type = BaseEnums.KeyType.PRIVATE
-        private = load_key(
+        private = BaseKeyLoaders.load_rsa(
             type=key_type,
             path=self._settings.PRIVATE_KEY_PATH,
             password=self._settings.KEY_PASSWORD
         )
         #* Parse public key
         key_type = BaseEnums.KeyType.PUBLIC
-        public = load_key(
+        public = BaseKeyLoaders.load_rsa(
             type=key_type,
             path=self._settings.PUBLIC_KEY_PATH
         )

maleo_foundation/middlewares/authentication.py

@@ -6,7 +6,7 @@ from typing import Tuple
 from maleo_foundation.authentication import Credentials, User
 from maleo_foundation.models.transfers.parameters.token import BaseTokenParametersTransfers
 from maleo_foundation.services.token import BaseTokenService
-from maleo_foundation.utils.extractor import extract_client_ip
+from maleo_foundation.utils.extractor import BaseExtractors
 from maleo_foundation.utils.logging import MiddlewareLogger
 
 class Backend(AuthenticationBackend):
@@ -16,7 +16,7 @@ class Backend(AuthenticationBackend):
         self._key = key
 
     async def authenticate(self, conn:HTTPConnection) -> Tuple[Credentials, User]:
-        client_ip = extract_client_ip(conn)
+        client_ip = BaseExtractors.extract_client_ip(conn)
         if "Authorization" not in conn.headers:
             self._logger.info(f"Request | IP: {client_ip} | URL: {conn.url.path} - Result | General: Header did not contain authorization")
             return Credentials(), User(authenticated=False)

maleo_foundation/middlewares/base.py

@@ -9,7 +9,7 @@ from fastapi.responses import JSONResponse
 from starlette.middleware.base import BaseHTTPMiddleware, RequestResponseEndpoint
 from typing import Awaitable, Callable, Optional, Sequence
 from maleo_foundation.models.responses import BaseResponses
-from maleo_foundation.utils.extractor import extract_client_ip
+from maleo_foundation.utils.extractor import BaseExtractors
 from maleo_foundation.utils.logging import MiddlewareLogger
 
 RequestProcessor = Callable[[Request], Awaitable[Optional[Response]]]
@@ -80,23 +80,6 @@ class BaseMiddleware(BaseHTTPMiddleware):
                 self.last_cleanup = now
                 self.logger.debug(f"Cleaned up request cache. Removed {len(inactive_ips)} inactive IPs. Current tracked IPs: {len(self.requests)}")
 
-    def _extract_client_ip(self, request:Request) -> str:
-        """Extract client IP with more robust handling of proxies"""
-        #* Check for X-Forwarded-For header (common when behind proxy/load balancer)
-        x_forwarded_for = request.headers.get("X-Forwarded-For")
-        if x_forwarded_for:
-            #* The client's IP is the first one in the list
-            ips = [ip.strip() for ip in x_forwarded_for.split(",")]
-            return ips[0]
-        
-        #* Check for X-Real-IP header (used by some proxies)
-        x_real_ip = request.headers.get("X-Real-IP")
-        if x_real_ip:
-            return x_real_ip
-            
-        #* Fall back to direct client connection
-        return request.client.host if request.client else "unknown"
-
     def _check_rate_limit(self, client_ip:str) -> bool:
         """Check if the client has exceeded their rate limit"""
         with self._lock:
@@ -179,7 +162,7 @@ class BaseMiddleware(BaseHTTPMiddleware):
         self._cleanup_old_data() #* Run periodic cleanup
         request_timestamp = datetime.now(tz=timezone.utc) #* Record the request timestamp
         start_time = time.perf_counter() #* Record the start time
-        client_ip = extract_client_ip(request) #* Get request IP with improved extraction
+        client_ip = BaseExtractors.extract_client_ip(request) #* Get request IP with improved extraction
 
         try:
             #* 1. Rate limit check

maleo_foundation/utils/__init__.py

@@ -1,13 +1,15 @@
 from __future__ import annotations
 from .formatter import BaseFormatter
-from .logger import BaseLogger
 from .exceptions import BaseExceptions
+from .extractor import BaseExtractors
+from .keyloader import BaseKeyLoaders
 from .controller import BaseControllerUtils
 from .query import BaseQueryUtils
 
 class BaseUtils:
     Formatter = BaseFormatter
-    Logger = BaseLogger
     Exceptions = BaseExceptions
+    Extractors = BaseExtractors
+    KeyLoader = BaseKeyLoaders
     Controller = BaseControllerUtils
     Query = BaseQueryUtils

maleo_foundation/utils/exceptions.py

@@ -8,7 +8,7 @@ from typing import Optional
 from maleo_foundation.models.responses import BaseResponses
 from maleo_foundation.models.transfers.results.service.general import BaseServiceGeneralResultsTransfers
 from maleo_foundation.models.transfers.results.service.query import BaseServiceQueryResultsTransfers
-from maleo_foundation.utils.logger import BaseLogger, LoggerFactory
+from maleo_foundation.utils.logging import BaseLogger
 
 class BaseExceptions:
     @staticmethod
@@ -27,15 +27,9 @@ class BaseExceptions:
     def database_exception_handler(
         operation:str,
         logger:Optional[BaseLogger] = None,
-        logger_factory:Optional[LoggerFactory] = None,
         fail_result_class:type[BaseServiceQueryResultsTransfers.Fail] = BaseServiceQueryResultsTransfers.Fail
     ):
         """Decorator to handle database-related exceptions consistently."""
-        if logger is not None and logger_factory is not None:
-            raise RuntimeError("Only one of 'logger' or 'logger_factory' should be provided, not both.")
-        if logger is None and logger_factory is None:
-            raise RuntimeError("One of 'logger' or 'logger_factory' must be provided.")
-        logger = logger or logger_factory()
         def decorator(func):
             @wraps(func)
             def wrapper(*args, **kwargs):
@@ -62,15 +56,9 @@ class BaseExceptions:
     def service_exception_handler(
         operation:str,
         logger:Optional[BaseLogger] = None,
-        logger_factory:Optional[LoggerFactory] = None,
         fail_result_class:type[BaseServiceGeneralResultsTransfers.Fail] = BaseServiceGeneralResultsTransfers.Fail
     ):
         """Decorator to handle service-related exceptions consistently."""
-        if logger is not None and logger_factory is not None:
-            raise RuntimeError("Only one of 'logger' or 'logger_factory' should be provided, not both.")
-        if logger is None and logger_factory is None:
-            raise RuntimeError("One of 'logger' or 'logger_factory' must be provided.")
-        logger = logger or logger_factory()
         def decorator(func):
             @wraps(func)
             def wrapper(*args, **kwargs):

maleo_foundation/utils/extractor.py

@@ -1,18 +1,20 @@
 from starlette.requests import HTTPConnection
 
-def extract_client_ip(conn:HTTPConnection) -> str:
-    """Extract client IP with more robust handling of proxies"""
-    #* Check for X-Forwarded-For header (common when behind proxy/load balancer)
-    x_forwarded_for = conn.headers.get("X-Forwarded-For")
-    if x_forwarded_for:
-        #* The client's IP is the first one in the list
-        ips = [ip.strip() for ip in x_forwarded_for.split(",")]
-        return ips[0]
+class BaseExtractors:
+    @staticmethod
+    def extract_client_ip(conn:HTTPConnection) -> str:
+        """Extract client IP with more robust handling of proxies"""
+        #* Check for X-Forwarded-For header (common when behind proxy/load balancer)
+        x_forwarded_for = conn.headers.get("X-Forwarded-For")
+        if x_forwarded_for:
+            #* The client's IP is the first one in the list
+            ips = [ip.strip() for ip in x_forwarded_for.split(",")]
+            return ips[0]
 
-    #* Check for X-Real-IP header (used by some proxies)
-    x_real_ip = conn.headers.get("X-Real-IP")
-    if x_real_ip:
-        return x_real_ip
+        #* Check for X-Real-IP header (used by some proxies)
+        x_real_ip = conn.headers.get("X-Real-IP")
+        if x_real_ip:
+            return x_real_ip
 
-    #* Fall back to direct client connection
-    return conn.client.host if conn.client else "unknown"
+        #* Fall back to direct client connection
+        return conn.client.host if conn.client else "unknown"

maleo_foundation/utils/keyloader.py

@@ -3,63 +3,65 @@ from cryptography.hazmat.primitives import serialization
 from typing import Optional, Union
 from maleo_foundation.enums import BaseEnums
 
-def load_key(
-    type:BaseEnums.KeyType,
-    path: Union[str, pathlib.Path],
-    password:Optional[Union[str, bytes]] = None,
-    format:BaseEnums.KeyFormatType = BaseEnums.KeyFormatType.STRING,
-) -> Union[bytes, str]:
-    """
-    Load an RSA private or public key strictly from a file.
+class BaseKeyLoaders:
+    @staticmethod
+    def load_rsa(
+        type:BaseEnums.KeyType,
+        path: Union[str, pathlib.Path],
+        password:Optional[Union[str, bytes]] = None,
+        format:BaseEnums.KeyFormatType = BaseEnums.KeyFormatType.STRING,
+    ) -> Union[bytes, str]:
+        """
+        Load an RSA private or public key strictly from a file.
 
-    Args:
-        path (str | pathlib.Path): Path to the PEM file.
-        password (str | bytes | None): Password for encrypted private keys (optional).
+        Args:
+            path (str | pathlib.Path): Path to the PEM file.
+            password (str | bytes | None): Password for encrypted private keys (optional).
 
-    Returns:
-        rsa.RSAPrivateKey | rsa.RSAPublicKey
-    """
-    if not isinstance(type, BaseEnums.KeyType):
-        raise TypeError("Invalid key type")
+        Returns:
+            rsa.RSAPrivateKey | rsa.RSAPublicKey
+        """
+        if not isinstance(type, BaseEnums.KeyType):
+            raise TypeError("Invalid key type")
 
-    file_path = pathlib.Path(path)
+        file_path = pathlib.Path(path)
 
-    if not file_path.is_file():
-        raise FileNotFoundError(f"Key file not found: {file_path}")
+        if not file_path.is_file():
+            raise FileNotFoundError(f"Key file not found: {file_path}")
 
-    if password is not None and not isinstance(password, (str, bytes)):
-        raise TypeError("Invalid passsword type")
+        if password is not None and not isinstance(password, (str, bytes)):
+            raise TypeError("Invalid passsword type")
 
-    if not isinstance(format, BaseEnums.KeyFormatType):
-        raise TypeError("Invalid key format type")
+        if not isinstance(format, BaseEnums.KeyFormatType):
+            raise TypeError("Invalid key format type")
 
-    key_data = file_path.read_bytes()
+        key_data = file_path.read_bytes()
 
-    if type == BaseEnums.KeyType.PRIVATE:
-        private_key = serialization.load_pem_private_key(
-            key_data,
-            password=password.encode() if isinstance(password, str) else password,
-        )
-        private_key_bytes = private_key.private_bytes(
-            encoding=serialization.Encoding.PEM,
-            format=serialization.PrivateFormat.PKCS8,
-            encryption_algorithm=serialization.NoEncryption()
-        )
-        if format == BaseEnums.KeyFormatType.BYTES:
-            return private_key_bytes
-        elif format == BaseEnums.KeyFormatType.STRING:
-            return private_key_bytes.decode()
+        if type == BaseEnums.KeyType.PRIVATE:
+            private_key = serialization.load_pem_private_key(
+                key_data,
+                password=password.encode() if isinstance(password, str) else password,
+            )
+            private_key_bytes = private_key.private_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PrivateFormat.PKCS8,
+                encryption_algorithm=serialization.NoEncryption()
+            )
+            if format == BaseEnums.KeyFormatType.BYTES:
+                return private_key_bytes
+            elif format == BaseEnums.KeyFormatType.STRING:
+                return private_key_bytes.decode()
 
-    elif type == BaseEnums.KeyType.PUBLIC:
-        public_key = serialization.load_pem_public_key(key_data)
-        public_key_bytes = public_key.public_bytes(
-            encoding=serialization.Encoding.PEM,
-            format=serialization.PublicFormat.SubjectPublicKeyInfo
-        )
-        if format == BaseEnums.KeyFormatType.BYTES:
-            return public_key_bytes
-        elif format == BaseEnums.KeyFormatType.STRING:
-            return public_key_bytes.decode()
+        elif type == BaseEnums.KeyType.PUBLIC:
+            public_key = serialization.load_pem_public_key(key_data)
+            public_key_bytes = public_key.public_bytes(
+                encoding=serialization.Encoding.PEM,
+                format=serialization.PublicFormat.SubjectPublicKeyInfo
+            )
+            if format == BaseEnums.KeyFormatType.BYTES:
+                return public_key_bytes
+            elif format == BaseEnums.KeyFormatType.STRING:
+                return public_key_bytes.decode()
 
-    else:
-        raise ValueError(f"Unsupported key type: {type}")
+        else:
+            raise ValueError(f"Unsupported key type: {type}")

{maleo_foundation-0.1.35.dist-info → maleo_foundation-0.1.37.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.1.35
+Version: 0.1.37
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT

{maleo_foundation-0.1.35.dist-info → maleo_foundation-0.1.37.dist-info}/RECORD

@@ -4,25 +4,6 @@ maleo_foundation/constants.py,sha256=aBmEfWlBqZxi0k-n6h2NM1YRLOjMnheEiLyQcjP-zCQ
 maleo_foundation/enums.py,sha256=uvwl3dl2r6BoJMEbtSETiLoyJubHup9Lc7VOg7w7zQo,2943
 maleo_foundation/extended_types.py,sha256=pIKt-_9tby4rmune3fmWcCW_mohaNRh_1lywBmdc-L4,301
 maleo_foundation/types.py,sha256=aKXnIgEhYGSfFqNMGLc4qIKGkINBRpkOo9R9cb2CbwI,2414
-maleo_foundation/clients/__init__.py,sha256=W8vydJYeDEi6gdmOZSBFSSDsfZJtb8C05CHErZgsZ30,188
-maleo_foundation/clients/general/__init__.py,sha256=l9eQrBeLW4aXtGU5aK3i6fD-msVR4526W7D9V8WCXIg,91
-maleo_foundation/clients/general/http.py,sha256=pObW6EaMeLDNsRZ9QJPzfhZDzcZ33kCsb-9Yfoh2MA4,1670
-maleo_foundation/clients/google/__init__.py,sha256=1uv6nF9QbATsSAcMimQOT7Y-eBljjDunBojNX6oAtS8,90
-maleo_foundation/clients/google/base.py,sha256=tdiqNNtvy-Ev_L7R4Dg9y7V14QdlbfCOQ2Mulo238aE,1141
-maleo_foundation/clients/google/secret.py,sha256=4k3pDs4HAibeCEgv8nUBADfhk2aftG9L1sfR3UxAyfE,2516
-maleo_foundation/clients/google/storage.py,sha256=smsmrjKAyxtfdqz3EzuUVx_rQeaTaYZ5VKNWCvwQ4U8,1971
-maleo_foundation/clients/google/cloud/__init__.py,sha256=WGMPxEKKdkz3XGY5dZn9E-nYhD1kv1MgRHbmVnky4zk,245
-maleo_foundation/clients/google/cloud/base.py,sha256=V_5Zdu90FQLgAfUZvlB1KojFzXNKZNIR516gjDXgaPU,1146
-maleo_foundation/clients/google/cloud/logging.py,sha256=s9T9bex0GeCPwIHrBRvilT23iyNKqJ5z50KcT76Jt5Y,2202
-maleo_foundation/clients/google/cloud/secret.py,sha256=1dua0V2FHesjltLdc1N4PF8xTXPzmcSA3sgwBzYNUtM,5853
-maleo_foundation/clients/google/cloud/storage.py,sha256=t8hAZiQj_RFhJJXE8a20WP7spNKTEFw1RK1AqurL3T8,3848
-maleo_foundation/clients/utils/__init__.py,sha256=hChEGABHH4tOFxPRcpxmlhkM9PgF18M7wXapH88hpu4,131
-maleo_foundation/clients/utils/logger.py,sha256=FMnHKV4i6xR6e8XN7kCNwTf1jhSLdJUIO7teSm5g0D4,1829
-maleo_foundation/db/__init__.py,sha256=fmvhCz4_siHfyKJujcUakKDKmuLxMhxn2w5tmfQwfcM,135
-maleo_foundation/db/engine.py,sha256=hhYjCt5IEb864H2RNlUVS7GfMzuThHKRV260Bgkhn_o,3003
-maleo_foundation/db/manager.py,sha256=nSstMJ9JBoEKTSLlz6MNf4Wuet8DLp2Pipfveg4kM1c,4663
-maleo_foundation/db/session.py,sha256=6flx_HVh4Fe3EohK2xDcyXmVAPOci1KFvhVK4wFcKtA,4736
-maleo_foundation/db/table.py,sha256=Dk5GXeO0gbBBPN2PJtZhlUx2x3vMbT4dxTBc3YLBbuc,1199
 maleo_foundation/expanded_types/__init__.py,sha256=lm_r7rxlLA0sgSTGQBMR9ZbZbVDpD7Te-UYb3oRVi1g,364
 maleo_foundation/expanded_types/client.py,sha256=To0kRXp3QTmuSu5rWKaCiTsMK9qkYiyYKYbHfw-y1fY,2396
 maleo_foundation/expanded_types/general.py,sha256=bjIBREYTS73tvS-Key7P7db82a2HHlSJ1XBAvKuYmT0,826
@@ -30,9 +11,9 @@ maleo_foundation/expanded_types/query.py,sha256=0yUG-JIVsanzB7KAkrRz_OsrhP6J0bRq
 maleo_foundation/expanded_types/service.py,sha256=q8jpKdbCbLWwH1UPQavKpVE14rC5rveduk2cFWzuhGw,2416
 maleo_foundation/expanded_types/token.py,sha256=4fRTJw6W5MYq71NksNrWNi7qYHQ4_lQwfu9WxwrMipc,355
 maleo_foundation/managers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-maleo_foundation/managers/db.py,sha256=Jf0w-9JOAG5X2quDxqqw6d2WUIX7MYGdlPGxWP0rxHs,4699
+maleo_foundation/managers/db.py,sha256=ZN0b43OgqQtk2WHKMJQ0E2TeaSEyVJ0-l4FEkrSG0Qo,4645
 maleo_foundation/managers/middleware.py,sha256=7CDXPMb28AR7J72TWOeKFxOlMypKezEtO9mr53a88B0,4032
-maleo_foundation/managers/service.py,sha256=un1rJA9YdFK-8QRDQPurBIsHtRlmaVd2Z0-Lzr2o7_c,20392
+maleo_foundation/managers/service.py,sha256=-xsghwPtqV95YcktytV7Zba_E38JkmwUPlHXcLppfkQ,20413
 maleo_foundation/managers/client/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 maleo_foundation/managers/client/base.py,sha256=lYREmEoTLShlPPXOKKiAopjefJ8nIWHCi7IvWkXXKeY,1465
 maleo_foundation/managers/client/maleo.py,sha256=NibYGdiN3EXUw5nx-tL48QAZym14GcA4BDZihGJNQ-g,4254
@@ -41,11 +22,12 @@ maleo_foundation/managers/client/google/base.py,sha256=7jCnzkBN-F8xJEfP5eopuyfRB
 maleo_foundation/managers/client/google/secret.py,sha256=E2SthMUHScIo9Cz5ICbCK7xBg16hnzKANk7--B82828,3481
 maleo_foundation/managers/client/google/storage.py,sha256=CZmbKBS4p7OCYb5MKWmGB56-Dl7gi7xXteoqpJpVH08,2748
 maleo_foundation/middlewares/__init__.py,sha256=bqE2EIFC3rWcR2AwFPR0fk2kSFfeTRzgA24GbnuT5RA,3697
-maleo_foundation/middlewares/authentication.py,sha256=j1IcNnsfVVgDL4eVPP3LARjh5rKHm2KUEfS3E3j7snc,3120
-maleo_foundation/middlewares/base.py,sha256=3OaB5F57F3epKNieoAgarYM6PimoUdUl3DgpadtVuqs,11743
+maleo_foundation/middlewares/authentication.py,sha256=mpJ4WJ25zw4SGvgpeJE9eSV3-AtK5IJtN2U8Dh9rmMk,3132
+maleo_foundation/middlewares/base.py,sha256=iGc_4JZYxE0k47Dty4aFOvpgXjQY_W_4tgqYndhq3V8,10991
 maleo_foundation/middlewares/cors.py,sha256=9uvBvY2N6Vxa9RP_YtESxcWo6Doi6uS0lzAG9iLY7Uc,2288
 maleo_foundation/models/__init__.py,sha256=AaKehO7c1HyKhoTGRmNHDddSeBXkW-_YNrpOGBu8Ms8,246
 maleo_foundation/models/responses.py,sha256=Ka9Peb1fVuQKaxyy11FVkUPtGtzyEm_9Xfe8Vla3ml0,4764
+maleo_foundation/models/table.py,sha256=Dk5GXeO0gbBBPN2PJtZhlUx2x3vMbT4dxTBc3YLBbuc,1199
 maleo_foundation/models/schemas/__init__.py,sha256=Xj8Ahsqyra-fmEaVcGPok5GOOsPQlKcknHYMvbjvENA,277
 maleo_foundation/models/schemas/general.py,sha256=hEQQPcddxMsJXMb36nqItIAfp3pqUyJOlaD7nXkNM2I,3609
 maleo_foundation/models/schemas/parameter.py,sha256=K47z2NzmTEhUiOfRiRLyRPXoQurbWsKBL7ObXAxIWRY,2100
@@ -72,17 +54,16 @@ maleo_foundation/models/transfers/results/service/controllers/__init__.py,sha256
 maleo_foundation/models/transfers/results/service/controllers/rest.py,sha256=wCuFyOTQkuBs2cqjPsWnPy0XIsCfMqGByhrSy57qp7Y,1107
 maleo_foundation/services/__init__.py,sha256=Ho5zJSA89xdGFKIwOdzjmd8sm23cIuwrqYAxCEBBTIU,120
 maleo_foundation/services/token.py,sha256=ZqRqOdGUnaSIam6-JHVdAW1UST-2EDtcVN0fpbPmXY4,1638
-maleo_foundation/utils/__init__.py,sha256=FavmL5XYGCm955EAKiWWcXYeU15p5rSzfcglpV2yI6c,387
+maleo_foundation/utils/__init__.py,sha256=eEnPPeA6la0mu7535EFEKUB02C1IO_R8JgYcohvf1qU,471
 maleo_foundation/utils/controller.py,sha256=ECzPzpw36zBAjKcWcDbUAhIJGbc6UpeypdUUX6ipXBg,6396
-maleo_foundation/utils/exceptions.py,sha256=nk3rD57fDR-D7BQkU1JEKV-Mu7FGMpLSEsqxdDZdKjU,4532
-maleo_foundation/utils/extractor.py,sha256=BOYkEiEJZTixScd_mEiLt2svKZ4gXBgD2WDlU6giI3w,718
-maleo_foundation/utils/keyloader.py,sha256=g7LYypj7UolmSgHRGXMFgVaWr55UayMdtKXR5NmB7VM,2341
-maleo_foundation/utils/logger.py,sha256=uTvzzKnGjbxRVLHbiMDw2zKKWNaCwV35sxgjDStEwNQ,3569
+maleo_foundation/utils/exceptions.py,sha256=LPPcU-6_3NbRIBZg2Nr2Ac5HF1qZJbHbMVnwfIfZg6g,3702
+maleo_foundation/utils/extractor.py,sha256=SZXVYDHWGaA-Dd1BUydwF2HHdZqexEielS4CjL0Ceng,814
+maleo_foundation/utils/keyloader.py,sha256=TOKgKLqvUV27MYkej9d_MQB9O8bOJ_WzaXlqHorkmpo,2581
 maleo_foundation/utils/logging.py,sha256=MwvZmZSA8SIdfq-knEvpYIgqnSpHcyHrZY9TVHWVHJA,9023
 maleo_foundation/utils/query.py,sha256=ODQ3adOYQNj5E2cRW9ytbjBz56nEDcnfq8mQ6YZbCCM,4375
 maleo_foundation/utils/formatter/__init__.py,sha256=iKf5YCbEdg1qKnFHyKqqcQbqAqEeRUf8mhI3v3dQoj8,78
 maleo_foundation/utils/formatter/case.py,sha256=TmvvlfzGdC_omMTB5vAa40TZBxQ3hnr-SYeo0M52Rlg,1352
-maleo_foundation-0.1.35.dist-info/METADATA,sha256=plzE197g_RRnn3THYEHohLmIL9ZZyGOwGt8dKnyiN44,3190
-maleo_foundation-0.1.35.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-maleo_foundation-0.1.35.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
-maleo_foundation-0.1.35.dist-info/RECORD,,
+maleo_foundation-0.1.37.dist-info/METADATA,sha256=G4M-2SvG4uuTt1hiIP7g0UnQmI4-SQUWbxb_OGm5tjc,3190
+maleo_foundation-0.1.37.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+maleo_foundation-0.1.37.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
+maleo_foundation-0.1.37.dist-info/RECORD,,

maleo_foundation/clients/__init__.py

@@ -1,7 +0,0 @@
-from __future__ import annotations
-from .general import BaseGeneralClients
-from .google import GoogleClients
-
-class BaseClients:
-    General = BaseGeneralClients
-    Google = GoogleClients

maleo_foundation/clients/general/__init__.py

@@ -1,4 +0,0 @@
-from .http import HTTPClientManager
-
-class BaseGeneralClients:
-    HTTP = HTTPClientManager

maleo_foundation/clients/general/http.py

@@ -1,50 +0,0 @@
-import httpx
-from contextlib import asynccontextmanager
-from typing import AsyncGenerator, Optional
-
-class HTTPClientManager:
-    client:Optional[httpx.AsyncClient] = None
-    base_url:Optional[str] = None
-
-    @classmethod
-    def initialize(cls) -> None:
-        """Initialize the HTTP client if not already initialized."""
-        if cls.client is None:
-            cls.client = httpx.AsyncClient()
-
-    @classmethod
-    async def _client_handler(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
-        """Reusable generator for client handling."""
-        if cls.client is None:
-            raise RuntimeError("Client has not been initialized. Call initialize first.")
-
-        yield cls.client
-
-    @classmethod
-    async def inject_client(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
-        return cls._client_handler()
-
-    @classmethod
-    @asynccontextmanager
-    async def get_client(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
-        """
-        Async context manager for manual HTTP client handling.
-        Supports `async with HTTPClientManager.get() as client:`
-        """
-        async for client in cls._client_handler():
-            yield client
-
-    @classmethod
-    def get_url(cls) -> str:
-        if cls.base_url is None:
-            raise RuntimeError("Base URL has not been initialized. Call initialize first.")
-        return cls.base_url
-
-    @classmethod
-    async def dispose(cls) -> None:
-        """Dispose of the HTTP client and release any resources."""
-        if cls.client is not None:
-            await cls.client.aclose()
-            cls.client = None
-        if cls.base_url is not None:
-            cls.base_url = None

maleo_foundation/clients/google/__init__.py

@@ -1,4 +0,0 @@
-from .cloud import GoogleCloudClients
-
-class GoogleClients:
-    Cloud = GoogleCloudClients

maleo_foundation/clients/google/base.py

@@ -1,32 +0,0 @@
-import os
-from google.auth import default
-from google.oauth2 import service_account
-from maleo_foundation.types import BaseTypes
-
-class GoogleClientManager:
-    def __init__(self, google_credentials_path:BaseTypes.OptionalString = None) -> None:
-        google_credentials_path = google_credentials_path or os.getenv("GOOGLE_CREDENTIALS_PATH")
-        try:
-            if google_credentials_path is not None:
-                self._credentials = service_account.Credentials.from_service_account_file(filename=google_credentials_path)
-            else:
-                self._credentials, _ = default()
-        except Exception as e:
-            raise ValueError(f"Failed to initialize credentials: {str(e)}")
-
-    @property
-    def credentials(self) -> service_account.Credentials:
-        return self._credentials
-    
-    @property
-    def name(self) -> str:
-        raise NotImplementedError()
-
-    @property
-    def client(self):
-        raise NotImplementedError()
-
-    def dispose(self) -> None:
-        """Dispose of the client and release any resources."""
-        if self._credentials is not None:
-            self._credentials = None

maleo_foundation/clients/google/cloud/__init__.py

@@ -1,8 +0,0 @@
-from .logging import GoogleCloudLogging
-from .secret import GoogleSecretManager
-from .storage import GoogleCloudStorage
-
-class GoogleCloudClients:
-    Logging = GoogleCloudLogging
-    Secret = GoogleSecretManager
-    Storage = GoogleCloudStorage

maleo_foundation/clients/google/cloud/base.py

@@ -1,32 +0,0 @@
-import os
-from google.auth import default
-from google.oauth2 import service_account
-from maleo_foundation.types import BaseTypes
-
-class GoogleCloudClientManager:
-    def __init__(self, google_credentials_path:BaseTypes.OptionalString = None) -> None:
-        google_credentials_path = google_credentials_path or os.getenv("GOOGLE_CREDENTIALS_PATH")
-        try:
-            if google_credentials_path is not None:
-                self._credentials = service_account.Credentials.from_service_account_file(filename=google_credentials_path)
-            else:
-                self._credentials, _ = default()
-        except Exception as e:
-            raise ValueError(f"Failed to initialize credentials: {str(e)}")
-
-    @property
-    def credentials(self) -> service_account.Credentials:
-        return self._credentials
-    
-    @property
-    def name(self) -> str:
-        raise NotImplementedError()
-
-    @property
-    def client(self):
-        raise NotImplementedError()
-
-    def dispose(self) -> None:
-        """Dispose of the client and release any resources."""
-        if self._credentials is not None:
-            self._credentials = None

maleo_foundation/clients/google/cloud/logging.py

@@ -1,63 +0,0 @@
-import os
-from google.auth import default
-from google.cloud.logging import Client
-from google.cloud.logging.handlers import CloudLoggingHandler
-from google.oauth2 import service_account
-from typing import Optional
-from .base import GoogleCloudClientManager
-
-class GoogleCloudLogging:
-    _client:Optional[Client] = None
-
-    @classmethod
-    def initialize(cls) -> Client:
-        """Initialize the cloud logging if not already initialized."""
-        if cls._client is None:
-            #* Setup credentials with fallback chain
-            credentials = None
-            credentials_file = os.getenv("GOOGLE_APPLICATION_CREDENTIALS")
-            try:
-                if credentials_file:
-                    credentials = service_account.Credentials.from_service_account_file(credentials_file)
-                else:
-                    credentials, _ = default()
-            except Exception as e:
-                raise ValueError(f"Failed to initialize credentials: {str(e)}")
-
-            cls._client = Client(credentials=credentials)
-            cls._client.setup_logging()
-
-    @classmethod
-    def dispose(cls) -> None:
-        """Dispose of the cloud logging and release any resources."""
-        if cls._client is not None:
-            cls._client = None
-
-    @classmethod
-    def _get_client(cls) -> Client:
-        """Retrieve the cloud logging client, initializing it if necessary."""
-        cls.initialize()
-        return cls._client
-
-    @classmethod
-    def create_handler(cls, name:str):
-        cls.initialize()
-        return CloudLoggingHandler(client=cls._client, name=name)
-
-class GoogleCloudLoggingV2(GoogleCloudClientManager):
-    def __init__(self, google_credentials_path = None) -> None:
-        super().__init__(google_credentials_path)
-        self._client = Client(credentials=self._credentials)
-        self._client.setup_logging()
-
-    @property
-    def client(self) -> Client:
-        return self._client
-
-    def dispose(self) -> None:
-        if self._client is not None:
-            self._client = None
-        return super().dispose()
-
-    def create_handler(self, name:str) -> CloudLoggingHandler:
-        return CloudLoggingHandler(client=self._client, name=name)