django-cfg 1.4.116__py3-none-any.whl → 1.5.14__py3-none-any.whl

django_cfg/models/ngrok/config.py

@@ -55,14 +55,15 @@ class NgrokConfig(BaseModel):
     def validate_enabled_in_debug_only(cls, v: bool) -> bool:
         """Ensure ngrok is only enabled in debug mode."""
         if v:
-            # Only check if Django is available and fully configured
+            # Use get_current_config() approach (same as GRPCServerConfig)
             try:
-                from django.conf import settings
-                # Only validate if settings are configured and DEBUG attribute exists
-                if settings.configured and hasattr(settings, 'DEBUG') and not settings.DEBUG:
+                from django_cfg.core import get_current_config
+
+                config = get_current_config()
+                if config and not config.debug:
                     raise ValueError("Ngrok can only be enabled in DEBUG mode")
-            except (ImportError, AttributeError, RuntimeError):
-                # Django not available, not configured, or settings not ready - skip validation
+            except Exception:
+                # Config not available yet - skip validation
                 pass
         return v
 

django_cfg/modules/base.py

@@ -156,16 +156,14 @@ class BaseCfgModule(ABC):
         """
         return self._get_config_key('enable_knowbase', False)
 
-    def should_enable_tasks(self) -> bool:
+    def should_enable_rq(self) -> bool:
         """
-        Check if django-cfg Tasks is enabled.
-        Auto-enables if knowbase or agents are enabled.
+        Check if django-cfg RQ is enabled.
         
         Returns:
-            True if Tasks is enabled, False otherwise
+            True if RQ is enabled, False otherwise
         """
-
-        return self.get_config().should_enable_tasks()
+        return self.get_config().should_enable_rq()
 
     def is_maintenance_enabled(self) -> bool:
         """
@@ -206,6 +204,21 @@ class BaseCfgModule(ABC):
 
         return False
 
+    def is_grpc_enabled(self) -> bool:
+        """
+        Check if django-cfg gRPC is enabled.
+
+        Returns:
+            True if gRPC is enabled, False otherwise
+        """
+        grpc_config = self._get_config_key('grpc', None)
+
+        # Check if grpc config exists and is enabled
+        if grpc_config and hasattr(grpc_config, 'enabled'):
+            return grpc_config.enabled
+
+        return False
+
 
 # Export the base class
 __all__ = [

django_cfg/modules/django_admin/__init__.py

@@ -57,6 +57,7 @@ from .config import (
     ImageField,
     MarkdownField,
     ResourceConfig,
+    ShortUUIDField,
     TextField,
     UserField,
 )
@@ -116,6 +117,7 @@ __all__ = [
     "DateTimeField",
     "ImageField",
     "MarkdownField",
+    "ShortUUIDField",
     "TextField",
     "UserField",
     # Advanced

django_cfg/modules/django_admin/apps.py

@@ -0,0 +1,19 @@
+"""
+Django app configuration for django_admin module.
+
+This makes django_admin a proper Django app so templates are automatically discovered.
+"""
+from django.apps import AppConfig
+
+
+class DjangoAdminConfig(AppConfig):
+    """Configuration for django_admin module."""
+
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "django_cfg.modules.django_admin"
+    label = "django_cfg_admin"
+    verbose_name = "Django Admin (django-cfg)"
+
+    def ready(self):
+        """Called when Django is ready."""
+        pass

django_cfg/modules/django_admin/base/pydantic_admin.py

@@ -523,7 +523,7 @@ class PydanticAdminMixin:
 
                 # Add Mermaid resources if plugins enabled
                 if doc_config.enable_plugins:
-                    from django_cfg.modules.django_admin.utils.mermaid_plugin import get_mermaid_resources
+                    from django_cfg.modules.django_admin.utils.markdown.mermaid_plugin import get_mermaid_resources
                     extra_context['mermaid_resources'] = get_mermaid_resources()
 
         return super().changelist_view(request, extra_context)
@@ -548,7 +548,7 @@ class PydanticAdminMixin:
 
                 # Add Mermaid resources if plugins enabled
                 if doc_config.enable_plugins:
-                    from django_cfg.modules.django_admin.utils.mermaid_plugin import get_mermaid_resources
+                    from django_cfg.modules.django_admin.utils.markdown.mermaid_plugin import get_mermaid_resources
                     extra_context['mermaid_resources'] = get_mermaid_resources()
 
         return super().changeform_view(request, object_id, form_url, extra_context)
@@ -558,12 +558,14 @@ class PydanticAdminMixin:
         Override form field for specific database field types.
 
         Automatically detects and customizes encrypted fields from django-crypto-fields.
+        Respects the show_encrypted_fields_as_plain_text setting from AdminConfig.
+        Uses custom widgets with copy-to-clipboard functionality.
         """
         # Check if this is an EncryptedTextField or EncryptedCharField
         field_class_name = db_field.__class__.__name__
         if 'Encrypted' in field_class_name and ('TextField' in field_class_name or 'CharField' in field_class_name):
             from django import forms
-            from django.forms.widgets import PasswordInput
+            from ..widgets import EncryptedFieldWidget, EncryptedPasswordWidget
 
             # Determine placeholder based on field name
             placeholder = "Enter value"
@@ -574,16 +576,25 @@ class PydanticAdminMixin:
             elif 'passphrase' in db_field.name.lower():
                 placeholder = "Enter Passphrase (if required)"
 
-            # Return CharField with PasswordInput widget for security
-            # render_value=True shows masked value (••••••) after save
+            # Widget attributes
+            widget_attrs = {
+                'placeholder': placeholder,
+            }
+
+            # Decide widget based on config
+            show_plain_text = getattr(self.config, 'show_encrypted_fields_as_plain_text', False)
+
+            if show_plain_text:
+                # Show as plain text with copy button
+                widget = EncryptedFieldWidget(attrs=widget_attrs, show_copy_button=True)
+            else:
+                # Show as password (masked) with copy button
+                # render_value=True shows masked value (••••••) after save
+                widget = EncryptedPasswordWidget(attrs=widget_attrs, render_value=True, show_copy_button=True)
+
+            # Return CharField with appropriate widget
             return forms.CharField(
-                widget=PasswordInput(
-                    attrs={
-                        'placeholder': placeholder,
-                        'class': 'appearance-none block w-full bg-gray-200 text-gray-700 border border-gray-200 rounded py-3 px-4 leading-tight focus:outline-none focus:bg-white focus:border-gray-500'
-                    },
-                    render_value=True  # Show masked value after save
-                ),
+                widget=widget,
                 required=not db_field.blank and not db_field.null,
                 help_text=db_field.help_text or "This field is encrypted at rest",
                 label=db_field.verbose_name if hasattr(db_field, 'verbose_name') else db_field.name.replace('_', ' ').title()

django_cfg/modules/django_admin/config/__init__.py

@@ -14,6 +14,7 @@ from .field_config import (
     DateTimeField,
     ImageField,
     MarkdownField,
+    ShortUUIDField,
     TextField,
     UserField,
 )
@@ -36,6 +37,7 @@ __all__ = [
     "DateTimeField",
     "ImageField",
     "MarkdownField",
+    "ShortUUIDField",
     "TextField",
     "UserField",
 ]

django_cfg/modules/django_admin/config/admin_config.py

@@ -148,6 +148,13 @@ class AdminConfig(BaseModel):
         description="Markdown documentation configuration"
     )
 
+    # Encrypted fields options
+    show_encrypted_fields_as_plain_text: bool = Field(
+        False,
+        description="Show encrypted fields (django-crypto-fields) as plain text instead of password masked. "
+                    "WARNING: This exposes sensitive data in the admin interface. Use only in trusted environments."
+    )
+
     def get_display_field_config(self, field_name: str) -> Optional[FieldConfig]:
         """Get FieldConfig for a specific field."""
         for field_config in self.display_fields:

django_cfg/modules/django_admin/config/background_task_config.py

@@ -18,7 +18,7 @@ class BackgroundTaskConfig(BaseModel):
         ```python
         background_config = BackgroundTaskConfig(
             enabled=True,
-            task_runner='rearq',
+            task_runner='django_rq',
             batch_size=100,
             timeout=300,
         )
@@ -35,9 +35,9 @@ class BackgroundTaskConfig(BaseModel):
         description="Enable background task processing"
     )
 
-    task_runner: Literal['rearq', 'celery', 'django_q', 'sync'] = Field(
-        'rearq',
-        description="Task runner to use for background operations"
+    task_runner: Literal['django_rq', 'sync'] = Field(
+        'sync',
+        description="Task runner to use for background operations (django_rq or sync)"
     )
 
     batch_size: int = Field(

django_cfg/modules/django_admin/config/field_config.py

@@ -341,3 +341,27 @@ class MarkdownField(FieldConfig):
             config['header_icon'] = self.header_icon
 
         return config
+
+
+class ShortUUIDField(FieldConfig):
+    """
+    Short UUID widget configuration for displaying shortened UUIDs.
+
+    Examples:
+        ShortUUIDField(name="id", length=8)
+        ShortUUIDField(name="uuid", length=12, copy_on_click=True)
+    """
+
+    ui_widget: Literal["short_uuid"] = "short_uuid"
+
+    length: int = Field(8, description="Number of characters to display from UUID")
+    copy_on_click: bool = Field(True, description="Enable click-to-copy functionality")
+    show_full_on_hover: bool = Field(True, description="Show full UUID in tooltip on hover")
+
+    def get_widget_config(self) -> Dict[str, Any]:
+        """Extract short UUID widget configuration."""
+        config = super().get_widget_config()
+        config['length'] = self.length
+        config['copy_on_click'] = self.copy_on_click
+        config['show_full_on_hover'] = self.show_full_on_hover
+        return config

django_cfg/modules/django_admin/templates/django_admin/widgets/encrypted_field.html

@@ -0,0 +1,80 @@
+{% comment %}
+Template for encrypted text field with copy button.
+Based on unfold/widgets/text.html with added copy functionality.
+{% endcomment %}
+
+<div class="max-w-2xl relative w-full">
+    {% if widget.prefix %}
+        <span class="absolute left-3 top-0 bottom-0 flex items-center justify-center">
+            {{ widget.prefix }}
+        </span>
+    {% endif %}
+
+    {% if widget.prefix_icon %}
+        <span class="material-symbols-outlined absolute left-3 top-0 bottom-0 flex items-center justify-center text-base-400 dark:text-base-500">
+            {{ widget.prefix_icon }}
+        </span>
+    {% endif %}
+
+    {% include "django/forms/widgets/input.html" %}
+
+    {% if widget.suffix %}
+        <span class="absolute right-3 top-0 bottom-0 flex items-center justify-center">
+            {{ widget.suffix }}
+        </span>
+    {% endif %}
+
+    {% if widget.suffix_icon %}
+        <span class="material-symbols-outlined absolute right-3 top-0 bottom-0 flex items-center justify-center text-base-400 dark:text-base-500">
+            {{ widget.suffix_icon }}
+        </span>
+    {% endif %}
+
+    {% if widget.show_copy_button %}
+        <button
+            type="button"
+            onclick="copyEncryptedField(this)"
+            class="material-symbols-outlined absolute right-3 top-0 bottom-0 flex items-center justify-center text-base-400 hover:text-primary-600 dark:text-base-500 dark:hover:text-primary-500 cursor-pointer transition-colors"
+            title="Copy to clipboard"
+        >
+            content_copy
+        </button>
+    {% endif %}
+</div>
+
+<script>
+function copyEncryptedField(button) {
+    // Get the input field (previous sibling of button's parent)
+    const container = button.parentElement;
+    const input = container.querySelector('input');
+
+    if (!input || !input.value) {
+        return;
+    }
+
+    // Copy to clipboard
+    navigator.clipboard.writeText(input.value).then(() => {
+        // Visual feedback - change icon temporarily
+        const originalIcon = button.textContent;
+        button.textContent = 'check';
+        button.classList.add('text-green-600', 'dark:text-green-500');
+
+        // Reset after 2 seconds
+        setTimeout(() => {
+            button.textContent = originalIcon;
+            button.classList.remove('text-green-600', 'dark:text-green-500');
+        }, 2000);
+    }).catch(err => {
+        console.error('Failed to copy:', err);
+        // Show error feedback
+        const originalIcon = button.textContent;
+        button.textContent = 'error';
+        button.classList.add('text-red-600', 'dark:text-red-500');
+
+        setTimeout(() => {
+            button.textContent = originalIcon;
+            button.classList.remove('text-red-600', 'dark:text-red-500');
+        }, 2000);
+    });
+}
+</script>

django_cfg/modules/django_admin/templates/django_admin/widgets/encrypted_password.html

@@ -0,0 +1,62 @@
+{% comment %}
+Template for encrypted password field with copy button.
+Based on Django's default password widget with Unfold styling and copy button.
+{% endcomment %}
+
+<div class="max-w-2xl relative w-full">
+    {% include "django/forms/widgets/input.html" %}
+
+    {% if widget.show_copy_button %}
+        <button
+            type="button"
+            onclick="copyEncryptedPassword(this)"
+            class="material-symbols-outlined absolute right-3 top-0 bottom-0 flex items-center justify-center text-base-400 hover:text-primary-600 dark:text-base-500 dark:hover:text-primary-500 cursor-pointer transition-colors"
+            title="Copy to clipboard"
+        >
+            content_copy
+        </button>
+    {% endif %}
+</div>
+
+<script>
+function copyEncryptedPassword(button) {
+    // Get the input field (previous sibling of button's parent)
+    const container = button.parentElement;
+    const input = container.querySelector('input');
+
+    if (!input || !input.value) {
+        return;
+    }
+
+    // For password fields, we need to temporarily change type to text to get the real value
+    const originalType = input.type;
+    input.type = 'text';
+    const value = input.value;
+    input.type = originalType;
+
+    // Copy to clipboard
+    navigator.clipboard.writeText(value).then(() => {
+        // Visual feedback - change icon temporarily
+        const originalIcon = button.textContent;
+        button.textContent = 'check';
+        button.classList.add('text-green-600', 'dark:text-green-500');
+
+        // Reset after 2 seconds
+        setTimeout(() => {
+            button.textContent = originalIcon;
+            button.classList.remove('text-green-600', 'dark:text-green-500');
+        }, 2000);
+    }).catch(err => {
+        console.error('Failed to copy:', err);
+        // Show error feedback
+        const originalIcon = button.textContent;
+        button.textContent = 'error';
+        button.classList.add('text-red-600', 'dark:text-red-500');
+
+        setTimeout(() => {
+            button.textContent = originalIcon;
+            button.classList.remove('text-red-600', 'dark:text-red-500');
+        }, 2000);
+    });
+}
+</script>

django_cfg/modules/django_admin/utils/__init__.py

@@ -1,17 +1,46 @@
 """
-Display and badge utilities for Django Admin.
+Display and utility modules for Django Admin.
+
+Refactored structure with logical organization:
+- badges/ - Status badges, progress badges, counter badges
+- displays/ - User displays, money displays, datetime displays
+- html/ - HTML building utilities (organized by functionality)
+- markdown/ - Markdown rendering with Mermaid support
+- decorators.py - Admin field decorators
+- html_builder.py - Backward-compatible facade for self.html.* API
 """
 
+# Badges
 from .badges import CounterBadge, ProgressBadge, StatusBadge
+
+# Decorators
 from .decorators import (
     annotated_field,
     badge_field,
     computed_field,
     currency_field,
 )
+
+# Displays
 from .displays import DateTimeDisplay, MoneyDisplay, UserDisplay
+
+# HTML Builders (organized by functionality)
+from .html import (
+    BadgeElements,
+    BaseElements,
+    CodeElements,
+    CompositionElements,
+    FormattingElements,
+    KeyValueElements,
+    MarkdownIntegration,
+    ProgressElements,
+)
+
+# HtmlBuilder - Backward-compatible facade
 from .html_builder import HtmlBuilder
-from .markdown_renderer import MarkdownRenderer
+
+# Markdown
+from .markdown import MarkdownRenderer
 
 __all__ = [
     # Display utilities
@@ -22,7 +51,16 @@ __all__ = [
     "StatusBadge",
     "ProgressBadge",
     "CounterBadge",
-    # HTML Builder
+    # HTML Builders (modular)
+    "BaseElements",
+    "CodeElements",
+    "BadgeElements",
+    "CompositionElements",
+    "FormattingElements",
+    "KeyValueElements",
+    "ProgressElements",
+    "MarkdownIntegration",
+    # HTML Builder (backward-compatible facade)
     "HtmlBuilder",
     # Markdown Renderer
     "MarkdownRenderer",

django_cfg/modules/django_admin/utils/badges/__init__.py

@@ -0,0 +1,13 @@
+"""
+Badge utilities for Django Admin.
+
+Provides StatusBadge, ProgressBadge, and CounterBadge classes.
+"""
+
+from .status_badges import CounterBadge, ProgressBadge, StatusBadge
+
+__all__ = [
+    "StatusBadge",
+    "ProgressBadge",
+    "CounterBadge",
+]

django_cfg/modules/django_admin/utils/{badges.py → badges/status_badges.py}

@@ -9,9 +9,9 @@ from django.contrib.humanize.templatetags.humanize import intcomma
 from django.utils.html import escape, format_html
 from django.utils.safestring import SafeString
 
-from ..icons import Icons
-from ..models.badge_models import StatusBadgeConfig
-from ..models.base import BadgeVariant
+from ...icons import Icons
+from ...models.badge_models import StatusBadgeConfig
+from ...models.base import BadgeVariant
 
 logger = logging.getLogger(__name__)
 

django_cfg/modules/django_admin/utils/displays/__init__.py

@@ -0,0 +1,13 @@
+"""
+Display utilities for Django Admin.
+
+Provides UserDisplay, MoneyDisplay, and DateTimeDisplay classes.
+"""
+
+from .data_displays import DateTimeDisplay, MoneyDisplay, UserDisplay
+
+__all__ = [
+    "UserDisplay",
+    "MoneyDisplay",
+    "DateTimeDisplay",
+]

django_cfg/modules/django_admin/utils/{displays.py → displays/data_displays.py}

@@ -12,8 +12,8 @@ from django.utils import timezone
 from django.utils.html import escape, format_html
 from django.utils.safestring import SafeString
 
-from ..icons import Icons
-from ..models.display_models import DateTimeDisplayConfig, MoneyDisplayConfig, UserDisplayConfig
+from ...icons import Icons
+from ...models.display_models import DateTimeDisplayConfig, MoneyDisplayConfig, UserDisplayConfig
 
 logger = logging.getLogger(__name__)
 

django_cfg/modules/django_admin/utils/html/__init__.py

@@ -0,0 +1,26 @@
+"""
+HTML builder module - organized and modular.
+
+Exports all HTML building classes for easy access.
+"""
+
+from .badges import BadgeElements
+from .base import BaseElements
+from .code import CodeElements
+from .composition import CompositionElements
+from .formatting import FormattingElements
+from .keyvalue import KeyValueElements
+from .markdown_integration import MarkdownIntegration
+from .progress import ProgressElements
+
+__all__ = [
+    # Core elements
+    "BaseElements",
+    "CodeElements",
+    "BadgeElements",
+    "CompositionElements",
+    "FormattingElements",
+    "KeyValueElements",
+    "ProgressElements",
+    "MarkdownIntegration",
+]

django_cfg/modules/django_admin/utils/html/badges.py

@@ -0,0 +1,55 @@
+"""
+Badge elements for Django Admin.
+
+Provides badge rendering with variants and icons.
+"""
+
+from typing import Optional
+
+from django.utils.html import escape, format_html
+from django.utils.safestring import SafeString
+
+
+class BadgeElements:
+    """Badge display elements."""
+
+    @staticmethod
+    def badge(text: any, variant: str = "primary", icon: Optional[str] = None) -> SafeString:
+        """
+        Render badge with optional icon.
+
+        Args:
+            text: Badge text
+            variant: primary, success, warning, danger, info, secondary
+            icon: Optional Material Icon
+
+        Usage:
+            html.badge("Active", variant="success", icon=Icons.CHECK_CIRCLE)
+        """
+        variant_classes = {
+            'success': 'bg-success-100 text-success-800 dark:bg-success-900 dark:text-success-200',
+            'warning': 'bg-warning-100 text-warning-800 dark:bg-warning-900 dark:text-warning-200',
+            'danger': 'bg-danger-100 text-danger-800 dark:bg-danger-900 dark:text-danger-200',
+            'info': 'bg-info-100 text-info-800 dark:bg-info-900 dark:text-info-200',
+            'primary': 'bg-primary-100 text-primary-800 dark:bg-primary-900 dark:text-primary-200',
+            'secondary': 'bg-base-100 text-font-default-light dark:bg-base-800 dark:text-font-default-dark',
+        }
+
+        css_classes = variant_classes.get(variant, variant_classes['primary'])
+
+        icon_html = ""
+        if icon:
+            icon_html = format_html('<span class="material-symbols-outlined text-xs mr-1">{}</span>', icon)
+
+        # Check if text is already safe HTML (e.g., from self.html.number() or self.html.inline())
+        if isinstance(text, SafeString):
+            # Already safe, don't escape
+            text_html = text
+        else:
+            # Regular text, escape for safety
+            text_html = escape(str(text))
+
+        return format_html(
+            '<span class="inline-flex items-center rounded-full px-2.5 py-0.5 text-xs font-medium {}">{}{}</span>',
+            css_classes, icon_html, text_html
+        )