django-cfg 2.3.332__tar.gz → 2.3.333__tar.gz

{django_cfg-2.3.332 → django_cfg-2.3.333}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 2.3.332
+Version: 2.3.333
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, 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

{django_cfg-2.3.332 → django_cfg-2.3.333}/pyproject.toml

@@ -10,7 +10,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "2.3.332"
+version = "2.3.333"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration,\nand 8 enterprise apps. Replace settings.py with validated models, \n90% less code. Production-ready with AI agents, auto-generated TypeScript clients, \nand zero-config features.\n"
 readme = "README.md"
 keywords = [

{django_cfg-2.3.332 → django_cfg-2.3.333}/src/django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "2.3.332"
+__version__ = "2.3.333"
 __license__ = "MIT"
 
 # Setup warnings debug early (checks env var only at this point)

django_cfg-2.3.333/src/django_cfg/appconfig.py

@@ -0,0 +1,68 @@
+"""
+Django app configuration for django_cfg.
+
+Lives here, not in `apps.py`: the package `django_cfg/apps/` shadows a module of
+that name, so Django never saw an AppConfig defined in it and ready() never ran.
+`django_cfg/apps/__init__.py` re-exports DjangoCfgConfig, which is what Django
+looks for when it resolves the "django_cfg" INSTALLED_APPS entry.
+
+Each startup concern lives in its own module under django_cfg/startup/:
+  constance.py          — Constance + Unfold admin registration
+  drf_patch.py          — JWT-aware DRF authentication patch
+  mime_types.py         — Media types a slim container image leaves out
+  type_stubs.py         — Auto-install DRF validated_data type stubs (dev only)
+  registry_validation.py — Validate DJANGO_CFG_REGISTRY entries at startup
+  command_shadowing.py  — Warn when a project command shares a name with a django-cfg one
+"""
+
+import logging
+
+from django.apps import AppConfig
+
+logger = logging.getLogger("django_cfg.startup")
+
+
+def _run_hook(hook) -> None:
+    """Run one startup hook; a failure is logged, never raised."""
+    try:
+        hook()
+    except Exception as exc:  # noqa: BLE001 - startup must never crash on an optional hook
+        logger.warning("django_cfg startup hook %s failed: %s", getattr(hook, "__name__", hook), exc)
+
+
+class DjangoCfgConfig(AppConfig):
+    """Configuration for django_cfg app."""
+
+    # Explicit: Django picks this config for the bare "django_cfg" entry.
+    default = True
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "django_cfg"
+    verbose_name = "Django Configuration"
+
+    def ready(self) -> None:
+        """Called when Django is ready — run all startup hooks.
+
+        Every optional hook is isolated: a failure logs a warning and never
+        stops the process. Each hook is idempotent (ready() may run twice).
+        """
+        try:
+            # Import registers the check; nothing to call.
+            from django_cfg.startup import command_shadowing  # noqa: F401
+        except Exception as exc:  # noqa: BLE001
+            logger.warning("django_cfg command_shadowing check not registered: %s", exc)
+        from django_cfg.startup.constance import register_constance_admin
+        from django_cfg.startup.drf_patch import patch_drf_authentication
+        from django_cfg.startup.mime_types import register_media_types
+        from django_cfg.startup.registry_validation import validate_registry
+        from django_cfg.startup.type_stubs import install_type_stubs
+
+        # First: django-storages reads `mimetypes` when it uploads, so the
+        # table has to be complete before anything can write a file.
+        for hook in (
+            register_media_types,
+            register_constance_admin,
+            install_type_stubs,
+            patch_drf_authentication,
+            validate_registry,
+        ):
+            _run_hook(hook)

django_cfg-2.3.333/src/django_cfg/apps/__init__.py

@@ -0,0 +1,10 @@
+"""
+django_cfg.apps — package of django-cfg sub-apps (system, api, payments, tools).
+
+Django resolves the INSTALLED_APPS entry "django_cfg" by importing
+`django_cfg.apps` and picking the AppConfig subclass found there. This package
+(not a module) is what that import returns, so the config is re-exported here.
+Keep this file light: no models and no heavy imports at import time.
+"""
+
+from django_cfg.appconfig import DjangoCfgConfig  # noqa: F401

{django_cfg-2.3.332 → django_cfg-2.3.333}/src/django_cfg/core/integration/setup_types.py

@@ -33,15 +33,18 @@ def _get_version() -> str:
         return "unknown"
 
 
-def _find_project_root() -> Path:
-    """Walk up from cwd to find project root (contains manage.py or pyrightconfig.json)."""
+def _find_project_root() -> Path | None:
+    """Walk up from cwd to find project root (contains manage.py or pyrightconfig.json).
+
+    Returns None when there is none: stubs are never written into an arbitrary cwd.
+    """
     cwd = Path.cwd()
     for directory in [cwd, *cwd.parents]:
         if (directory / "manage.py").exists() or (directory / "pyrightconfig.json").exists():
             return directory
         if directory == directory.parent or directory == Path.home():
             break
-    return cwd
+    return None
 
 
 def _get_stubs_source() -> Path:
@@ -118,6 +121,8 @@ def install(force: bool = False) -> None:
     Safe to call multiple times — re-runs only when django-cfg version changes.
     """
     project_root = _find_project_root()
+    if project_root is None:
+        return
     version = _get_version()
 
     if not force and _is_current_version_installed(project_root, version):

{django_cfg-2.3.332 → django_cfg-2.3.333}/src/django_cfg/middleware/authentication.py

@@ -68,6 +68,9 @@ def _patch_drf_authenticate():
 
         self._not_authenticated()
 
+    if getattr(DRFRequest._authenticate, "_django_cfg_jwt_aware", False):
+        return  # already applied (module import and AppConfig.ready() both call this)
+    _jwt_aware_authenticate._django_cfg_jwt_aware = True  # type: ignore[attr-defined]
     DRFRequest._authenticate = _jwt_aware_authenticate  # type: ignore[method-assign]
 
 
@@ -75,7 +78,7 @@ def _patch_drf_authenticate():
 # This module is always imported by DRF before the first request because
 # 'django_cfg.middleware.authentication.JWTAuthenticationWithLastLogin' is in
 # DEFAULT_AUTHENTICATION_CLASSES — DRF imports it on first authenticate() call.
-# The patch is idempotent: re-running it is safe (replaces the same method again).
+# The patch is idempotent: a marker on the patched method makes a second call a no-op.
 # DjangoCfgConfig.ready() also calls it for even earlier application.
 _patch_drf_authenticate()
 

django_cfg-2.3.333/src/django_cfg/startup/constance.py

@@ -0,0 +1,53 @@
+"""
+django_cfg.startup.constance — Register Constance admin with Unfold integration.
+"""
+
+import logging
+
+logger = logging.getLogger("django_cfg.startup")
+
+_admin_class = None
+
+
+def _get_admin_class():
+    """Build the Unfold-flavoured Constance admin once (None if deps are missing)."""
+    global _admin_class
+    if _admin_class is None:
+        from constance.admin import ConstanceAdmin
+        from unfold.admin import ModelAdmin
+
+        class ConstanceConfigAdmin(ConstanceAdmin, ModelAdmin):
+            """Constance admin with Unfold integration."""
+
+        _admin_class = ConstanceConfigAdmin
+    return _admin_class
+
+
+def register_constance_admin() -> None:
+    """Register Constance admin using Unfold ModelAdmin if both are installed. Idempotent."""
+    try:
+        from django.apps import apps
+        from django.conf import settings
+        from django.contrib import admin
+
+        if not (hasattr(settings, "CONSTANCE_CONFIG") and settings.CONSTANCE_CONFIG):
+            return
+        if not apps.is_installed("constance"):
+            return
+
+        from constance.admin import Config
+
+        admin_class = _get_admin_class()
+        current = admin.site._registry.get(Config)
+        if isinstance(current, admin_class):
+            return  # already ours; never register twice
+
+        # Constance registered its own admin on import; swap it for ours.
+        # The private registry is touched directly: unregister()+register()
+        # would raise NotRegistered/AlreadyRegistered depending on load order.
+        admin.site._registry[Config] = admin_class(Config, admin.site)
+
+    except ImportError:
+        pass  # constance or unfold not installed
+    except Exception as exc:
+        logger.warning("django-cfg: could not register Constance admin: %s", exc)

{django_cfg-2.3.332 → django_cfg-2.3.333}/src/django_cfg/startup/drf_patch.py

@@ -5,11 +5,15 @@ Ensures that AuthenticationFailed raised by non-JWT backends does not block
 JWT authentication when the request carries a JWT Bearer token.
 """
 
+import logging
+
+logger = logging.getLogger("django_cfg.startup")
+
 
 def patch_drf_authentication() -> None:
     """Apply JWT-aware DRF authentication patch. Called after all apps are loaded."""
     try:
         from django_cfg.middleware.authentication import _patch_drf_authenticate
         _patch_drf_authenticate()
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.warning("django-cfg: could not apply the DRF authentication patch: %s", exc)

{django_cfg-2.3.332 → django_cfg-2.3.333}/src/django_cfg/startup/registry_validation.py

@@ -3,7 +3,7 @@ django_cfg.startup.registry_validation — Validate DJANGO_CFG_REGISTRY at start
 
 Iterates all registry entries, attempts importlib.import_module + getattr for each.
 Optional-dependency entries that fail because their package isn't installed are
-logged at DEBUG level only. Required entries that fail are logged as ERROR.
+logged at DEBUG level only. Required entries that fail are logged as WARNING (never an error: a config that works must not be rejected).
 
 The lazy-import mechanism (__getattr__ in django_cfg/__init__.py) is NOT touched —
 this is a read-only validation pass that surfaces broken entries at startup rather
@@ -32,8 +32,15 @@ def validate_registry() -> None:
     """
     try:
         from django_cfg.registry import DJANGO_CFG_REGISTRY
+    except ModuleNotFoundError as exc:
+        if exc.name == "django_cfg.registry":
+            # The lazy-import registry was removed; nothing to validate.
+            logger.debug("django_cfg registry module not present, validation skipped")
+            return
+        logger.warning("Failed to import DJANGO_CFG_REGISTRY: %s", exc)
+        return
     except Exception as exc:
-        logger.error("Failed to import DJANGO_CFG_REGISTRY: %s", exc)
+        logger.warning("Failed to import DJANGO_CFG_REGISTRY: %s", exc)
         return
 
     broken: list[str] = []
@@ -41,7 +48,7 @@ def validate_registry() -> None:
         try:
             mod = importlib.import_module(module_path)
             if not hasattr(mod, attr_name):
-                logger.error(
+                logger.warning(
                     "Registry entry '%s': module '%s' has no attribute '%s'",
                     symbol, module_path, attr_name,
                 )
@@ -54,13 +61,13 @@ def validate_registry() -> None:
                     symbol, exc,
                 )
             else:
-                logger.error(
+                logger.warning(
                     "Registry entry '%s': cannot import '%s' — %s",
                     symbol, module_path, exc,
                 )
                 broken.append(symbol)
         except Exception as exc:
-            logger.error(
+            logger.warning(
                 "Registry entry '%s': unexpected error importing '%s.%s' — %s",
                 symbol, module_path, attr_name, exc,
             )

django_cfg-2.3.333/src/django_cfg/startup/type_stubs.py

@@ -0,0 +1,43 @@
+"""
+django_cfg.startup.type_stubs — Auto-install DRF type stubs for Pyright.
+
+Writes typings/rest_framework/serializers.pyi and patches pyrightconfig.json
+so that after is_valid(raise_exception=True) Pyright narrows validated_data
+to dict[str, Any]. Only runs in a development context, and only writes inside
+a project root (a directory with manage.py or pyrightconfig.json), never into
+site-packages or the environment.
+"""
+
+import logging
+import os
+
+logger = logging.getLogger("django_cfg.startup")
+
+_NON_DEV_ENVS = ("production", "prod", "staging", "stage", "test", "testing", "ci")
+
+
+def _is_dev_context() -> bool:
+    """True only for DEBUG=True outside production-like envs and containers."""
+    from django.conf import settings
+
+    if not getattr(settings, "DEBUG", False):
+        return False
+    if os.environ.get("DJANGO_ENV", "development").strip().lower() in _NON_DEV_ENVS:
+        return False
+    # Containers (Docker/Kubernetes) are never a place to write project files.
+    if os.path.exists("/.dockerenv") or os.environ.get("KUBERNETES_SERVICE_HOST"):
+        return False
+    return True
+
+
+def install_type_stubs() -> None:
+    """Install DRF validated_data type stubs. No-op unless in a DEBUG dev context."""
+    try:
+        if not _is_dev_context():
+            return
+
+        from django_cfg.core.integration.setup_types import install
+        install()
+
+    except Exception as exc:
+        logger.debug("django-cfg: type stubs skipped: %s", exc)

django_cfg-2.3.332/src/django_cfg/apps/__init__.py

@@ -1 +0,0 @@
-# Django CFG Apps Package

django_cfg-2.3.332/src/django_cfg/apps.py

@@ -1,40 +0,0 @@
-"""
-Django app configuration for django_cfg.
-
-Each startup concern lives in its own module under django_cfg/startup/:
-  constance.py          — Constance + Unfold admin registration
-  drf_patch.py          — JWT-aware DRF authentication patch
-  mime_types.py         — Media types a slim container image leaves out
-  type_stubs.py         — Auto-install DRF validated_data type stubs (dev only)
-  registry_validation.py — Validate DJANGO_CFG_REGISTRY entries at startup
-  command_shadowing.py  — Warn when a project command shares a name with a django-cfg one
-"""
-
-from django.apps import AppConfig
-
-
-class DjangoCfgConfig(AppConfig):
-    """Configuration for django_cfg app."""
-
-    default_auto_field = "django.db.models.BigAutoField"
-    name = "django_cfg"
-    verbose_name = "Django Configuration"
-
-    def ready(self) -> None:
-        """Called when Django is ready — run all startup hooks."""
-        from django_cfg.startup.constance import register_constance_admin
-        from django_cfg.startup.drf_patch import patch_drf_authentication
-        from django_cfg.startup.mime_types import register_media_types
-        from django_cfg.startup.type_stubs import install_type_stubs
-        from django_cfg.startup.registry_validation import validate_registry
-        # Import registers the check; nothing to call.
-        from django_cfg.startup import command_shadowing  # noqa: F401
-
-        # First: django-storages reads `mimetypes` when it uploads, so the
-        # table has to be complete before anything can write a file.
-        register_media_types()
-
-        register_constance_admin()
-        install_type_stubs()
-        patch_drf_authentication()
-        validate_registry()

django_cfg-2.3.332/src/django_cfg/startup/constance.py

@@ -1,27 +0,0 @@
-"""
-django_cfg.startup.constance — Register Constance admin with Unfold integration.
-"""
-
-
-def register_constance_admin() -> None:
-    """Register Constance admin using Unfold ModelAdmin if both are installed."""
-    try:
-        from django.conf import settings
-        from django.contrib import admin
-
-        if not (hasattr(settings, "CONSTANCE_CONFIG") and settings.CONSTANCE_CONFIG):
-            return
-
-        from constance.admin import Config, ConstanceAdmin
-        from unfold.admin import ModelAdmin
-
-        class ConstanceConfigAdmin(ConstanceAdmin, ModelAdmin):
-            """Constance admin with Unfold integration."""
-            pass
-
-        admin.site._registry[Config] = ConstanceConfigAdmin(Config, admin.site)
-
-    except ImportError:
-        pass
-    except Exception:
-        pass

django_cfg-2.3.332/src/django_cfg/startup/type_stubs.py

@@ -1,22 +0,0 @@
-"""
-django_cfg.startup.type_stubs — Auto-install DRF type stubs for Pyright.
-
-Writes typings/rest_framework/serializers.pyi and patches pyrightconfig.json
-so that after is_valid(raise_exception=True) Pyright narrows validated_data
-to dict[str, Any]. Only runs in development environments.
-"""
-
-
-def install_type_stubs() -> None:
-    """Install DRF validated_data type stubs. No-op in production."""
-    try:
-        import os
-        is_dev = os.environ.get("DJANGO_ENV", "development") not in ("production", "prod")
-        if not is_dev:
-            return
-
-        from django_cfg.core.integration.setup_types import install
-        install()
-
-    except Exception:
-        pass