django-cfg 1.4.96__py3-none-any.whl → 1.4.97__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.96"
+__version__ = "1.4.97"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/apps/frontend/views.py

@@ -4,8 +4,9 @@ JWT tokens are automatically injected into HTML responses for authenticated user
 This is specific to Next.js frontend apps only.
 
 Features:
-- Automatic extraction of ZIP archives with timestamp comparison
-- Auto-reextraction when ZIP is newer than extracted directory
+- Automatic extraction of ZIP archives with metadata comparison (size + mtime)
+- Auto-reextraction when ZIP content changes (size or timestamp)
+- Marker file (.zip_meta) tracks ZIP metadata for reliable comparison
 - Cache busting (no-store headers for HTML)
 - SPA routing with fallback strategies
 - JWT token injection for authenticated users
@@ -29,12 +30,13 @@ logger = logging.getLogger(__name__)
 
 class ZipExtractionMixin:
     """
-    Mixin for automatic ZIP extraction with timestamp-based refresh.
+    Mixin for automatic ZIP extraction with metadata-based refresh.
 
     Provides intelligent ZIP archive handling:
     - Auto-extraction when directory doesn't exist
-    - Auto-reextraction when ZIP is newer than extracted directory
-    - Timestamp comparison ensures fresh builds are always deployed
+    - Auto-reextraction when ZIP metadata changes (size or mtime)
+    - Marker file (.zip_meta) tracks ZIP state for reliable comparison
+    - Works correctly in Docker where timestamps can be misleading
 
     Usage:
         class MyView(ZipExtractionMixin, View):
@@ -43,12 +45,16 @@ class ZipExtractionMixin:
 
     def extract_zip_if_needed(self, base_dir: Path, zip_path: Path, app_name: str) -> bool:
         """
-        Extract ZIP archive if needed based on ZIP modification time comparison.
+        Extract ZIP archive if needed based on ZIP metadata (size + mtime) comparison.
 
         Logic:
         1. If directory doesn't exist → extract
-        2. If ZIP is newer than directory → remove and re-extract
-        3. If directory is newer than ZIP → use existing
+        2. If marker file doesn't exist → extract
+        3. If ZIP metadata changed (size or mtime) → remove and re-extract
+        4. If metadata matches → use existing
+
+        Uses marker file (.zip_meta) to track ZIP metadata. More reliable than
+        just mtime comparison, especially in Docker where timestamps can be misleading.
 
         Args:
             base_dir: Target directory for extraction
@@ -65,30 +71,40 @@ class ZipExtractionMixin:
             logger.error(f"[{app_name}] ZIP not found: {zip_path}")
             return False
 
-        # Get ZIP modification time
-        zip_mtime = datetime.fromtimestamp(zip_path.stat().st_mtime)
+        # Get ZIP metadata (size + mtime for reliable comparison)
+        zip_stat = zip_path.stat()
+        current_meta = f"{zip_stat.st_size}:{zip_stat.st_mtime}"
+
+        # Marker file stores ZIP metadata
+        marker_file = base_dir / '.zip_meta'
 
         # Priority 1: If directory doesn't exist at all - always extract
         if not base_dir.exists():
             should_extract = True
             logger.info(f"[{app_name}] Directory doesn't exist, will extract")
 
-        # Priority 2: Directory exists - compare timestamps
+        # Priority 2: Marker file doesn't exist - extract (first run or corrupted)
+        elif not marker_file.exists():
+            should_extract = True
+            logger.info(f"[{app_name}] No marker file found, will extract")
+
+        # Priority 3: Compare stored metadata with current ZIP metadata
         else:
-            # Get directory modification time
-            dir_mtime = datetime.fromtimestamp(base_dir.stat().st_mtime)
-
-            # If ZIP is newer than directory - re-extract
-            if zip_mtime > dir_mtime:
-                logger.info(f"[{app_name}] ZIP is newer (ZIP: {zip_mtime}, DIR: {dir_mtime}), re-extracting")
-                try:
-                    shutil.rmtree(base_dir)
-                    should_extract = True
-                except Exception as e:
-                    logger.error(f"[{app_name}] Failed to remove old directory: {e}")
-                    return False
-            else:
-                logger.debug(f"[{app_name}] Directory is up-to-date (DIR: {dir_mtime} >= ZIP: {zip_mtime})")
+            try:
+                stored_meta = marker_file.read_text().strip()
+                if stored_meta != current_meta:
+                    logger.info(f"[{app_name}] ZIP metadata changed (stored: {stored_meta}, current: {current_meta}), re-extracting")
+                    try:
+                        shutil.rmtree(base_dir)
+                        should_extract = True
+                    except Exception as e:
+                        logger.error(f"[{app_name}] Failed to remove old directory: {e}")
+                        return False
+                else:
+                    logger.info(f"[{app_name}] ZIP unchanged (meta: {current_meta}), using existing directory")
+            except Exception as e:
+                logger.warning(f"[{app_name}] Failed to read marker file: {e}, will re-extract")
+                should_extract = True
 
         # Extract ZIP if needed
         if should_extract:
@@ -97,7 +113,10 @@ class ZipExtractionMixin:
                 base_dir.parent.mkdir(parents=True, exist_ok=True)
                 with zipfile.ZipFile(zip_path, 'r') as zip_ref:
                     zip_ref.extractall(base_dir)
-                logger.info(f"[{app_name}] Successfully extracted {zip_path.name}")
+
+                # Write marker file with current metadata
+                marker_file.write_text(current_meta)
+                logger.info(f"[{app_name}] Successfully extracted {zip_path.name} and saved marker (meta: {current_meta})")
                 return True
             except Exception as e:
                 logger.error(f"[{app_name}] Failed to extract: {e}")
@@ -114,7 +133,7 @@ class NextJSStaticView(ZipExtractionMixin, View):
 
     Features:
     - Serves Next.js static export files like a static file server
-    - Smart ZIP extraction: auto-refreshes when ZIP is newer than directory
+    - Smart ZIP extraction: compares ZIP metadata (size + mtime) with marker file
     - Automatically injects JWT tokens for authenticated users
     - Tokens injected into HTML responses only
     - Handles Next.js client-side routing (.html fallback)
@@ -123,9 +142,10 @@ class NextJSStaticView(ZipExtractionMixin, View):
 
     ZIP Extraction Logic:
     - If directory doesn't exist: extract from ZIP
-    - If ZIP is newer than directory: remove and re-extract
-    - If directory is up-to-date: use existing files
-    - This ensures fresh builds are always deployed automatically
+    - If marker file missing: extract from ZIP
+    - If ZIP metadata changed: remove and re-extract
+    - If metadata matches: use existing files
+    - Marker file (.zip_meta) ensures reliable comparison in Docker
 
     Path resolution examples:
     - /cfg/admin/              → /cfg/admin/index.html

django_cfg/modules/nextjs_admin/views.py

@@ -5,8 +5,8 @@ Serves Next.js static files with SPA routing support and JWT injection.
 
 Features:
 - Priority-based ZIP resolution (solution project → package fallback)
-- Automatic extraction with timestamp comparison (ZIP mtime vs directory mtime)
-- Cache busting (no-store headers + timestamp query params)
+- Automatic extraction with metadata comparison (ZIP size + mtime vs marker file)
+- Cache busting (no-store headers for HTML)
 - SPA routing with fallback strategies
 - JWT token injection for authenticated users
 
@@ -15,8 +15,9 @@ ZIP Resolution Priority:
 2. Package fallback: django_cfg/static/frontend/nextjs_admin.zip → django_cfg/static/frontend/nextjs_admin/
 
 Extraction Logic:
-- Compares ZIP mtime with directory mtime
-- Re-extracts only when ZIP is newer
+- Marker file (.zip_meta) tracks ZIP metadata (size:mtime)
+- Re-extracts when metadata changes (size or timestamp)
+- Reliable in Docker where timestamps can be misleading
 - Ensures fresh builds are deployed automatically
 """
 
@@ -42,7 +43,7 @@ class NextJsAdminView(ZipExtractionMixin, LoginRequiredMixin, View):
     Features:
     - Serves Next.js static build files
     - Priority-based ZIP resolution (solution first, package fallback)
-    - Smart ZIP extraction: compares ZIP mtime vs directory mtime
+    - Smart ZIP extraction: metadata comparison (size + mtime) with marker file
     - Cache busting: no-store headers for HTML files
     - Automatic JWT token injection for authenticated users
     - SPA routing support (path/to/route → path/to/route/index.html)
@@ -53,9 +54,10 @@ class NextJsAdminView(ZipExtractionMixin, LoginRequiredMixin, View):
 
     ZIP Extraction Logic:
     - If directory doesn't exist: extract from ZIP
-    - If ZIP is newer than directory: remove and re-extract
-    - If directory is up-to-date: use existing files
-    - Ensures fresh builds are deployed automatically
+    - If marker file missing: extract from ZIP
+    - If ZIP metadata changed: remove and re-extract
+    - If metadata matches: use existing files
+    - Marker file (.zip_meta) ensures reliable comparison in Docker
 
     URL Examples:
         /cfg/nextjs-admin/admin/                    → admin/index.html

django_cfg/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.96"
+version = "1.4.97"
 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/templatetags/django_cfg.py

@@ -6,7 +6,6 @@ Provides template tags for accessing django-cfg configuration constants.
 
 import os
 import socket
-import time
 from django import template
 from django.conf import settings
 from django.utils.safestring import mark_safe
@@ -184,13 +183,9 @@ def nextjs_admin_url(path=''):
     # Normalize path - remove leading/trailing slashes
     path = path.strip('/')
 
-    # Add cache busting parameter (timestamp in milliseconds)
-    cache_buster = f'_={int(time.time() * 1000)}'
-
     if not settings.DEBUG:
-        # Production mode: always use static files with cache buster
-        base_url = f'/cfg/admin/admin/{path}' if path else '/cfg/admin/admin/'
-        return f'{base_url}?{cache_buster}'
+        # Production mode: always use static files
+        return f'/cfg/admin/{path}' if path else '/cfg/admin/'
 
     # Check if port 3001 is available for Tab 1 (built-in admin)
     port_3001_available = _is_port_available('localhost', 3001)
@@ -198,13 +193,11 @@ def nextjs_admin_url(path=''):
     if port_3001_available:
         # Dev server is running on 3001 - use it (builtin admin has no /admin prefix)
         base_url = 'http://localhost:3001'
-        url = f'{base_url}/{path}' if path else base_url
-        return f'{url}?{cache_buster}'
+        return f'{base_url}/{path}' if path else base_url
     else:
-        # No dev server or dev server stopped - use static files with cache buster
+        # No dev server or dev server stopped - use static files
         # Static files are served from /cfg/admin/ but ZIP contains files in root (no /admin prefix)
-        base_url = f'/cfg/admin/{path}' if path else '/cfg/admin/'
-        return f'{base_url}?{cache_buster}'
+        return f'/cfg/admin/{path}' if path else '/cfg/admin/'
 
 
 @register.simple_tag
@@ -280,20 +273,15 @@ def nextjs_external_admin_url(route=''):
 
         route = route.strip('/')
 
-        # Add cache busting parameter (timestamp in milliseconds)
-        cache_buster = f'_={int(time.time() * 1000)}'
-
         # Auto-detect development mode: DEBUG=True + port 3000 available
         if settings.DEBUG and _is_port_available('localhost', 3000):
             # Development mode: solution project on port 3000
             # Routes start with /admin in Next.js (e.g., /admin, /admin/crypto)
             base_url = 'http://localhost:3000/admin'
-            url = f'{base_url}/{route}' if route else base_url
-            return f'{url}?{cache_buster}'
+            return f'{base_url}/{route}' if route else base_url
         else:
             # Production mode: use relative URL - Django serves from extracted ZIP with /admin prefix
-            base_url = f"/cfg/nextjs-admin/admin/{route}" if route else "/cfg/nextjs-admin/admin/"
-            return f'{base_url}?{cache_buster}'
+            return f"/cfg/nextjs-admin/admin/{route}" if route else "/cfg/nextjs-admin/admin/"
     except Exception:
         return ''
 

{django_cfg-1.4.96.dist-info → django_cfg-1.4.97.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.96
+Version: 1.4.97
 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

{django_cfg-1.4.96.dist-info → django_cfg-1.4.97.dist-info}/RECORD

@@ -1,5 +1,5 @@
 django_cfg/README.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/__init__.py,sha256=UbaqH6yGdQLEgNwn0Hmp7oKhbtKyZTVYU4UIvyIPn_c,1620
+django_cfg/__init__.py,sha256=_L0rVeRDg_vkLAwSqGT8ka-Mc6eZ0ddniv5wfm9RJvM,1620
 django_cfg/apps.py,sha256=72m3uuvyqGiLx6gOfE-BD3P61jddCCERuBOYpxTX518,1605
 django_cfg/config.py,sha256=y4Z3rnYsHBE0TehpwAIPaxr---mkvyKrZGGsNwYso74,1398
 django_cfg/apps/__init__.py,sha256=JtDmEYt1OcleWM2ZaeX0LKDnRQzPOavfaXBWG4ECB5Q,26
@@ -228,7 +228,7 @@ django_cfg/apps/frontend/apps.py,sha256=9eEK0Tq2nOsol7xSK5aobdwTDJTJrWx6Iy1I1DQb
 django_cfg/apps/frontend/setup.py,sha256=TxKQwQw4xTF6VSyhrQBzbUsdsVQR9JHdjc36LZKeQh4,2444
 django_cfg/apps/frontend/test_routing.py,sha256=fshJOR9ln7m3gXY9EI1_ix_6E5xua6DR264b16RIF-w,4832
 django_cfg/apps/frontend/urls.py,sha256=Vz22_2i2w1J0KQYDCxHnTF5rUf32kUUSBDJZrP07XgY,284
-django_cfg/apps/frontend/views.py,sha256=SOYOgZdJWnNQLOMLY1Lx7xkGnI_pS4OKV5UNydQsh48,13922
+django_cfg/apps/frontend/views.py,sha256=JPTJRPCGY3zLLiiz1F9CsZiLkXbQ5RfnViJZzBUpV7o,15023
 django_cfg/apps/frontend/templates/frontend/404.html,sha256=LCFig_dcgDDmYKhgOLu8R2KDs_aQS6Es6rAxLTAEXWs,2175
 django_cfg/apps/knowbase/README.md,sha256=HXt_J6WCN-LsMhA7p9mdvih07_vp_r_hkPdmqHhNEeo,3965
 django_cfg/apps/knowbase/__init__.py,sha256=cfGnxDQwjajPhUoleKkgvdabJcB0LdXEglnsBojKkPo,1045
@@ -1021,7 +1021,7 @@ django_cfg/modules/django_unfold/models/navigation.py,sha256=PPEeqA2HBaA1-VjADiX
 django_cfg/modules/nextjs_admin/__init__.py,sha256=lfrZYyNRExH3Z5De8G4hQBIZoFlW5Ejze3couNrztbY,312
 django_cfg/modules/nextjs_admin/apps.py,sha256=HxVUMmWTKdYpwJ00iIfWVFsBzsawsOVhEPZqjk_izjI,347
 django_cfg/modules/nextjs_admin/urls.py,sha256=7n0yStm0WNchw14Rtu_mgsIA3WKQsYP9WZt3-YOUWjU,603
-django_cfg/modules/nextjs_admin/views.py,sha256=4gzdo2gxY2zSs9MxxZc2Z7FfJHGsg5ZcGXWOo4i3sLA,11246
+django_cfg/modules/nextjs_admin/views.py,sha256=zvRMZZRRcwIA3ie0AEnllOUUwLklbt3nq-P5Eq9BzeY,11385
 django_cfg/modules/nextjs_admin/models/__init__.py,sha256=WGw9KXcYd1O9AoA_bpMoz2gLZUlRzjGmUBjjbObcUi0,100
 django_cfg/modules/nextjs_admin/models/config.py,sha256=0ADqLuiywSCQfx_z9dkwjFCca3lr3F2uQffIjTr_QXw,5864
 django_cfg/modules/nextjs_admin/templatetags/__init__.py,sha256=ChVBnJggCIY8rMhfyJFoA8k0qKo-8FtJknrk54Vx4wM,51
@@ -1076,7 +1076,7 @@ django_cfg/templates/admin/index.html,sha256=RidRvZwc6LFzRi8l6vHBgyM_CD0yvhPWvr4
 django_cfg/templates/emails/base_email.html,sha256=TWcvYa2IHShlF_E8jf1bWZStRO0v8G4L_GexPxvz6XQ,8836
 django_cfg/templates/unfold/layouts/skeleton.html,sha256=2ArkcNZ34mFs30cOAsTQ1EZiDXcB0aVxkO71lJq9SLE,718
 django_cfg/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/templatetags/django_cfg.py,sha256=BLkdH6Pl32itRafOpPxXGg1QhZ9huacAAqFv-W8LTkM,10044
+django_cfg/templatetags/django_cfg.py,sha256=Q1-dQV8SPOuQu1dFg5eT1gT88eEUXloYMz-7_-OHT0c,9522
 django_cfg/utils/__init__.py,sha256=64wwXJuXytvwt8Ze_erSR2HmV07nGWJ6DV5wloRBvYE,435
 django_cfg/utils/path_resolution.py,sha256=2n0I04lQkSssFaELu3A93YyMAl1K10KPdpxMt5k4Iy0,13341
 django_cfg/utils/smart_defaults.py,sha256=ZUj6K_Deq-fp5O0Dy_Emt257UWFn0f9bkgFv9YCR58U,9239
@@ -1084,9 +1084,9 @@ django_cfg/utils/version_check.py,sha256=WO51J2m2e-wVqWCRwbultEwu3q1lQasV67Mw2aa
 django_cfg/CHANGELOG.md,sha256=jtT3EprqEJkqSUh7IraP73vQ8PmKUMdRtznQsEnqDZk,2052
 django_cfg/CONTRIBUTING.md,sha256=DU2kyQ6PU0Z24ob7O_OqKWEYHcZmJDgzw-lQCmu6uBg,3041
 django_cfg/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg/pyproject.toml,sha256=Npc1mjOUxl_Dvp1uFVjLCbrQo1tlTMMxj4Oemc6kLvo,8572
-django_cfg-1.4.96.dist-info/METADATA,sha256=6LS9GzmiwHVvee547cEZjnwrdkib9Kw9Zja8LowXnk0,23733
-django_cfg-1.4.96.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-django_cfg-1.4.96.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
-django_cfg-1.4.96.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg-1.4.96.dist-info/RECORD,,
+django_cfg/pyproject.toml,sha256=0AbWzGlCW_MemwzdLfIeySO-sNszpPYNvkPOTe_DUF4,8572
+django_cfg-1.4.97.dist-info/METADATA,sha256=cb_cXupXvXVnnbikccyCZZwHhzgsBSOa8OWbx76N524,23733
+django_cfg-1.4.97.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+django_cfg-1.4.97.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
+django_cfg-1.4.97.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
+django_cfg-1.4.97.dist-info/RECORD,,