django-cfg 1.4.11__tar.gz → 1.4.14__tar.gz

{django_cfg-1.4.11 → django_cfg-1.4.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.11
+Version: 1.4.14
 Summary: Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com

{django_cfg-1.4.11 → django_cfg-1.4.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.11"
+version = "1.4.14"
 description = "Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "ai-agents", "enterprise-django", "django-settings", "type-safe-config",]

django_cfg-1.4.14/src/django_cfg/apps/urls.py

@@ -0,0 +1,146 @@
+"""
+Django CFG API URLs
+
+Built-in API endpoints for django_cfg functionality.
+"""
+
+from django.urls import path, include
+from typing import List
+
+
+def get_enabled_cfg_apps() -> List[str]:
+    """
+    Get list of enabled django-cfg apps based on configuration.
+    
+    Returns:
+        List of enabled app paths (e.g., ['django_cfg.apps.accounts', ...])
+    """
+    from django_cfg.modules.base import BaseCfgModule
+    
+    base_module = BaseCfgModule()
+    enabled_apps = []
+    
+    if base_module.is_accounts_enabled():
+        enabled_apps.append("django_cfg.apps.accounts")
+    
+    if base_module.is_support_enabled():
+        enabled_apps.append("django_cfg.apps.support")
+    
+    if base_module.is_newsletter_enabled():
+        enabled_apps.append("django_cfg.apps.newsletter")
+    
+    if base_module.is_leads_enabled():
+        enabled_apps.append("django_cfg.apps.leads")
+    
+    if base_module.is_knowbase_enabled():
+        enabled_apps.append("django_cfg.apps.knowbase")
+    
+    if base_module.is_agents_enabled():
+        enabled_apps.append("django_cfg.apps.agents")
+    
+    if base_module.should_enable_tasks():
+        enabled_apps.append("django_cfg.apps.tasks")
+    
+    if base_module.is_payments_enabled():
+        enabled_apps.append("django_cfg.apps.payments")
+    
+    return enabled_apps
+
+
+def get_default_cfg_group():
+    """
+    Returns default OpenAPIGroupConfig for enabled django-cfg apps.
+    
+    Only includes apps that are enabled in the current configuration.
+    
+    This can be imported and added to your project's OpenAPIClientConfig groups:
+    
+    ```python
+    from django_cfg.apps.urls import get_default_cfg_group
+    
+    openapi_client = OpenAPIClientConfig(
+        groups=[
+            get_default_cfg_group(),
+            # ... your custom groups
+        ]
+    )
+    ```
+    
+    Returns:
+        OpenAPIGroupConfig with enabled django-cfg apps
+    """
+    from django_cfg.modules.django_client.core.config import OpenAPIGroupConfig
+    
+    return OpenAPIGroupConfig(
+        name="cfg",
+        apps=get_enabled_cfg_apps(),
+        title="Django-CFG API",
+        description="Authentication (OTP), Support, Newsletter, Leads, Knowledge Base, AI Agents, Tasks, Payments",
+        version="1.0.0",
+    )
+
+
+def _safe_include(pattern_path: str, module_path: str):
+    """Helper to safely include URL module if it exists."""
+    try:
+        return path(pattern_path, include(module_path))
+    except ImportError:
+        return None
+
+
+# Core API endpoints (always enabled)
+# Note: All prefixes are explicit here (cfg/, health/, etc.)
+urlpatterns = [
+    path('cfg/health/', include('django_cfg.apps.api.health.urls')),
+    path('cfg/endpoints/', include('django_cfg.apps.api.endpoints.urls')),
+    path('cfg/commands/', include('django_cfg.apps.api.commands.urls')),
+    path('cfg/openapi/', include('django_cfg.modules.django_client.urls')),
+]
+
+# Django-CFG apps - conditionally registered based on config
+# Map app paths to URL patterns (with cfg/ prefix from add_django_cfg_urls)
+APP_URL_MAP = {
+    "django_cfg.apps.accounts": [
+        ("cfg/accounts/", "django_cfg.apps.accounts.urls"),
+    ],
+    "django_cfg.apps.support": [
+        ("cfg/support/", "django_cfg.apps.support.urls"),
+    ],
+    "django_cfg.apps.newsletter": [
+        ("cfg/newsletter/", "django_cfg.apps.newsletter.urls"),
+    ],
+    "django_cfg.apps.leads": [
+        ("cfg/leads/", "django_cfg.apps.leads.urls"),
+    ],
+    "django_cfg.apps.knowbase": [
+        ("cfg/knowbase/", "django_cfg.apps.knowbase.urls"),
+    ],
+    "django_cfg.apps.agents": [
+        ("cfg/agents/", "django_cfg.apps.agents.urls"),
+    ],
+    "django_cfg.apps.tasks": [
+        ("cfg/tasks/", "django_cfg.apps.tasks.urls"),
+        ("cfg/tasks/admin/", "django_cfg.apps.tasks.urls_admin"),
+    ],
+    "django_cfg.apps.payments": [
+        ("cfg/payments/", "django_cfg.apps.payments.urls"),
+        ("cfg/payments/admin/", "django_cfg.apps.payments.urls_admin"),
+    ],
+}
+
+# Register URLs for enabled apps only
+enabled_apps = get_enabled_cfg_apps()
+cfg_app_urls = []
+
+for app_path in enabled_apps:
+    if app_path in APP_URL_MAP:
+        for url_pattern, url_module in APP_URL_MAP[app_path]:
+            cfg_app_urls.append(_safe_include(url_pattern, url_module))
+
+# Maintenance (special case - admin only)
+from django_cfg.modules.base import BaseCfgModule
+if BaseCfgModule().is_maintenance_enabled():
+    cfg_app_urls.append(_safe_include('admin/django_cfg_maintenance/', 'django_cfg.apps.maintenance.urls_admin'))
+
+# Add only successfully imported URLs
+urlpatterns.extend([url for url in cfg_app_urls if url is not None])

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/core/generation/integration_generators/api.py

@@ -152,9 +152,10 @@ class APIFrameworksGenerator:
                 },
                 "COMPONENT_SPLIT_REQUEST": True,
                 "COMPONENT_SPLIT_PATCH": True,
-                # Auto-fix enum naming collisions
+                # Postprocessing hooks
                 "POSTPROCESSING_HOOKS": [
                     "django_cfg.modules.django_client.spectacular.auto_fix_enum_names",
+                    "django_cfg.modules.django_client.spectacular.mark_async_operations",
                 ],
             }
 

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/core/integration/url_integration.py

@@ -10,18 +10,17 @@ from django_cfg.core.environment import EnvironmentDetector
 from django.conf import settings
 
 
-def add_django_cfg_urls(urlpatterns: List[URLPattern], cfg_prefix: str = "cfg/") -> List[URLPattern]:
+def add_django_cfg_urls(urlpatterns: List[URLPattern]) -> List[URLPattern]:
     """
     Automatically add django_cfg URLs and all integrations to the main URL configuration.
     
     This function adds:
-    - Django CFG management URLs (cfg/)
+    - Django CFG management URLs
     - Django Client URLs (if available)
     - Startup information display (based on config)
     
     Args:
         urlpatterns: Existing URL patterns list
-        cfg_prefix: URL prefix for django_cfg endpoints (default: "cfg/")
         
     Returns:
         Updated URL patterns list with all URLs added
@@ -35,17 +34,13 @@ def add_django_cfg_urls(urlpatterns: List[URLPattern], cfg_prefix: str = "cfg/")
             path("admin/", admin.site.urls),
         ]
         
-        # Automatically adds:
-        # - path("cfg/", include("django_cfg.apps.urls"))
-        # - Django Client URLs (if available)
-        # - Startup info display (based on config.startup_info_mode)
+        # Automatically adds django_cfg URLs with proper prefixes
         urlpatterns = add_django_cfg_urls(urlpatterns)
     """
     # Add django_cfg API URLs
-    # Note: Django Client URLs are included in django_cfg.apps.urls
-    # at /cfg/openapi/{group}/schema/ to avoid conflicts
+    # Note: URL prefixes (cfg/, health/, etc.) are defined in django_cfg.apps.urls
     new_patterns = urlpatterns + [
-        path(cfg_prefix, include("django_cfg.apps.urls")),
+        path("", include("django_cfg.apps.urls")),
     ]
 
     # Add django-browser-reload URLs in development (if installed)

django_cfg-1.4.14/src/django_cfg/models/django/openapi.py

@@ -0,0 +1,125 @@
+"""
+Django Client (OpenAPI) Configuration with DRF Integration
+
+Extended configuration model that integrates openapi_client for automatic
+TypeScript and Python client generation from Django REST Framework endpoints.
+
+This replaces django-revolution with a cleaner, faster, type-safe implementation.
+"""
+
+from typing import Dict, Any, Optional
+from pydantic import Field
+from django_cfg.modules.django_client.core.config import OpenAPIConfig, OpenAPIGroupConfig
+
+
+class OpenAPIClientConfig(OpenAPIConfig):
+    """
+    Extended OpenAPI configuration with DRF parameters for django-cfg integration.
+
+    This extends the base OpenAPIConfig to include DRF-specific
+    parameters and django-cfg integration helpers.
+
+    Example:
+        ```python
+        from django_cfg import OpenAPIClientConfig, OpenAPIGroupConfig
+
+        config = OpenAPIClientConfig(
+            enabled=True,
+            groups=[
+                OpenAPIGroupConfig(
+                    name='api',
+                    apps=['users', 'posts'],
+                    title='Main API',
+                    version='v1',
+                ),
+            ],
+            drf_title='My API',
+            drf_description='REST API for my project',
+        )
+        ```
+    """
+
+    # DRF Configuration parameters for automatic DRF setup
+    drf_title: str = Field(
+        default="API",
+        description="API title for DRF Spectacular"
+    )
+    drf_description: str = Field(
+        default="RESTful API",
+        description="API description for DRF Spectacular"
+    )
+    drf_version: str = Field(
+        default="1.0.0",
+        description="API version for DRF Spectacular"
+    )
+    drf_schema_path_prefix: Optional[str] = Field(
+        default=None,  # Will default to "/api/" if None
+        description="Schema path prefix for DRF Spectacular"
+    )
+    drf_enable_browsable_api: bool = Field(
+        default=True,
+        description="Enable DRF browsable API with Tailwind theme"
+    )
+    drf_enable_throttling: bool = Field(
+        default=False,
+        description="Enable DRF throttling"
+    )
+    drf_serve_include_schema: bool = Field(
+        default=False,
+        description="Include schema in Spectacular UI"
+    )
+
+    # Django-cfg specific integration
+    api_prefix: str = Field(
+        default="api",
+        description="API prefix for URL routing (e.g., 'api' -> /api/...)"
+    )
+
+    def get_drf_schema_path_prefix(self) -> str:
+        """Get the schema path prefix, defaulting to api_prefix if not set."""
+        if self.drf_schema_path_prefix:
+            return self.drf_schema_path_prefix
+        return f"/{self.api_prefix}/"
+
+    def get_drf_config_kwargs(self) -> Dict[str, Any]:
+        """
+        Get kwargs for DRF configuration from this config.
+
+        Returns:
+            Dict of parameters for DRF + Spectacular setup
+        """
+        return {
+            "title": self.drf_title,
+            "description": self.drf_description,
+            "version": self.drf_version,
+            "schema_path_prefix": self.get_drf_schema_path_prefix(),
+            "enable_browsable_api": self.drf_enable_browsable_api,
+            "enable_throttling": self.drf_enable_throttling,
+            "serve_include_schema": self.drf_serve_include_schema,
+            # REQUIRED by django-client for correct Request/Response split
+            "component_split_request": True,
+            "component_split_patch": True,
+        }
+
+    def get_groups_with_defaults(self) -> Dict[str, OpenAPIGroupConfig]:
+        """
+        Get groups with django-cfg default groups automatically added.
+        
+        Automatically adds the 'cfg' group with all django-cfg apps if not explicitly defined.
+
+        Returns:
+            Dict of groups including default django-cfg groups
+        """
+        # Convert list to dict for compatibility
+        groups_dict = {group.name: group for group in self.groups}
+
+        # Add default 'cfg' group if not explicitly defined
+        if 'cfg' not in groups_dict:
+            try:
+                from django_cfg.apps.urls import get_default_cfg_group
+                groups_dict['cfg'] = get_default_cfg_group()
+            except Exception:
+                pass
+
+        return groups_dict
+

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/modules/django_client/core/archive/manager.py

@@ -57,12 +57,12 @@ class ArchiveManager:
 
         if python_dir and python_dir.exists():
             dest = archive_path / "python"
-            shutil.copytree(python_dir, dest)
+            shutil.copytree(python_dir, dest, dirs_exist_ok=True)
             copied["python"] = str(dest)
 
         if typescript_dir and typescript_dir.exists():
             dest = archive_path / "typescript"
-            shutil.copytree(typescript_dir, dest)
+            shutil.copytree(typescript_dir, dest, dirs_exist_ok=True)
             copied["typescript"] = str(dest)
 
         # Create metadata

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/modules/django_client/core/config/config.py

@@ -76,6 +76,26 @@ class OpenAPIConfig(BaseModel):
         description="Generate TypeScript client",
     )
 
+    generate_package_files: bool = Field(
+        default=False,
+        description="Generate package.json (TypeScript) and pyproject.toml (Python)",
+    )
+
+    generate_zod_schemas: bool = Field(
+        default=False,
+        description="Generate Zod schemas for runtime validation (TypeScript only)",
+    )
+
+    generate_fetchers: bool = Field(
+        default=False,
+        description="Generate typed fetcher functions (TypeScript only, requires Zod schemas)",
+    )
+
+    generate_swr_hooks: bool = Field(
+        default=False,
+        description="Generate SWR hooks for React (TypeScript only, requires fetchers)",
+    )
+
     client_structure: Literal["flat", "namespaced"] = Field(
         default="namespaced",
         description=(

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/modules/django_client/core/config/service.py

@@ -59,7 +59,7 @@ class DjangoOpenAPI:
         if not self.config:
             return {}
 
-        # Use get_groups_with_defaults if available (ExtendedOpenAPIConfig)
+        # Use get_groups_with_defaults if available (OpenAPIClientConfig)
         if hasattr(self.config, 'get_groups_with_defaults'):
             return self.config.get_groups_with_defaults()
 

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/modules/django_client/core/generator/__init__.py

@@ -22,10 +22,10 @@ Usage:
 from pathlib import Path
 from typing import Literal
 
-from django_cfg.modules.django_client.core.generator.base import GeneratedFile
-from django_cfg.modules.django_client.core.generator.python import PythonGenerator
-from django_cfg.modules.django_client.core.generator.typescript import TypeScriptGenerator
-from django_cfg.modules.django_client.core.ir import IRContext
+from .base import GeneratedFile
+from .python import PythonGenerator
+from .typescript import TypeScriptGenerator
+from ..ir import IRContext
 
 __all__ = [
     "PythonGenerator",

{django_cfg-1.4.11 → django_cfg-1.4.14}/src/django_cfg/modules/django_client/core/generator/base.py

@@ -48,6 +48,11 @@ class BaseGenerator(ABC):
         client_structure: str = "namespaced",
         openapi_schema: dict | None = None,
         tag_prefix: str = "",
+        package_config: dict | None = None,
+        generate_package_files: bool = False,
+        generate_zod_schemas: bool = False,
+        generate_fetchers: bool = False,
+        generate_swr_hooks: bool = False,
     ):
         """
         Initialize generator with IR context.
@@ -57,11 +62,21 @@ class BaseGenerator(ABC):
             client_structure: Client structure ("flat" or "namespaced")
             openapi_schema: OpenAPI schema dict (for embedding in client)
             tag_prefix: Prefix to add to all tag names (e.g., "cfg_")
+            package_config: Package configuration (name, version, author, etc.)
+            generate_package_files: Whether to generate package.json/pyproject.toml
+            generate_zod_schemas: Whether to generate Zod schemas (TypeScript only)
+            generate_fetchers: Whether to generate typed fetchers (TypeScript only)
+            generate_swr_hooks: Whether to generate SWR hooks (TypeScript only, React)
         """
         self.context = context
         self.client_structure = client_structure
         self.openapi_schema = openapi_schema
         self.tag_prefix = tag_prefix
+        self.package_config = package_config or {}
+        self.generate_package_files = generate_package_files
+        self.generate_zod_schemas = generate_zod_schemas
+        self.generate_fetchers = generate_fetchers
+        self.generate_swr_hooks = generate_swr_hooks
 
     # ===== Namespaced Structure Helpers =====
 
@@ -765,3 +780,59 @@ class BaseGenerator(ABC):
             lines.append(" ".join(current_line))
 
         return lines
+
+    def format_enum_description(self, text: str) -> str:
+        """
+        Format enum description by splitting bullet points.
+
+        Enum descriptions from OpenAPI often have the format:
+        "* `value1` - Desc1 * `value2` - Desc2"
+
+        This method splits them into separate lines:
+        "* `value1` - Desc1\n* `value2` - Desc2"
+
+        Args:
+            text: Enum description text
+
+        Returns:
+            Formatted description with proper line breaks
+        """
+        if not text:
+            return text
+
+        # Split by " * `" pattern (preserving the first *)
+        import re
+        # Replace " * `" with newline + "* `"
+        formatted = re.sub(r'\s+\*\s+`', '\n* `', text.strip())
+
+        return formatted
+
+    def sanitize_enum_name(self, name: str) -> str:
+        """
+        Sanitize enum name by converting to PascalCase.
+
+        Examples:
+            "OrderDetail.status" -> "OrderDetailStatus"
+            "Currency.currency_type" -> "CurrencyCurrencyType"
+            "CurrencyList.currency_type" -> "CurrencyListCurrencyType"
+            "User.role" -> "UserRole"
+
+        Args:
+            name: Original enum name (may contain dots, underscores)
+
+        Returns:
+            Sanitized PascalCase name
+        """
+        # Replace dots with underscores, then split and convert to PascalCase
+        parts = name.replace('.', '_').split('_')
+        result = []
+        for word in parts:
+            if not word:
+                continue
+            # If word is already PascalCase/camelCase, keep it as is
+            # Otherwise capitalize first letter only
+            if word[0].isupper():
+                result.append(word)
+            else:
+                result.append(word[0].upper() + word[1:] if len(word) > 1 else word.upper())
+        return ''.join(result)

django_cfg-1.4.14/src/django_cfg/modules/django_client/core/generator/python/__init__.py

@@ -0,0 +1,16 @@
+"""
+Python Generator - Generates Python client (Pydantic 2 + httpx).
+
+This generator creates a complete Python API client from IR:
+- Pydantic 2 models (Request/Response/Patch splits)
+- Enum classes from x-enum-varnames
+- httpx.AsyncClient for async HTTP
+- Django CSRF/session handling
+- Type-safe (MyPy strict mode compatible)
+
+Reference: https://docs.pydantic.dev/latest/
+"""
+
+from .generator import PythonGenerator
+
+__all__ = ['PythonGenerator']