django-cfg 1.1.81__py3-none-any.whl → 1.2.0__py3-none-any.whl

django_cfg/apps/tasks/@docs/README.md

@@ -1,195 +0,0 @@
-# 📚 Django-CFG Tasks Documentation
-
-## 🎯 Overview
-
-This directory contains comprehensive documentation for Django-CFG task system, covering all aspects of background task processing with Dramatiq.
-
-**Documentation follows the DOCS_MODULE.md methodology** for LLM-optimized, token-efficient documentation.
-
----
-
-## 📖 Documentation Files
-
-### [TASKS_QUEUES.md](./TASKS_QUEUES.md) %%PRIORITY:HIGH%%
-**Main documentation covering**:
-- Architecture and core components
-- Queue configuration and usage patterns  
-- Worker management (manual startup)
-- Task processing flows
-- Common issues and solutions
-- Development workflow
-- Production deployment
-
-**Use this for**: Understanding the system, configuration, and general usage.
-
-### [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) %%PRIORITY:HIGH%%
-**Comprehensive troubleshooting guide covering**:
-- Critical issues (tasks stuck, Redis DB mismatch, worker failures)
-- Diagnostic tools and commands
-- Recovery procedures
-- Performance issues
-- Emergency procedures
-- Prevention tips
-
-**Use this for**: Debugging problems, performance issues, and system recovery.
-
-### [CONFIGURATION.md](./CONFIGURATION.md)
-**Complete configuration reference covering**:
-- Configuration models (TaskConfig, DramatiqConfig)
-- Environment-specific configurations
-- Docker and container setup
-- Process management (systemd, supervisor)
-- Security configuration
-- Monitoring and health checks
-- Advanced configuration options
-
-**Use this for**: Setting up environments, deployment, and advanced configuration.
-
----
-
-## 🚀 Quick Start
-
-### 1. Basic Setup
-```python
-# In your Django-CFG config
-from django_cfg.models.tasks import TaskConfig, DramatiqConfig
-
-config = SampleProjectConfig(
-    tasks=TaskConfig(
-        enabled=True,
-        dramatiq=DramatiqConfig(
-            redis_db=2,  # Important: Use separate Redis DB
-            processes=2,
-            threads=4,
-            queues=["default", "knowledge", "high", "low"]
-        )
-    )
-)
-```
-
-### 2. Start Workers
-```bash
-# Manual startup (recommended)
-poetry run python manage.py rundramatiq --processes 2 --threads 4
-
-# Development mode
-poetry run python manage.py rundramatiq --processes 1 --threads 2
-```
-
-### 3. Create Tasks
-```python
-import dramatiq
-
-@dramatiq.actor(queue_name="knowledge")
-def process_document(document_id: str):
-    # Your task logic here
-    pass
-
-# Enqueue task
-process_document.send("doc-123")
-```
-
----
-
-## 🔧 Key Changes %%BREAKING_CHANGE%%
-
-### Removed in v1.1.54
-- **Auto-start functionality**: No more automatic worker startup
-- **`auto_start_worker` field**: Removed from TaskConfig model
-- **Subprocess worker management**: Eliminated due to reliability issues
-
-### Why the Change?
-1. **Subprocess Issues**: Workers couldn't find Django commands properly
-2. **Environment Problems**: `DJANGO_SETTINGS_MODULE` not inherited correctly  
-3. **Process Management**: Better handled by systemd/supervisor in production
-4. **Reliability**: Manual startup is more predictable and debuggable
-
----
-
-## 🚨 Common Issues Quick Reference
-
-| Issue | Quick Fix |
-|-------|-----------|
-| Tasks stuck in pending | Start workers: `poetry run python manage.py rundramatiq` |
-| Redis DB mismatch | Check `redis_db=2` in config, verify Redis URL |
-| Worker subprocess fails | Use manual startup, not auto-start |
-| Database routing errors | Verify `app_label` matches database routing |
-| Message decoding errors | Clear DLQ: `redis-cli -n 2 DEL dramatiq:queue:knowledge.DQ` |
-
----
-
-## 🎯 Documentation Philosophy
-
-This documentation follows these principles:
-
-### LLM-Optimized %%AI_HINT%%
-- **Token-efficient**: Concise but comprehensive
-- **Structured**: Clear headings and sections for easy parsing
-- **Searchable**: Tagged with relevant keywords
-- **Contextual**: Includes AI hints and priority markers
-
-### Problem-Focused
-- **Real Issues**: Documents actual problems encountered
-- **Tested Solutions**: All solutions have been verified
-- **Prevention**: Includes anti-patterns and best practices
-- **Recovery**: Emergency procedures for critical issues
-
-### Production-Ready
-- **Deployment**: Covers systemd, supervisor, Docker
-- **Monitoring**: Health checks, logging, metrics
-- **Security**: Redis security, environment variables
-- **Scaling**: Resource planning and performance tuning
-
----
-
-## 🔍 Finding Information
-
-### By Use Case
-- **Setting up tasks**: Start with [TASKS_QUEUES.md](./TASKS_QUEUES.md) → Architecture section
-- **Deployment**: Go to [CONFIGURATION.md](./CONFIGURATION.md) → Process Management
-- **Debugging**: Check [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) → Diagnostic Tools
-- **Performance**: See [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) → Performance Issues
-
-### By Component
-- **Redis**: All files cover Redis, see Configuration for security
-- **Workers**: TASKS_QUEUES.md for management, TROUBLESHOOTING.md for issues
-- **Queues**: TASKS_QUEUES.md for configuration, TROUBLESHOOTING.md for monitoring
-- **Tasks**: TASKS_QUEUES.md for flows, TROUBLESHOOTING.md for debugging
-
-### By Environment
-- **Development**: TASKS_QUEUES.md → Development Workflow
-- **Production**: CONFIGURATION.md → Production Deployment
-- **Testing**: CONFIGURATION.md → Testing Configuration
-- **Docker**: CONFIGURATION.md → Docker Configuration
-
----
-
-## 📊 Documentation Metrics
-
-- **Total Lines**: ~2,400 lines across 4 files
-- **Max File Size**: <1,000 lines per file (DOCS_MODULE.md compliant)
-- **Coverage**: 100% of task system functionality
-- **Examples**: 50+ code examples and commands
-- **Issues Covered**: 15+ common problems with solutions
-
----
-
-## 🧠 Contributing
-
-When updating this documentation:
-
-1. **Follow DOCS_MODULE.md format**: Use proper headings, tags, and markers
-2. **Keep files under 1,000 lines**: Split if necessary
-3. **Test all examples**: Ensure code examples work
-4. **Update version history**: Mark changes with version numbers
-5. **Add AI hints**: Use `%%AI_HINT%%` for important context
-
-### Documentation Standards
-- **Concise**: Every line adds value
-- **Accurate**: All information verified
-- **Current**: Regular updates with system changes
-- **Searchable**: Proper tagging and keywords
-
-**TAGS**: `documentation, tasks, queues, dramatiq, django-cfg`
-**DEPENDS_ON**: Django-CFG task system, Dramatiq, Redis
-**USED_BY**: Developers, DevOps, System administrators, AI assistants

django_cfg/models/unfold.py

@@ -1,271 +0,0 @@
-"""
-Unfold Configuration Models for django_cfg.
-
-Provides type-safe configuration for Django Unfold admin interface.
-"""
-
-from typing import List, Optional, Dict, Any
-from pydantic import BaseModel, Field
-from django.urls import reverse_lazy, NoReverseMatch
-import base64
-
-from django_cfg.modules.unfold.tailwind import get_unfold_colors, get_css_variables
-
-class UnfoldColors(BaseModel):
-    """Unfold color theme configuration."""
-
-    primary: Optional[str] = Field(None, description="Primary color")
-    success: Optional[str] = Field(None, description="Success color")
-    warning: Optional[str] = Field(None, description="Warning color")
-    danger: Optional[str] = Field(None, description="Danger color")
-    info: Optional[str] = Field(None, description="Info color")
-
-
-class UnfoldSidebar(BaseModel):
-    """Unfold sidebar configuration."""
-
-    show_search: bool = Field(True, description="Show search in sidebar")
-    show_all_applications: bool = Field(True, description="Show all applications")
-    navigation: List[Dict[str, Any]] = Field(default_factory=list, description="Custom navigation")
-
-
-class NavigationItem(BaseModel):
-    """Single navigation item configuration."""
-
-    title: str = Field(..., description="Navigation item title")
-    icon: Optional[str] = Field(None, description="Material icon name")
-    link: Optional[str] = Field(None, description="Navigation link")
-    badge: Optional[str] = Field(None, description="Badge text")
-
-class NavigationGroup(BaseModel):
-    """Navigation group configuration."""
-
-    title: str = Field(..., description="Group title")
-    separator: bool = Field(True, description="Add separator before group")
-    collapsible: bool = Field(True, description="Group is collapsible")
-    items: List[NavigationItem] = Field(default_factory=list, description="Group items")
-
-
-class DropdownItem(BaseModel):
-    """Dropdown menu item configuration."""
-
-    title: str = Field(..., description="Item title")
-    icon: str = Field(..., description="Material icon name")
-    link: str = Field(..., description="Item URL")
-
-
-class QuickAction(BaseModel):
-    """Quick action configuration for dashboard."""
-
-    title: str = Field(..., description="Action title")
-    icon: str = Field(..., description="Material icon name")
-    url: str = Field(..., description="Action URL")
-    description: Optional[str] = Field(None, description="Action description")
-    color: Optional[str] = Field(None, description="Action color")
-
-
-def get_reverse_lazy(link: str) -> str:
-    try:
-        return reverse_lazy(link)
-    except NoReverseMatch:
-        return link
-
-
-class DashboardWidget(BaseModel):
-    """Dashboard widget configuration."""
-
-    title: str = Field(..., description="Widget title")
-    template: Optional[str] = Field(None, description="Custom template path")
-    callback: Optional[str] = Field(None, description="Callback function path")
-    width: int = Field(12, description="Widget width (1-12)")
-    order: int = Field(0, description="Widget order")
-
-
-class UnfoldTheme(BaseModel):
-    """Complete Unfold theme configuration."""
-
-    # Basic theme settings
-    site_title: str = Field("Django Admin", description="Site title")
-    site_header: str = Field("Django Administration", description="Site header")
-    site_url: str = Field("/", description="Site URL")
-    site_symbol: str = Field("rocket_launch", description="Material icon for site")
-
-    # UI settings
-    show_history: bool = Field(True, description="Show history in admin")
-    show_view_on_site: bool = Field(True, description="Show view on site links")
-    show_back_button: bool = Field(False, description="Show back button")
-
-    # Theme and appearance
-    theme: Optional[str] = Field(None, description="Theme: light, dark, or None for switcher")
-    colors: UnfoldColors = Field(default_factory=UnfoldColors, description="Color theme")
-    sidebar: UnfoldSidebar = Field(default_factory=UnfoldSidebar, description="Sidebar config")
-
-    # Dashboard
-    dashboard_callback: Optional[str] = Field(None, description="Dashboard callback function")
-    environment_callback: Optional[str] = Field(None, description="Environment callback function")
-
-    # Navigation
-    navigation: List[NavigationGroup] = Field(default_factory=list, description="Custom navigation")
-
-    # Site dropdown menu
-    site_dropdown: List[DropdownItem] = Field(default_factory=list, description="Site dropdown menu items")
-
-    # Quick actions and widgets
-    quick_actions: List[QuickAction] = Field(default_factory=list, description="Dashboard quick actions")
-    widgets: List[DashboardWidget] = Field(default_factory=list, description="Dashboard widgets")
-
-    def to_django_settings(self) -> Dict[str, Any]:
-        """Convert to Django UNFOLD settings."""
-        # Try to import colors, fallback to base colors if not available
-        colors = get_unfold_colors()
-
-        settings = {
-            "SITE_TITLE": self.site_title,
-            "SITE_HEADER": self.site_header,
-            "SITE_URL": self.site_url,
-            "SITE_SYMBOL": self.site_symbol,
-            "SHOW_HISTORY": self.show_history,
-            "SHOW_VIEW_ON_SITE": self.show_view_on_site,
-            "SHOW_BACK_BUTTON": self.show_back_button,
-            "COLORS": colors,
-            "BORDER_RADIUS": "8px",
-        }
-
-        # Theme settings
-        if self.theme:
-            settings["THEME"] = self.theme
-
-        # Sidebar configuration - KEY PART!
-        sidebar_config = {
-            "show_search": self.sidebar.show_search,
-            "command_search": True,
-            "show_all_applications": self.sidebar.show_all_applications,
-        }
-        
-        # Get default navigation from dashboard manager
-        from django_cfg.modules.unfold.dashboard import DashboardManager
-        dashboard = DashboardManager()
-        nav_items = dashboard.get_navigation_config()
-        
-        # 1. Add custom navigation from project (if defined)
-        if self.navigation:
-            # Project has custom navigation - add it first
-            for group in self.navigation:
-                group_dict = {
-                    "title": group.title,
-                    "separator": group.separator,
-                    "collapsible": group.collapsible,
-                    "items": [
-                        {
-                            "title": item.title,
-                            "icon": item.icon,
-                            "link": get_reverse_lazy(item.link),
-                        }
-                        for item in group.items
-                    ],
-                }
-                nav_items.append(group_dict)
-        
-        sidebar_config["navigation"] = nav_items
-
-        settings["SIDEBAR"] = sidebar_config
-
-        # Command interface
-        settings["COMMAND"] = {
-            "search_models": True,
-            "show_history": True,
-        }
-
-        # Multi-language support - DISABLED
-        settings["SHOW_LANGUAGES"] = False
-
-        # Site dropdown menu
-        if self.site_dropdown:
-            settings["SITE_DROPDOWN"] = [
-                {
-                    "icon": item.icon,
-                    "title": item.title,
-                    "link": item.link,
-                }
-                for item in self.site_dropdown
-            ]
-
-        # Dashboard callback
-        if self.dashboard_callback:
-            settings["DASHBOARD_CALLBACK"] = self.dashboard_callback
-
-        # Environment callback
-        if self.environment_callback:
-            settings["ENVIRONMENT_CALLBACK"] = self.environment_callback
-
-        return settings
-
-
-
-class UnfoldConfig(BaseModel):
-    """
-    Main Unfold configuration for django_cfg.
-
-    Usage:
-        unfold = UnfoldConfig(
-            theme=UnfoldTheme(
-                site_title="My Admin",
-                site_header="My Project Admin",
-            )
-        )
-    """
-
-    enabled: bool = Field(True, description="Enable Unfold admin interface")
-    theme: UnfoldTheme = Field(default_factory=UnfoldTheme, description="Unfold theme configuration")
-
-    # Additional settings that can be overridden
-    additional_settings: Dict[str, Any] = Field(default_factory=dict, description="Additional Django UNFOLD settings")
-
-    def to_django_settings(self) -> Dict[str, Any]:
-        """Generate Django settings for Unfold."""
-        if not self.enabled:
-            return {}
-
-        # Get base settings from theme
-        unfold_settings = self.theme.to_django_settings()
-
-        # Inject universal CSS variables (includes object-tools flex)
-        if "STYLES" not in unfold_settings:
-            unfold_settings["STYLES"] = []
-        
-        # Add our CSS as inline data URI
-        css_content = get_css_variables()
-        css_b64 = base64.b64encode(css_content.encode('utf-8')).decode('utf-8')
-        data_uri = f"data:text/css;base64,{css_b64}"
-        
-        unfold_settings["STYLES"].append(lambda request: data_uri)
-        
-        # Add Tailwind CSS CDN
-        if "SCRIPTS" not in unfold_settings:
-            unfold_settings["SCRIPTS"] = []
-        
-        # unfold_settings["SCRIPTS"].append(
-        #     lambda request: "https://cdn.tailwindcss.com/4.1.11"
-        # )
-
-        # Merge additional settings
-        unfold_settings.update(self.additional_settings)
-
-        return {"UNFOLD": unfold_settings}
-
-    def get_installed_apps(self) -> List[str]:
-        """Get required installed apps for Unfold."""
-        if not self.enabled:
-            return []
-
-        return [
-            "unfold",  # Must be before django.contrib.admin
-            "unfold.contrib.filters",  # Optional filters
-            "unfold.contrib.forms",  # Optional form elements
-            "unfold.contrib.inlines",  # Inline forms
-            "unfold.contrib.import_export",  # Import/export functionality
-            "unfold.contrib.guardian",  # Guardian permissions
-            "unfold.contrib.simple_history",  # Simple history
-            "unfold.contrib.location_field",  # Location fields
-            "unfold.contrib.constance",  # Constance integration
-        ]

django_cfg/modules/unfold/__init__.py

@@ -1,29 +0,0 @@
-"""
-Django CFG Unfold Module
-
-Complete Unfold admin interface integration with system monitoring,
-dashboard callbacks, and auto-configuration.
-"""
-
-from .system_monitor import SystemMonitor
-from .dashboard import DashboardManager
-from .callbacks import UnfoldCallbacks
-from .models import DashboardData, StatCard, SystemHealthItem, QuickAction
-
-# Export instances for easy import
-system_monitor = SystemMonitor()
-dashboard_manager = DashboardManager()
-unfold_callbacks = UnfoldCallbacks()
-
-__all__ = [
-    "SystemMonitor",
-    "DashboardManager", 
-    "UnfoldCallbacks",
-    "DashboardData",
-    "StatCard",
-    "SystemHealthItem",
-    "QuickAction",
-    "system_monitor",
-    "dashboard_manager",
-    "unfold_callbacks",
-]