django-cfg 1.4.9__py3-none-any.whl → 1.4.11__py3-none-any.whl

django_cfg/templates/admin/layouts/dashboard_with_tabs.html

@@ -16,7 +16,7 @@
         if (!tabs.length || !contents.length) return;
         
         // Tab names for URL hash
-        const tabNames = ['overview', 'zones', 'users', 'system', 'stats', 'app-stats', 'commands'];
+        const tabNames = ['overview', 'zones', 'users', 'system', 'stats', 'app-stats', 'commands', 'documentation'];
         
         // Global function for tab switching
         window.switchTab = function(idx, updateHash = true) {
@@ -493,14 +493,22 @@
                 <span class="material-icons mr-2 align-middle text-sm">apps</span>
                 App Stats
             </button>
-            <button 
-                type="button" 
+            <button
+                type="button"
                 data-tab="6"
                 class="px-4 py-3 rounded-t-lg focus:outline-none"
             >
                 <span class="material-icons mr-2 align-middle text-sm">terminal</span>
                 Commands
             </button>
+            <button
+                type="button"
+                data-tab="7"
+                class="px-4 py-3 rounded-t-lg focus:outline-none"
+            >
+                <span class="material-icons mr-2 align-middle text-sm">description</span>
+                Documentation
+            </button>
         </div>
 
         <div class="flex flex-col gap-5">
@@ -533,6 +541,10 @@
             <div class="tab-content" data-tab="6">
                 {% block commands_tab %}{% endblock %}
             </div>
+
+            <div class="tab-content" data-tab="7">
+                {% block documentation_tab %}{% endblock %}
+            </div>
         </div>
 
         <!-- Footer Section -->

django_cfg/templates/admin/sections/documentation_section.html

@@ -0,0 +1,172 @@
+{% load static %}
+<link rel="stylesheet" href="{% static 'admin/css/prose-unfold.css' %}">
+
+<!-- Documentation Section -->
+<div class="space-y-6">
+    {% if error %}
+        <!-- Error State -->
+        <div class="bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-default p-6">
+            <div class="flex items-center space-x-2 text-red-600 dark:text-red-400">
+                <span class="material-symbols-outlined">error</span>
+                <span class="font-semibold">Error loading documentation</span>
+            </div>
+            <p class="mt-2 text-sm text-red-600 dark:text-red-400">{{ error }}</p>
+        </div>
+    {% elif commands_by_module %}
+        <!-- Commands by App -->
+        {% for app_key, app in commands_by_module.items %}
+            <div class="app-block bg-gradient-to-br from-white to-base-50 dark:from-base-800 dark:to-base-900 rounded-default shadow-md border border-base-200 dark:border-base-700 overflow-hidden mb-6">
+                <!-- App Header (Toggle) -->
+                <div class="app-toggle cursor-pointer select-none p-6 border-b border-base-200 dark:border-base-700 hover:bg-base-100/50 dark:hover:bg-base-900/30 transition-all duration-200"
+                     data-app="{{ app_key }}">
+                    <div class="w-full flex items-center justify-between">
+                        <h3 class="text-lg font-semibold text-font-important-light dark:text-font-important-dark flex items-center">
+                            <div class="w-10 h-10 rounded-lg bg-primary-100 dark:bg-primary-900/30 flex items-center justify-center mr-3">
+                                <span class="material-symbols-outlined text-primary-600 dark:text-primary-400">description</span>
+                            </div>
+                            <div>
+                                <div class="flex items-center gap-2">
+                                    {{ app.display_name }}
+                                    <span class="px-2 py-0.5 text-xs font-medium rounded-full bg-base-200 dark:bg-base-700 text-font-default-light dark:text-font-default-dark app-count">
+                                        {{ app.commands|length }}
+                                    </span>
+                                </div>
+                            </div>
+                        </h3>
+                        <span class="material-symbols-outlined text-base-400 dark:text-base-500 toggle-icon transition-transform duration-200 select-none">expand_more</span>
+                    </div>
+                </div>
+
+                <!-- App Content -->
+                <div class="app-content bg-base-50/30 dark:bg-base-900/30 p-6 space-y-4" data-app="{{ app_key }}" style="display: none;">
+
+                    <!-- Commands List -->
+                    <div class="space-y-3">
+                        {% for command in app.commands %}
+                            <div class="documentation-card bg-white dark:bg-base-900 rounded-default border border-base-200/60 dark:border-base-700/60 p-4 hover:border-base-300 dark:hover:border-base-600 transition-all duration-200">
+                                <!-- Command Header -->
+                                <div class="flex items-start justify-between mb-3">
+                                    <div class="flex-1">
+                                        <div class="flex items-center flex-wrap gap-2 mb-2">
+                                            <code class="text-sm font-mono bg-base-100 dark:bg-base-800 px-2 py-1 rounded text-primary-600 dark:text-primary-400">
+                                                python manage.py {{ command.name }}
+                                            </code>
+                                            {% if command.is_destructive %}
+                                                <span class="text-xs bg-red-100 dark:bg-red-900/30 text-red-600 dark:text-red-400 px-2 py-0.5 rounded">
+                                                    Destructive
+                                                </span>
+                                            {% endif %}
+                                            {% if command.web_executable %}
+                                                <span class="text-xs bg-green-100 dark:bg-green-900/30 text-green-600 dark:text-green-400 px-2 py-0.5 rounded">
+                                                    Web Executable
+                                                </span>
+                                            {% endif %}
+                                        </div>
+                                        <p class="text-sm text-font-default-light dark:text-font-default-dark">
+                                            {{ command.help }}
+                                        </p>
+                                    </div>
+                                </div>
+
+                                <!-- Command Docstring -->
+                                {% if command.docstring %}
+                                    <div class="mt-3 prose prose-unfold max-w-none text-sm">
+                                        {{ command.docstring }}
+                                    </div>
+                                {% endif %}
+
+                                <!-- Arguments -->
+                                {% if command.arguments %}
+                                    <div class="mt-4 border-t border-base-200 dark:border-base-700 pt-3">
+                                        <h4 class="text-xs font-semibold text-font-important-light dark:text-font-important-dark uppercase mb-2">
+                                            Arguments
+                                        </h4>
+                                        <div class="space-y-2">
+                                            {% for arg in command.arguments %}
+                                                <div class="flex items-start space-x-2 text-sm">
+                                                    <code class="font-mono bg-base-100 dark:bg-base-800 px-2 py-0.5 rounded text-xs text-primary-600 dark:text-primary-400 whitespace-nowrap">
+                                                        {{ arg.options|join:", " }}
+                                                    </code>
+                                                    <div class="flex-1">
+                                                        <span class="text-font-default-light dark:text-font-default-dark">
+                                                            {{ arg.help }}
+                                                        </span>
+                                                        {% if arg.default %}
+                                                            <span class="text-font-subtle-light dark:text-font-subtle-dark text-xs">
+                                                                (default: {{ arg.default }})
+                                                            </span>
+                                                        {% endif %}
+                                                        {% if arg.required %}
+                                                            <span class="text-xs text-red-600 dark:text-red-400 ml-1">
+                                                                *required
+                                                            </span>
+                                                        {% endif %}
+                                                    </div>
+                                                </div>
+                                            {% endfor %}
+                                        </div>
+                                    </div>
+                                {% endif %}
+                            </div>
+                        {% endfor %}
+                    </div>
+                </div>
+            </div>
+        {% endfor %}
+
+        <!-- Summary Stats -->
+        <div class="bg-white dark:bg-base-800 rounded-default shadow-sm border border-base-200 dark:border-base-700 p-4 mt-6">
+            <div class="flex items-center justify-center gap-8 text-sm text-font-subtle-light dark:text-font-subtle-dark">
+                <div class="flex items-center gap-2">
+                    <span class="material-symbols-outlined text-base">folder</span>
+                    <span>{{ total_modules }} module{{ total_modules|pluralize }}</span>
+                </div>
+                <div class="flex items-center gap-2">
+                    <span class="material-symbols-outlined text-base">terminal</span>
+                    <span>{{ total_commands }} command{{ total_commands|pluralize }}</span>
+                </div>
+            </div>
+        </div>
+    {% else %}
+        <!-- Empty State -->
+        <div class="bg-base-50 dark:bg-base-800 rounded-default border border-base-200 dark:border-base-700 p-12 text-center">
+            <span class="material-symbols-outlined text-6xl text-base-400 dark:text-base-500 mb-4">inbox</span>
+            <h3 class="text-lg font-medium text-font-important-light dark:text-font-important-dark mb-2">
+                No Commands Found
+            </h3>
+            <p class="text-font-subtle-light dark:text-font-subtle-dark">
+                No Django-CFG management commands available.
+            </p>
+        </div>
+    {% endif %}
+</div>
+
+<!-- JavaScript for App Toggle -->
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    // App toggle functionality
+    const appToggles = document.querySelectorAll('.app-toggle');
+    appToggles.forEach(toggle => {
+        toggle.addEventListener('click', function() {
+            const app = this.dataset.app;
+            const content = document.querySelector(`.app-content[data-app="${app}"]`);
+            const icon = this.querySelector('.toggle-icon');
+
+            if (content.style.display === 'none' || !content.style.display) {
+                content.style.display = 'block';
+                icon.textContent = 'expand_less';
+            } else {
+                content.style.display = 'none';
+                icon.textContent = 'expand_more';
+            }
+        });
+
+        // Initialize - start collapsed
+        const app = toggle.dataset.app;
+        const content = document.querySelector(`.app-content[data-app="${app}"]`);
+        if (content) {
+            content.style.display = 'none';
+        }
+    });
+});
+</script>

django_cfg/templates/admin/snippets/tabs/documentation_tab.html

@@ -0,0 +1,231 @@
+{% load unfold %}
+
+<!-- Documentation Tab Content -->
+<div class="space-y-8">
+    <!-- Header -->
+    <div class="">
+        <div class="flex items-center justify-between mb-6">
+            <div>
+                <h1 class="text-2xl font-bold text-font-important-light dark:text-font-important-dark">Commands Documentation</h1>
+                <p class="text-font-default-light dark:text-font-default-dark mt-2">
+                    Complete guide to all Django management commands
+                </p>
+            </div>
+            <div class="flex items-center space-x-2 text-sm text-font-subtle-light dark:text-font-subtle-dark">
+                <span class="material-icons text-blue-500">menu_book</span>
+                <span>Management Commands Reference</span>
+            </div>
+        </div>
+    </div>
+
+    <!-- Documentation Content -->
+    <div class="bg-white dark:bg-base-900 rounded-lg border border-base-200 dark:border-base-700 overflow-hidden shadow-sm">
+        <div class="p-6">
+            {% if documentation_content %}
+                <!-- Rendered Markdown Content -->
+                <div class="prose prose-slate dark:prose-invert max-w-none">
+                    {{ documentation_content|safe }}
+                </div>
+            {% else %}
+                <!-- Fallback: Display README.md as code -->
+                <div class="markdown-body">
+                    <pre class="bg-base-50 dark:bg-base-800 rounded-lg p-4 overflow-x-auto text-sm"><code>{% if readme_content %}{{ readme_content }}{% else %}Documentation not found.
+
+Please ensure that README.md exists at:
+/src/django_cfg/management/README.md{% endif %}</code></pre>
+                </div>
+            {% endif %}
+        </div>
+    </div>
+</div>
+
+<style>
+/* Markdown/Documentation styling */
+.prose {
+    color: #374151;
+}
+
+.dark .prose {
+    color: #d1d5db;
+}
+
+.prose h1 {
+    font-size: 2em;
+    font-weight: 700;
+    margin-top: 0;
+    margin-bottom: 1em;
+    color: #111827;
+    border-bottom: 2px solid #e5e7eb;
+    padding-bottom: 0.5em;
+}
+
+.dark .prose h1 {
+    color: #f9fafb;
+    border-bottom-color: #374151;
+}
+
+.prose h2 {
+    font-size: 1.5em;
+    font-weight: 600;
+    margin-top: 2em;
+    margin-bottom: 1em;
+    color: #1f2937;
+}
+
+.dark .prose h2 {
+    color: #e5e7eb;
+}
+
+.prose h3 {
+    font-size: 1.25em;
+    font-weight: 600;
+    margin-top: 1.5em;
+    margin-bottom: 0.75em;
+    color: #374151;
+}
+
+.dark .prose h3 {
+    color: #d1d5db;
+}
+
+.prose h4 {
+    font-size: 1.1em;
+    font-weight: 600;
+    margin-top: 1.25em;
+    margin-bottom: 0.5em;
+    color: #4b5563;
+}
+
+.dark .prose h4 {
+    color: #9ca3af;
+}
+
+.prose p {
+    margin-top: 1em;
+    margin-bottom: 1em;
+    line-height: 1.75;
+}
+
+.prose ul, .prose ol {
+    margin-top: 1em;
+    margin-bottom: 1em;
+    padding-left: 1.5em;
+}
+
+.prose li {
+    margin-top: 0.5em;
+    margin-bottom: 0.5em;
+}
+
+.prose code {
+    background-color: #f3f4f6;
+    color: #ef4444;
+    padding: 0.2em 0.4em;
+    border-radius: 0.25em;
+    font-size: 0.875em;
+    font-family: 'Courier New', monospace;
+}
+
+.dark .prose code {
+    background-color: #374151;
+    color: #fca5a5;
+}
+
+.prose pre {
+    background-color: #f9fafb;
+    border: 1px solid #e5e7eb;
+    border-radius: 0.5em;
+    padding: 1em;
+    overflow-x: auto;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.dark .prose pre {
+    background-color: #1f2937;
+    border-color: #374151;
+}
+
+.prose pre code {
+    background-color: transparent;
+    color: #111827;
+    padding: 0;
+    border-radius: 0;
+}
+
+.dark .prose pre code {
+    color: #f9fafb;
+}
+
+.prose a {
+    color: #2563eb;
+    text-decoration: none;
+    font-weight: 500;
+}
+
+.prose a:hover {
+    text-decoration: underline;
+}
+
+.dark .prose a {
+    color: #60a5fa;
+}
+
+.prose blockquote {
+    border-left: 4px solid #e5e7eb;
+    padding-left: 1em;
+    font-style: italic;
+    color: #6b7280;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.dark .prose blockquote {
+    border-left-color: #374151;
+    color: #9ca3af;
+}
+
+.prose table {
+    width: 100%;
+    border-collapse: collapse;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.prose th,
+.prose td {
+    border: 1px solid #e5e7eb;
+    padding: 0.5em 1em;
+    text-align: left;
+}
+
+.dark .prose th,
+.dark .prose td {
+    border-color: #374151;
+}
+
+.prose th {
+    background-color: #f9fafb;
+    font-weight: 600;
+}
+
+.dark .prose th {
+    background-color: #1f2937;
+}
+
+.prose hr {
+    border: 0;
+    border-top: 1px solid #e5e7eb;
+    margin-top: 2em;
+    margin-bottom: 2em;
+}
+
+.dark .prose hr {
+    border-top-color: #374151;
+}
+
+/* Add emoji support */
+.prose :where(p, li, td):not(:where([class~="not-prose"] *)) {
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
+}
+</style>

{django_cfg-1.4.9.dist-info → django_cfg-1.4.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.9
+Version: 1.4.11
 Summary: Django AI framework with built-in agents, type-safe Pydantic v2 configuration, and 8 enterprise apps. Replace settings.py, validate at startup, 90% less code. Production-ready AI workflows for Django.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com
@@ -45,7 +45,6 @@ Requires-Dist: django-import-export<5.0,>=4.3.0
 Requires-Dist: django-json-widget<3.0,>=2.0.0
 Requires-Dist: django-ratelimit<5.0.0,>=4.1.0
 Requires-Dist: django-redis<7.0,>=6.0.0
-Requires-Dist: django-revolution>=1.0.45
 Requires-Dist: django-tailwind[reload]<5.0.0,>=4.2.0
 Requires-Dist: django-unfold<1.0,>=0.64.0
 Requires-Dist: djangorestframework-simplejwt<6.0,>=5.5.0
@@ -56,6 +55,7 @@ Requires-Dist: drf-nested-routers<1.0,>=0.94.0
 Requires-Dist: drf-spectacular-sidecar<2026.0,>=2025.8.0
 Requires-Dist: drf-spectacular<1.0,>=0.28.0
 Requires-Dist: hiredis<4.0,>=2.0.0
+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: mypy<2.0.0,>=1.18.2