django-cfg 1.5.8__py3-none-any.whl → 1.5.14__py3-none-any.whl

django_cfg/modules/django_client/core/generator/typescript/templates/main_index.ts.jinja

@@ -33,7 +33,6 @@
  */
 
 import { APIClient } from "./client";
-import { OPENAPI_SCHEMA } from "./schema";
 import {
   StorageAdapter,
   LocalStorageAdapter,
@@ -82,9 +81,6 @@ export * as Hooks from "./_utils/hooks";
 // Re-export core client
 export { APIClient };
 
-// Re-export OpenAPI schema
-export { OPENAPI_SCHEMA };
-
 // Re-export storage adapters for convenience
 export type { StorageAdapter };
 export { LocalStorageAdapter, CookieStorageAdapter, MemoryStorageAdapter };
@@ -267,11 +263,19 @@ export class API {
   }
 
   /**
-   * Get OpenAPI schema
-   * @returns Complete OpenAPI specification for this API
+   * Get OpenAPI schema path
+   * @returns Path to the OpenAPI schema JSON file
+   *
+   * Note: The OpenAPI schema is available in the schema.json file.
+   * You can load it dynamically using:
+   * ```typescript
+   * const schema = await fetch('./schema.json').then(r => r.json());
+   * // or using fs in Node.js:
+   * // const schema = JSON.parse(fs.readFileSync('./schema.json', 'utf-8'));
+   * ```
    */
-  getSchema(): any {
-    return OPENAPI_SCHEMA;
+  getSchemaPath(): string {
+    return './schema.json';
   }
 }
 

django_cfg/modules/django_client/core/parser/base.py

@@ -62,8 +62,12 @@ class BaseParser(ABC):
             IRContext with all schemas and operations
 
         Raises:
-            ValueError: If COMPONENT_SPLIT_REQUEST is not detected
+            ValueError: If COMPONENT_SPLIT_REQUEST is not detected or schema name conflicts found
         """
+        # CRITICAL: Validate schema names BEFORE parsing
+        # This prevents generation from starting with invalid schemas
+        self._validate_schema_names()
+
         # Parse metadata
         openapi_info = self._parse_openapi_info()
         django_metadata = self._parse_django_metadata()
@@ -237,54 +241,134 @@ class BaseParser(ABC):
 
         return False
 
-    # ===== Schema Parsing =====
+    # ===== Schema Validation =====
+
+    def _validate_schema_names(self) -> None:
+        """
+        Validate schema names for conflicts BEFORE parsing.
+
+        This method checks for:
+        1. Case-insensitive duplicates (e.g., "User" and "user")
+        2. Exact duplicates (e.g., "GRPCServerInfo" from two different serializers)
+
+        Raises:
+            ValueError: If schema name conflicts are detected (hard exit with traceback)
+
+        Example conflicts:
+            - Case-insensitive: "Profile" and "profile" → filesystem conflict
+            - Exact duplicate: "HealthCheck" from multiple serializers → schema conflict
+        """
+        import traceback
+        import sys
 
-    def _parse_all_schemas(self) -> dict[str, IRSchemaObject]:
-        """Parse all schemas from components."""
         if not self.spec.components or not self.spec.components.schemas:
-            return {}
+            return  # No schemas to validate
 
-        # Check for duplicate schema names with different casing
         schema_names = list(self.spec.components.schemas.keys())
         lowercase_map = {}
-        exact_duplicate_map = {}
+        exact_duplicate_sources = {}
 
         for name in schema_names:
             lowercase = name.lower()
 
             # Check case-insensitive duplicates
             if lowercase in lowercase_map:
-                raise ValueError(
-                    f"Duplicate schema names with different casing detected:\n"
-                    f"  - {lowercase_map[lowercase]}\n"
-                    f"  - {name}\n"
-                    f"This causes conflicts in case-insensitive file systems.\n"
-                    f"Please rename one of the serializers in your Django code."
+                existing_name = lowercase_map[lowercase]
+                error_msg = (
+                    f"\n{'=' * 80}\n"
+                    f"❌ SCHEMA NAME CONFLICT DETECTED\n"
+                    f"{'=' * 80}\n\n"
+                    f"Conflict Type: Case-insensitive duplicate\n"
+                    f"Schema Names:\n"
+                    f"  1. '{existing_name}'\n"
+                    f"  2. '{name}'\n\n"
+                    f"Problem:\n"
+                    f"  These names differ only in casing and will cause conflicts on\n"
+                    f"  case-insensitive filesystems (macOS, Windows).\n\n"
+                    f"Solution:\n"
+                    f"  Rename one of the Django serializers to make them distinct.\n"
+                    f"  Example: {name}Serializer → {name}DetailSerializer\n\n"
+                    f"{'=' * 80}\n"
                 )
-            lowercase_map[lowercase] = name
 
-            # Check exact duplicates
-            if name in exact_duplicate_map:
-                # Get schema titles to show source serializer names
-                schema1 = self.spec.components.schemas.get(name)
-                title1 = getattr(schema1, 'title', 'Unknown')
-                title2 = exact_duplicate_map[name]
+                # Print full error with traceback
+                print(error_msg, file=sys.stderr)
+                print("\n🔍 Traceback (schema validation):", file=sys.stderr)
+                traceback.print_stack(file=sys.stderr)
 
+                # Hard exit - stop generation immediately
                 raise ValueError(
-                    f"Duplicate schema name detected: '{name}'\n"
-                    f"Multiple serializers are generating the same schema name:\n"
-                    f"  - {title1}\n"
-                    f"  - {title2}\n"
-                    f"This causes schema conflicts in the generated API client.\n"
-                    f"Please rename one of the serializers to make them unique.\n"
-                    f"Example: HealthCheckSerializer → GRPCHealthCheckSerializer"
+                    f"Case-insensitive schema name conflict: '{existing_name}' vs '{name}'. "
+                    f"Cannot generate client with conflicting schema names."
                 )
 
-            # Store with title for later comparison
+            lowercase_map[lowercase] = name
+
+            # Track schema sources for exact duplicate detection
             schema = self.spec.components.schemas.get(name)
-            title = getattr(schema, 'title', name)
-            exact_duplicate_map[name] = title
+            if schema and not isinstance(schema, ReferenceObject):
+                # Get source information from schema
+                title = getattr(schema, 'title', name)
+                description = getattr(schema, 'description', '')
+
+                # Create signature for duplicate detection
+                if name in exact_duplicate_sources:
+                    # Found exact duplicate!
+                    existing = exact_duplicate_sources[name]
+                    error_msg = (
+                        f"\n{'=' * 80}\n"
+                        f"❌ SCHEMA NAME CONFLICT DETECTED\n"
+                        f"{'=' * 80}\n\n"
+                        f"Conflict Type: Exact duplicate schema name\n"
+                        f"Schema Name: '{name}'\n\n"
+                        f"Sources:\n"
+                        f"  1. {existing['title']}\n"
+                        f"     Description: {existing['description'][:100]}\n"
+                        f"  2. {title}\n"
+                        f"     Description: {description[:100]}\n\n"
+                        f"Problem:\n"
+                        f"  Multiple serializers are generating the same schema name '{name}'.\n"
+                        f"  This causes schema conflicts in the generated API client and\n"
+                        f"  OpenAPI documentation.\n\n"
+                        f"Solution:\n"
+                        f"  Rename one of the serializers to make them unique.\n"
+                        f"  Examples:\n"
+                        f"    - HealthCheckSerializer → GRPCHealthCheckSerializer\n"
+                        f"    - ServerInfoSerializer → GRPCServerStatusSerializer\n\n"
+                        f"{'=' * 80}\n"
+                    )
+
+                    # Print full error with traceback
+                    print(error_msg, file=sys.stderr)
+                    print("\n🔍 Traceback (schema validation):", file=sys.stderr)
+                    traceback.print_stack(file=sys.stderr)
+
+                    # Hard exit - stop generation immediately
+                    raise ValueError(
+                        f"Duplicate schema name detected: '{name}'. "
+                        f"Multiple serializers are generating this schema. "
+                        f"Cannot generate client with conflicting schemas."
+                    )
+
+                # Store for duplicate detection
+                exact_duplicate_sources[name] = {
+                    'title': title,
+                    'description': description,
+                }
+
+    # ===== Schema Parsing =====
+
+    def _parse_all_schemas(self) -> dict[str, IRSchemaObject]:
+        """
+        Parse all schemas from components.
+
+        Note: Schema name validation is done in _validate_schema_names()
+        which is called BEFORE this method in parse().
+        """
+        if not self.spec.components or not self.spec.components.schemas:
+            return {}
 
+        # Parse schemas (validation already done in _validate_schema_names)
         schemas = {}
         for name, schema_or_ref in self.spec.components.schemas.items():
             # Skip references for now

django_cfg/modules/django_client/management/commands/generate_client.py

@@ -8,12 +8,15 @@ Usage:
 """
 
 
-from django.core.management.base import BaseCommand, CommandError
+from django.core.management.base import CommandError
 
+from django_cfg.management.utils import AdminCommand
 
-class Command(BaseCommand):
+
+class Command(AdminCommand):
     """Generate OpenAPI clients for configured application groups."""
 
+    command_name = 'generate_client'
     help = "Generate Python, TypeScript, and Go API clients from OpenAPI schemas"
 
     def add_arguments(self, parser):

django_cfg/modules/django_client/management/commands/validate_openapi.py

@@ -12,12 +12,15 @@ Usage:
 from pathlib import Path
 from typing import List
 
-from django.core.management.base import BaseCommand, CommandError
+from django.core.management.base import CommandError
 
+from django_cfg.management.utils import AdminCommand
 
-class Command(BaseCommand):
+
+class Command(AdminCommand):
     """Validate and fix OpenAPI schema quality issues in DRF serializers."""
 
+    command_name = 'validate_openapi'
     help = "Validate and auto-fix OpenAPI schema quality issues"
 
     def add_arguments(self, parser):

django_cfg/modules/django_email/management/commands/test_email.py

@@ -5,22 +5,16 @@ Tests email sending functionality using django_cfg configuration.
 """
 
 from django.contrib.auth import get_user_model
-from django.core.management.base import BaseCommand
 
-from django_cfg.modules.django_logging import get_logger
+from django_cfg.management.utils import SafeCommand
 
 User = get_user_model()
-logger = get_logger('test_email')
 
 
-class Command(BaseCommand):
+class Command(SafeCommand):
     """Command to test email functionality."""
 
-    # Web execution metadata
-    web_executable = True
-    requires_input = False
-    is_destructive = False
-
+    command_name = 'test_email'
     help = "Test email sending functionality"
 
     def add_arguments(self, parser):
@@ -48,7 +42,7 @@ class Command(BaseCommand):
         subject = options["subject"]
         message = options["message"]
 
-        logger.info(f"Starting email test for {email}")
+        self.logger.info(f"Starting email test for {email}")
         self.stdout.write(f"🚀 Testing email service for {email}")
 
         # Create test user if not exists

django_cfg/modules/django_ngrok/management/commands/runserver_ngrok.py

@@ -12,8 +12,6 @@ from django.core.management.commands.runserver import Command as RunServerComman
 from django_cfg.modules.django_logging import get_logger
 from django_cfg.modules.django_ngrok import get_ngrok_service
 
-logger = get_logger('runserver_ngrok')
-
 
 class Command(RunServerCommand):
     """Enhanced runserver command with ngrok tunnel support."""
@@ -25,6 +23,11 @@ class Command(RunServerCommand):
 
     help = f'{RunServerCommand.help.rstrip(".")} with ngrok tunnel.'
 
+    def __init__(self, *args, **kwargs):
+        """Initialize with logger."""
+        super().__init__(*args, **kwargs)
+        self.logger = get_logger('runserver_ngrok')
+
     def add_arguments(self, parser):
         super().add_arguments(parser)
         parser.add_argument(
@@ -76,14 +79,14 @@ class Command(RunServerCommand):
         ngrok_service = get_ngrok_service()
 
         self.stdout.write("🚇 Starting ngrok tunnel...")
-        logger.info(f"Starting ngrok tunnel for port {server_port}")
+        self.logger.info(f"Starting ngrok tunnel for port {server_port}")
 
         tunnel_url = ngrok_service.start_tunnel(server_port)
 
         if tunnel_url:
             # Wait for tunnel to be fully established
             self.stdout.write("⏳ Waiting for tunnel to be established...")
-            logger.info("Waiting for ngrok tunnel to be fully established")
+            self.logger.info("Waiting for ngrok tunnel to be fully established")
 
             max_retries = 10
             retry_count = 0
@@ -98,10 +101,10 @@ class Command(RunServerCommand):
                     current_url = ngrok_service.get_tunnel_url()
                     if current_url and current_url == tunnel_url:
                         tunnel_ready = True
-                        logger.info(f"Ngrok tunnel established successfully: {tunnel_url}")
+                        self.logger.info(f"Ngrok tunnel established successfully: {tunnel_url}")
                         break
                 except Exception as e:
-                    logger.warning(f"Tunnel check attempt {retry_count} failed: {e}")
+                    self.logger.warning(f"Tunnel check attempt {retry_count} failed: {e}")
 
                 self.stdout.write(f"⏳ Tunnel check {retry_count}/{max_retries}...")
 
@@ -116,16 +119,16 @@ class Command(RunServerCommand):
                 self.stdout.write(
                     self.style.SUCCESS(f"✅ Ngrok tunnel ready: {tunnel_url}")
                 )
-                logger.info(f"Ngrok tunnel fully ready: {tunnel_url}")
+                self.logger.info(f"Ngrok tunnel fully ready: {tunnel_url}")
             else:
                 self.stdout.write(
                     self.style.WARNING("⚠️ Ngrok tunnel started but may not be fully ready")
                 )
-                logger.warning("Ngrok tunnel started but readiness check failed")
+                self.logger.warning("Ngrok tunnel started but readiness check failed")
         else:
             error_msg = "Failed to start ngrok tunnel"
             self.stdout.write(self.style.ERROR(f"❌ {error_msg}"))
-            logger.error(error_msg)
+            self.logger.error(error_msg)
 
     def _set_ngrok_env_vars(self, tunnel_url: str):
         """Set environment variables with ngrok URL for easy access."""
@@ -145,10 +148,10 @@ class Command(RunServerCommand):
             os.environ['NGROK_API_URL'] = tunnel_url
 
             # Environment variables set - no need for verbose output
-            logger.info(f"Set ngrok environment variables: {tunnel_url}")
+            self.logger.info(f"Set ngrok environment variables: {tunnel_url}")
 
         except Exception as e:
-            logger.warning(f"Could not set ngrok environment variables: {e}")
+            self.logger.warning(f"Could not set ngrok environment variables: {e}")
 
     def _update_allowed_hosts(self, tunnel_url: str):
         """Update ALLOWED_HOSTS with ngrok domain."""
@@ -164,7 +167,7 @@ class Command(RunServerCommand):
             if hasattr(settings, 'ALLOWED_HOSTS'):
                 if ngrok_host not in settings.ALLOWED_HOSTS:
                     settings.ALLOWED_HOSTS.append(ngrok_host)
-                    logger.info(f"Added {ngrok_host} to ALLOWED_HOSTS")
+                    self.logger.info(f"Added {ngrok_host} to ALLOWED_HOSTS")
 
         except Exception as e:
-            logger.warning(f"Could not update ALLOWED_HOSTS: {e}")
+            self.logger.warning(f"Could not update ALLOWED_HOSTS: {e}")

django_cfg/modules/django_telegram/management/commands/test_telegram.py

@@ -4,20 +4,13 @@ Test Telegram Command
 Tests Telegram notification functionality using django_cfg configuration.
 """
 
-from django.core.management.base import BaseCommand
+from django_cfg.management.utils import SafeCommand
 
-from django_cfg.modules.django_logging import get_logger
 
-logger = get_logger('test_telegram')
-
-class Command(BaseCommand):
+class Command(SafeCommand):
     """Command to test Telegram functionality."""
 
-    # Web execution metadata
-    web_executable = True
-    requires_input = False
-    is_destructive = False
-
+    command_name = 'test_telegram'
     help = "Test Telegram notification functionality"
 
     def add_arguments(self, parser):
@@ -29,7 +22,7 @@ class Command(BaseCommand):
         )
 
     def handle(self, *args, **options):
-        logger.info("Starting test_telegram command")
+        self.logger.info("Starting test_telegram command")
         message = options["message"]
 
         self.stdout.write("🚀 Testing Telegram notification service")

django_cfg/modules/django_twilio/management/commands/test_twilio.py

@@ -4,20 +4,13 @@ Test Twilio Command
 Tests Twilio messaging functionality using django_cfg configuration.
 """
 
-from django.core.management.base import BaseCommand
+from django_cfg.management.utils import SafeCommand
 
-from django_cfg.modules.django_logging import get_logger
 
-logger = get_logger('test_twilio')
-
-class Command(BaseCommand):
+class Command(SafeCommand):
     """Command to test Twilio functionality."""
 
-    # Web execution metadata
-    web_executable = True
-    requires_input = False
-    is_destructive = False
-
+    command_name = 'test_twilio'
     help = "Test Twilio messaging functionality"
 
     def add_arguments(self, parser):
@@ -45,7 +38,7 @@ class Command(BaseCommand):
         )
 
     def handle(self, *args, **options):
-        logger.info("Starting test_twilio command")
+        self.logger.info("Starting test_twilio command")
         to_number = options["to"]
         message = options["message"]
         is_whatsapp = options["whatsapp"]

django_cfg/modules/django_unfold/navigation.py

@@ -148,29 +148,17 @@ class NavigationManager(BaseCfgModule):
 
         # gRPC Dashboard (if enabled)
         if self.is_grpc_enabled():
-            grpc_items = []
-
-            # Monitoring API endpoint
-            grpc_items.append(
-                NavigationItem(title="Monitor", icon=Icons.MONITOR_HEART, link="/cfg/admin/admin/dashboard/grpc/")
-            )
-
-            # Request Logs with safe URL resolution
-            logs_item = self._create_nav_item(
-                title="Request Logs",
-                icon=Icons.LIST_ALT,
-                url_name="admin:grpc_grpcrequestlog_changelist",
-                fallback_link="/admin/grpc/grpcrequestlog/"
-            )
-            if logs_item:
-                grpc_items.append(logs_item)
-
             navigation_sections.append(
                 NavigationSection(
                     title="gRPC",
                     separator=True,
                     collapsible=True,
-                    items=grpc_items
+                    items=[
+                        NavigationItem(title="Monitor", icon=Icons.MONITOR_HEART, link="/cfg/admin/admin/dashboard/grpc/"),
+                        NavigationItem(title="Request Logs", icon=Icons.LIST_ALT, link=str(reverse_lazy("admin:grpc_grpcrequestlog_changelist"))),
+                        NavigationItem(title="API Keys", icon=Icons.KEY, link=str(reverse_lazy("admin:grpc_grpcapikey_changelist"))),
+                        NavigationItem(title="Server Status", icon=Icons.HEALTH_AND_SAFETY, link=str(reverse_lazy("admin:grpc_grpcserverstatus_changelist"))),
+                    ]
                 )
             )
 

django_cfg/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.5.8"
+version = "1.5.14"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]

django_cfg/registry/modules.py

@@ -13,11 +13,8 @@ MODULES_REGISTRY = {
     # Centrifugo module
     "DjangoCfgCentrifugoConfig": ("django_cfg.apps.integrations.centrifugo.services.client.config", "DjangoCfgCentrifugoConfig"),
 
-    # gRPC module
+    # gRPC module (uses flat API - no nested config imports needed)
     "GRPCConfig": ("django_cfg.models.api.grpc", "GRPCConfig"),
-    "GRPCServerConfig": ("django_cfg.models.api.grpc", "GRPCServerConfig"),
-    "GRPCAuthConfig": ("django_cfg.models.api.grpc", "GRPCAuthConfig"),
-    "GRPCProtoConfig": ("django_cfg.models.api.grpc", "GRPCProtoConfig"),
 
     # Next.js Admin Integration
     "NextJsAdminConfig": ("django_cfg.modules.nextjs_admin", "NextJsAdminConfig"),

django_cfg/requirements.txt

@@ -0,0 +1,52 @@
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# ⚠️  DJANGO-CFG LIBRARY - TESTING & DEVELOPMENT INSTRUCTIONS
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#
+# ❌ DO NOT test django-cfg library directly from this directory!
+# ❌ DO NOT use pip install -r requirements.txt
+# ❌ DO NOT use poetry install here
+#
+# ✅ This library is AUTOMATICALLY LINKED to the Django test project
+# ✅ All changes in this library are IMMEDIATELY available in the test project
+# ✅ NO installation or build steps needed - just edit and test!
+#
+# 📋 HOW TO TEST YOUR CHANGES:
+#
+# This library (django-cfg-dev) is automatically symlinked to:
+# ../../../../solution/projects/django/
+#
+# All testing MUST be done through the Django project:
+#
+#   cd ../../../../solution/projects/django
+#   poetry run python manage.py migrate
+#   poetry run python manage.py runserver
+#   poetry run python manage.py test
+#   poetry run pytest
+#
+# 🔄 WORKFLOW:
+#
+# 1. Edit django-cfg library code here (src/django_cfg/...)
+# 2. Changes are INSTANTLY available in the Django project (via symlink)
+# 3. Test your changes by running Django commands from ../../../../solution/projects/django
+# 4. No rebuild or reinstall needed - it's live!
+#
+# 📁 PROJECT STRUCTURE:
+#
+#   @projects/django-cfg/
+#   ├── projects/django-cfg-dev/           ← Django-CFG library (YOU ARE HERE)
+#   │   └── src/django_cfg/               ← Library source code
+#   └── solution/projects/django/         ← Django test project (GO HERE)
+#       ├── manage.py                     ← Run commands here
+#       ├── pyproject.toml                ← Django project dependencies
+#       └── .venv/                        ← Contains symlink to django-cfg-dev
+#
+# 🔗 SYMLINK DETAILS:
+#
+# The symlink is created automatically via: make install-local
+# Located at: ../../../../solution/projects/django/.venv/lib/python3.12/site-packages/django_cfg
+# Points to: projects/django-cfg-dev/src/django_cfg (this directory)
+#
+# 💡 TIP: If symlink is broken, run from django-cfg root:
+#   make install-local
+#
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{django_cfg-1.5.8.dist-info → django_cfg-1.5.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.5.8
+Version: 1.5.14
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com