django-cfg 1.4.109__py3-none-any.whl → 1.4.110__py3-none-any.whl

django_cfg/modules/django_admin/utils/markdown_renderer.py

@@ -0,0 +1,344 @@
+"""
+Markdown rendering service for Django Admin.
+
+Provides utilities for rendering markdown content from strings or files
+with beautiful Tailwind CSS styling and collapsible sections.
+"""
+
+import logging
+import os
+from pathlib import Path
+from typing import Any, Optional, Union
+
+from django.utils.html import escape, format_html
+from django.utils.safestring import SafeString, mark_safe
+
+logger = logging.getLogger(__name__)
+
+try:
+    import mistune
+    MISTUNE_AVAILABLE = True
+except ImportError:
+    MISTUNE_AVAILABLE = False
+
+
+class MarkdownRenderer:
+    """
+    Markdown rendering service with file/string support and collapsible UI.
+
+    Features:
+        - Render markdown from strings or .md files
+        - Auto-detect content type (file path vs markdown string)
+        - Beautiful Tailwind CSS styling with dark mode
+        - Collapsible sections for documentation
+        - Support for all markdown features (tables, code blocks, etc.)
+
+    Usage:
+        # In admin.py
+        from django_cfg.modules.django_admin.utils import MarkdownRenderer
+
+        class MyAdmin(admin.ModelAdmin):
+            def documentation(self, obj):
+                # From file
+                return MarkdownRenderer.render(obj.docs_file_path, collapsible=True)
+
+                # From string
+                return MarkdownRenderer.render(obj.markdown_content, collapsible=True)
+
+                # From field or string with custom title
+                return MarkdownRenderer.render(
+                    obj.description,
+                    collapsible=True,
+                    title="Description"
+                )
+    """
+
+    # Singleton markdown parser instances
+    _md_with_plugins = None
+    _md_without_plugins = None
+
+    @classmethod
+    def _get_markdown_parser(cls, enable_plugins: bool = True):
+        """Get or create markdown parser instance (singleton pattern)."""
+        if not MISTUNE_AVAILABLE:
+            return None
+
+        if enable_plugins:
+            if cls._md_with_plugins is None:
+                cls._md_with_plugins = mistune.create_markdown(
+                    plugins=['strikethrough', 'table', 'url', 'task_lists', 'def_list']
+                )
+            return cls._md_with_plugins
+        else:
+            if cls._md_without_plugins is None:
+                cls._md_without_plugins = mistune.create_markdown()
+            return cls._md_without_plugins
+
+    @classmethod
+    def _load_from_file(cls, file_path: Union[str, Path]) -> Optional[str]:
+        """
+        Load markdown content from file.
+
+        Args:
+            file_path: Path to .md file
+
+        Returns:
+            File content or None if error
+        """
+        try:
+            path = Path(file_path)
+            if not path.exists():
+                logger.warning(f"Markdown file not found: {file_path}")
+                return None
+
+            if not path.suffix.lower() in ['.md', '.markdown']:
+                logger.warning(f"File is not a markdown file: {file_path}")
+                return None
+
+            with open(path, 'r', encoding='utf-8') as f:
+                return f.read()
+        except Exception as e:
+            logger.error(f"Error loading markdown file {file_path}: {e}")
+            return None
+
+    @classmethod
+    def _is_file_path(cls, content: str) -> bool:
+        """
+        Check if content is a file path.
+
+        Args:
+            content: String to check
+
+        Returns:
+            True if looks like a file path
+        """
+        # Check if it's a valid path and file exists
+        if '\n' in content:
+            return False  # Multi-line content is not a file path
+
+        try:
+            path = Path(content)
+            return path.exists() and path.is_file() and path.suffix.lower() in ['.md', '.markdown']
+        except (OSError, ValueError):
+            return False
+
+    @classmethod
+    def render_markdown(
+        cls,
+        text: str,
+        css_class: str = "",
+        max_height: Optional[str] = None,
+        enable_plugins: bool = True
+    ) -> SafeString:
+        """
+        Render markdown text to HTML with beautiful Tailwind styling.
+
+        Args:
+            text: Markdown content
+            css_class: Additional CSS classes
+            max_height: Max height with scrolling (e.g., "400px", "20rem")
+            enable_plugins: Enable mistune plugins (tables, strikethrough, etc.)
+
+        Returns:
+            SafeString with rendered HTML
+        """
+        if not MISTUNE_AVAILABLE:
+            return format_html(
+                '<div class="text-warning-600 dark:text-warning-400 p-3 bg-warning-50 dark:bg-warning-900/20 border border-warning-200 dark:border-warning-700 rounded">'
+                '<strong>⚠️ Mistune not installed:</strong> Install with: pip install mistune>=3.1.4'
+                '</div>'
+            )
+
+        if not text:
+            return format_html(
+                '<span class="text-font-subtle-light dark:text-font-subtle-dark">No content</span>'
+            )
+
+        # Get markdown parser
+        md = cls._get_markdown_parser(enable_plugins)
+        if not md:
+            return format_html(
+                '<div class="text-danger-600 dark:text-danger-400">Error: Could not initialize markdown parser</div>'
+            )
+
+        # Render markdown to HTML
+        html_content = md(str(text))
+
+        # Beautiful Tailwind prose styles
+        base_classes = (
+            "prose prose-sm dark:prose-invert max-w-none "
+            "prose-headings:font-semibold prose-headings:text-font-default-light dark:prose-headings:text-font-default-dark "
+            "prose-h1:text-2xl prose-h1:mb-4 prose-h1:mt-6 prose-h1:border-b prose-h1:border-base-200 dark:prose-h1:border-base-700 prose-h1:pb-2 "
+            "prose-h2:text-xl prose-h2:mb-3 prose-h2:mt-5 prose-h2:border-b prose-h2:border-base-200 dark:prose-h2:border-base-700 prose-h2:pb-1 "
+            "prose-h3:text-lg prose-h3:mb-2 prose-h3:mt-4 "
+            "prose-h4:text-base prose-h4:mb-2 prose-h4:mt-3 "
+            "prose-p:mb-3 prose-p:leading-relaxed prose-p:text-font-default-light dark:prose-p:text-font-default-dark "
+            "prose-a:text-primary-600 dark:prose-a:text-primary-400 prose-a:no-underline hover:prose-a:underline prose-a:font-medium "
+            "prose-strong:text-font-default-light dark:prose-strong:text-font-default-dark prose-strong:font-semibold "
+            "prose-code:bg-base-100 dark:prose-code:bg-base-800 prose-code:text-danger-600 dark:prose-code:text-danger-400 "
+            "prose-code:px-1.5 prose-code:py-0.5 prose-code:rounded prose-code:text-xs prose-code:font-mono "
+            "prose-code:before:content-none prose-code:after:content-none "
+            "prose-pre:bg-base-50 dark:prose-pre:bg-base-900 prose-pre:border prose-pre:border-base-200 dark:prose-pre:border-base-700 prose-pre:rounded-lg "
+            "prose-blockquote:border-l-4 prose-blockquote:border-primary-300 dark:prose-blockquote:border-primary-600 "
+            "prose-blockquote:bg-base-50 dark:prose-blockquote:bg-base-900 prose-blockquote:pl-4 prose-blockquote:pr-4 prose-blockquote:py-2 "
+            "prose-blockquote:italic prose-blockquote:text-font-subtle-light dark:prose-blockquote:text-font-subtle-dark "
+            "prose-ul:list-disc prose-ul:pl-6 prose-ul:mb-3 prose-ul:text-font-default-light dark:prose-ul:text-font-default-dark "
+            "prose-ol:list-decimal prose-ol:pl-6 prose-ol:mb-3 prose-ol:text-font-default-light dark:prose-ol:text-font-default-dark "
+            "prose-li:mb-1 "
+            "prose-table:border-collapse prose-table:w-full prose-table:text-sm "
+            "prose-th:bg-base-100 dark:prose-th:bg-base-800 prose-th:border prose-th:border-base-300 dark:prose-th:border-base-600 "
+            "prose-th:px-4 prose-th:py-2 prose-th:text-left prose-th:font-semibold prose-th:text-font-default-light dark:prose-th:text-font-default-dark "
+            "prose-td:border prose-td:border-base-200 dark:prose-td:border-base-700 prose-td:px-4 prose-td:py-2 "
+            "prose-td:text-font-default-light dark:prose-td:text-font-default-dark "
+            "prose-img:rounded-lg prose-img:shadow-md prose-img:border prose-img:border-base-200 dark:prose-img:border-base-700 "
+            "prose-hr:border-base-200 dark:prose-hr:border-base-700 prose-hr:my-6 "
+            "prose-em:text-font-default-light dark:prose-em:text-font-default-dark "
+        )
+
+        # Combine with custom classes
+        classes = f"{base_classes} {css_class}".strip()
+
+        # Add container div with max-height if specified
+        style = ""
+        if max_height:
+            style = f'max-height: {max_height}; overflow-y: auto;'
+
+        return format_html(
+            '<div class="{}" {}>{}</div>',
+            classes,
+            mark_safe(f'style="{style}"') if style else '',
+            mark_safe(html_content)
+        )
+
+    @classmethod
+    def render(
+        cls,
+        content: Union[str, Path],
+        collapsible: bool = False,
+        title: str = "Documentation",
+        icon: str = "description",
+        max_height: Optional[str] = "500px",
+        enable_plugins: bool = True,
+        default_open: bool = False
+    ) -> SafeString:
+        """
+        Universal markdown renderer - auto-detects file vs string content.
+
+        Args:
+            content: Markdown string, file path, or Path object
+            collapsible: Wrap in collapsible Tailwind details/summary
+            title: Title for collapsible section
+            icon: Material icon name for title
+            max_height: Max height for scrolling (None = no limit)
+            enable_plugins: Enable markdown plugins
+            default_open: If collapsible, open by default
+
+        Returns:
+            Rendered HTML as SafeString
+
+        Examples:
+            # Simple render from string
+            MarkdownRenderer.render("# Hello\\n\\nThis is **bold**")
+
+            # From file
+            MarkdownRenderer.render("/path/to/docs.md")
+
+            # Collapsible documentation
+            MarkdownRenderer.render(
+                obj.description,
+                collapsible=True,
+                title="API Documentation",
+                icon="api"
+            )
+
+            # From file with collapse
+            MarkdownRenderer.render(
+                "docs/README.md",
+                collapsible=True,
+                title="Project Documentation",
+                default_open=True
+            )
+        """
+        if not content:
+            return format_html(
+                '<span class="text-font-subtle-light dark:text-font-subtle-dark text-sm">No documentation available</span>'
+            )
+
+        # Convert to string if Path object
+        content_str = str(content)
+
+        # Try to load from file if it looks like a file path
+        markdown_text = content_str
+        is_from_file = False
+
+        if cls._is_file_path(content_str):
+            file_content = cls._load_from_file(content_str)
+            if file_content:
+                markdown_text = file_content
+                is_from_file = True
+            else:
+                return format_html(
+                    '<div class="text-warning-600 dark:text-warning-400 p-3 bg-warning-50 dark:bg-warning-900/20 border border-warning-200 dark:border-warning-700 rounded">'
+                    '<strong>⚠️ File not found:</strong> {}'
+                    '</div>',
+                    escape(content_str)
+                )
+
+        # Render markdown
+        rendered_html = cls.render_markdown(
+            markdown_text,
+            max_height=max_height if not collapsible else None,
+            enable_plugins=enable_plugins
+        )
+
+        # Return without collapse if not requested
+        if not collapsible:
+            return rendered_html
+
+        # Wrap in beautiful collapsible section
+        open_attr = 'open' if default_open else ''
+
+        return format_html(
+            '<details class="group border border-base-200 dark:border-base-700 rounded-lg overflow-hidden bg-white dark:bg-base-800 shadow-sm hover:shadow-md transition-shadow" {}>'
+            '<summary class="cursor-pointer px-4 py-3 bg-base-50 dark:bg-base-900 hover:bg-base-100 dark:hover:bg-base-800 transition-colors flex items-center gap-2 select-none">'
+            '<span class="material-symbols-outlined text-base text-primary-600 dark:text-primary-400 group-open:rotate-90 transition-transform">{}</span>'
+            '<span class="font-semibold text-sm text-font-default-light dark:text-font-default-dark">{}</span>'
+            '<span class="text-xs text-font-subtle-light dark:text-font-subtle-dark ml-auto">{}</span>'
+            '</summary>'
+            '<div class="p-4 bg-white dark:bg-base-800" {}>'
+            '{}'
+            '</div>'
+            '</details>',
+            mark_safe(open_attr),
+            'chevron_right',  # Arrow icon
+            escape(title),
+            'Click to expand' if not default_open else 'Click to collapse',
+            mark_safe(f'style="max-height: {max_height}; overflow-y: auto;"') if max_height else '',
+            rendered_html
+        )
+
+    @classmethod
+    def render_docs(
+        cls,
+        content: Union[str, Path],
+        **kwargs
+    ) -> SafeString:
+        """
+        Shorthand for rendering documentation (always collapsible by default).
+
+        Args:
+            content: Markdown string or file path
+            **kwargs: Additional arguments passed to render()
+
+        Returns:
+            Rendered collapsible documentation
+
+        Example:
+            def documentation(self, obj):
+                return MarkdownRenderer.render_docs(obj.docs_path)
+        """
+        # Set collapsible=True by default for docs
+        if 'collapsible' not in kwargs:
+            kwargs['collapsible'] = True
+
+        return cls.render(content, **kwargs)

django_cfg/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.dist-info → django_cfg-1.4.110.dist-info}/METADATA

@@ -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.dist-info → django_cfg-1.4.110.dist-info}/RECORD

@@ -1,5 +1,5 @@
 django_cfg/README.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/__init__.py,sha256=fOg2eKyhb6AAON0Y5yU5AoTiDjb3u-C0JommQ8cTqgg,1621
+django_cfg/__init__.py,sha256=HbtRDtHlqf7LLLnJjYEq_tMe99Y4cjV_Kx8txhAOD_k,1621
 django_cfg/apps.py,sha256=72m3uuvyqGiLx6gOfE-BD3P61jddCCERuBOYpxTX518,1605
 django_cfg/config.py,sha256=y4Z3rnYsHBE0TehpwAIPaxr---mkvyKrZGGsNwYso74,1398
 django_cfg/apps/__init__.py,sha256=JtDmEYt1OcleWM2ZaeX0LKDnRQzPOavfaXBWG4ECB5Q,26
@@ -668,18 +668,16 @@ django_cfg/models/tasks/config.py,sha256=0Tc7O2mVQLc8IYXMm__cdeP0ytYn_NucL2xyA95
 django_cfg/models/tasks/utils.py,sha256=9TEbdxgd0N_O2T_7GGwkyPeDg4H7tSKLHoHG_n8edqg,4459
 django_cfg/modules/__init__.py,sha256=Ip9WMpzImEwIAywpFwU056_v0O9oIGG7nCT1YSArxkw,316
 django_cfg/modules/base.py,sha256=Grmgxc5dvnAEM1sudWEWO4kv8L0Ks-y32nxTk2vwdjQ,6272
-django_cfg/modules/django_admin/CHANGELOG_CODE_METHODS.md,sha256=HfE_rUlovx1zX_1hkzQsjwghaFvIvUWjZ_Aume8lhIs,3823
-django_cfg/modules/django_admin/IMPORT_EXPORT_FIX.md,sha256=F8z4oHZk7jkRChxW8tKsVf0Q_OujjlBUs8UJNirn55Y,2055
-django_cfg/modules/django_admin/RESOURCE_CONFIG_ENHANCEMENT.md,sha256=MKUpRHMqM3KDEKZthWhul-4EoSnE75kkWd7IcEzwYDQ,8729
-django_cfg/modules/django_admin/__init__.py,sha256=LYVFCVgN6Irr80dK8SkXgKQ-Xgg2MyRL5CgfOgmSt8A,3190
+django_cfg/modules/django_admin/__init__.py,sha256=ncTMbxR7ccVd5xS-sZE_yJODjVMFq8HDFaDnP6lyvIg,3328
 django_cfg/modules/django_admin/base/__init__.py,sha256=tzre09bnD_SlS-pA30WzYZRxyvch7eLq3q0wLEcZOmc,118
-django_cfg/modules/django_admin/base/pydantic_admin.py,sha256=v2U-Tm_zWkDsh1CGmYL-xJdsVvHKX7MjUMrFwpY6wpw,20879
+django_cfg/modules/django_admin/base/pydantic_admin.py,sha256=EZnkPFXDHvqR-JtDfYvJfg5_Nocn7svgXvQdVsTbv9A,24389
 django_cfg/modules/django_admin/base/unfold_admin.py,sha256=iqpRWSkzW5HktXDuuG7G3J6RoIfW48dWPMJTa7Yk08g,729
-django_cfg/modules/django_admin/config/__init__.py,sha256=IjD2pJBb_rboj9V4_4uzBmzIIzm4a5Xy8XIieL5myww,755
+django_cfg/modules/django_admin/config/__init__.py,sha256=HDuJxhAS27EiL1pXLNvMePREB2gfoS2i_0Ur1ITCjAM,926
 django_cfg/modules/django_admin/config/action_config.py,sha256=JjS01JxLT-FzUVq7RlKaB7L38wmVL8uibXO_iXZcljo,1668
-django_cfg/modules/django_admin/config/admin_config.py,sha256=7ozVnLqJcUrHu-UK-PdOfuX2UOvR1gkigThgQsfO0wY,5030
+django_cfg/modules/django_admin/config/admin_config.py,sha256=TnPI-kLZj6uoIH7opCD70HQ6I_yJ7jPKnphS0h9P42s,5242
 django_cfg/modules/django_admin/config/background_task_config.py,sha256=7-8B1rhpeafanVxtjFQUx0mVjcA5xmxZIxqKzaBwMX0,1760
-django_cfg/modules/django_admin/config/field_config.py,sha256=TXdmz1GHC0N7euzqgB9p5EhFCYzsEobb8VSgS4kG4ho,8928
+django_cfg/modules/django_admin/config/documentation_config.py,sha256=lI_gMSWCtyKmdyttLNdgbg_zbGgrwXA-QoLxVOXJj9A,14189
+django_cfg/modules/django_admin/config/field_config.py,sha256=LeHoumm-lmiYIu0dBmoyCdTkddQdcv20_KrD3WRhkQ0,11743
 django_cfg/modules/django_admin/config/fieldset_config.py,sha256=5BPUWO_HvS6YhPU_vqQPzRT2y3OIPrBCioFuer5-mrA,1249
 django_cfg/modules/django_admin/config/resource_config.py,sha256=6ELWSuHlrpNqV2wO2sL_o2mE2DXLd_solcsdN5O6eQg,3962
 django_cfg/modules/django_admin/icons/README.md,sha256=j-NUixSC1QJh7PqYKxLZpPrTxKrAnx0urQraXgv4JHI,5612
@@ -691,12 +689,17 @@ django_cfg/modules/django_admin/models/action_models.py,sha256=clzu_DJOexrqyKfkv
 django_cfg/modules/django_admin/models/badge_models.py,sha256=ob5NOtx8YZ9KRVmn9fxLWg_OXbvt3fLhhk8wwU5eP8E,538
 django_cfg/modules/django_admin/models/base.py,sha256=fmgS-X3GAGEBXiBy4OQGeOMzB7qIkvzDXla5-_EHAQE,611
 django_cfg/modules/django_admin/models/display_models.py,sha256=rONmja60Qz8n4qNvzjXIQryO_-UGZK136SrElO8iFfM,1087
+django_cfg/modules/django_admin/templates/django_admin/change_form_docs.html,sha256=MtP-UKebcOdz6YsZxLV5-UFq6WfmlV3mEF7qsCdYOKg,815
+django_cfg/modules/django_admin/templates/django_admin/change_list_docs.html,sha256=MfH6mf9v6E3y97TjvjvZ2A7RMhOkKd6CtxEw3tPV5WE,802
+django_cfg/modules/django_admin/templates/django_admin/documentation_block.html,sha256=IHB1dDGavvHNnez6modI1wJxvoXuZSQmsBu0nheYcZA,13974
+django_cfg/modules/django_admin/templates/django_admin/markdown_docs_block.html,sha256=nO9oEyDYozYF-euaLzE0Cn_Yo_LGUlta-BsRgShDG10,1992
 django_cfg/modules/django_admin/utils/CODE_BLOCK_DOCS.md,sha256=rp5qMG-Ci30fIs6EyZctjEbhQwxfNq9e36B4CTZOnR0,9456
-django_cfg/modules/django_admin/utils/__init__.py,sha256=DkMCGBbSe6Xfgdse-C8JkcqTRxtq3k2tMKxt39F1GfA,649
+django_cfg/modules/django_admin/utils/__init__.py,sha256=5V1Og6fpIpRqDIoqF7jYnBmPl9TjV5kByghzT6iOpPs,745
 django_cfg/modules/django_admin/utils/badges.py,sha256=eZ1UThdwvv2cHAIDc4vTrD5xAet7fmeb9h9yj4ZXJ-c,6328
 django_cfg/modules/django_admin/utils/decorators.py,sha256=s4jTcgPklY4T4xjXsMHpShd71K_LzgKogem9JKBgNzk,8371
 django_cfg/modules/django_admin/utils/displays.py,sha256=f-FT1mD-X56X6xLDJ9FuCi4oz_UYirdLosYrXnJP3hI,7862
-django_cfg/modules/django_admin/utils/html_builder.py,sha256=d-_laj5Yz7gY0Xkwg1vNIlcK-N8F1Z3atM4-t1584pw,9793
+django_cfg/modules/django_admin/utils/html_builder.py,sha256=EMzz1rGJCM7jTgfWb8LKqSdok1oq_oaWbBk6v9qvCrU,12831
+django_cfg/modules/django_admin/utils/markdown_renderer.py,sha256=nrMopdVA114W_UOvYFUtnbfj_Di0LHmtmrxG53hsn_Y,13834
 django_cfg/modules/django_admin/widgets/__init__.py,sha256=mmPw5FMYR21GDGFMr-MOCcdM4G2_ZR60ClInHjdnTBE,115
 django_cfg/modules/django_admin/widgets/registry.py,sha256=q0Yyaze5ZTYLJslPyX9e4Few_FGLnGBQwtNln9Okyt4,5610
 django_cfg/modules/django_client/__init__.py,sha256=iHaGKbsyR2wMmVCWNsETC7cwB60fZudvnFMiK1bchW8,529
@@ -1050,9 +1053,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=yWqSAdesaQe0xiDRPoQw25Opq0yhKyr1nZM-k058-E4,8614
-django_cfg-1.4.109.dist-info/METADATA,sha256=Xml6V2JxDfn4DHkJAC0BLkupFncQDqJsON9sROSJvms,23801
-django_cfg-1.4.109.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-django_cfg-1.4.109.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
-django_cfg-1.4.109.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg-1.4.109.dist-info/RECORD,,
+django_cfg/pyproject.toml,sha256=lz106jlJ2YsUxr9D0NqVgp5x2TZSNT1vbTrZ_YaeydQ,8637
+django_cfg-1.4.110.dist-info/METADATA,sha256=xG_TAByn-K2qm3HlL_4cMNNHz4UpMrpV5hVIzTNGdKU,23836
+django_cfg-1.4.110.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+django_cfg-1.4.110.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
+django_cfg-1.4.110.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
+django_cfg-1.4.110.dist-info/RECORD,,

django_cfg/modules/django_admin/CHANGELOG_CODE_METHODS.md

@@ -1,153 +0,0 @@
-# CHANGELOG: Code Display Methods
-
-## [2024-10-29] Added `code()` and `code_block()` methods to HtmlBuilder
-
-### Summary
-Added two new methods to `HtmlBuilder` for displaying code in Django Admin interfaces with proper styling, scrolling support, and color variants.
-
-### New Methods
-
-#### 1. `html.code(text, css_class="")`
-Display inline code snippets.
-
-**Use cases:**
-- File paths
-- Short commands
-- Configuration keys
-- Single-line code
-
-**Example:**
-```python
-self.html.code("/path/to/file")
-self.html.code("DEBUG=True")
-```
-
-#### 2. `html.code_block(text, language=None, max_height=None, variant="default")`
-Display multi-line code blocks with:
-- Optional scrolling (via `max_height`)
-- Color variants (default, warning, danger, success, info)
-- Language hints for future syntax highlighting
-- Proper text wrapping and escaping
-
-**Use cases:**
-- JSON configuration
-- Command output (stdout/stderr)
-- Error messages and stack traces
-- Log files
-- API requests/responses
-- SQL queries
-
-**Examples:**
-```python
-# JSON
-self.html.code_block(json.dumps(data, indent=2), language="json")
-
-# Logs with scrolling
-self.html.code_block(obj.stdout, max_height="400px")
-
-# Errors
-self.html.code_block(obj.error_message, variant="danger", max_height="300px")
-
-# Warnings
-self.html.code_block(obj.stderr, variant="warning", max_height="400px")
-```
-
-### Files Modified
-
-**`utils/html_builder.py`:**
-- Added `code()` method (lines 207-227)
-- Added `code_block()` method (lines 229-278)
-
-### Features
-
-✅ **Automatic HTML Escaping** - Prevents XSS
-✅ **Dark Mode Support** - Full Tailwind dark: classes
-✅ **Responsive Design** - Works on mobile
-✅ **Color Variants** - 5 variants for different contexts
-✅ **Scrollable Content** - Max height with overflow
-✅ **Consistent Styling** - Matches django-cfg design system
-✅ **Future-proof** - Language parameter for syntax highlighting
-✅ **Type Hints** - Full typing support
-
-### Technical Details
-
-**Dependencies:**
-- Django's `format_html` and `escape`
-- Tailwind CSS classes (already in use)
-- No additional packages required
-
-**Styling:**
-- Uses existing Tailwind utility classes
-- Follows django-cfg color system
-- Light/dark mode variants
-
-**Performance:**
-- No JavaScript required
-- Pure CSS for scrolling
-- Minimal HTML overhead
-
-### Breaking Changes
-None - purely additive changes.
-
-### Backward Compatibility
-100% backward compatible. All existing code continues to work.
-
-### Migration Path
-Optional migration from manual HTML:
-
-**Before:**
-```python
-def output_display(self, obj):
-    return format_html('<pre>{}</pre>', obj.stdout)
-```
-
-**After:**
-```python
-def output_display(self, obj):
-    return self.html.code_block(obj.stdout, max_height="400px")
-```
-
-### Real-World Usage
-
-Already implemented in:
-- `apps.adminpanel.admin.config.CommandExecutionAdmin`
-  - JSON args/options display
-  - stdout/stderr output with scrolling
-  - Error messages with danger variant
-
-### Documentation
-
-Full documentation available in:
-- `CODE_BLOCK_DOCS.md` - Complete guide with examples
-- API Reference (to be updated)
-- Quick Start guide (to be updated)
-
-### Testing
-
-Manual testing performed:
-- ✅ Inline code rendering
-- ✅ Code block with/without scrolling
-- ✅ All 5 color variants
-- ✅ JSON formatting
-- ✅ Long text with wrapping
-- ✅ Dark mode
-- ✅ HTML escaping
-
-### Next Steps
-
-Recommended for future:
-1. Add to API Reference documentation
-2. Add to Examples documentation
-3. Consider syntax highlighting library integration (Prism.js, highlight.js)
-4. Add to django-cfg changelog
-5. Update tutorial/quick-start docs
-
-### Contributors
-- Implementation: Claude Code
-- Use Case: CommandExecution admin in StockAPIS project
-
----
-
-**Version:** Added in django-cfg dev build (2024-10-29)
-**Status:** ✅ Complete and tested
-**Impact:** Low - purely additive feature