django-cfg 1.4.48__py3-none-any.whl → 1.5.7__py3-none-any.whl

django_cfg/__init__.py

@@ -32,9 +32,14 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.48"
+__version__ = "1.5.7"
 __license__ = "MIT"
 
+# Setup warnings debug early (checks env var only at this point)
+# Will also check config.debug_warnings later when config is loaded
+from .core.debug import setup_warnings_debug
+setup_warnings_debug()
+
 # Import registry for organized lazy loading
 from .config import LIB_NAME
 from .registry import DJANGO_CFG_REGISTRY

django_cfg/apps/api/endpoints/README.md

@@ -0,0 +1,144 @@
+# Django CFG Endpoints API
+
+Модуль для работы с Django URL endpoints.
+
+## Структура
+
+```
+endpoints/
+├── endpoints_status/     # Проверка статуса всех endpoints
+│   ├── checker.py        # Логика проверки endpoints
+│   ├── drf_views.py      # DRF views
+│   ├── serializers.py    # Serializers
+│   ├── tests.py          # Tests
+│   └── views.py          # Plain Django views
+├── urls_list/            # Список всех URL в Django
+│   ├── views.py          # DRF views для вывода URLs
+│   └── serializers.py    # Serializers
+└── urls.py               # URL routing
+```
+
+## Endpoints
+
+### Endpoints Status
+
+Проверяет здоровье всех зарегистрированных endpoints в Django.
+
+- **DRF (Browsable)**: `/cfg/endpoints/drf/`
+- **JSON**: `/cfg/endpoints/`
+
+**Query параметры:**
+- `include_unnamed` (bool): Включить endpoints без имени (default: false)
+- `timeout` (int): Timeout запроса в секундах (default: 5)
+- `auto_auth` (bool): Автоматически повторить с JWT при 401/403 (default: true)
+
+### URLs List
+
+Выводит список всех зарегистрированных URL patterns в Django.
+
+- **Full details**: `/cfg/endpoints/urls/`
+- **Compact**: `/cfg/endpoints/urls/compact/`
+
+**Compact** возвращает только pattern + name для каждого URL.
+
+**Full details** возвращает:
+- Pattern (regex или typed)
+- Name
+- Full name (с namespace)
+- Namespace
+- View name
+- View class
+- HTTP methods
+- Module path
+
+## Примеры
+
+### URLs List (Full)
+
+```bash
+curl http://localhost:8000/cfg/endpoints/urls/
+```
+
+```json
+{
+  "status": "success",
+  "service": "Django CFG",
+  "version": "2.0.0",
+  "base_url": "http://localhost:8000",
+  "total_urls": 150,
+  "urls": [
+    {
+      "pattern": "/api/accounts/profile/",
+      "name": "account_profile",
+      "full_name": "api:account_profile",
+      "namespace": "api",
+      "view": "ProfileViewSet",
+      "view_class": "ProfileViewSet",
+      "methods": ["get", "post", "put", "patch", "delete"],
+      "module": "apps.accounts.views"
+    },
+    ...
+  ]
+}
+```
+
+### URLs List (Compact)
+
+```bash
+curl http://localhost:8000/cfg/endpoints/urls/compact/
+```
+
+```json
+{
+  "status": "success",
+  "total": 150,
+  "urls": [
+    {
+      "pattern": "/api/accounts/profile/",
+      "name": "account_profile"
+    },
+    ...
+  ]
+}
+```
+
+### Endpoints Status
+
+```bash
+curl http://localhost:8000/cfg/endpoints/drf/
+```
+
+```json
+{
+  "status": "healthy",
+  "timestamp": "2025-10-26T10:30:00Z",
+  "total_endpoints": 100,
+  "healthy": 95,
+  "unhealthy": 0,
+  "warnings": 3,
+  "errors": 0,
+  "skipped": 2,
+  "endpoints": [...]
+}
+```
+
+## Health Check Integration
+
+URLs list endpoint доступен из health check:
+
+```bash
+curl http://localhost:8000/cfg/health/drf/
+```
+
+```json
+{
+  "status": "healthy",
+  ...
+  "links": {
+    "urls_list": "http://localhost:8000/cfg/endpoints/urls/",
+    "urls_list_compact": "http://localhost:8000/cfg/endpoints/urls/compact/",
+    "endpoints_status": "http://localhost:8000/cfg/endpoints/drf/",
+    "quick_health": "http://localhost:8000/cfg/health/drf/quick/"
+  }
+}
+```

django_cfg/apps/api/endpoints/endpoints_status/__init__.py

@@ -0,0 +1,13 @@
+"""
+Django CFG Endpoints Status module.
+"""
+
+from .checker import check_all_endpoints
+from .drf_views import DRFEndpointsStatusView
+from .views import EndpointsStatusView
+
+__all__ = [
+    'check_all_endpoints',
+    'DRFEndpointsStatusView',
+    'EndpointsStatusView',
+]

django_cfg/apps/api/endpoints/urls.py

@@ -1,15 +1,22 @@
 """
-Django CFG Endpoints Status URLs.
+Django CFG Endpoints URLs.
 """
 
 from django.urls import path
 
-from . import drf_views, views
+from .endpoints_status import DRFEndpointsStatusView, EndpointsStatusView
+from .urls_list import DRFURLsListCompactView, DRFURLsListView
 
 urlpatterns = [
-    # Original JSON endpoint
-    path('', views.EndpointsStatusView.as_view(), name='endpoints_status'),
+    # Endpoints Status - Original JSON endpoint
+    path('', EndpointsStatusView.as_view(), name='endpoints_status'),
 
-    # DRF Browsable API endpoint with Tailwind theme
-    path('drf/', drf_views.DRFEndpointsStatusView.as_view(), name='endpoints_status_drf'),
+    # Endpoints Status - DRF Browsable API endpoint with Tailwind theme
+    path('drf/', DRFEndpointsStatusView.as_view(), name='endpoints_status_drf'),
+
+    # URLs List - Full details
+    path('urls/', DRFURLsListView.as_view(), name='urls_list'),
+
+    # URLs List - Compact (pattern + name only)
+    path('urls/compact/', DRFURLsListCompactView.as_view(), name='urls_list_compact'),
 ]

django_cfg/apps/api/endpoints/urls_list/__init__.py

@@ -0,0 +1,10 @@
+"""
+Django CFG URLs List module.
+"""
+
+from .views import DRFURLsListCompactView, DRFURLsListView
+
+__all__ = [
+    'DRFURLsListView',
+    'DRFURLsListCompactView',
+]

django_cfg/apps/api/endpoints/urls_list/serializers.py

@@ -0,0 +1,74 @@
+"""
+Django CFG URLs List Serializers
+
+DRF serializers for URLs list API.
+"""
+
+from rest_framework import serializers
+
+
+class URLPatternSerializer(serializers.Serializer):
+    """Serializer for single URL pattern."""
+
+    pattern = serializers.CharField(
+        help_text="URL pattern (e.g., ^api/users/(?P<pk>[^/.]+)/$)"
+    )
+    name = serializers.CharField(
+        required=False,
+        allow_null=True,
+        help_text="URL name (if defined)"
+    )
+    full_name = serializers.CharField(
+        required=False,
+        allow_null=True,
+        help_text="Full URL name with namespace (e.g., admin:index)"
+    )
+    namespace = serializers.CharField(
+        required=False,
+        allow_null=True,
+        help_text="URL namespace"
+    )
+    view = serializers.CharField(
+        required=False,
+        allow_null=True,
+        help_text="View function/class name"
+    )
+    view_class = serializers.CharField(
+        required=False,
+        allow_null=True,
+        help_text="View class name (for CBV/ViewSets)"
+    )
+    methods = serializers.ListField(
+        child=serializers.CharField(),
+        required=False,
+        help_text="Allowed HTTP methods"
+    )
+    module = serializers.CharField(
+        required=False,
+        allow_null=True,
+        help_text="View module path"
+    )
+
+
+class URLsListSerializer(serializers.Serializer):
+    """Serializer for URLs list response."""
+
+    status = serializers.CharField(
+        help_text="Status: success or error"
+    )
+    service = serializers.CharField(
+        help_text="Service name"
+    )
+    version = serializers.CharField(
+        help_text="Django-CFG version"
+    )
+    base_url = serializers.CharField(
+        help_text="Base URL of the service"
+    )
+    total_urls = serializers.IntegerField(
+        help_text="Total number of registered URLs"
+    )
+    urls = URLPatternSerializer(
+        many=True,
+        help_text="List of all registered URL patterns"
+    )

django_cfg/apps/api/endpoints/urls_list/views.py

@@ -0,0 +1,231 @@
+"""
+Django CFG URLs List DRF View
+
+DRF browsable API view for listing all Django URLs with Tailwind theme support.
+"""
+
+from typing import Any, Dict, List
+from urllib.parse import urljoin
+
+from django.conf import settings
+from django.urls import URLPattern, URLResolver, get_resolver
+from rest_framework import status
+from rest_framework.permissions import AllowAny
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+from django_cfg.core.integration import get_current_version
+
+from .serializers import URLsListSerializer
+
+
+class DRFURLsListView(APIView):
+    """
+    Django CFG URLs list endpoint with DRF Browsable API.
+
+    Lists all registered Django URLs with their:
+    - Pattern
+    - Name
+    - View/ViewSet
+    - Full URL
+    - HTTP methods
+
+    This endpoint uses DRF Browsable API with Tailwind CSS theme! 🎨
+    """
+
+    permission_classes = [AllowAny]  # Public endpoint (can be restricted)
+    serializer_class = URLsListSerializer  # For schema generation
+
+    def get(self, request):
+        """Return all registered URLs."""
+        try:
+            config = getattr(settings, 'config', None)
+
+            # Get base URL from config or settings
+            base_url = getattr(config, 'site_url', None) if config else None
+            if not base_url:
+                base_url = request.build_absolute_uri('/').rstrip('/')
+
+            urls_data = {
+                "status": "success",
+                "service": config.project_name if config else "Django CFG",
+                "version": get_current_version(),
+                "base_url": base_url,
+                "total_urls": 0,
+                "urls": []
+            }
+
+            # Extract all URLs
+            url_patterns = self._get_all_urls()
+            urls_data["urls"] = url_patterns
+            urls_data["total_urls"] = len(url_patterns)
+
+            return Response(urls_data, status=status.HTTP_200_OK)
+
+        except Exception as e:
+            return Response({
+                "status": "error",
+                "error": str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    def _get_all_urls(self, urlpatterns=None, prefix='', namespace=None) -> List[Dict[str, Any]]:
+        """
+        Recursively extract all URL patterns from Django URLconf.
+
+        Args:
+            urlpatterns: URL patterns to process
+            prefix: URL prefix from parent resolvers
+            namespace: Current namespace
+
+        Returns:
+            List of URL pattern dictionaries
+        """
+        if urlpatterns is None:
+            urlpatterns = get_resolver().url_patterns
+
+        url_list = []
+
+        for pattern in urlpatterns:
+            if isinstance(pattern, URLResolver):
+                # Recursively process URL resolver (include())
+                new_prefix = prefix + str(pattern.pattern)
+                new_namespace = f"{namespace}:{pattern.namespace}" if namespace and pattern.namespace else pattern.namespace or namespace
+
+                url_list.extend(
+                    self._get_all_urls(
+                        pattern.url_patterns,
+                        prefix=new_prefix,
+                        namespace=new_namespace
+                    )
+                )
+            elif isinstance(pattern, URLPattern):
+                # Extract URL pattern details
+                url_pattern = prefix + str(pattern.pattern)
+                url_name = pattern.name
+
+                # Build full name with namespace
+                if namespace and url_name:
+                    full_name = f"{namespace}:{url_name}"
+                else:
+                    full_name = url_name
+
+                # Get view information
+                view_info = self._get_view_info(pattern)
+
+                url_list.append({
+                    "pattern": url_pattern,
+                    "name": url_name,
+                    "full_name": full_name,
+                    "namespace": namespace,
+                    "view": view_info["view"],
+                    "view_class": view_info["view_class"],
+                    "methods": view_info["methods"],
+                    "module": view_info["module"],
+                })
+
+        return url_list
+
+    def _get_view_info(self, pattern: URLPattern) -> Dict[str, Any]:
+        """
+        Extract view information from URL pattern.
+
+        Args:
+            pattern: URLPattern instance
+
+        Returns:
+            Dictionary with view information
+        """
+        view_info = {
+            "view": None,
+            "view_class": None,
+            "methods": [],
+            "module": None,
+        }
+
+        try:
+            callback = pattern.callback
+
+            if callback is None:
+                return view_info
+
+            # Get view name
+            if hasattr(callback, '__name__'):
+                view_info["view"] = callback.__name__
+            elif hasattr(callback, '__class__'):
+                view_info["view"] = callback.__class__.__name__
+
+            # Get view class (for CBV/ViewSets)
+            if hasattr(callback, 'cls'):
+                view_info["view_class"] = callback.cls.__name__
+
+                # Get HTTP methods from ViewSet/APIView
+                if hasattr(callback.cls, 'http_method_names'):
+                    view_info["methods"] = callback.cls.http_method_names
+
+                # Get module
+                if hasattr(callback.cls, '__module__'):
+                    view_info["module"] = callback.cls.__module__
+
+            # For function-based views
+            elif hasattr(callback, '__module__'):
+                view_info["module"] = callback.__module__
+
+                # Try to determine methods from decorator
+                if hasattr(callback, 'methods'):
+                    view_info["methods"] = list(callback.methods)
+                else:
+                    view_info["methods"] = ['GET']  # Default for FBV
+
+        except Exception:
+            pass
+
+        return view_info
+
+
+class DRFURLsListCompactView(APIView):
+    """
+    Compact URLs list endpoint - just patterns and names.
+
+    This endpoint uses DRF Browsable API with Tailwind CSS theme! 🎨
+    """
+
+    permission_classes = [AllowAny]
+
+    def get(self, request):
+        """Return compact URL list."""
+        try:
+            url_patterns = self._get_compact_urls()
+
+            return Response({
+                "status": "success",
+                "total": len(url_patterns),
+                "urls": url_patterns
+            }, status=status.HTTP_200_OK)
+
+        except Exception as e:
+            return Response({
+                "status": "error",
+                "error": str(e)
+            }, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
+
+    def _get_compact_urls(self, urlpatterns=None, prefix='') -> List[Dict[str, str]]:
+        """Extract URLs in compact format."""
+        if urlpatterns is None:
+            urlpatterns = get_resolver().url_patterns
+
+        url_list = []
+
+        for pattern in urlpatterns:
+            if isinstance(pattern, URLResolver):
+                new_prefix = prefix + str(pattern.pattern)
+                url_list.extend(
+                    self._get_compact_urls(pattern.url_patterns, prefix=new_prefix)
+                )
+            elif isinstance(pattern, URLPattern):
+                url_pattern = prefix + str(pattern.pattern)
+                url_list.append({
+                    "pattern": url_pattern,
+                    "name": pattern.name or "unnamed",
+                })
+
+        return url_list

django_cfg/apps/api/health/drf_views.py

@@ -13,6 +13,7 @@ import psutil
 from django.conf import settings
 from django.core.cache import cache
 from django.db import connections
+from django.urls import reverse
 from django.utils import timezone
 from rest_framework import status
 from rest_framework.permissions import AllowAny
@@ -102,6 +103,17 @@ class DRFHealthCheckView(APIView):
             "python_version": f"{os.sys.version_info.major}.{os.sys.version_info.minor}.{os.sys.version_info.micro}",
         }
 
+        # Add useful links using reverse()
+        health_data["links"] = {
+            "urls_list": request.build_absolute_uri(reverse('urls_list')),
+            "urls_list_compact": request.build_absolute_uri(reverse('urls_list_compact')),
+            "endpoints_status": request.build_absolute_uri(reverse('endpoints_status_drf')),
+            "quick_health": request.build_absolute_uri(reverse('django_cfg_drf_quick_health')),
+        }
+
+        # Add OpenAPI schema links
+        health_data["links"]["openapi_schemas"] = self._get_openapi_schema_links(request)
+
         # Return appropriate HTTP status
         http_status = status.HTTP_200_OK
         if health_data["status"] == "unhealthy":
@@ -191,6 +203,30 @@ class DRFHealthCheckView(APIView):
                 "error": str(e)
             }
 
+    def _get_openapi_schema_links(self, request) -> Dict[str, str]:
+        """Get OpenAPI schema links for all configured groups."""
+        try:
+            from django_cfg.modules.django_client.core import get_openapi_service
+
+            service = get_openapi_service()
+
+            if not service.config or not service.is_enabled():
+                return {}
+
+            schema_links = {}
+            for group_name in service.get_group_names():
+                try:
+                    schema_url_name = f'openapi-schema-{group_name}'
+                    schema_links[group_name] = request.build_absolute_uri(reverse(schema_url_name))
+                except Exception:
+                    # Skip if URL name doesn't exist
+                    continue
+
+            return schema_links
+
+        except Exception:
+            return {}
+
     def _check_system_resources(self) -> Dict[str, Any]:
         """Check system resource usage."""
         try:

django_cfg/apps/api/health/serializers.py

@@ -28,6 +28,10 @@ class HealthCheckSerializer(serializers.Serializer):
     environment = serializers.DictField(
         help_text="Environment information"
     )
+    links = serializers.DictField(
+        required=False,
+        help_text="Useful API endpoint links"
+    )
 
 
 class QuickHealthSerializer(serializers.Serializer):