drf-to-mkdoc 0.1.9__py3-none-any.whl → 0.2.1__py3-none-any.whl

drf_to_mkdoc/utils/schema.py

@@ -0,0 +1,259 @@
+import inspect
+import logging
+from importlib import import_module
+from types import SimpleNamespace
+from typing import Any
+
+from drf_spectacular.openapi import AutoSchema as SpectacularAutoSchema
+from drf_spectacular.plumbing import ComponentRegistry
+from rest_framework.serializers import BaseSerializer, ListSerializer
+from rest_framework.viewsets import ViewSetMixin
+
+from drf_to_mkdoc.conf.settings import drf_to_mkdoc_settings
+
+logger = logging.getLogger(__name__)
+
+
+class ViewMetadataExtractor:
+    """Extracts metadata from DRF views."""
+
+    def __init__(self, view, callback, method):
+        self.view = view
+        self.callback = callback
+        self.method = method
+        self.view_instance = None
+        self.action = None
+        self.error_message = None
+
+    def _create_view_instance(self):
+        """Create view instance for introspection."""
+        try:
+            self.view_instance = self.view()
+        except (TypeError, AttributeError, ImportError) as e:
+            self.error_message = str(e)
+            return False
+        else:
+            return True
+
+    def _extract_permissions(self):
+        """Extract permission classes from view."""
+        permission_classes = []
+        if hasattr(self.view, "permission_classes"):
+            for perm_class in self.view.permission_classes:
+                permission_classes.append(f"{perm_class.__module__}.{perm_class.__name__}")
+        return permission_classes
+
+    def _extract_action(self):
+        """Extract action name from ViewSet."""
+        if isinstance(self.view_instance, ViewSetMixin):
+            self.action = self.callback.actions.get(self.method.lower())
+            if self.action:
+                self.view_instance.action = self.action
+                self.view_instance.request = SimpleNamespace(method=self.method.upper())
+
+    def _extract_serializer_from_view_instance(self):
+        """Try to get serializer class from view instance."""
+        if not hasattr(self.view_instance, "get_serializer_class"):
+            return None
+
+        try:
+            serializer_cls = self.view_instance.get_serializer_class()
+        except (AttributeError, TypeError, ImportError) as e:
+            logger.debug(f"Failed to get serializer from view instance: {e}")
+            return None
+        else:
+            return f"{serializer_cls.__module__}.{serializer_cls.__name__}"
+
+    def _extract_serializer_from_action(self):
+        """Try to get serializer class from action method."""
+        if not self.action:
+            return None
+
+        action_method = getattr(self.view, self.action, None)
+        if not (action_method and callable(action_method)):
+            return None
+
+        if hasattr(action_method, "serializer_class"):
+            serializer_cls = action_method.serializer_class
+            return f"{serializer_cls.__module__}.{serializer_cls.__name__}"
+        if hasattr(action_method, "kwargs") and "serializer_class" in action_method.kwargs:
+            serializer_cls = action_method.kwargs["serializer_class"]
+            return f"{serializer_cls.__module__}.{serializer_cls.__name__}"
+
+        return None
+
+    def _extract_serializer_from_class(self):
+        """Try to get serializer class from view class."""
+        if hasattr(self.view, "serializer_class") and self.view.serializer_class:
+            serializer_cls = self.view.serializer_class
+            return f"{serializer_cls.__module__}.{serializer_cls.__name__}"
+        return None
+
+    def _extract_action_source(self):
+        """Get action source info if no serializer found."""
+        if not self.action:
+            return {}
+
+        action_method = getattr(self.view, self.action, None)
+        if not (action_method and callable(action_method)):
+            return {}
+
+        return {
+            "importable_path": f"{self.view.__module__}.{self.view.__name__}.{self.action}",
+            "module": self.view.__module__,
+            "class_name": self.view.__name__,
+            "method_name": self.action,
+        }
+
+    def _extract_serializer_parents(self, serializer_cls):
+        """Extract parent classes of serializer up to specified depth."""
+        if not serializer_cls:
+            return []
+
+        parents = []
+        for base in inspect.getmro(serializer_cls)[
+            1 : drf_to_mkdoc_settings.SERIALIZERS_INHERITANCE_DEPTH + 1
+        ]:
+            if base is object or base.__module__ == "builtins":
+                continue
+            parents.append(f"{base.__module__}.{base.__name__}")
+
+        return parents
+
+    def _extract_serializer_attrs(self, serializer_cls):
+        """Extract nested serializer attributes up to specified depth."""
+        if not serializer_cls:
+            return {}
+
+        attrs = {}
+        try:
+            serializer_instance = serializer_cls()
+            for field_name, field in getattr(serializer_instance, "fields", {}).items():
+                if isinstance(field, ListSerializer) and isinstance(
+                    field.child, BaseSerializer
+                ):
+                    # Handle ListSerializer and similar fields
+                    child_class = field.child.__class__
+                    attrs[field_name] = {
+                        "type": "list",
+                        "child_serializer": f"{child_class.__module__}.{child_class.__name__}",
+                    }
+                elif isinstance(field, BaseSerializer):
+                    # Handle nested serializers
+                    nested_class = field.__class__
+                    attrs[field_name] = {
+                        "type": "nested",
+                        "serializer": f"{nested_class.__module__}.{nested_class.__name__}",
+                    }
+        except (TypeError, AttributeError) as e:
+            logger.debug(f"Failed to extract serializer attributes: {e}")
+
+        return attrs
+
+    def extract(self):
+        """Extract all metadata from view."""
+        if not self._create_view_instance():
+            return {
+                "view_class": f"{self.view.__module__}.{self.view.__name__}",
+                "action": None,
+                "serializer_class": None,
+                "permission_classes": [],
+                "error_message": str(self.error_message),
+                "action_source": {},
+                "serializer_parents": [],
+                "serializer_attrs": {},
+            }
+
+        permission_classes = self._extract_permissions()
+        self._extract_action()
+
+        serializer_class = None
+        serializer_class_str = (
+            self._extract_serializer_from_view_instance()
+            or self._extract_serializer_from_action()
+            or self._extract_serializer_from_class()
+        )
+
+        if serializer_class_str:
+            module_name, class_name = serializer_class_str.rsplit(".", 1)
+            try:
+                module = import_module(module_name)
+                serializer_class = getattr(module, class_name)
+            except (ImportError, AttributeError) as e:
+                logger.debug(f"Failed to import serializer class: {e}")
+
+        action_source = {} if serializer_class_str else self._extract_action_source()
+        serializer_parents = (
+            self._extract_serializer_parents(serializer_class) if serializer_class else []
+        )
+        serializer_attrs = (
+            self._extract_serializer_attrs(serializer_class) if serializer_class else {}
+        )
+
+        return {
+            "view_class": f"{self.view.__module__}.{self.view.__name__}",
+            "action": self.action,
+            "serializer_class": serializer_class_str,
+            "permission_classes": permission_classes,
+            "error_message": str(self.error_message) if self.error_message else None,
+            "action_source": action_source,
+            "serializer_parents": serializer_parents,
+            "serializer_attrs": serializer_attrs,
+        }
+
+
+class AutoSchema(SpectacularAutoSchema):
+    """
+    Custom AutoSchema that extends drf_spectacular's AutoSchema to add view metadata
+    directly to the operation during schema generation instead of using a postprocessing hook.
+    """
+
+    def get_operation(
+        self,
+        path: str,
+        path_regex: str,
+        path_prefix: str,
+        method: str,
+        registry: ComponentRegistry,
+    ) -> dict[str, Any] | None:
+        # Call the parent's get_operation to get the base operation
+        operation = super().get_operation(path, path_regex, path_prefix, method, registry)
+
+        if operation:
+            try:
+                # Extract metadata from the view
+                view = self.view.__class__
+                callback = self._get_callback_obj(method)
+                metadata = ViewMetadataExtractor(view, callback, method).extract()
+
+                # Add metadata to the operation
+                operation.setdefault("x-metadata", {})
+                operation["x-metadata"].update(metadata)
+            except Exception:
+                # Log the error but don't break schema generation
+                logger.exception("Error adding metadata to operation")
+
+        return operation
+
+    def _get_callback_obj(self, method: str):
+        """
+        Helper method to get the callback object with actions.
+        This is needed to extract the action name from the callback.
+        """
+        # Access the view's action_map or action to determine the mapping
+        actions = {}
+
+        # For ViewSets, the action_map contains the method->action mapping
+        if hasattr(self.view, "action_map") and self.view.action_map is not None:
+            actions = {m.lower(): a for m, a in self.view.action_map.items()}
+        # For APIViews with an explicit action
+        elif hasattr(self.view, "action"):
+            actions = {method.lower(): self.view.action}
+
+        # Create a callback-like object with the necessary attributes
+        class CallbackObj:
+            def __init__(self, view_cls, actions_dict):
+                self.cls = view_cls
+                self.actions = actions_dict
+
+        return CallbackObj(self.view.__class__, actions)

{drf_to_mkdoc-0.1.9.dist-info → drf_to_mkdoc-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drf-to-mkdoc
-Version: 0.1.9
+Version: 0.2.1
 Summary: Generate Markdown API docs from Django/DRF OpenAPI schema for MkDocs
 Author-email: Hossein Shayesteh <shayestehhs1@gmail.com>
 Maintainer-email: Hossein Shayesteh <shayestehhs1@gmail.com>
@@ -76,13 +76,14 @@ INSTALLED_APPS = [
 
 # Required for OpenAPI schema generation
 REST_FRAMEWORK = {
-    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
+    'DEFAULT_SCHEMA_CLASS': 'drf_to_mkdoc.utils.schema.AutoSchema',  # Use our custom AutoSchema
 }
 
 SPECTACULAR_SETTINGS = {
     'TITLE': 'Your API',
     'DESCRIPTION': 'Your API description',
     'VERSION': '1.0.0',
+
 }
 
 DRF_TO_MKDOC = {
@@ -110,10 +111,19 @@ DRF_TO_MKDOC = {
 python manage.py build_docs --settings=docs_settings
 ```
 
+## Available Commands
+
+- `build_docs`: Build the complete documentation site with MkDocs
+- `build_endpoint_docs`: Build endpoint documentation from OpenAPI schema
+- `build_model_docs`: Build model documentation from model JSON data
+- `extract_model_data`: Extract model data from Django model introspection and save as JSON
+- `update_doc_schema`: Update the final schema by copying the documented schema
+
 ## What you get
 
 See a detailed overview of generated files in `docs/structure.md` and a feature breakdown in `docs/features.md`.
 
+
 ## How it works
 
 Under the hood, drf-to-mkdoc introspects your models and reads your DRF OpenAPI schema to generate clean, organized Markdown. Then MkDocs turns it into a polished static site. Always current, no manual updates.
@@ -154,8 +164,9 @@ drf-to-mkdoc/
 │   ├── management/
 │   │   └── commands/
 │   │       ├── build_docs.py           # Build MkDocs site
-│   │       ├── generate_docs.py        # Main documentation generator
-│   │       ├── generate_model_docs.py  # Model documentation
+│   │       ├── build_endpoint_docs.py  # Build endpoint documentation
+│   │       ├── build_model_docs.py     # Build model documentation
+│   │       ├── extract_model_data.py   # Extract model data from Django
 │   │       └── update_doc_schema.py    # Schema updates
 │   └── utils/
 │       ├── common.py        # Shared utilities
@@ -222,4 +233,4 @@ your-project/
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines. 
-This will ensure that only the source configuration and scripts are versioned, while the generated documentation is excluded. 
+This will ensure that only the source configuration and scripts are versioned, while the generated documentation is excluded.

{drf_to_mkdoc-0.1.9.dist-info → drf_to_mkdoc-0.2.1.dist-info}/RECORD

@@ -1,16 +1,18 @@
 drf_to_mkdoc/__init__.py,sha256=IbTW5uKQvJRG9ncHRuk_AGKHPn4ruxs5LqDpUFgUhws,180
 drf_to_mkdoc/apps.py,sha256=-NrC_dRr6GmLmNQhkNh819B7V1SS4DYDv5JOR0TtuJM,560
 drf_to_mkdoc/conf/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-drf_to_mkdoc/conf/defaults.py,sha256=DZiATgfjkyU_J1RgR_zAzPdOVp-F2o3LVwjb3hP6j0U,660
-drf_to_mkdoc/conf/settings.py,sha256=OOna4jWNTEfROBprpKnEHVl5RcAYExmOf0gBMA0E_FY,1664
+drf_to_mkdoc/conf/defaults.py,sha256=iG5ssgaJgDoI92cyCDCHmuY1uvMCeU8T0D3gxrDPWYM,986
+drf_to_mkdoc/conf/settings.py,sha256=BruquzEGvGzJ3YhXnWHn4gxxZA6Ed1Twtry8rokgdUI,5557
 drf_to_mkdoc/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 drf_to_mkdoc/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-drf_to_mkdoc/management/commands/build_docs.py,sha256=71dDDbb-qjRZr0kugviHtf3W_MSPFVjxkJ0tlLn97zM,4037
+drf_to_mkdoc/management/commands/build_docs.py,sha256=k2N8i7sNWPJGVzUSdkDu47FleCSjIxClRq1dWBHwhjQ,4057
+drf_to_mkdoc/management/commands/build_endpoint_docs.py,sha256=UcKoHFzmsEhs90kHMRvRe2XWx6xigrGAnwA5iEs839s,2450
+drf_to_mkdoc/management/commands/build_model_docs.py,sha256=8d7UjwwIsEsReIH4b93nTqFnrZO8kPHXdQaSTYudUGw,1926
+drf_to_mkdoc/management/commands/extract_model_data.py,sha256=XoMO4C22ZPKQ99bh1WskEUT1JkA3GpDN5wb3_D5cN0I,13583
 drf_to_mkdoc/management/commands/generate_doc_json.py,sha256=mWdYgMbSeLP4iQZeUm2DxwYQmdGy8w05XTEfbT_nOJo,19833
-drf_to_mkdoc/management/commands/generate_docs.py,sha256=LUvKeJQ_cDL48rEfbWyjDsYEwzkQEpxpEjqUm11zQJg,5011
-drf_to_mkdoc/management/commands/generate_model_docs.py,sha256=A_Q6o10kfy-GN_ZDD9YS6jv3RTyxBy28DEsi5qKZZoU,13421
 drf_to_mkdoc/management/commands/update_doc_schema.py,sha256=TtHVQxnVpB_VELRkVcdsDXDU5zXdguFleB1mXCDMAbg,2009
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/endpoints-filter.js,sha256=KtfWroqsXg-wwmk36hpoH--M9WIW85EFNGeswMjFu4g,6138
+drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out-sidebar.js,sha256=zvEIm5rxTdMdmzElmmAqniIrI4ms2vsqGOMI0VFb_RQ,38953
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/accessibility.css,sha256=DwCGPoaxaUvyifryrKqmkFDH06XBNf65kYsflMTbi0M,494
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/animations.css,sha256=61m9SLAbatVUNuFeTUTxktoMu9SskYcwFjTsHYbsCRo,393
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/badges.css,sha256=kUlUcf72uRw6x6Gn7cUq_aTuSGBbhumZ4Us-eBDM7DM,1251
@@ -26,6 +28,7 @@ drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/sections.css,sha256=xdrO6
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/stats.css,sha256=0cDD8s63r6zQid_O1schNvfIwys1Y526xO6-B6s4Lxc,667
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/tags.css,sha256=dOw13qsvVjx9cibzgzXlOutXVosNp6LzFfEFKvumG8w,1785
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/theme-toggle.css,sha256=j1P5xDQDfos8jeVYz5s1jjEeujMlZtLi39OC6VeuMcA,1034
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/try-out-sidebar.css,sha256=tkfQRpX0HTe09dqdjA4GxG5lOCLpw3Mp7VuxkFQtCvI,15829
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/variables.css,sha256=Sg2vcQOHdpmEFDn43OeZcMIKxtr5EOEI_wISkCmtcSU,1895
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/animations.css,sha256=IrqN9vJKgaHAWk2PBRKKmFHgH-lQlw5YZvEOGDqYk_g,656
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/base.css,sha256=qdXDVScWoEvFbSRfjDlnxvQZBy2JFX9yXPngMWNSZ7o,1849
@@ -34,17 +37,31 @@ drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/model-tables.css,sha256=8CSy
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/responsive.css,sha256=ygqyUtpiWchTBBIQil1C6mN0AC5xinLoP7whSKfBmwg,944
 drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/variables.css,sha256=2HvyjnJrygSzdzpE-FYpo6FGhrYhmZ7NwDFAkADXQNg,1094
 drf_to_mkdoc/utils/__init__.py,sha256=6dFTb07S6yIf-INMy0Mlgf5purNir687ZU9WZtITh4k,68
-drf_to_mkdoc/utils/common.py,sha256=SxjGe9MtyxTyroXP7QdUiW9QqZ1N7xPjHHaAI-hqYxc,12077
-drf_to_mkdoc/utils/endpoint_detail_generator.py,sha256=mX3sklhWsd-FmOV-ePrhLpg5l8-Eu7V7qb5EL4Tq0FI,27650
-drf_to_mkdoc/utils/endpoint_list_generator.py,sha256=P7pEHscHNHpjDuTXmAUPYV3_t8uGSdaYOgiDGGoCwYc,9705
-drf_to_mkdoc/utils/model_detail_generator.py,sha256=P5kWO-5aWgvyPgzq1qXnt1380ExnrzlOw18zI57P9u0,8063
-drf_to_mkdoc/utils/model_list_generator.py,sha256=7gTPwxOxlvvCfDgVPTbGPsLi1gnI47UjMqKc57qRmks,2409
+drf_to_mkdoc/utils/endpoint_detail_generator.py,sha256=1HvnOzqczZNqO8pbXedz6cSQ_pOFPDkmeD9yVxNOz7A,26989
+drf_to_mkdoc/utils/endpoint_list_generator.py,sha256=Mtk93QNkSz_J1m2sQ5_43CmvZW9yEqDaueEx4OhW8XQ,9722
+drf_to_mkdoc/utils/model_detail_generator.py,sha256=oS07F_sDfqnfF1vSs79skUR6A7Wios2SqrQ_PqqyFUM,8179
+drf_to_mkdoc/utils/model_list_generator.py,sha256=xdZbZDz4Ujj7OI5k60xc6ZeFHQjQV8mALqiD65Odpqs,2578
+drf_to_mkdoc/utils/schema.py,sha256=14Gs4OhKDlTlk6DRFjszWNA08U3WlExUrItFHwYIdB8,10101
+drf_to_mkdoc/utils/ai_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+drf_to_mkdoc/utils/ai_tools/enums.py,sha256=K39bJjHgXwNst2NL6z-5bztW3ZU5iCxg2b0KEodD6eM,238
+drf_to_mkdoc/utils/ai_tools/exceptions.py,sha256=yFauOtuSRGRnQt41u2qCMvWEbN0eblgKwXuH-GX3Wbk,634
+drf_to_mkdoc/utils/ai_tools/types.py,sha256=KZhE92sXbifEo0hx-DA4smKnIUgCmCQXvhUvYjX_3LY,2032
+drf_to_mkdoc/utils/ai_tools/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+drf_to_mkdoc/utils/ai_tools/providers/base_provider.py,sha256=mSp5xeWkym4Fg2m0iIXaXGotSVSWWdfN6RfeI_8e2VY,4132
+drf_to_mkdoc/utils/ai_tools/providers/gemini_provider.py,sha256=BJGwhy7rEsgV03catSmAq1Kx6kXAzCh_-5WoT3SCS94,2969
+drf_to_mkdoc/utils/commons/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+drf_to_mkdoc/utils/commons/code_extractor.py,sha256=a4SyfTCyh9KGB8-p9pi760E_l8ZoWA6yGhaBi6Zn6XA,665
+drf_to_mkdoc/utils/commons/file_utils.py,sha256=pdjrNZ_oR664tIwKinhlHL3Oeo-pKwaI4vG_PQT-9R8,1182
+drf_to_mkdoc/utils/commons/model_utils.py,sha256=IC2X-SchY448N_T6HA0iOkjuEkmRN92fnDHiaD95aR0,3033
+drf_to_mkdoc/utils/commons/operation_utils.py,sha256=0nQqJYuXcmUeIgEg5mvRPGC9uwMKJFTpswV0L8UX35w,2691
+drf_to_mkdoc/utils/commons/path_utils.py,sha256=Pi9g1xXDPsRzmn4kTeNSVtXG9v6n1h2ZphUgOCYAduw,2992
+drf_to_mkdoc/utils/commons/schema_utils.py,sha256=0sw3zp0onsF3NVv4ImpHbXfypTA2yIIFMIId_D9NZfg,7837
 drf_to_mkdoc/utils/extractors/__init__.py,sha256=BvC8gKOPVI9gU1Piw0jRhKQ2ER5s1moAxgq7ZYkJWNI,86
-drf_to_mkdoc/utils/extractors/query_parameter_extractors.py,sha256=gnDlvF-bxkTp2NcEQf0EZZAfmdQzUpedhZ7N1LAYQzU,8432
+drf_to_mkdoc/utils/extractors/query_parameter_extractors.py,sha256=5QY5_PGQ5XpXRL9ZLr0570ywPcygQ8ZxnlfnSCHhnF0,8540
 drf_to_mkdoc/utils/md_generators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 drf_to_mkdoc/utils/md_generators/query_parameters_generators.py,sha256=N-XqZ_FUODSR5V4xM9oEA3aaIiNGNmNwpvrWbQTx6RI,2566
-drf_to_mkdoc-0.1.9.dist-info/licenses/LICENSE,sha256=3n9_ckIREsH8ogCxWW6dFsw_WfGcluG2mHcgl9i_UU0,1068
-drf_to_mkdoc-0.1.9.dist-info/METADATA,sha256=FgkNktIYpIuto47SGr2cvo_DdxMs15HGG6d8uaZAc7w,7037
-drf_to_mkdoc-0.1.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-drf_to_mkdoc-0.1.9.dist-info/top_level.txt,sha256=ZzJecR6j_tvLZiubUBEgawHflozC4DQy9ooNf1yDJ3Q,13
-drf_to_mkdoc-0.1.9.dist-info/RECORD,,
+drf_to_mkdoc-0.2.1.dist-info/licenses/LICENSE,sha256=3n9_ckIREsH8ogCxWW6dFsw_WfGcluG2mHcgl9i_UU0,1068
+drf_to_mkdoc-0.2.1.dist-info/METADATA,sha256=ceVXnbJZXWmzEXhEKKhhwb64I9Nwqlds-4exCLYcvEE,7563
+drf_to_mkdoc-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+drf_to_mkdoc-0.2.1.dist-info/top_level.txt,sha256=ZzJecR6j_tvLZiubUBEgawHflozC4DQy9ooNf1yDJ3Q,13
+drf_to_mkdoc-0.2.1.dist-info/RECORD,,

drf_to_mkdoc/management/commands/generate_docs.py

@@ -1,138 +0,0 @@
-#!/usr/bin/env python3
-
-from pathlib import Path
-
-from django.core.management.base import BaseCommand
-
-from drf_to_mkdoc.conf.settings import drf_to_mkdoc_settings
-from drf_to_mkdoc.utils.common import get_schema, load_model_json_data
-from drf_to_mkdoc.utils.endpoint_detail_generator import (
-    generate_endpoint_files,
-    parse_endpoints_from_schema,
-)
-from drf_to_mkdoc.utils.endpoint_list_generator import create_endpoints_index
-from drf_to_mkdoc.utils.model_detail_generator import generate_model_docs
-from drf_to_mkdoc.utils.model_list_generator import create_models_index
-
-
-class Command(BaseCommand):
-    help = "Generate complete API documentation (models + endpoints + navigation)"
-
-    def add_arguments(self, parser):
-        parser.add_argument(
-            "--endpoints-only",
-            action="store_true",
-            help="Generate only endpoint documentation",
-        )
-        parser.add_argument(
-            "--models-only",
-            action="store_true",
-            help="Generate only model documentation",
-        )
-
-    def handle(self, *args, **options):
-        self.stdout.write(self.style.SUCCESS("🚀 Starting documentation generation..."))
-
-        docs_dir = Path(drf_to_mkdoc_settings.DOCS_DIR)
-        docs_dir.mkdir(parents=True, exist_ok=True)
-
-        if options["models_only"]:
-            self._generate_models_only()
-        elif options["endpoints_only"]:
-            self._generate_endpoints_only()
-        else:
-            self._generate_all()
-
-        self.stdout.write(self.style.SUCCESS("✅ Documentation generation complete!"))
-
-    def _generate_models_only(self):
-        """Generate only model documentation"""
-        self.stdout.write("📋 Generating model documentation...")
-
-        # Load model data
-        json_data = load_model_json_data()
-        models_data = json_data.get("models", {}) if json_data else {}
-
-        if not models_data:
-            self.stdout.write(self.style.WARNING("⚠️  No model data found"))
-            return
-
-        docs_dir = Path(drf_to_mkdoc_settings.DOCS_DIR)
-
-        # Generate model documentation
-        generate_model_docs(models_data, docs_dir)
-        create_models_index(models_data, docs_dir)
-
-        self.stdout.write(self.style.SUCCESS("✅ Model documentation generated"))
-
-    def _generate_endpoints_only(self):
-        """Generate only endpoint documentation"""
-        self.stdout.write("🔗 Generating endpoint documentation...")
-
-        # Load schema
-        schema = get_schema()
-        if not schema:
-            self.stdout.write(self.style.ERROR("❌ Failed to load OpenAPI schema"))
-            return
-
-        paths = schema.get("paths", {})
-        components = schema.get("components", {})
-
-        self.stdout.write(f"📊 Loaded {len(paths)} API paths")
-
-        docs_dir = Path(drf_to_mkdoc_settings.DOCS_DIR)
-
-        # Parse and generate endpoints
-        endpoints_by_app = parse_endpoints_from_schema(paths)
-        total_endpoints = generate_endpoint_files(endpoints_by_app, components)
-        create_endpoints_index(endpoints_by_app, docs_dir)
-
-        self.stdout.write(
-            self.style.SUCCESS(
-                f"✅ Generated {total_endpoints} endpoint files with Django view introspection"
-            )
-        )
-
-    def _generate_all(self):
-        """Generate complete documentation"""
-        self.stdout.write("📚 Generating complete documentation...")
-
-        docs_dir = Path(drf_to_mkdoc_settings.DOCS_DIR)
-
-        # Load data
-        json_data = load_model_json_data()
-        models_data = json_data.get("models", {}) if json_data else {}
-        schema = get_schema()
-
-        if not schema:
-            self.stdout.write(self.style.ERROR("❌ Failed to load OpenAPI schema"))
-            return
-
-        paths = schema.get("paths", {})
-        components = schema.get("components", {})
-
-        self.stdout.write(f"📊 Loaded {len(paths)} API paths")
-
-        # Generate model documentation
-        if models_data:
-            self.stdout.write("📋 Generating model documentation...")
-            try:
-                generate_model_docs(models_data)
-                create_models_index(models_data, docs_dir)
-            except Exception as e:
-                self.stdout.write(self.style.WARNING(f"⚠️  Failed to generate model docs: {e}"))
-                self.stdout.write(self.style.WARNING("Continuing with endpoint generation..."))
-        else:
-            self.stdout.write(self.style.WARNING("⚠️  No model data found"))
-
-        # Generate endpoint documentation
-        self.stdout.write("🔗 Generating endpoint documentation...")
-        endpoints_by_app = parse_endpoints_from_schema(paths)
-        total_endpoints = generate_endpoint_files(endpoints_by_app, components)
-        create_endpoints_index(endpoints_by_app, docs_dir)
-
-        self.stdout.write(
-            self.style.SUCCESS(
-                f"✅ Generated {total_endpoints} endpoint files with Django view introspection"
-            )
-        )