django-cfg 1.3.13__py3-none-any.whl → 1.4.0__py3-none-any.whl

django_cfg/modules/django_tailwind/templates/django_tailwind/components/navbar.html

@@ -0,0 +1,124 @@
+{% comment %}
+Universal Navbar Component
+
+Parameters:
+- title: Navbar title (default: "Django CFG")
+- icon: Emoji or HTML icon (default: "💎")
+- nav_items: List of navigation items (optional)
+  Example: [
+    {'label': 'Dashboard', 'url': '/dashboard/', 'active': True},
+    {'label': 'Settings', 'url': '/settings/'},
+  ]
+- show_theme_toggle: Show dark mode toggle (default: True)
+- show_user_menu: Show user menu dropdown (default: True)
+- sticky: Make navbar sticky (default: True)
+- full_width: Make navbar full width (default: False, uses max-w-7xl)
+- extra_actions: Additional action buttons (optional, block content)
+
+User menu parameters:
+- show_profile: Show profile link in user menu (default: False)
+- show_logout: Show logout link in user menu (default: False)
+- profile_url: Custom profile URL (default: /profile/)
+- logout_url: Custom logout URL (default: /accounts/logout/)
+
+Usage:
+
+Basic:
+{% include 'django_tailwind/components/navbar.html' with title="My App" icon="🚀" %}
+
+Full width navbar:
+{% include 'django_tailwind/components/navbar.html' with title="Dashboard" full_width=True %}
+
+With navigation items:
+{% include 'django_tailwind/components/navbar.html' with title="Dashboard" nav_items=menu_items %}
+
+With user menu options:
+{% include 'django_tailwind/components/navbar.html' with show_profile=True show_logout=True %}
+
+In template context:
+menu_items = [
+    {'label': 'Home', 'url': '/', 'active': True},
+    {'label': 'About', 'url': '/about/'},
+]
+
+Custom navbar (extending):
+{% with title="My App" icon="🚀" %}
+    {% include 'django_tailwind/components/navbar.html' %}
+{% endwith %}
+{% endcomment %}
+
+<header class="bg-white dark:bg-gray-800 shadow-sm border-b border-gray-200 dark:border-gray-700 {% if sticky|default:True %}sticky top-0 z-50{% endif %}">
+    <div class="{% if full_width %}w-full{% else %}max-w-7xl mx-auto{% endif %} px-4 sm:px-6 lg:px-8">
+        <!-- Main navbar row -->
+        <div class="flex justify-between h-16">
+            <!-- Left: Logo, Title & Navigation -->
+            <div class="flex items-center space-x-6">
+                <div class="flex items-center space-x-3">
+                    {% if icon %}
+                    <span class="text-2xl">{{ icon }}</span>
+                    {% endif %}
+                    <h1 class="text-xl font-semibold text-gray-900 dark:text-white">
+                        {{ title|default:"Django CFG" }}
+                    </h1>
+                </div>
+
+                <!-- Navigation items (horizontal links) -->
+                {% if nav_items %}
+                <nav class="hidden md:flex items-center space-x-1">
+                    {% for item in nav_items %}
+                    <a href="{{ item.url }}"
+                       class="px-3 py-2 rounded-md text-sm font-medium transition-colors
+                              {% if item.active %}
+                                  bg-gray-100 dark:bg-gray-700 text-gray-900 dark:text-white
+                              {% else %}
+                                  text-gray-600 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-700 hover:text-gray-900 dark:hover:text-white
+                              {% endif %}">
+                        {% if item.icon %}<span class="mr-1">{{ item.icon }}</span>{% endif %}
+                        {{ item.label }}
+                    </a>
+                    {% endfor %}
+                </nav>
+                {% endif %}
+            </div>
+
+            <!-- Right: Actions -->
+            <div class="flex items-center space-x-4">
+
+                <!-- Extra actions slot -->
+                {% if extra_actions %}
+                {{ extra_actions }}
+                {% endif %}
+
+                <!-- Dark Mode Toggle -->
+                {% if show_theme_toggle|default:True %}
+                {% include 'django_tailwind/components/theme_toggle.html' %}
+                {% endif %}
+
+                <!-- User Menu -->
+                {% if show_user_menu|default:True %}
+                {% include 'django_tailwind/components/user_menu.html' with show_profile=show_profile show_logout=show_logout profile_url=profile_url logout_url=logout_url %}
+                {% endif %}
+            </div>
+        </div>
+
+        <!-- Mobile navigation (dropdown) -->
+        {% if nav_items %}
+        <div class="md:hidden pb-3 pt-2 border-t border-gray-200 dark:border-gray-700">
+            <nav class="flex flex-col space-y-1">
+                {% for item in nav_items %}
+                <a href="{{ item.url }}"
+                   class="px-3 py-2 rounded-md text-sm font-medium transition-colors
+                          {% if item.active %}
+                              bg-gray-100 dark:bg-gray-700 text-gray-900 dark:text-white
+                          {% else %}
+                              text-gray-600 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-700 hover:text-gray-900 dark:hover:text-white
+                          {% endif %}">
+                    {% if item.icon %}<span class="mr-2">{{ item.icon }}</span>{% endif %}
+                    {{ item.label }}
+                </a>
+                {% endfor %}
+            </nav>
+        </div>
+        {% endif %}
+    </div>
+</header>

django_cfg/modules/django_tailwind/templates/django_tailwind/components/theme_toggle.html

@@ -0,0 +1,54 @@
+{% comment %}
+Theme Toggle Component
+
+Usage:
+{% include 'django_tailwind/components/theme_toggle.html' %}
+
+With custom classes:
+{% include 'django_tailwind/components/theme_toggle.html' with button_class="custom-class" %}
+
+Variants:
+- button_variant: "default" (default), "icon", "text"
+- button_class: additional CSS classes
+{% endcomment %}
+
+{% if button_variant == "text" %}
+<!-- Text variant with label -->
+<button @click="darkMode = !darkMode"
+        class="inline-flex items-center space-x-2 px-3 py-2 text-sm font-medium text-gray-700 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white transition-colors {{ button_class }}">
+    <svg x-show="!darkMode" class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
+    </svg>
+    <svg x-show="darkMode" x-cloak class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"/>
+    </svg>
+    <span x-show="!darkMode">Dark Mode</span>
+    <span x-show="darkMode" x-cloak>Light Mode</span>
+</button>
+
+{% elif button_variant == "icon" %}
+<!-- Icon only variant (compact) -->
+<button @click="darkMode = !darkMode"
+        class="p-2 text-gray-600 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white transition-colors {{ button_class }}"
+        aria-label="Toggle dark mode">
+    <svg x-show="!darkMode" class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
+    </svg>
+    <svg x-show="darkMode" x-cloak class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"/>
+    </svg>
+</button>
+
+{% else %}
+<!-- Default variant (with background) -->
+<button @click="darkMode = !darkMode"
+        class="p-2 text-gray-600 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors {{ button_class }}"
+        aria-label="Toggle dark mode">
+    <svg x-show="!darkMode" class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"/>
+    </svg>
+    <svg x-show="darkMode" x-cloak class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"/>
+    </svg>
+</button>
+{% endif %}

django_cfg/modules/django_tailwind/templates/django_tailwind/components/user_menu.html

@@ -0,0 +1,116 @@
+{% comment %}
+User Menu Component with Dropdown
+
+Shows user avatar, name, and dropdown menu with:
+- Admin panel link (for staff)
+- Profile link (optional)
+- Logout link (optional)
+
+Parameters:
+- show_admin: Show admin link (default: auto-detect if user.is_staff)
+- show_profile: Show profile link (default: False)
+- show_logout: Show logout link (default: False)
+- profile_url: Custom profile URL
+- logout_url: Custom logout URL
+
+Usage:
+{% include 'django_tailwind/components/user_menu.html' %}
+
+With parameters:
+{% include 'django_tailwind/components/user_menu.html' with show_profile=True show_logout=True %}
+{% endcomment %}
+
+{% load tailwind_info %}
+
+{% if request.user.is_authenticated %}
+<!-- User Menu Dropdown -->
+<div class="relative" x-data="{ userMenuOpen: false }" @click.away="userMenuOpen = false">
+    <!-- User Avatar Button -->
+    <button @click="userMenuOpen = !userMenuOpen"
+            class="flex items-center space-x-2 p-2 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors focus:outline-none focus:ring-2 focus:ring-primary-500">
+        <!-- Avatar -->
+        <div class="w-8 h-8 rounded-full bg-gradient-to-br from-blue-500 to-purple-600 flex items-center justify-center text-white text-sm font-semibold">
+            {% get_user_initials as user_initials %}
+            {{ user_initials }}
+        </div>
+
+        <!-- User Name (hidden on mobile) -->
+        <span class="hidden md:block text-sm font-medium text-gray-700 dark:text-gray-300">
+            {% get_user_display_name as user_name %}
+            {{ user_name }}
+        </span>
+
+        <!-- Dropdown Arrow -->
+        <svg class="w-4 h-4 text-gray-500 dark:text-gray-400 transition-transform"
+             :class="{ 'rotate-180': userMenuOpen }"
+             fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"/>
+        </svg>
+    </button>
+
+    <!-- Dropdown Menu -->
+    <div x-show="userMenuOpen"
+         x-cloak
+         x-transition:enter="transition ease-out duration-200"
+         x-transition:enter-start="opacity-0 scale-95"
+         x-transition:enter-end="opacity-100 scale-100"
+         x-transition:leave="transition ease-in duration-150"
+         x-transition:leave-start="opacity-100 scale-100"
+         x-transition:leave-end="opacity-0 scale-95"
+         class="absolute right-0 mt-2 w-56 rounded-lg shadow-lg bg-white dark:bg-gray-800 ring-1 ring-black ring-opacity-5 divide-y divide-gray-100 dark:divide-gray-700 z-50">
+
+        <!-- User Info Section -->
+        <div class="px-4 py-3">
+            <p class="text-sm font-medium text-gray-900 dark:text-white">
+                {{ user_name }}
+            </p>
+            {% if request.user.email %}
+            <p class="text-xs text-gray-500 dark:text-gray-400 truncate">
+                {{ request.user.email }}
+            </p>
+            {% endif %}
+        </div>
+
+        <!-- Menu Items -->
+        <div class="py-1">
+            {% get_admin_url as admin_url %}
+
+            <!-- Admin Panel Link (for staff only) -->
+            {% if show_admin|default:request.user.is_staff %}
+            <a href="{{ admin_url }}"
+               class="flex items-center px-4 py-2 text-sm text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors">
+                <svg class="w-5 h-5 mr-3 text-gray-500 dark:text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"/>
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                </svg>
+                Admin Panel
+            </a>
+            {% endif %}
+
+            <!-- Profile Link (optional) -->
+            {% if show_profile %}
+            <a href="{{ profile_url|default:'/profile/' }}"
+               class="flex items-center px-4 py-2 text-sm text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors">
+                <svg class="w-5 h-5 mr-3 text-gray-500 dark:text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z"/>
+                </svg>
+                Profile
+            </a>
+            {% endif %}
+        </div>
+
+        <!-- Logout Section -->
+        {% if show_logout %}
+        <div class="py-1">
+            <a href="{{ logout_url|default:'/accounts/logout/' }}"
+               class="flex items-center px-4 py-2 text-sm text-red-600 dark:text-red-400 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors">
+                <svg class="w-5 h-5 mr-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M17 16l4-4m0 0l-4-4m4 4H7m6 4v1a3 3 0 01-3 3H6a3 3 0 01-3-3V7a3 3 0 013-3h4a3 3 0 013 3v1"/>
+                </svg>
+                Logout
+            </a>
+        </div>
+        {% endif %}
+    </div>
+</div>
+{% endif %}

django_cfg/modules/django_tailwind/templates/django_tailwind/simple.html

@@ -0,0 +1,46 @@
+{% extends 'django_tailwind/base.html' %}
+
+{% block container_class %}{% endblock %}
+
+{% block main %}
+<!-- Floating Dark Mode Toggle -->
+<div class="fixed top-4 right-4 z-50">
+    {% include 'django_tailwind/components/theme_toggle.html' %}
+</div>
+
+<div class="min-h-screen flex items-center justify-center px-4 py-12">
+    <div class="w-full max-w-md">
+        {% block content %}
+        <div class="bg-white dark:bg-gray-800 rounded-lg shadow-lg p-8 text-center">
+            {% block simple_icon %}
+            <div class="text-6xl mb-4">
+                {% block icon %}ℹ️{% endblock %}
+            </div>
+            {% endblock %}
+
+            {% block simple_title %}
+            <h1 class="text-2xl font-bold text-gray-900 dark:text-white mb-4">
+                {% block heading %}Title{% endblock %}
+            </h1>
+            {% endblock %}
+
+            {% block simple_message %}
+            <p class="text-gray-600 dark:text-gray-400 mb-6">
+                {% block message %}Message goes here{% endblock %}
+            </p>
+            {% endblock %}
+
+            {% block simple_actions %}
+            <div class="flex flex-col sm:flex-row gap-3 justify-center">
+                {% block actions %}
+                <a href="/"
+                   class="inline-flex items-center justify-center px-6 py-3 border border-transparent rounded-lg shadow-sm text-base font-medium text-white bg-blue-600 hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500 transition-colors">
+                    Go Home
+                </a>
+                {% endblock %}
+            </div>
+            {% endblock %}
+        </div>
+    </div>
+</div>
+{% endblock %}

django_cfg/modules/django_tailwind/templatetags/__init__.py

@@ -0,0 +1 @@
+"""Django Tailwind templatetags package."""

django_cfg/modules/django_tailwind/templatetags/tailwind_info.py

@@ -0,0 +1,185 @@
+"""
+Django Tailwind Layouts templatetags.
+
+Template tags for universal Tailwind layouts with dark mode support.
+"""
+
+from django import template
+from django.utils.safestring import mark_safe
+
+register = template.Library()
+
+
+# Library metadata
+LIBRARY_INFO = {
+    'name': 'Django Tailwind Layouts',
+    'version': '1.0.0',
+    'description': 'Universal Tailwind CSS layouts with dark mode for Django applications',
+    'url': 'https://github.com/yourusername/django-cfg',
+    'author': 'Django-CFG Team',
+    'license': 'MIT',
+}
+
+
+@register.simple_tag
+def tailwind_lib_name():
+    """Get library name."""
+    return LIBRARY_INFO['name']
+
+
+@register.simple_tag
+def tailwind_lib_version():
+    """Get library version."""
+    return LIBRARY_INFO['version']
+
+
+@register.simple_tag
+def tailwind_lib_description():
+    """Get library description."""
+    return LIBRARY_INFO['description']
+
+
+@register.simple_tag
+def tailwind_lib_url():
+    """Get library URL."""
+    return LIBRARY_INFO['url']
+
+
+@register.simple_tag
+def tailwind_lib_author():
+    """Get library author."""
+    return LIBRARY_INFO['author']
+
+
+@register.simple_tag
+def tailwind_lib_info():
+    """
+    Get complete library info as dictionary.
+
+    Usage in template:
+        {% load tailwind_info %}
+        {% tailwind_lib_info as lib %}
+        <p>{{ lib.name }} v{{ lib.version }}</p>
+    """
+    return LIBRARY_INFO
+
+
+@register.simple_tag
+def tailwind_powered_by():
+    """
+    Generate "Powered by" HTML snippet.
+
+    Usage:
+        {% load tailwind_info %}
+        {% tailwind_powered_by %}
+    """
+    return mark_safe(
+        f'Powered by <a href="{LIBRARY_INFO["url"]}" '
+        f'class="font-medium text-gray-900 dark:text-white hover:text-blue-600 dark:hover:text-blue-400 transition-colors" '
+        f'target="_blank">{LIBRARY_INFO["name"]}</a> v{LIBRARY_INFO["version"]}'
+    )
+
+
+@register.simple_tag
+def tailwind_footer_text():
+    """
+    Generate footer text with library info.
+
+    Usage:
+        {% load tailwind_info %}
+        {% tailwind_footer_text %}
+    """
+    return mark_safe(
+        f'<span class="text-gray-600 dark:text-gray-400">{LIBRARY_INFO["name"]}</span> '
+        f'<span class="text-gray-400 dark:text-gray-600">v{LIBRARY_INFO["version"]}</span>'
+    )
+
+
+@register.filter
+def add_class(field, css_class):
+    """
+    Add CSS class to form field.
+
+    Usage:
+        {{ form.field|add_class:"custom-class" }}
+    """
+    return field.as_widget(attrs={"class": css_class})
+
+
+@register.simple_tag(takes_context=True)
+def get_admin_url(context):
+    """
+    Get admin URL from settings or default.
+
+    Usage:
+        {% load tailwind_info %}
+        {% get_admin_url as admin_url %}
+        <a href="{{ admin_url }}">Admin</a>
+    """
+    from django.conf import settings
+    from django.urls import reverse
+
+    # Try to get custom admin URL from settings
+    admin_url = getattr(settings, 'ADMIN_URL', None)
+
+    if not admin_url:
+        try:
+            admin_url = reverse('admin:index')
+        except Exception:
+            admin_url = '/admin/'
+
+    return admin_url
+
+
+@register.simple_tag(takes_context=True)
+def get_user_display_name(context):
+    """
+    Get user display name (full name or username).
+
+    Usage:
+        {% load tailwind_info %}
+        {% get_user_display_name as user_name %}
+    """
+    request = context.get('request')
+    if not request or not request.user.is_authenticated:
+        return 'Guest'
+
+    user = request.user
+
+    # Try full name first
+    full_name = user.get_full_name() if hasattr(user, 'get_full_name') else ''
+    if full_name:
+        return full_name
+
+    # Fallback to username
+    return user.username if hasattr(user, 'username') else 'User'
+
+
+@register.simple_tag(takes_context=True)
+def get_user_initials(context):
+    """
+    Get user initials for avatar.
+
+    Usage:
+        {% load tailwind_info %}
+        {% get_user_initials as initials %}
+    """
+    request = context.get('request')
+    if not request or not request.user.is_authenticated:
+        return '?'
+
+    user = request.user
+
+    # Try to get initials from full name
+    if hasattr(user, 'get_full_name'):
+        full_name = user.get_full_name()
+        if full_name:
+            parts = full_name.split()
+            if len(parts) >= 2:
+                return f"{parts[0][0]}{parts[1][0]}".upper()
+            elif len(parts) == 1:
+                return parts[0][:2].upper()
+
+    # Fallback to username
+    username = user.username if hasattr(user, 'username') else 'U'
+    return username[:2].upper()

django_cfg/modules/django_tasks/__init__.py

@@ -0,0 +1,29 @@
+"""
+Django-CFG Task Service Module.
+
+Simplified task service for Dramatiq integration with essential functionality.
+"""
+
+from .service import DjangoTasks
+from .factory import (
+    get_task_service,
+    reset_task_service,
+    is_task_system_available,
+    get_task_health,
+    initialize_task_system,
+)
+from .settings import (
+    generate_dramatiq_settings_from_config,
+    extend_constance_config_with_tasks,
+)
+
+__all__ = [
+    "DjangoTasks",
+    "get_task_service",
+    "reset_task_service",
+    "is_task_system_available",
+    "get_task_health",
+    "generate_dramatiq_settings_from_config",
+    "extend_constance_config_with_tasks",
+    "initialize_task_system",
+]