django-cfg 1.4.111__py3-none-any.whl → 1.4.114__py3-none-any.whl

django_cfg/core/generation/data_generators/cache.py

@@ -58,13 +58,18 @@ class CacheSettingsGenerator:
 
         # Default cache - always provide one
         if self.config.cache_default:
+            # User explicitly configured cache_default
             caches["default"] = self.config.cache_default.to_django_config(
                 self.config.env_mode,
                 self.config.debug,
                 "default"
             )
+        elif self.config.redis_url:
+            # Auto-create Redis cache from redis_url
+            logger.info(f"Auto-creating Redis cache from redis_url: {self.config.redis_url}")
+            caches["default"] = self._get_redis_cache_config()
         else:
-            # Create default cache backend
+            # Fallback to default cache backend (LocMem/FileBased depending on env)
             caches["default"] = self._get_default_cache_config()
 
         # Sessions cache
@@ -88,9 +93,30 @@ class CacheSettingsGenerator:
 
         return settings
 
+    def _get_redis_cache_config(self) -> Dict[str, Any]:
+        """
+        Auto-create Redis cache from config.redis_url.
+
+        Returns:
+            Dictionary with Redis cache backend configuration
+        """
+        from ....models.infrastructure.cache import CacheConfig
+
+        redis_cache = CacheConfig(
+            redis_url=self.config.redis_url,
+            timeout=300,  # 5 minutes default
+            max_connections=50,
+            key_prefix=self.config.project_name.lower().replace(" ", "_") if self.config.project_name else "django",
+        )
+        return redis_cache.to_django_config(
+            self.config.env_mode,
+            self.config.debug,
+            "default"
+        )
+
     def _get_default_cache_config(self) -> Dict[str, Any]:
         """
-        Get default cache configuration.
+        Get default cache configuration (fallback when no redis_url).
 
         Returns:
             Dictionary with default cache backend configuration

django_cfg/core/generation/integration_generators/__init__.py

@@ -6,9 +6,12 @@ Contains generators for third-party integrations and frameworks:
 - External services (Telegram, Unfold, Constance)
 - API frameworks (JWT, DRF, Spectacular, OpenAPI Client)
 - Background tasks (ReArq)
+- Task scheduling (django-q2)
+- Tailwind CSS configuration
 """
 
 from .api import APIFrameworksGenerator
+from .django_q2 import DjangoQ2SettingsGenerator
 from .sessions import SessionSettingsGenerator
 from .tasks import TasksSettingsGenerator
 from .third_party import ThirdPartyIntegrationsGenerator
@@ -18,4 +21,5 @@ __all__ = [
     "ThirdPartyIntegrationsGenerator",
     "APIFrameworksGenerator",
     "TasksSettingsGenerator",
+    "DjangoQ2SettingsGenerator",
 ]

django_cfg/core/generation/integration_generators/django_q2.py

@@ -0,0 +1,133 @@
+"""
+Django-Q2 settings generator for django-cfg.
+
+Generates django-q2 settings and handles INSTALLED_APPS integration.
+"""
+
+from typing import TYPE_CHECKING, Any, Dict, Optional
+
+from django_cfg.modules.django_logging import logger
+
+if TYPE_CHECKING:
+    from django_cfg.models.django.django_q import DjangoQ2Config
+
+
+class DjangoQ2SettingsGenerator:
+    """
+    Generates task scheduling settings for django-q2.
+
+    Automatically:
+    - Generates Q_CLUSTER configuration
+    - Adds django_q to INSTALLED_APPS if enabled
+    - Configures broker, workers, and task settings
+    - Provides schedule management via Django ORM
+
+    Django-Q2 vs django-crontab:
+    - No need to run 'crontab add' - schedules in database
+    - Built-in admin interface for monitoring
+    - Support for both cron and interval scheduling
+    - Task retries and hooks
+    - Async task support
+    """
+
+    def __init__(self, config: "DjangoQ2Config", parent_config: Optional[Any] = None):
+        """
+        Initialize with Django-Q2 configuration.
+
+        Args:
+            config: DjangoQ2Config instance
+            parent_config: Optional parent DjangoConfig for accessing redis_url
+        """
+        self.config = config
+        self.parent_config = parent_config
+
+    def generate(self) -> Dict[str, Any]:
+        """
+        Generate Django-Q2 settings.
+
+        Returns:
+            Dictionary with Q_CLUSTER configuration
+        """
+        if not self.config or not self.config.enabled:
+            return {}
+
+        settings = self.config.to_django_settings(parent_config=self.parent_config)
+
+        # Log configuration
+        logger.info(
+            f"✓ Configured Django-Q2 task queue "
+            f"[broker: {self.config.broker_class}, workers: {self.config.workers}]"
+        )
+
+        enabled_schedules = self.config.get_enabled_schedules()
+        if enabled_schedules:
+            logger.info(
+                f"✓ Found {len(enabled_schedules)} scheduled task(s) "
+                f"[use admin or management commands to create schedules]"
+            )
+
+            # Log individual schedules in debug mode
+            for schedule in enabled_schedules:
+                logger.debug(
+                    f"  - {schedule.name}: {schedule.schedule_type} → "
+                    f"{schedule.command if schedule.command else schedule.func}"
+                )
+
+            logger.info(
+                "📝 To create schedules: python manage.py qcluster "
+                "or use Django admin at /admin/django_q/schedule/"
+            )
+
+        return settings
+
+    def generate_schedule_creation_code(self) -> str:
+        """
+        Generate Python code to create schedules programmatically.
+
+        Returns:
+            Python code string for creating schedules
+
+        Example:
+            ```python
+            code = generator.generate_schedule_creation_code()
+            # Use in management command or startup script
+            ```
+        """
+        if not self.config or not self.config.enabled:
+            return ""
+
+        enabled_schedules = self.config.get_enabled_schedules()
+        if not enabled_schedules:
+            return ""
+
+        lines = [
+            "# Auto-generated Django-Q2 schedule creation",
+            "from django_q.models import Schedule",
+            "",
+            "# Create or update schedules",
+        ]
+
+        for schedule in enabled_schedules:
+            schedule_dict = schedule.to_django_q_format()
+
+            lines.append("")
+            lines.append(f"# {schedule.name}")
+            lines.append("Schedule.objects.update_or_create(")
+            lines.append(f"    name='{schedule.name}',")
+            lines.append("    defaults={")
+
+            for key, value in schedule_dict.items():
+                if key == "name":
+                    continue
+                if isinstance(value, str):
+                    lines.append(f"        '{key}': '{value}',")
+                else:
+                    lines.append(f"        '{key}': {value},")
+
+            lines.append("    }")
+            lines.append(")")
+
+        return "\n".join(lines)
+
+
+__all__ = ["DjangoQ2SettingsGenerator"]

django_cfg/core/generation/orchestrator.py

@@ -78,6 +78,7 @@ class SettingsOrchestrator:
             settings.update(self._generate_third_party_settings())
             settings.update(self._generate_api_settings())
             settings.update(self._generate_tasks_settings())
+            settings.update(self._generate_django_q2_settings())
             settings.update(self._generate_tailwind_settings())
 
             # Apply additional settings (user overrides)
@@ -223,6 +224,18 @@ class SettingsOrchestrator:
         except Exception as e:
             raise ConfigurationError(f"Failed to generate tasks settings: {e}") from e
 
+    def _generate_django_q2_settings(self) -> Dict[str, Any]:
+        """Generate Django-Q2 task scheduling settings."""
+        if not hasattr(self.config, "django_q2") or not self.config.django_q2:
+            return {}
+
+        try:
+            from .integration_generators.django_q2 import DjangoQ2SettingsGenerator
+            generator = DjangoQ2SettingsGenerator(self.config.django_q2, parent_config=self.config)
+            return generator.generate()
+        except Exception as e:
+            raise ConfigurationError(f"Failed to generate Django-Q2 settings: {e}") from e
+
     def _generate_tailwind_settings(self) -> Dict[str, Any]:
         """Generate Tailwind CSS settings."""
         try:

django_cfg/core/integration/display/startup.py

@@ -116,7 +116,7 @@ class StartupDisplayManager(BaseDisplayManager):
 
             # Get library info
             from django_cfg.config import (
-                LIB_DOCS_URL,
+                LIB_SITE_URL,
                 LIB_GITHUB_URL,
                 LIB_SITE_URL,
                 LIB_SUPPORT_URL,
@@ -138,7 +138,7 @@ class StartupDisplayManager(BaseDisplayManager):
             info_table.add_row("🔍 Env Source", env_source)
 
             info_table.add_row("🌐 Site", LIB_SITE_URL)
-            info_table.add_row("📚 Docs", LIB_DOCS_URL)
+            info_table.add_row("📚 Docs", LIB_SITE_URL)
             info_table.add_row("🐙 GitHub", LIB_GITHUB_URL)
             info_table.add_row("🆘 Support", LIB_SUPPORT_URL)
 

django_cfg/core/integration/url_integration.py

@@ -176,7 +176,7 @@ def get_django_cfg_urls_info() -> dict:
         Dictionary with complete URL integration info
     """
     from django_cfg.config import (
-        LIB_DOCS_URL,
+        LIB_SITE_URL,
         LIB_GITHUB_URL,
         LIB_HEALTH_URL,
         LIB_NAME,
@@ -205,7 +205,7 @@ def get_django_cfg_urls_info() -> dict:
             "prefix": "cfg/",
             "description": LIB_NAME,
             "site_url": LIB_SITE_URL,
-            "docs_url": LIB_DOCS_URL,
+            "docs_url": LIB_SITE_URL,
             "github_url": LIB_GITHUB_URL,
             "support_url": LIB_SUPPORT_URL,
             "health_url": LIB_HEALTH_URL,

django_cfg/models/__init__.py

@@ -35,6 +35,7 @@ from .base.module import BaseCfgAutoModule
 from .django.axes import AxesConfig
 from .django.constance import ConstanceConfig, ConstanceField
 from .django.crypto_fields import CryptoFieldsConfig
+from .django.django_q2 import DjangoQ2Config, DjangoQ2ScheduleConfig
 from .django.environment import EnvironmentConfig
 from .django.openapi import OpenAPIClientConfig
 from .infrastructure.cache import CacheConfig
@@ -79,6 +80,8 @@ __all__ = [
     "EnvironmentConfig",
     "ConstanceConfig",
     "ConstanceField",
+    "DjangoQ2Config",
+    "DjangoQ2ScheduleConfig",
     "OpenAPIClientConfig",
     "UnfoldConfig",
     "AxesConfig",

django_cfg/models/django/__init__.py

@@ -6,6 +6,7 @@ Django integrations and extensions.
 
 from .axes import AxesConfig
 from .constance import ConstanceConfig, ConstanceField
+from .django_q2 import DjangoQ2Config, DjangoQ2ScheduleConfig
 from .environment import EnvironmentConfig
 from .openapi import OpenAPIClientConfig
 
@@ -13,6 +14,8 @@ __all__ = [
     "EnvironmentConfig",
     "ConstanceConfig",
     "ConstanceField",
+    "DjangoQ2Config",
+    "DjangoQ2ScheduleConfig",
     "OpenAPIClientConfig",
     "AxesConfig",
 ]