django-cfg 1.4.20__py3-none-any.whl → 1.4.23__py3-none-any.whl

django_cfg/models/api/cors.py

@@ -5,48 +5,49 @@ Handles CORS settings with smart defaults and custom header support.
 """
 
 from typing import List, Optional
+
 from pydantic import BaseModel, Field
 
 
 class CORSConfig(BaseModel):
     """CORS configuration with smart defaults"""
-    
+
     # Custom headers (user-defined)
     custom_headers: List[str] = Field(
         default_factory=list,
         description="Custom headers to allow (e.g., ['x-api-key'])"
     )
-    
+
     # Origins
     allowed_origins: Optional[List[str]] = Field(
         default=None,
         description="Allowed origins (None = all origins allowed)"
     )
-    
+
     # Credentials
     allow_credentials: bool = Field(
         default=True,
         description="Allow credentials in CORS requests"
     )
-    
+
     # Methods
     allowed_methods: List[str] = Field(
         default_factory=lambda: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
         description="Allowed HTTP methods"
     )
-    
+
     # Max age
     max_age: int = Field(
         default=86400,  # 24 hours
         description="Max age for preflight requests in seconds"
     )
-    
+
     def get_all_headers(self) -> List[str]:
         """Get all headers (standard + custom)"""
         # Standard headers that are always needed
         standard_headers = [
             "accept",
-            "accept-encoding", 
+            "accept-encoding",
             "authorization",
             "content-type",
             "dnt",
@@ -55,10 +56,10 @@ class CORSConfig(BaseModel):
             "x-csrftoken",
             "x-requested-with",
         ]
-        
+
         # Combine with custom headers
         all_headers = standard_headers + self.custom_headers
-        
+
         # Remove duplicates while preserving order
         seen = set()
         unique_headers = []
@@ -66,7 +67,7 @@ class CORSConfig(BaseModel):
             if header.lower() not in seen:
                 seen.add(header.lower())
                 unique_headers.append(header)
-        
+
         return unique_headers
 
 
@@ -74,10 +75,10 @@ class CORSConfig(BaseModel):
 
 try:
     from .cfg import BaseCfgAutoModule
-    
+
     class DjangoCORSModule(BaseCfgAutoModule):
         """Django CORS auto-configuration module"""
-        
+
         def get_smart_defaults(self) -> CORSConfig:
             """Get smart default CORS configuration"""
             return CORSConfig(
@@ -87,23 +88,23 @@ try:
                 allowed_methods=["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
                 max_age=86400,  # 24 hours
             )
-        
+
         def get_module_config(self) -> CORSConfig:
             """Get CORS configuration with project overrides"""
             if self.has_config_field('cors'):
                 return self.get_config_field('cors')
             return self.get_smart_defaults()
-        
+
         def get_cors_config(self, custom_headers: Optional[List[str]] = None) -> CORSConfig:
             """Get CORS configuration with custom headers support"""
             # Get base config (project or defaults)
             cors_config = self.get_module_config()
-            
+
             # Override custom headers if provided
             if custom_headers:
                 cors_config = cors_config.model_copy()
                 cors_config.custom_headers = custom_headers
-            
+
             return cors_config
 
 except ImportError:

django_cfg/models/api/drf/__init__.py

@@ -9,9 +9,9 @@ Provides type-safe configuration for DRF and API documentation:
 """
 
 from .config import DRFConfig
+from .redoc import RedocUISettings
 from .spectacular import SpectacularConfig
 from .swagger import SwaggerUISettings
-from .redoc import RedocUISettings
 
 __all__ = [
     "DRFConfig",

django_cfg/models/api/drf/config.py

@@ -2,7 +2,8 @@
 Django REST Framework configuration.
 """
 
-from typing import Dict, Any, List
+from typing import Any, Dict, List
+
 from pydantic import BaseModel, Field
 
 

django_cfg/models/api/drf/redoc.py

@@ -2,7 +2,8 @@
 Redoc UI settings for DRF Spectacular.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from pydantic import BaseModel, Field
 
 

django_cfg/models/api/drf/spectacular.py

@@ -2,10 +2,12 @@
 DRF Spectacular configuration for OpenAPI/Swagger documentation.
 """
 
-from typing import Dict, Any, Optional, List
+from typing import Any, Dict, List, Optional
+
 from pydantic import BaseModel, Field
-from .swagger import SwaggerUISettings
+
 from .redoc import RedocUISettings
+from .swagger import SwaggerUISettings
 
 
 class SpectacularConfig(BaseModel):

django_cfg/models/api/drf/swagger.py

@@ -2,7 +2,8 @@
 Swagger UI settings for DRF Spectacular.
 """
 
-from typing import Dict, Any
+from typing import Any, Dict
+
 from pydantic import BaseModel, Field
 
 

django_cfg/models/api/jwt.py

@@ -3,9 +3,10 @@ JWT Configuration for Django CFG
 Type-safe JWT authentication configuration with Pydantic v2
 """
 
-from typing import Dict, Any, Optional, Tuple
 from datetime import timedelta
-from pydantic import BaseModel, Field, ConfigDict, field_validator
+from typing import Any, Dict, Optional, Tuple
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 
 class JWTConfig(BaseModel):
@@ -14,13 +15,13 @@ class JWTConfig(BaseModel):
     
     Provides type-safe JWT token configuration with environment-aware defaults.
     """
-    
+
     model_config = ConfigDict(
         validate_assignment=True,
         extra="forbid",
         str_strip_whitespace=True,
     )
-    
+
     # === Token Lifetimes ===
     access_token_lifetime_hours: Optional[int] = Field(
         default=None,
@@ -28,68 +29,68 @@ class JWTConfig(BaseModel):
         le=8760,  # 1 year max
         description="Access token lifetime in hours (None = maximum: 8760 hours/1 year)"
     )
-    
+
     refresh_token_lifetime_days: Optional[int] = Field(
         default=None,
         ge=1,
         le=365,  # 1 year max
         description="Refresh token lifetime in days (None = maximum: 365 days/1 year)"
     )
-    
+
     # === Token Rotation ===
     rotate_refresh_tokens: bool = Field(
         default=True,
         description="Rotate refresh tokens on each use"
     )
-    
+
     blacklist_after_rotation: bool = Field(
         default=True,
         description="Blacklist old tokens after rotation"
     )
-    
+
     # === Security Settings ===
     algorithm: str = Field(
         default="HS256",
         description="JWT signing algorithm"
     )
-    
+
     update_last_login: bool = Field(
         default=True,
         description="Update user's last login on token refresh"
     )
-    
+
     # === Token Claims ===
     user_id_field: str = Field(
         default="id",
         description="User model field for user ID claim"
     )
-    
+
     user_id_claim: str = Field(
         default="user_id",
         description="JWT claim name for user ID"
     )
-    
+
     token_type_claim: str = Field(
         default="token_type",
         description="JWT claim name for token type"
     )
-    
+
     jti_claim: str = Field(
         default="jti",
         description="JWT claim name for token ID"
     )
-    
+
     # === Authentication Headers ===
     auth_header_types: Tuple[str, ...] = Field(
         default=("Bearer",),
         description="Accepted authentication header types"
     )
-    
+
     auth_header_name: str = Field(
         default="HTTP_AUTHORIZATION",
         description="HTTP header name for authentication"
     )
-    
+
     # === Advanced Settings ===
     leeway: int = Field(
         default=0,
@@ -97,17 +98,17 @@ class JWTConfig(BaseModel):
         le=300,  # 5 minutes max
         description="Leeway for token expiration in seconds"
     )
-    
+
     audience: Optional[str] = Field(
         default=None,
         description="JWT audience claim"
     )
-    
+
     issuer: Optional[str] = Field(
         default=None,
         description="JWT issuer claim"
     )
-    
+
     @field_validator("algorithm")
     @classmethod
     def validate_algorithm(cls, v: str) -> str:
@@ -120,7 +121,7 @@ class JWTConfig(BaseModel):
         if v not in allowed_algorithms:
             raise ValueError(f"Algorithm must be one of: {', '.join(allowed_algorithms)}")
         return v
-    
+
     @field_validator("auth_header_types")
     @classmethod
     def validate_auth_header_types(cls, v: Tuple[str, ...]) -> Tuple[str, ...]:
@@ -128,7 +129,7 @@ class JWTConfig(BaseModel):
         if not v:
             raise ValueError("At least one auth header type must be specified")
         return v
-    
+
     def configure_for_environment(self, environment: str, debug: bool = False) -> "JWTConfig":
         """
         Configure JWT settings based on environment.
@@ -141,7 +142,7 @@ class JWTConfig(BaseModel):
             New JWTConfig instance with environment-specific settings
         """
         config_data = self.model_dump()
-        
+
         if environment == "development" or debug:
             # Development: shorter tokens for security
             config_data.update({
@@ -164,9 +165,9 @@ class JWTConfig(BaseModel):
                 "rotate_refresh_tokens": False,  # Simpler for tests
                 "blacklist_after_rotation": False,
             })
-        
+
         return self.__class__(**config_data)
-    
+
     def get_effective_access_token_hours(self) -> int:
         """
         Get effective access token lifetime in hours.
@@ -175,7 +176,7 @@ class JWTConfig(BaseModel):
             Access token lifetime (8760 hours if None = maximum)
         """
         return self.access_token_lifetime_hours if self.access_token_lifetime_hours is not None else 8760
-    
+
     def get_effective_refresh_token_days(self) -> int:
         """
         Get effective refresh token lifetime in days.
@@ -184,7 +185,7 @@ class JWTConfig(BaseModel):
             Refresh token lifetime (365 days if None = maximum)
         """
         return self.refresh_token_lifetime_days if self.refresh_token_lifetime_days is not None else 365
-    
+
     def to_django_settings(self, secret_key: str) -> Dict[str, Any]:
         """
         Convert to Django SIMPLE_JWT settings.
@@ -200,32 +201,32 @@ class JWTConfig(BaseModel):
                 # Token lifetimes
                 "ACCESS_TOKEN_LIFETIME": timedelta(hours=self.get_effective_access_token_hours()),
                 "REFRESH_TOKEN_LIFETIME": timedelta(days=self.get_effective_refresh_token_days()),
-                
+
                 # Token rotation
                 "ROTATE_REFRESH_TOKENS": self.rotate_refresh_tokens,
                 "BLACKLIST_AFTER_ROTATION": self.blacklist_after_rotation,
-                
+
                 # Security
                 "ALGORITHM": self.algorithm,
                 "SIGNING_KEY": secret_key,
                 "VERIFYING_KEY": None,
                 "UPDATE_LAST_LOGIN": self.update_last_login,
-                
+
                 # Claims
                 "USER_ID_FIELD": self.user_id_field,
                 "USER_ID_CLAIM": self.user_id_claim,
                 "TOKEN_TYPE_CLAIM": self.token_type_claim,
                 "JTI_CLAIM": self.jti_claim,
-                
+
                 # Headers
                 "AUTH_HEADER_TYPES": self.auth_header_types,
                 "AUTH_HEADER_NAME": self.auth_header_name,
-                
+
                 # Advanced
                 "LEEWAY": self.leeway,
                 "AUDIENCE": self.audience,
                 "ISSUER": self.issuer,
-                
+
                 # Additional settings
                 "JWK_URL": None,
                 "USER_AUTHENTICATION_RULE": "rest_framework_simplejwt.authentication.default_user_authentication_rule",
@@ -236,7 +237,7 @@ class JWTConfig(BaseModel):
                 "SLIDING_TOKEN_REFRESH_LIFETIME": timedelta(days=self.get_effective_refresh_token_days()),
             }
         }
-    
+
     def get_token_info(self) -> Dict[str, str]:
         """
         Get human-readable token lifetime information.
@@ -246,15 +247,15 @@ class JWTConfig(BaseModel):
         """
         access_hours = self.get_effective_access_token_hours()
         refresh_days = self.get_effective_refresh_token_days()
-        
+
         access_desc = f"{access_hours} hour{'s' if access_hours != 1 else ''}"
         if self.access_token_lifetime_hours is None:
             access_desc += " (maximum)"
-            
+
         refresh_desc = f"{refresh_days} day{'s' if refresh_days != 1 else ''}"
         if self.refresh_token_lifetime_days is None:
             refresh_desc += " (maximum)"
-        
+
         return {
             "access_token": access_desc,
             "refresh_token": refresh_desc,

django_cfg/models/api/keys.py

@@ -9,7 +9,8 @@ Following CRITICAL_REQUIREMENTS.md:
 """
 
 from typing import Optional
-from pydantic import BaseModel, Field, field_validator, SecretStr
+
+from pydantic import BaseModel, Field, SecretStr, field_validator
 
 
 class ApiKeys(BaseModel):
@@ -26,25 +27,25 @@ class ApiKeys(BaseModel):
         )
         ```
     """
-    
+
     model_config = {
         "validate_assignment": True,
         "extra": "forbid",
         "str_strip_whitespace": True,
         "validate_default": True,
     }
-    
+
     # === LLM Provider Keys ===
     openai: Optional[SecretStr] = Field(
         default=None,
         description="OpenAI API key for GPT models and embeddings"
     )
-    
+
     openrouter: Optional[SecretStr] = Field(
         default=None,
         description="OpenRouter API key for access to multiple LLM providers"
     )
-    
+
     @field_validator("openai")
     @classmethod
     def validate_openai_key(cls, v: Optional[SecretStr]) -> Optional[SecretStr]:
@@ -65,7 +66,7 @@ class ApiKeys(BaseModel):
             raise ValueError("OpenAI API key appears to be too short")
 
         return v
-    
+
     @field_validator("openrouter")
     @classmethod
     def validate_openrouter_key(cls, v: Optional[SecretStr]) -> Optional[SecretStr]:
@@ -86,23 +87,23 @@ class ApiKeys(BaseModel):
             raise ValueError("OpenRouter API key appears to be too short")
 
         return v
-    
+
     def get_openai_key(self) -> Optional[str]:
         """Get OpenAI API key as string."""
         return self.openai.get_secret_value() if self.openai else None
-    
+
     def get_openrouter_key(self) -> Optional[str]:
         """Get OpenRouter API key as string."""
         return self.openrouter.get_secret_value() if self.openrouter else None
-    
+
     def has_openai(self) -> bool:
         """Check if OpenAI key is configured."""
         return self.openai is not None
-    
+
     def has_openrouter(self) -> bool:
         """Check if OpenRouter key is configured."""
         return self.openrouter is not None
-    
+
     def get_preferred_provider(self) -> Optional[str]:
         """
         Get preferred provider based on availability.
@@ -122,4 +123,4 @@ class ApiKeys(BaseModel):
 # Export the main class
 __all__ = [
     "ApiKeys",
-]
+]