django-cfg 1.4.117__tar.gz → 1.4.119__tar.gz

{django_cfg-1.4.117 → django_cfg-1.4.119}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.117
+Version: 1.4.119
 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

{django_cfg-1.4.117 → django_cfg-1.4.119}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.117"
+version = "1.4.119"
 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",]

{django_cfg-1.4.117 → django_cfg-1.4.119}/src/django_cfg/__init__.py

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

{django_cfg-1.4.117 → django_cfg-1.4.119}/src/django_cfg/core/builders/apps_builder.py

@@ -166,6 +166,8 @@ class InstalledAppsBuilder:
         # Add django-q2 if enabled
         if hasattr(self.config, "django_q2") and self.config.django_q2 and self.config.django_q2.enabled:
             apps.append("django_q")
+            # Auto-add django_q2 module for automatic schedule synchronization
+            apps.append("django_cfg.modules.django_q2")
 
         # Add DRF Tailwind theme module (uses Tailwind via CDN)
         if self.config.enable_drf_tailwind:

{django_cfg-1.4.117 → django_cfg-1.4.119}/src/django_cfg/core/constants.py

@@ -45,6 +45,7 @@ DEFAULT_APPS: List[str] = [
     # Django CFG Core
     "django_cfg",
     "django_cfg.modules.django_client",
+    "django_cfg.modules.django_admin",
 ]
 
 # Default middleware stack

{django_cfg-1.4.117 → django_cfg-1.4.119}/src/django_cfg/models/django/django_q2.py

@@ -302,6 +302,19 @@ class DjangoQ2Config(BaseModel):
         )
         ```
 
+    Schedule Synchronization (AUTOMATIC):
+        When Django-Q2 is enabled, schedules are automatically synced after migrations.
+
+        The module 'django_cfg.modules.django_q2' is automatically added to INSTALLED_APPS
+        when django_q2.enabled=True, so you don't need to add it manually.
+
+        It uses Django's post_migrate signal to sync schedules from config to database.
+
+        Manual sync (optional):
+        ```bash
+        python manage.py sync_django_q_schedules
+        ```
+
     Admin interface:
         - Visit /admin/django_q/ to view tasks and schedules
         - Monitor task execution, failures, and performance

django_cfg-1.4.119/src/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-1.4.117 → django_cfg-1.4.119}/src/django_cfg/modules/django_admin/base/pydantic_admin.py

@@ -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-1.4.117 → django_cfg-1.4.119}/src/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-1.4.119/src/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-1.4.119/src/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-1.4.119/src/django_cfg/modules/django_admin/widgets/__init__.py

@@ -0,0 +1,12 @@
+"""
+Widget system for Django Admin.
+"""
+
+from .encrypted_field_widget import EncryptedFieldWidget, EncryptedPasswordWidget
+from .registry import WidgetRegistry
+
+__all__ = [
+    "WidgetRegistry",
+    "EncryptedFieldWidget",
+    "EncryptedPasswordWidget",
+]

django_cfg-1.4.119/src/django_cfg/modules/django_admin/widgets/encrypted_field_widget.py

@@ -0,0 +1,66 @@
+"""
+Custom widget for encrypted fields with copy button.
+"""
+from typing import Any, Optional
+
+from unfold.widgets import UnfoldAdminPasswordInput, UnfoldAdminTextInputWidget
+
+
+class EncryptedFieldWidget(UnfoldAdminTextInputWidget):
+    """
+    Text input widget for encrypted fields with copy-to-clipboard button.
+
+    Extends UnfoldAdminTextInputWidget to add a copy button on the right side.
+    """
+
+    template_name = "django_admin/widgets/encrypted_field.html"
+
+    def __init__(self, attrs: Optional[dict[str, Any]] = None, show_copy_button: bool = True) -> None:
+        """
+        Initialize the widget.
+
+        Args:
+            attrs: Widget attributes
+            show_copy_button: Whether to show the copy button (default: True)
+        """
+        self.show_copy_button = show_copy_button
+        super().__init__(attrs=attrs)
+
+    def get_context(self, name, value, attrs):
+        """Add copy button context."""
+        context = super().get_context(name, value, attrs)
+        context['widget']['show_copy_button'] = self.show_copy_button
+        return context
+
+
+class EncryptedPasswordWidget(UnfoldAdminPasswordInput):
+    """
+    Password input widget for encrypted fields with copy button.
+
+    Extends UnfoldAdminPasswordInput to add a copy button on the right side.
+    """
+
+    template_name = "django_admin/widgets/encrypted_password.html"
+
+    def __init__(
+        self,
+        attrs: Optional[dict[str, Any]] = None,
+        render_value: bool = False,
+        show_copy_button: bool = True
+    ) -> None:
+        """
+        Initialize the widget.
+
+        Args:
+            attrs: Widget attributes
+            render_value: Whether to render the value (default: False)
+            show_copy_button: Whether to show the copy button (default: True)
+        """
+        self.show_copy_button = show_copy_button
+        super().__init__(attrs=attrs, render_value=render_value)
+
+    def get_context(self, name, value, attrs):
+        """Add copy button context."""
+        context = super().get_context(name, value, attrs)
+        context['widget']['show_copy_button'] = self.show_copy_button
+        return context

django_cfg-1.4.119/src/django_cfg/modules/django_q2/README.md

@@ -0,0 +1,140 @@
+# Django-Q2 Module
+
+Автоматическая синхронизация расписаний Django-Q2 из конфига в базу данных.
+
+## Зачем это нужно?
+
+Django-Q2 хранит расписания в базе данных, но **не создаёт их автоматически** из конфига.
+Этот модуль решает эту проблему - синхронизирует расписания после каждой миграции.
+
+## Использование
+
+### 1. Включи Django-Q2 в конфиге
+
+```python
+# config.py
+from django_cfg.models.django import DjangoQ2Config
+
+django_q2 = DjangoQ2Config(
+    enabled=True,  # ← Автоматически добавит django_q и django_cfg.modules.django_q2 в INSTALLED_APPS
+    schedules=[...]
+)
+```
+
+**Модуль подключается автоматически!** Не нужно вручную добавлять в INSTALLED_APPS.
+
+### 2. Определи расписания в конфиге
+
+```python
+from django_cfg.models.django import DjangoQ2Config, DjangoQ2ScheduleConfig
+
+django_q2 = DjangoQ2Config(
+    enabled=True,
+    schedules=[
+        DjangoQ2ScheduleConfig(
+            name="Sync balances hourly",
+            schedule_type="hourly",
+            command="sync_account_balances",
+            command_args=["--verbose"],
+        ),
+        DjangoQ2ScheduleConfig(
+            name="Cleanup daily",
+            schedule_type="cron",
+            cron="0 2 * * *",  # 2 AM каждый день
+            command="cleanup_old_data",
+            command_kwargs={"days": 30},
+        ),
+    ],
+)
+```
+
+### 3. Запусти миграции
+
+```bash
+python manage.py migrate
+```
+
+**Вывод:**
+```
+Running migrations:
+  ...
+  Syncing 2 Django-Q2 schedule(s)...
+    ✓ Created schedule: Sync balances hourly
+    ✓ Created schedule: Cleanup daily
+  ✅ Django-Q2 schedules synced: 2 created, 0 updated
+```
+
+### 4. Запусти qcluster
+
+```bash
+python manage.py qcluster
+```
+
+Готово! Расписания автоматически синхронизированы и работают.
+
+## Как это работает?
+
+1. **Модуль подключается** к сигналу `post_migrate`
+2. **После миграций** автоматически:
+   - Читает расписания из конфига
+   - Создаёт/обновляет их в базе данных (Schedule model)
+3. **Django-Q2 читает** расписания из базы и выполняет задачи
+
+## Ручная синхронизация (опционально)
+
+Если нужно синхронизировать без миграций:
+
+```bash
+python manage.py sync_django_q_schedules
+
+# Или с --dry-run для проверки:
+python manage.py sync_django_q_schedules --dry-run
+```
+
+## Безопасность
+
+- ✅ **Идемпотентность**: можно запускать много раз, не создаст дубликаты
+- ✅ **Без race conditions**: синхронизация происходит один раз за цикл миграций
+- ✅ **Graceful degradation**: если Django-Q2 не установлен, модуль просто молча пропустит синхронизацию
+- ✅ **Logging**: все операции логируются для отладки
+
+## Преимущества перед ручной синхронизацией
+
+| Аспект | Ручная синхронизация | Модуль |
+|--------|---------------------|--------|
+| Автоматизация | Нужно помнить запускать | Автоматически |
+| Деплой | Легко забыть | Всегда синхронизировано |
+| CI/CD | Нужно добавлять в скрипты | Работает из коробки |
+| Ошибки | Легко пропустить | Логи миграций |
+
+## Troubleshooting
+
+### Расписания не создаются
+
+Проверь:
+1. Модуль добавлен в INSTALLED_APPS
+2. `django_q2.enabled = True` в конфиге
+3. В конфиге есть расписания
+4. Миграции запущены: `python manage.py migrate`
+
+### Расписания не обновляются
+
+Запусти миграции повторно или используй ручную синхронизацию:
+```bash
+python manage.py migrate --run-syncdb
+# или
+python manage.py sync_django_q_schedules
+```
+
+### Логи синхронизации
+
+Включи DEBUG логи:
+```python
+LOGGING = {
+    'loggers': {
+        'django_cfg.modules.django_q2': {
+            'level': 'DEBUG',
+        },
+    },
+}
+```

django_cfg-1.4.119/src/django_cfg/modules/django_q2/__init__.py

@@ -0,0 +1,8 @@
+"""
+Django-Q2 module for django-cfg.
+
+Provides automatic schedule synchronization from config to database.
+"""
+from .apps import DjangoQ2ModuleConfig
+
+__all__ = ['DjangoQ2ModuleConfig']

django_cfg-1.4.119/src/django_cfg/modules/django_q2/apps.py

@@ -0,0 +1,107 @@
+"""
+AppConfig for Django-Q2 module with automatic schedule synchronization.
+"""
+import logging
+from django.apps import AppConfig
+from django.db.models.signals import post_migrate
+
+logger = logging.getLogger(__name__)
+
+
+def sync_schedules_after_migrate(sender, **kwargs):
+    """
+    Automatically sync Django-Q2 schedules after migrations.
+
+    This ensures schedules are always up-to-date after deployment.
+    Runs only once per migration cycle, safe from race conditions.
+    """
+    # Only run for the django_cfg_django_q2 app itself
+    if sender.name != 'django_cfg.modules.django_q2':
+        return
+
+    # Import here to avoid circular imports and ensure Django is ready
+    try:
+        from django_q.models import Schedule
+        from django_cfg.core.config import get_current_config
+    except ImportError as e:
+        logger.warning(f"Could not import Django-Q2 dependencies: {e}")
+        return
+
+    config = get_current_config()
+
+    if not config or not hasattr(config, 'django_q2') or not config.django_q2 or not config.django_q2.enabled:
+        logger.debug("Django-Q2 not enabled, skipping schedule sync")
+        return
+
+    enabled_schedules = config.django_q2.get_enabled_schedules()
+
+    if not enabled_schedules:
+        logger.debug("No Django-Q2 schedules found in config")
+        return
+
+    logger.info(f"Syncing {len(enabled_schedules)} Django-Q2 schedule(s)...")
+
+    created = 0
+    updated = 0
+
+    for schedule_config in enabled_schedules:
+        schedule_dict = schedule_config.to_django_q_format()
+        name = schedule_dict['name']
+
+        try:
+            schedule, created_flag = Schedule.objects.update_or_create(
+                name=name,
+                defaults=schedule_dict
+            )
+
+            if created_flag:
+                created += 1
+                logger.info(f"  ✓ Created schedule: {name}")
+            else:
+                updated += 1
+                logger.debug(f"  ✓ Updated schedule: {name}")
+
+        except Exception as e:
+            logger.error(f"  ✗ Failed to sync schedule '{name}': {e}")
+
+    logger.info(f"✅ Django-Q2 schedules synced: {created} created, {updated} updated")
+
+
+class DjangoQ2ModuleConfig(AppConfig):
+    """
+    AppConfig for Django-Q2 module.
+
+    Automatically syncs schedules from config to database after migrations.
+    This eliminates the need for manual `sync_django_q_schedules` command.
+
+    Features:
+    - Automatic schedule sync after migrations
+    - Safe from race conditions (runs only once)
+    - Logs all sync operations
+    - Gracefully handles missing dependencies
+
+    Usage:
+        Add to INSTALLED_APPS:
+        INSTALLED_APPS = [
+            ...
+            'django_cfg.modules.django_q2',  # Auto-syncs schedules
+        ]
+    """
+
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_cfg.modules.django_q2'
+    verbose_name = 'Django-CFG Django-Q2 Module'
+
+    def ready(self):
+        """
+        Connect post_migrate signal to automatically sync schedules.
+
+        This runs after all migrations are complete, ensuring:
+        1. Database tables exist
+        2. Config is loaded
+        3. Schedules are synced only once per migration cycle
+        """
+        # Connect the signal
+        post_migrate.connect(sync_schedules_after_migrate, sender=self)
+
+        logger.debug(f"{self.verbose_name} initialized - auto-sync enabled")