release: bump version to 0.3.0

- Refactor Redis backend connection handling and pool management
- Update algorithm implementations with improved type annotations
- Enhance config loader validation with stricter Pydantic schemas
- Improve decorator and middleware error handling
- Expand example scripts with better docstrings and usage patterns
- Add new 00_basic_usage.py example for quick start
- Reorganize examples directory structure
- Fix type annotation inconsistencies across core modules
- Update dependencies in pyproject.toml

fastapi_traffic/core/config_loader.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import json
 import os
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, TypeVar
+from typing import TYPE_CHECKING, Any, TypeVar, cast
 
 from pydantic import BaseModel, ConfigDict, ValidationError, field_validator
 
@@ -300,6 +300,14 @@ class ConfigLoader:
 
         _check_non_loadable(raw_config)
 
+        # Merge loadable overrides before validation so required fields can be supplied
+        non_loadable_overrides: dict[str, Any] = {}
+        for key, value in overrides.items():
+            if key in _NON_LOADABLE_FIELDS:
+                non_loadable_overrides[key] = value
+            elif key in _RATE_LIMIT_FIELDS:
+                raw_config[key] = value
+
         try:
             schema = _RateLimitSchema(**raw_config)  # type: ignore[arg-type]  # Pydantic coerces str→typed values at runtime
         except ValidationError as e:
@@ -307,10 +315,8 @@ class ConfigLoader:
 
         config_dict = schema.model_dump(exclude_defaults=True)
 
-        # Apply overrides
-        for key, value in overrides.items():
-            if key in _NON_LOADABLE_FIELDS or key in _RATE_LIMIT_FIELDS:
-                config_dict[key] = value
+        # Apply non-loadable overrides (callables, etc.)
+        config_dict.update(non_loadable_overrides)
 
         # Ensure required field 'limit' is present
         if "limit" not in config_dict:
@@ -363,7 +369,15 @@ class ConfigLoader:
             msg = "JSON root must be an object"
             raise ConfigurationError(msg)
 
-        _check_non_loadable(raw_config)
+        _check_non_loadable(cast("dict[str, Any]", raw_config))
+
+        # Merge loadable overrides before validation so required fields can be supplied
+        non_loadable_overrides: dict[str, Any] = {}
+        for key, value in overrides.items():
+            if key in _NON_LOADABLE_FIELDS:
+                non_loadable_overrides[key] = value
+            elif key in _RATE_LIMIT_FIELDS:
+                raw_config[key] = value
 
         try:
             schema = _RateLimitSchema(**raw_config)  # type: ignore[arg-type]  # Pydantic coerces str→typed values at runtime
@@ -372,10 +386,8 @@ class ConfigLoader:
 
         config_dict = schema.model_dump(exclude_defaults=True)
 
-        # Apply overrides
-        for key, value in overrides.items():
-            if key in _NON_LOADABLE_FIELDS or key in _RATE_LIMIT_FIELDS:
-                config_dict[key] = value
+        # Apply non-loadable overrides (callables, etc.)
+        config_dict.update(non_loadable_overrides)
 
         # Ensure required field 'limit' is present
         if "limit" not in config_dict:
@@ -404,9 +416,7 @@ class ConfigLoader:
         Raises:
             ConfigurationError: If configuration is invalid.
         """
-        raw_config = self._extract_env_config(
-            "GLOBAL_", _GLOBAL_FIELDS, env_source
-        )
+        raw_config = self._extract_env_config("GLOBAL_", _GLOBAL_FIELDS, env_source)
 
         _check_non_loadable(raw_config)
 
@@ -472,10 +482,10 @@ class ConfigLoader:
             msg = "JSON root must be an object"
             raise ConfigurationError(msg)
 
-        _check_non_loadable(raw_config)
+        _check_non_loadable(cast("dict[str, Any]", raw_config))
 
         try:
-            schema = _GlobalSchema(**raw_config)
+            schema = _GlobalSchema(**cast("dict[str, Any]", raw_config))
         except ValidationError as e:
             raise ConfigurationError(_format_validation_error(e)) from e