django-cfg 1.4.109__tar.gz → 1.4.110__tar.gz

{django_cfg-1.4.109 → django_cfg-1.4.110}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.109
+Version: 1.4.110
 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
@@ -58,6 +58,7 @@ Requires-Dist: httpx<1.0,>=0.28.1
 Requires-Dist: jinja2<4.0.0,>=3.1.6
 Requires-Dist: loguru<1.0,>=0.7.0
 Requires-Dist: lxml<7.0,>=6.0.0
+Requires-Dist: mistune<4.0,>=3.1.4
 Requires-Dist: mypy<2.0.0,>=1.18.2
 Requires-Dist: ngrok>=1.5.1; python_version >= '3.12'
 Requires-Dist: openai<2.0,>=1.107.0

{django_cfg-1.4.109 → django_cfg-1.4.110}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.109"
+version = "1.4.110"
 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",]
 classifiers = [ "Development Status :: 4 - Beta", "Framework :: Django", "Framework :: Django :: 5.2", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Dynamic Content", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Systems Administration", "Typing :: Typed",]
 requires-python = ">=3.12,<3.14"
-dependencies = [ "pydantic>=2.11.0,<3.0", "pydantic[email]>=2.11.0,<3.0", "PyYAML>=6.0,<7.0", "click>=8.2.0,<9.0", "questionary>=2.1.0,<3.0", "rich>=14.0.0,<15.0", "cloudflare>=4.3.0,<5.0", "loguru>=0.7.0,<1.0", "colorlog>=6.9.0,<7.0", "cachetools>=5.3.0,<7.0", "toml>=0.10.2,<0.11.0", "ngrok>=1.5.1; python_version>='3.12'", "psycopg[binary,pool]>=3.2.0,<4.0", "dj-database-url>=3.0.0,<4.0", "whitenoise>=6.8.0,<7.0", "django-cors-headers>=4.7.0,<5.0", "djangorestframework>=3.16.0,<4.0", "djangorestframework-simplejwt>=5.5.0,<6.0", "djangorestframework-simplejwt[token-blacklist]>=5.5.0,<6.0", "drf-nested-routers>=0.94.0,<1.0", "django-filter>=25.0,<26.0", "django-ratelimit>=4.1.0,<5.0.0", "drf-spectacular>=0.28.0,<1.0", "drf-spectacular-sidecar>=2025.8.0,<2026.0", "django-json-widget>=2.0.0,<3.0", "django-import-export>=4.3.0,<5.0", "django-extensions>=4.1.0,<5.0", "django-constance>=4.3.0,<5.0", "django-unfold>=0.64.0,<1.0", "django-redis>=6.0.0,<7.0", "redis>=6.4.0,<7.0", "hiredis>=2.0.0,<4.0", "rearq>=0.2.0,<1.0", "setuptools>=75.0.0; python_version>='3.13'", "pyTelegramBotAPI>=4.28.0,<5.0", "coolname>=2.2.0,<3.0", "django-admin-rangefilter>=0.13.0,<1.0", "python-json-logger>=3.3.0,<4.0", "requests>=2.32.0,<3.0", "tiktoken>=0.11.0,<1.0", "openai>=1.107.0,<2.0", "twilio>=9.8.0,<10.0", "sendgrid>=6.12.0,<7.0", "beautifulsoup4>=4.13.0,<5.0", "lxml>=6.0.0,<7.0", "pgvector>=0.4.0,<1.0", "tenacity>=9.1.2,<10.0.0", "mypy (>=1.18.2,<2.0.0)", "django-tailwind[reload] (>=4.2.0,<5.0.0)", "jinja2 (>=3.1.6,<4.0.0)", "django-axes[ipware] (>=8.0.0,<9.0.0)", "pydantic-settings (>=2.11.0,<3.0.0)", "pytz>=2025.1", "httpx>=0.28.1,<1.0",]
+dependencies = [ "pydantic>=2.11.0,<3.0", "pydantic[email]>=2.11.0,<3.0", "PyYAML>=6.0,<7.0", "click>=8.2.0,<9.0", "questionary>=2.1.0,<3.0", "rich>=14.0.0,<15.0", "cloudflare>=4.3.0,<5.0", "loguru>=0.7.0,<1.0", "colorlog>=6.9.0,<7.0", "cachetools>=5.3.0,<7.0", "toml>=0.10.2,<0.11.0", "ngrok>=1.5.1; python_version>='3.12'", "psycopg[binary,pool]>=3.2.0,<4.0", "dj-database-url>=3.0.0,<4.0", "whitenoise>=6.8.0,<7.0", "django-cors-headers>=4.7.0,<5.0", "djangorestframework>=3.16.0,<4.0", "djangorestframework-simplejwt>=5.5.0,<6.0", "djangorestframework-simplejwt[token-blacklist]>=5.5.0,<6.0", "drf-nested-routers>=0.94.0,<1.0", "django-filter>=25.0,<26.0", "django-ratelimit>=4.1.0,<5.0.0", "drf-spectacular>=0.28.0,<1.0", "drf-spectacular-sidecar>=2025.8.0,<2026.0", "django-json-widget>=2.0.0,<3.0", "django-import-export>=4.3.0,<5.0", "django-extensions>=4.1.0,<5.0", "django-constance>=4.3.0,<5.0", "django-unfold>=0.64.0,<1.0", "django-redis>=6.0.0,<7.0", "redis>=6.4.0,<7.0", "hiredis>=2.0.0,<4.0", "rearq>=0.2.0,<1.0", "setuptools>=75.0.0; python_version>='3.13'", "pyTelegramBotAPI>=4.28.0,<5.0", "coolname>=2.2.0,<3.0", "django-admin-rangefilter>=0.13.0,<1.0", "python-json-logger>=3.3.0,<4.0", "requests>=2.32.0,<3.0", "tiktoken>=0.11.0,<1.0", "openai>=1.107.0,<2.0", "twilio>=9.8.0,<10.0", "sendgrid>=6.12.0,<7.0", "beautifulsoup4>=4.13.0,<5.0", "lxml>=6.0.0,<7.0", "pgvector>=0.4.0,<1.0", "tenacity>=9.1.2,<10.0.0", "mypy (>=1.18.2,<2.0.0)", "django-tailwind[reload] (>=4.2.0,<5.0.0)", "jinja2 (>=3.1.6,<4.0.0)", "django-axes[ipware] (>=8.0.0,<9.0.0)", "pydantic-settings (>=2.11.0,<3.0.0)", "pytz>=2025.1", "httpx>=0.28.1,<1.0", "mistune>=3.1.4,<4.0",]
 [[project.authors]]
 name = "Django-CFG Team"
 email = "info@djangocfg.com"

{django_cfg-1.4.109 → django_cfg-1.4.110}/requirements-dev.txt

@@ -40,6 +40,7 @@ isort>=6.0,<7.0
 jinja2 (>=3.1.6,<4.0.0)
 loguru>=0.7.0,<1.0
 lxml>=6.0.0,<7.0
+mistune>=3.1.4,<4.0
 mkdocs-material>=9.6,<10.0
 mkdocs>=1.6,<2.0
 mkdocstrings[python]>=0.30,<1.0

{django_cfg-1.4.109 → django_cfg-1.4.110}/requirements-test.txt

@@ -36,6 +36,7 @@ httpx>=0.28.1,<1.0
 jinja2 (>=3.1.6,<4.0.0)
 loguru>=0.7.0,<1.0
 lxml>=6.0.0,<7.0
+mistune>=3.1.4,<4.0
 mypy (>=1.18.2,<2.0.0)
 ngrok>=1.5.1; python_version>='3.12'
 openai>=1.107.0,<2.0

{django_cfg-1.4.109 → django_cfg-1.4.110}/requirements.txt

@@ -33,6 +33,7 @@ httpx>=0.28.1,<1.0
 jinja2 (>=3.1.6,<4.0.0)
 loguru>=0.7.0,<1.0
 lxml>=6.0.0,<7.0
+mistune>=3.1.4,<4.0
 mypy (>=1.18.2,<2.0.0)
 ngrok>=1.5.1; python_version>='3.12'
 openai>=1.107.0,<2.0

{django_cfg-1.4.109 → django_cfg-1.4.110}/src/django_cfg/__init__.py

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

{django_cfg-1.4.109 → django_cfg-1.4.110}/src/django_cfg/modules/django_admin/__init__.py

@@ -51,9 +51,11 @@ from .config import (
     BooleanField,
     CurrencyField,
     DateTimeField,
+    DocumentationConfig,
     FieldConfig,
     FieldsetConfig,
     ImageField,
+    MarkdownField,
     ResourceConfig,
     TextField,
     UserField,
@@ -73,6 +75,7 @@ from .icons import IconCategories, Icons
 from .utils import (
     CounterBadge,
     DateTimeDisplay,
+    MarkdownRenderer,
     MoneyDisplay,
     ProgressBadge,
     StatusBadge,
@@ -105,12 +108,14 @@ __all__ = [
     "ActionConfig",
     "ResourceConfig",
     "BackgroundTaskConfig",
+    "DocumentationConfig",
     # Specialized Field Types
     "BadgeField",
     "BooleanField",
     "CurrencyField",
     "DateTimeField",
     "ImageField",
+    "MarkdownField",
     "TextField",
     "UserField",
     # Advanced
@@ -125,6 +130,7 @@ __all__ = [
     "StatusBadge",
     "ProgressBadge",
     "CounterBadge",
+    "MarkdownRenderer",
     # Decorators
     "computed_field",
     "badge_field",

{django_cfg-1.4.109 → django_cfg-1.4.110}/src/django_cfg/modules/django_admin/base/pydantic_admin.py

@@ -3,6 +3,7 @@ PydanticAdmin - Declarative admin base class.
 """
 
 import logging
+from pathlib import Path
 from typing import Any, List, Optional
 
 from django.utils.safestring import mark_safe
@@ -152,6 +153,56 @@ class PydanticAdminMixin:
 
             cls.changelist_view = changelist_view_with_import_export
 
+        # Documentation configuration
+        if config.documentation:
+            cls._setup_documentation(config)
+
+    @classmethod
+    def _setup_documentation(cls, config: AdminConfig):
+        """
+        Setup documentation using unfold's template hooks.
+
+        Uses unfold's built-in hooks:
+        - list_before_template: Shows documentation before changelist table
+        - change_form_before_template: Shows documentation before fieldsets
+        """
+        doc_config = config.documentation
+
+        # Set unfold template hooks
+        if doc_config.show_on_changelist:
+            cls.list_before_template = "django_admin/documentation_block.html"
+
+        if doc_config.show_on_changeform:
+            cls.change_form_before_template = "django_admin/documentation_block.html"
+
+        # Store documentation config for access in views
+        cls.documentation_config = doc_config
+
+    def _get_app_path(self) -> Optional[Path]:
+        """
+        Detect the app path for relative file resolution.
+
+        Returns:
+            Path to the app directory or None
+        """
+        if not self.model:
+            return None
+
+        try:
+            # Get app label from model
+            app_label = self.model._meta.app_label
+
+            # Try to get app config
+            from django.apps import apps
+            app_config = apps.get_app_config(app_label)
+
+            if app_config and hasattr(app_config, 'path'):
+                return Path(app_config.path)
+        except Exception as e:
+            logger.warning(f"Could not detect app path for {self.model}: {e}")
+
+        return None
+
     @classmethod
     def _generate_resource_class(cls, config: AdminConfig):
         """
@@ -452,6 +503,46 @@ class PydanticAdminMixin:
 
         return tuple(filtered_fieldsets)
 
+    def changelist_view(self, request, extra_context=None):
+        """Override to add documentation context to changelist."""
+        if extra_context is None:
+            extra_context = {}
+
+        # Add documentation context if configured
+        if hasattr(self, 'documentation_config') and self.documentation_config:
+            doc_config = self.documentation_config
+            app_path = self._get_app_path()
+
+            if doc_config.show_on_changelist:
+                extra_context['documentation_config'] = doc_config
+                extra_context['documentation_sections'] = doc_config.get_sections(app_path)
+
+                # Add management commands if enabled
+                if doc_config.show_management_commands:
+                    extra_context['management_commands'] = doc_config._discover_management_commands(app_path)
+
+        return super().changelist_view(request, extra_context)
+
+    def changeform_view(self, request, object_id=None, form_url='', extra_context=None):
+        """Override to add documentation context to changeform."""
+        if extra_context is None:
+            extra_context = {}
+
+        # Add documentation context if configured
+        if hasattr(self, 'documentation_config') and self.documentation_config:
+            doc_config = self.documentation_config
+            app_path = self._get_app_path()
+
+            if doc_config.show_on_changeform:
+                extra_context['documentation_config'] = doc_config
+                extra_context['documentation_sections'] = doc_config.get_sections(app_path)
+
+                # Add management commands if enabled
+                if doc_config.show_management_commands:
+                    extra_context['management_commands'] = doc_config._discover_management_commands(app_path)
+
+        return super().changeform_view(request, object_id, form_url, extra_context)
+
     def formfield_for_dbfield(self, db_field, request, **kwargs):
         """
         Override form field for specific database field types.

{django_cfg-1.4.109 → django_cfg-1.4.110}/src/django_cfg/modules/django_admin/config/__init__.py

@@ -5,6 +5,7 @@ Configuration models for declarative Django Admin.
 from .action_config import ActionConfig
 from .admin_config import AdminConfig
 from .background_task_config import BackgroundTaskConfig
+from .documentation_config import DocumentationConfig, DocumentationSection
 from .field_config import (
     FieldConfig,
     BadgeField,
@@ -12,6 +13,7 @@ from .field_config import (
     CurrencyField,
     DateTimeField,
     ImageField,
+    MarkdownField,
     TextField,
     UserField,
 )
@@ -25,12 +27,15 @@ __all__ = [
     "ActionConfig",
     "ResourceConfig",
     "BackgroundTaskConfig",
+    "DocumentationConfig",
+    "DocumentationSection",
     # Specialized Field Types
     "BadgeField",
     "BooleanField",
     "CurrencyField",
     "DateTimeField",
     "ImageField",
+    "MarkdownField",
     "TextField",
     "UserField",
 ]

{django_cfg-1.4.109 → django_cfg-1.4.110}/src/django_cfg/modules/django_admin/config/admin_config.py

@@ -9,6 +9,7 @@ from pydantic import BaseModel, ConfigDict, Field
 
 from .action_config import ActionConfig
 from .background_task_config import BackgroundTaskConfig
+from .documentation_config import DocumentationConfig
 from .field_config import FieldConfig
 from .fieldset_config import FieldsetConfig
 from .resource_config import ResourceConfig
@@ -141,6 +142,12 @@ class AdminConfig(BaseModel):
         description="Configuration for background task processing"
     )
 
+    # Documentation
+    documentation: Optional[DocumentationConfig] = Field(
+        None,
+        description="Markdown documentation configuration"
+    )
+
     def get_display_field_config(self, field_name: str) -> Optional[FieldConfig]:
         """Get FieldConfig for a specific field."""
         for field_config in self.display_fields: