django-cfg 1.4.11__py3-none-any.whl → 1.4.14__py3-none-any.whl

django_cfg/apps/urls.py

@@ -5,130 +5,142 @@ Built-in API endpoints for django_cfg functionality.
 """
 
 from django.urls import path, include
-from typing import List, Dict
-from django.urls import URLPattern
+from typing import List
 
 
-def _register_group_urls(patterns: List[URLPattern], groups: Dict) -> None:
+def get_enabled_cfg_apps() -> List[str]:
     """
-    Auto-register URLs from OpenAPI groups using convention.
-
-    Convention: cfg_{app} → /cfg/{app}/
-
-    Args:
-        patterns: URL patterns list to append to
-        groups: OpenAPI groups dict
-    """
-    for group_name in groups.keys():
-        # Only django-cfg apps (convention: cfg_*)
-        if not group_name.startswith('cfg_'):
-            continue
-
-        # Extract app name: cfg_payments → payments
-        app_name = group_name[4:]
-
-        # Register main URLs: /cfg/{app}/
-        try:
-            patterns.append(
-                path(f'cfg/{app_name}/', include(f'django_cfg.apps.{app_name}.urls'))
-            )
-        except ImportError:
-            pass  # URL module doesn't exist
-
-        # Register admin URLs: /cfg/{app}/admin/ (if exists)
-        try:
-            patterns.append(
-                path(f'cfg/{app_name}/admin/', include(f'django_cfg.apps.{app_name}.urls_admin'))
-            )
-        except ImportError:
-            pass  # Admin URL module doesn't exist
-
-
-def _register_apps_fallback(patterns: List[URLPattern]) -> None:
-    """
-    Fallback: Register apps when OpenAPI is disabled.
-
-    Uses BaseCfgModule checks to determine which apps are enabled.
-
-    Args:
-        patterns: URL patterns list to append to
+    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()
-
-    # Business logic apps
-    if base_module.is_support_enabled():
-        patterns.append(path('cfg/support/', include('django_cfg.apps.support.urls')))
-
+    enabled_apps = []
+    
     if base_module.is_accounts_enabled():
-        patterns.append(path('cfg/accounts/', include('django_cfg.apps.accounts.urls')))
-
+        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():
-        patterns.append(path('cfg/newsletter/', include('django_cfg.apps.newsletter.urls')))
-
+        enabled_apps.append("django_cfg.apps.newsletter")
+    
     if base_module.is_leads_enabled():
-        patterns.append(path('cfg/leads/', include('django_cfg.apps.leads.urls')))
-
+        enabled_apps.append("django_cfg.apps.leads")
+    
     if base_module.is_knowbase_enabled():
-        patterns.append(path('cfg/knowbase/', include('django_cfg.apps.knowbase.urls')))
-
+        enabled_apps.append("django_cfg.apps.knowbase")
+    
     if base_module.is_agents_enabled():
-        patterns.append(path('cfg/agents/', include('django_cfg.apps.agents.urls')))
-
+        enabled_apps.append("django_cfg.apps.agents")
+    
     if base_module.should_enable_tasks():
-        patterns.append(path('cfg/tasks/', include('django_cfg.apps.tasks.urls')))
-        patterns.append(path('cfg/tasks/admin/', include('django_cfg.apps.tasks.urls_admin')))
-
+        enabled_apps.append("django_cfg.apps.tasks")
+    
     if base_module.is_payments_enabled():
-        patterns.append(path('cfg/payments/', include('django_cfg.apps.payments.urls')))
-        patterns.append(path('cfg/payments/admin/', include('django_cfg.apps.payments.urls_admin')))
-
-    # Standalone apps
-    if base_module.is_maintenance_enabled():
-        patterns.append(
-            path('admin/django_cfg_maintenance/', include('django_cfg.apps.maintenance.urls_admin'))
-        )
-
-    if base_module.is_rpc_enabled():
-        patterns.append(path('rpc/', include('django_cfg.modules.django_ipc_client.dashboard.urls')))
-        patterns.append(path('admin/rpc/', include('django_cfg.modules.django_ipc_client.dashboard.urls_admin')))
+        enabled_apps.append("django_cfg.apps.payments")
+    
+    return enabled_apps
 
 
-def get_django_cfg_urlpatterns() -> List[URLPattern]:
+def get_default_cfg_group():
     """
-    Get Django CFG URL patterns based on OpenAPI groups.
-
+    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:
-        List of URL patterns for django_cfg
+        OpenAPIGroupConfig with enabled django-cfg apps
     """
-    patterns = [
-        # Core APIs (always enabled)
-        path('health/', include('django_cfg.apps.api.health.urls')),
-        path('endpoints/', include('django_cfg.apps.api.endpoints.urls')),
-        path('commands/', include('django_cfg.apps.api.commands.urls')),
-
-        # OpenAPI schemas (if enabled)
-        # Provides /openapi/{group}/schema/
-        path('openapi/', include('django_cfg.modules.django_client.urls')),
-    ]
-
+    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:
-        # Auto-register from OpenAPI groups (preferred)
-        from django_cfg.modules.django_client.core import get_openapi_service
-        service = get_openapi_service()
-
-        if service and service.is_enabled():
-            _register_group_urls(patterns, service.get_groups())
-        else:
-            # Fallback: Use BaseCfgModule when OpenAPI disabled
-            _register_apps_fallback(patterns)
-
-    except Exception:
-        # Last resort fallback
-        _register_apps_fallback(patterns)
-
-    return patterns
-
-
-# Generate URL patterns dynamically
-urlpatterns = get_django_cfg_urlpatterns()
+        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/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/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/models/django/openapi.py

@@ -8,11 +8,11 @@ This replaces django-revolution with a cleaner, faster, type-safe implementation
 """
 
 from typing import Dict, Any, Optional
-from pydantic import BaseModel, Field
+from pydantic import Field
 from django_cfg.modules.django_client.core.config import OpenAPIConfig, OpenAPIGroupConfig
 
 
-class ExtendedOpenAPIConfig(OpenAPIConfig):
+class OpenAPIClientConfig(OpenAPIConfig):
     """
     Extended OpenAPI configuration with DRF parameters for django-cfg integration.
 
@@ -21,9 +21,9 @@ class ExtendedOpenAPIConfig(OpenAPIConfig):
 
     Example:
         ```python
-        from django_cfg import ExtendedOpenAPIConfig, OpenAPIGroupConfig
+        from django_cfg import OpenAPIClientConfig, OpenAPIGroupConfig
 
-        config = ExtendedOpenAPIConfig(
+        config = OpenAPIClientConfig(
             enabled=True,
             groups=[
                 OpenAPIGroupConfig(
@@ -57,8 +57,8 @@ class ExtendedOpenAPIConfig(OpenAPIConfig):
         description="Schema path prefix for DRF Spectacular"
     )
     drf_enable_browsable_api: bool = Field(
-        default=False,
-        description="Enable DRF browsable API"
+        default=True,
+        description="Enable DRF browsable API with Tailwind theme"
     )
     drf_enable_throttling: bool = Field(
         default=False,
@@ -104,6 +104,8 @@ class ExtendedOpenAPIConfig(OpenAPIConfig):
     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
@@ -111,128 +113,13 @@ class ExtendedOpenAPIConfig(OpenAPIConfig):
         # Convert list to dict for compatibility
         groups_dict = {group.name: group for group in self.groups}
 
-        # Add default django-cfg groups if enabled
-        try:
-            from django_cfg.modules.base import BaseCfgModule
-            base_module = BaseCfgModule()
-
-            support_enabled = base_module.is_support_enabled()
-            accounts_enabled = base_module.is_accounts_enabled()
-            newsletter_enabled = base_module.is_newsletter_enabled()
-            leads_enabled = base_module.is_leads_enabled()
-            knowbase_enabled = base_module.is_knowbase_enabled()
-            agents_enabled = base_module.is_agents_enabled()
-            tasks_enabled = base_module.should_enable_tasks()
-            payments_enabled = base_module.is_payments_enabled()
-
-            # Collect all enabled django-cfg apps for unified group
-            enabled_cfg_apps = []
-            if support_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.support")
-            if accounts_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.accounts")
-            if newsletter_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.newsletter")
-            if leads_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.leads")
-            if knowbase_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.knowbase")
-            if agents_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.agents")
-            if tasks_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.tasks")
-            if payments_enabled:
-                enabled_cfg_apps.append("django_cfg.apps.payments")
-
-            # Add unified 'cfg' group with all enabled apps
-            if enabled_cfg_apps and 'cfg' not in groups_dict:
-                groups_dict['cfg'] = OpenAPIGroupConfig(
-                    name="cfg",
-                    apps=enabled_cfg_apps,
-                    title="Django-CFG API",
-                    description="All django-cfg built-in applications",
-                )
-
-            # Skip individual cfg_* groups - use unified 'cfg' instead
-            return groups_dict
-
-            # Add Support group if enabled
-            if support_enabled and 'cfg_support' not in groups_dict:
-                groups_dict['cfg_support'] = OpenAPIGroupConfig(
-                    name="cfg_support",
-                    apps=["django_cfg.apps.support"],
-                    title="Support API",
-                    description="Support tickets and messages API",
-                )
-
-            # Add Accounts group if enabled
-            if accounts_enabled and 'cfg_accounts' not in groups_dict:
-                groups_dict['cfg_accounts'] = OpenAPIGroupConfig(
-                    name="cfg_accounts",
-                    apps=["django_cfg.apps.accounts"],
-                    title="Accounts API",
-                    description="User management, OTP, profiles, and activity tracking API",
-                )
-
-            # Add Newsletter group if enabled
-            if newsletter_enabled and 'cfg_newsletter' not in groups_dict:
-                groups_dict['cfg_newsletter'] = OpenAPIGroupConfig(
-                    name="cfg_newsletter",
-                    apps=["django_cfg.apps.newsletter"],
-                    title="Newsletter API",
-                    description="Email campaigns, subscriptions, and newsletter management API",
-                )
-
-            # Add Leads group if enabled
-            if leads_enabled and 'cfg_leads' not in groups_dict:
-                groups_dict['cfg_leads'] = OpenAPIGroupConfig(
-                    name="cfg_leads",
-                    apps=["django_cfg.apps.leads"],
-                    title="Leads API",
-                    description="Lead collection, contact forms, and CRM integration API",
-                )
-
-            # Add Knowbase group if enabled
-            if knowbase_enabled and 'cfg_knowbase' not in groups_dict:
-                groups_dict['cfg_knowbase'] = OpenAPIGroupConfig(
-                    name="cfg_knowbase",
-                    apps=["django_cfg.apps.knowbase"],
-                    title="Knowbase API",
-                    description="Knowledge base, AI chat, embeddings, and search API",
-                )
-
-            # Add Agents group if enabled
-            if agents_enabled and 'cfg_agents' not in groups_dict:
-                groups_dict['cfg_agents'] = OpenAPIGroupConfig(
-                    name="cfg_agents",
-                    apps=["django_cfg.apps.agents"],
-                    title="Agents API",
-                    description="Agent definitions, executions, workflows, and tools API",
-                )
-
-            # Add Tasks group if enabled
-            if tasks_enabled and 'cfg_tasks' not in groups_dict:
-                groups_dict['cfg_tasks'] = OpenAPIGroupConfig(
-                    name="cfg_tasks",
-                    apps=["django_cfg.apps.tasks"],
-                    title="Tasks API",
-                    description="Tasks, workflows, and automation API",
-                )
-
-            # Add Payments group if enabled
-            if payments_enabled and 'cfg_payments' not in groups_dict:
-                groups_dict['cfg_payments'] = OpenAPIGroupConfig(
-                    name="cfg_payments",
-                    apps=["django_cfg.apps.payments"],
-                    title="Payments API",
-                    description="Payments, subscriptions, and billing API",
-                )
-
-        except Exception:
-            pass
+        # 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
 
-
-# Alias for easier import
-OpenAPIClientConfig = ExtendedOpenAPIConfig

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/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/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/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/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/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']