fastlib-py 0.3.3__tar.gz → 0.3.5__tar.gz

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastlib-py
-Version: 0.3.3
+Version: 0.3.5
 Summary: Fastlib, high performance, easy to use, fast to code, ready for production
 Author-email: tyvekZhang <tyvekzhang@gmail.com>
 Maintainer-email: tyvekZhang <tyvekzhang@gmail.com>
@@ -10,14 +10,13 @@ Keywords: fastapi,library,sqlmodel,web
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiosqlite>=0.21

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/_logging/config.py

@@ -4,7 +4,7 @@ Log configuration and logging utility for the application.
 """
 
 from pathlib import Path
-from typing import Literal, Optional
+from typing import Literal
 
 from fastlib.config.base import BaseConfig
 from fastlib.config.manager import config_class
@@ -29,7 +29,7 @@ class LogConfig(BaseConfig):
         error_log_rotation: str = "1 day",
         error_log_retention: str = "90 days",
         enable_async: bool = True,
-        max_file_size: Optional[str] = "10 MB",
+        max_file_size: str | None = "10 MB",
         time_format: str = "YYYY-MM-DD",
         **kwargs,
     ):

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/_logging/handlers.py

@@ -5,12 +5,11 @@ A comprehensive logging tool for the application.
 
 import sys
 from pathlib import Path
-from typing import Optional
 
 from loguru import logger
 
-from fastlib.config.manager import ConfigManager
 from fastlib._logging.config import LogConfig
+from fastlib.config.manager import ConfigManager
 
 
 class Logger:
@@ -19,7 +18,7 @@ class Logger:
     """
 
     _instances: dict[str, "Logger"] = {}
-    _config: Optional[LogConfig] = None
+    _config: LogConfig | None = None
     _is_configured: bool = False
 
     @classmethod
@@ -49,7 +48,7 @@ class Logger:
     @classmethod
     def get_instance(
         cls,
-        name: Optional[str] = None,
+        name: str | None = None,
     ) -> "Logger":
         """
         Get or create a named logger instance.

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/cache/_disk_cache.py

@@ -5,7 +5,7 @@ import json
 import threading
 import time
 from contextlib import asynccontextmanager
-from typing import Any, Optional
+from typing import Any
 
 import diskcache
 
@@ -28,7 +28,7 @@ class PageCache(Cache):
         self,
         key: str,
         value: Any,
-        ex: Optional[int] = None,
+        ex: int | None = None,
         nx: bool = False,  # only set if not exists
         xx: bool = False,  # only set if exists
     ) -> bool:
@@ -38,7 +38,7 @@ class PageCache(Cache):
             return False
         return self.cache.set(key, value, expire=ex)
 
-    async def get(self, key: str) -> Optional[Any]:
+    async def get(self, key: str) -> Any | None:
         return self.cache.get(key, None)
 
     async def delete(self, *keys: str) -> int:
@@ -86,7 +86,7 @@ class PageCache(Cache):
         self.cache.set(name, data)
         return 1
 
-    async def hget(self, name: str, key: str) -> Optional[Any]:
+    async def hget(self, name: str, key: str) -> Any | None:
         data = self.cache.get(name, {})
         return data.get(key) if isinstance(data, dict) else None
 
@@ -136,7 +136,7 @@ class PageCache(Cache):
         self._set_list(name, lst)
         return len(lst)
 
-    async def lpop(self, name: str) -> Optional[Any]:
+    async def lpop(self, name: str) -> Any | None:
         lst = self._get_list(name)
         if not lst:
             return None
@@ -144,7 +144,7 @@ class PageCache(Cache):
         self._set_list(name, lst)
         return val
 
-    async def rpop(self, name: str) -> Optional[Any]:
+    async def rpop(self, name: str) -> Any | None:
         lst = self._get_list(name)
         if not lst:
             return None

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/cache/_redis_cache.py

@@ -47,7 +47,7 @@ class RedisCache(Cache):
         self,
         key: str,
         value: Any,
-        ex: Optional[int] = None,
+        ex: int | None = None,
         nx: bool = False,
         xx: bool = False,
     ) -> bool:
@@ -65,7 +65,7 @@ class RedisCache(Cache):
         except RedisError as e:
             raise CacheError(f"Failed to set key {key}", e) from e
 
-    async def get(self, key: str) -> Optional[Any]:
+    async def get(self, key: str) -> Any | None:
         """Get a value from cache."""
         try:
             return await self.redis_client.get(key)
@@ -127,7 +127,7 @@ class RedisCache(Cache):
         except RedisError as e:
             raise CacheError(f"Failed to set hash field {key} in {name}", e) from e
 
-    async def hget(self, name: str, key: str) -> Optional[Any]:
+    async def hget(self, name: str, key: str) -> Any | None:
         """Get a field from a hash."""
         try:
             return await self.redis_client.hget(name, key)
@@ -164,14 +164,14 @@ class RedisCache(Cache):
         except RedisError as e:
             raise CacheError(f"Failed to rpush values to list {name}", e) from e
 
-    async def lpop(self, name: str) -> Optional[Any]:
+    async def lpop(self, name: str) -> Any | None:
         """Pop a value from the left of a list."""
         try:
             return await self.redis_client.lpop(name)
         except RedisError as e:
             raise CacheError(f"Failed to lpop from list {name}", e) from e
 
-    async def rpop(self, name: str) -> Optional[Any]:
+    async def rpop(self, name: str) -> Any | None:
         """Pop a value from the right of a list."""
         try:
             return await self.redis_client.rpop(name)

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/cache/base.py

@@ -7,13 +7,13 @@ for different caching implementations like Redis, memory cache, etc.
 
 from abc import ABC, abstractmethod
 from contextlib import asynccontextmanager
-from typing import Any, Optional
+from typing import Any
 
 
 class CacheError(Exception):
     """Custom exception for cache-related errors."""
 
-    def __init__(self, message: str, original_error: Optional[Exception] = None):
+    def __init__(self, message: str, original_error: Exception | None = None):
         self.message = message
         self.original_error = original_error
         super().__init__(f"Cache Error: {message}")
@@ -37,7 +37,7 @@ class Cache(ABC):
         self,
         key: str,
         value: Any,
-        ex: Optional[int] = None,
+        ex: int | None = None,
         nx: bool = False,
         xx: bool = False,
     ) -> bool:
@@ -45,7 +45,7 @@ class Cache(ABC):
         pass
 
     @abstractmethod
-    async def get(self, key: str) -> Optional[Any]:
+    async def get(self, key: str) -> Any | None:
         """Get a value from cache."""
         pass
 
@@ -85,7 +85,7 @@ class Cache(ABC):
         pass
 
     @abstractmethod
-    async def hget(self, name: str, key: str) -> Optional[Any]:
+    async def hget(self, name: str, key: str) -> Any | None:
         """Get a field from a hash."""
         pass
 
@@ -110,12 +110,12 @@ class Cache(ABC):
         pass
 
     @abstractmethod
-    async def lpop(self, name: str) -> Optional[Any]:
+    async def lpop(self, name: str) -> Any | None:
         """Pop a value from the left of a list."""
         pass
 
     @abstractmethod
-    async def rpop(self, name: str) -> Optional[Any]:
+    async def rpop(self, name: str) -> Any | None:
         """Pop a value from the right of a list."""
         pass
 

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/config/loader.py

@@ -2,7 +2,7 @@
 """ConfigLoader class for loading and managing application configurations from YAML files."""
 
 import os
-from typing import Any, Optional
+from typing import Any
 
 import yaml
 from loguru import logger
@@ -12,7 +12,7 @@ from fastlib.config import utils as config_util
 
 
 class ConfigLoader:
-    def __init__(self, env: str, base_config_file: Optional[str] = None) -> None:
+    def __init__(self, env: str, base_config_file: str | None = None) -> None:
         """
         Initializes a new instance of the ConfigLoader class
 
@@ -59,7 +59,7 @@ class ConfigLoader:
             except yaml.YAMLError as e:
                 raise yaml.YAMLError(f"Error parsing YAML file {file_path}: {e}") from e
 
-    def load_config(self, environment: Optional[str] = None) -> dict[str, Any]:
+    def load_config(self, environment: str | None = None) -> dict[str, Any]:
         """
         Load the base configuration and merge with environment-specific settings.
         """

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/config/manager.py

@@ -2,7 +2,7 @@
 """Configuration loading and management with dynamic registry support."""
 
 import os
-from typing import Any, Optional
+from typing import Any
 
 from fastlib import constants as constant
 from fastlib.config import utils as config_util
@@ -38,7 +38,7 @@ def config_class(name: str):
 class ConfigManager:
     """Global configuration manager with static methods and dynamic registry support."""
 
-    _global_config_dict: Optional[dict[str, Any]] = None
+    _global_config_dict: dict[str, Any] | None = None
     _config_instances: dict[str, BaseConfig] = {}
     _initialized: bool = False
 
@@ -63,9 +63,9 @@ class ConfigManager:
 
     @staticmethod
     def initialize_global_config(
-        env: Optional[str] = None,
-        config_file: Optional[str] = None,
-        custom_configs: Optional[dict[str, Any]] = None,
+        env: str | None = None,
+        config_file: str | None = None,
+        custom_configs: dict[str, Any] | None = None,
     ) -> None:
         """
         Initialize global configuration.
@@ -136,7 +136,7 @@ class ConfigManager:
                 ) from e
 
     @staticmethod
-    def get_config_instance(config_name: str) -> Optional[BaseConfig]:
+    def get_config_instance(config_name: str) -> BaseConfig | None:
         """
         Get a specific configuration instance.
 
@@ -205,7 +205,7 @@ class ConfigManager:
         return ConfigManager._initialized
 
     @staticmethod
-    def get_config_dict() -> Optional[dict[str, Any]]:
+    def get_config_dict() -> dict[str, Any] | None:
         """
         Get the raw configuration dictionary.
 

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/config/registry.py

@@ -2,7 +2,7 @@
 """Configuration registry for dynamic configuration class management."""
 
 # Import BaseConfig from config module to avoid circular imports
-from typing import Any, Optional
+from typing import Any
 
 
 class ConfigRegistry:
@@ -36,7 +36,7 @@ class ConfigRegistry:
         cls._registry[name] = config_class
 
     @classmethod
-    def get_config_class(cls, name: str) -> Optional[type]:
+    def get_config_class(cls, name: str) -> type | None:
         """
         Get a registered configuration class.
 
@@ -49,7 +49,7 @@ class ConfigRegistry:
         return cls._registry.get(name)
 
     @classmethod
-    def create_instance(cls, name: str, config_dict: dict[str, Any]) -> Optional[Any]:
+    def create_instance(cls, name: str, config_dict: dict[str, Any]) -> Any | None:
         """
         Create an instance of a registered configuration class.
 

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/config/utils.py

@@ -3,7 +3,7 @@
 
 import configparser
 from pathlib import Path
-from typing import Any, NamedTuple, Optional
+from typing import Any, NamedTuple
 from urllib.parse import urlparse
 
 from loguru import logger
@@ -36,8 +36,8 @@ class ProjectInfo:
         self,
         name: str,
         version: str,
-        description: Optional[str] = None,
-        authors: Optional[list[str]] = None,
+        description: str | None = None,
+        authors: list[str] | None = None,
     ):
         self.name = name
         self.version = version

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/contextvars.py

@@ -6,12 +6,12 @@ the current authenticated user's ID throughout the request lifecycle.
 """
 
 from contextvars import ContextVar
-from typing import Any, Optional
+from typing import Any
 
 from loguru import logger
 
 # Type aliases for better readability
-UserID = Optional[int]
+UserID = int | None
 
 # Context variable declaration
 _current_user_id: ContextVar[UserID] = ContextVar("current_user_id", default=None)

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/exception/base.py

@@ -2,7 +2,7 @@
 """Base exception class for the application."""
 
 from http import HTTPStatus
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel
 
@@ -27,8 +27,8 @@ class BaseException(Exception):
     def __init__(
         self,
         code: ErrorDetail,
-        message: Optional[str] = None,
-        details: Optional[Any] = None,
+        message: str | None = None,
+        details: Any | None = None,
     ):
         """
         Initialize the HTTPException.
@@ -58,5 +58,5 @@ class SystemErrorCode:
 
 class SystemException(BaseException):
     code: SystemErrorCode
-    message: Optional[str] = None
-    details: Optional[Any] = None
+    message: str | None = None
+    details: Any | None = None

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/exception/exception_handler.py

@@ -4,7 +4,7 @@
 import textwrap
 import traceback
 from http import HTTPStatus
-from typing import Any, Optional
+from typing import Any
 
 from fastapi import Request
 from fastapi.exception_handlers import http_exception_handler
@@ -95,7 +95,7 @@ def build_error_response(
     exc: Exception,
     request: Request,
     status_code: int,
-    headers: Optional[dict[str, str]] = None,
+    headers: dict[str, str] | None = None,
 ) -> Response:
     """
     Build standardized error response.

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/i18n/manager.py

@@ -5,8 +5,8 @@ Internationalization context manager
 
 import contextvars
 import functools
-from collections.abc import Awaitable
-from typing import Any, Callable, TypeVar
+from collections.abc import Awaitable, Callable
+from typing import Any, TypeVar
 
 from fastlib.i18n.types import Language
 

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/i18n/messages.py

@@ -3,7 +3,6 @@
 
 import json
 from pathlib import Path
-from typing import Optional, Union
 
 from fastlib.constants import RESOURCE_DIR
 from fastlib.i18n.types import Language
@@ -17,7 +16,7 @@ TRANSLATIONS = {
 }
 
 
-def load_translations(base_dirs: Union[Path, list[Path], None] = None):
+def load_translations(base_dirs: Path | list[Path] | None = None):
     """Load translation files from specified directories.
 
     Args:
@@ -61,9 +60,7 @@ def load_translations(base_dirs: Union[Path, list[Path], None] = None):
                         TRANSLATIONS[lang.value][namespace] = translations_data
 
 
-def get_message(
-    message_type: str, key: str, language: Optional[Language] = None
-) -> str:
+def get_message(message_type: str, key: str, language: Language | None = None) -> str:
     """Get translated message for given type, key and language.
 
     Args:
@@ -80,7 +77,6 @@ def get_message(
     # Try to get message from requested language
     lang_dict = TRANSLATIONS.get(language.value, {})
     msg = lang_dict.get(message_type, {}).get(key)
-    print(f"lang_dict: {lang_dict}")
     if msg:
         return msg
 

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/i18n/types.py

@@ -84,23 +84,3 @@ class Language(Enum):
     def is_supported(cls, code: str) -> bool:
         """Check if language code is supported"""
         return code in cls.supported_codes()
-
-
-# if __name__ == "__main__":
-#     # Register new languages dynamically
-#     Language.register("es", "Spanish", "Español")
-#     Language.register("ja", "Japanese", "日本語")
-#     Language.register("ar", "Arabic", "العربية", "rtl")
-
-#     # Access new languages
-#     spanish = Language.ES
-#     print(f"Spanish code: {spanish.value}")  # es
-#     print(f"Spanish native: {spanish.native_name}")  # Español
-
-#     # Check support
-#     print(Language.is_supported("fr"))  # False
-#     print(Language.is_supported("ja"))  # True
-
-#     # Get from code
-#     japanese = Language.from_code("ja")
-#     print(japanese.display_name)  # Japanese

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/i18n/utils.py

@@ -3,8 +3,6 @@
 Internationalization utilities
 """
 
-from typing import Optional
-
 from .manager import I18nContext
 from .messages import get_message
 from .types import Language
@@ -21,12 +19,12 @@ LANGUAGE_MAPPING = {
 }
 
 
-def _resolve_language(language: Optional[Language]) -> Language:
+def _resolve_language(language: Language | None) -> Language:
     """Return given language or current context default"""
     return language or I18nContext.get_language()
 
 
-def parse_language(language_str: Optional[str]) -> Language:
+def parse_language(language_str: str | None) -> Language:
     """Parse string like 'zh-CN', 'en-US' to Language enum"""
     if not language_str:
         return DEFAULT_LANGUAGE
@@ -36,7 +34,7 @@ def parse_language(language_str: Optional[str]) -> Language:
 
 
 def get_localized_message(
-    category: str, key: str, language: Optional[Language] = None
+    category: str, key: str, language: Language | None = None
 ) -> str:
     """Get localized message by category ('error', 'success', 'business')"""
     lang = _resolve_language(language)

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/logging.py

@@ -2,6 +2,7 @@
 """
 Logging module
 """
+
 from ._logging.handlers import Logger
 
-logger = Logger.initialize()
+logger = Logger.initialize()

{fastlib_py-0.3.3 → fastlib_py-0.3.5}/fastlib/mapper/base_mapper.py

@@ -3,7 +3,7 @@
 
 from abc import ABC, abstractmethod
 from collections.abc import Sequence
-from typing import Any, Generic, Optional, TypeVar
+from typing import Any, Generic, TypeVar
 
 from pydantic import BaseModel
 from sqlmodel import SQLModel
@@ -19,7 +19,7 @@ IDType = TypeVar("IDType", int, str)
 class BaseMapper(ABC, Generic[ModelType]):
     @abstractmethod
     async def insert(
-        self, *, data: ModelType, db_session: Optional[AsyncSession] = None
+        self, *, data: ModelType, db_session: AsyncSession | None = None
     ) -> ModelType:
         """Insert a single data into the database.
 
@@ -37,7 +37,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         self,
         *,
         data_list: list[ModelType],
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
     ) -> int:
         """Insert data list into the database in a single operation.
 
@@ -52,8 +52,8 @@ class BaseMapper(ABC, Generic[ModelType]):
 
     @abstractmethod
     async def select_by_id(
-        self, *, id: IDType, db_session: Optional[AsyncSession] = None
-    ) -> Optional[ModelType]:
+        self, *, id: IDType, db_session: AsyncSession | None = None
+    ) -> ModelType | None:
         """Select a single record by its ID.
 
         Args:
@@ -67,7 +67,7 @@ class BaseMapper(ABC, Generic[ModelType]):
 
     @abstractmethod
     async def select_by_ids(
-        self, *, ids: list[IDType], db_session: Optional[AsyncSession] = None
+        self, *, ids: list[IDType], db_session: AsyncSession | None = None
     ) -> list[ModelType]:
         """Select record list by their IDs.
 
@@ -86,7 +86,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         *,
         current: IDType,
         page_size: int,
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
         **kwargs,
     ) -> tuple[list[ModelType], int]:
         """Select record list with pagination.
@@ -109,7 +109,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         current: IDType,
         page_size: int,
         sort: list[SortItem] = None,
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
         **kwargs,
     ) -> tuple[list[ModelType], int]:
         """Select record list with pagination and sorting.
@@ -133,7 +133,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         current: IDType,
         page_size: int,
         sort: list[SortItem] = None,
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
         **kwargs,
     ) -> tuple[list[ModelType], int]:
         """Select record list with pagination and sorting by parent ID.
@@ -152,7 +152,7 @@ class BaseMapper(ABC, Generic[ModelType]):
 
     @abstractmethod
     async def update_by_id(
-        self, *, data: ModelType, db_session: Optional[AsyncSession] = None
+        self, *, data: ModelType, db_session: AsyncSession | None = None
     ) -> int:
         """Update a record by its ID.
 
@@ -170,7 +170,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         self,
         *,
         data: Sequence[dict[str, Any]],
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
     ) -> int:
         """
         Update multiple records.
@@ -190,7 +190,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         *,
         ids: list[IDType],
         data: dict[str, Any],
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
     ) -> int:
         """Update record list by their IDs with the same values.
 
@@ -206,7 +206,7 @@ class BaseMapper(ABC, Generic[ModelType]):
 
     @abstractmethod
     async def delete_by_id(
-        self, *, id: IDType, db_session: Optional[AsyncSession] = None
+        self, *, id: IDType, db_session: AsyncSession | None = None
     ) -> int:
         """Delete a data by its ID.
 
@@ -221,7 +221,7 @@ class BaseMapper(ABC, Generic[ModelType]):
 
     @abstractmethod
     async def batch_delete_by_ids(
-        self, *, ids: list[IDType], db_session: Optional[AsyncSession] = None
+        self, *, ids: list[IDType], db_session: AsyncSession | None = None
     ) -> int:
         """Delete multiple data_list by their IDs.
 
@@ -242,7 +242,7 @@ class BaseMapper(ABC, Generic[ModelType]):
         schema_class: SchemaType,
         level: int = 1,
         max_level: int = 5,
-        db_session: Optional[AsyncSession] = None,
+        db_session: AsyncSession | None = None,
     ) -> list[SchemaType]:
         """
         Recursively fetch children of given parent items up to 5 levels.