drf-to-mkdoc 0.2.0__py3-none-any.whl → 0.2.2__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 Exception 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.2.0.dist-info → drf_to_mkdoc-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drf-to-mkdoc
-Version: 0.2.0
+Version: 0.2.2
 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.2.2.dist-info/RECORD

@@ -0,0 +1,85 @@
+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=iG5ssgaJgDoI92cyCDCHmuY1uvMCeU8T0D3gxrDPWYM,986
+drf_to_mkdoc/conf/settings.py,sha256=3f268CZzyf9KYab6EvsjIVXP6KBik1k_B4JyJpXDwrU,5456
+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=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/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
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/base.css,sha256=K9lEjO-TEaUsFCaiuBwqDGrrjIJP8oBDh7igBGRTD3g,1839
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/endpoint-content.css,sha256=1EKHfDeOSpNJe6l3mHzsBlLqLVCJn_1TKtEVfV7Dp88,3452
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/endpoints-grid.css,sha256=Ct4H_ma3tC_1ogw9IeSNmUDZFJwzQWjCM6GomNXV8ig,4115
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/filter-section.css,sha256=MDsGVwgFMhP28pegPLJFn3_GJqVSWZAoy6quz5_9Gz0,4424
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/fixes.css,sha256=MIPiwWXkSMt5I_q6jN6X5CvWTBmq1CERKZffhvf3sKM,720
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/layout.css,sha256=dyoTUJ5Y8njxdWE6t2G3nRS-bT0BT04UMat8K6yW2y4,637
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/loading.css,sha256=C_wZjMw5Cs2inpg892S0_E7_m5bT8BwZfVBRQfvIcKw,712
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/responsive.css,sha256=mzR4tB3XrCg6Ih-X5GEzXzZoSR0R0AEKArRIZ7LqiGU,1672
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/endpoints/sections.css,sha256=xdrO6vUpthFFN1ESummoGuG5MPtE2d2lPsBOWuv-T6o,705
+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
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/model-cards.css,sha256=IppCOptBoFeQCz2sc-exPrnxvsdDxcwYGM-foQrZoVU,2779
+drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/model-tables.css,sha256=8CSy8YdFOJ3lGZ3sTVz2jd8cIxIryubQFrwcygAw06w,1352
+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/templates/models_index.html,sha256=A_Lu3wFMG2Nf8Bv4zttz3e0gZpxBcvDjSvX_rfOYdeI,837
+drf_to_mkdoc/templates/endpoints/detail/base.html,sha256=7aAjSjt6mgOMuvDlC2MQKg70i5fcK9Pi_SzTNoRUNm8,822
+drf_to_mkdoc/templates/endpoints/detail/path_parameters.html,sha256=M7OPUg88e3bw01rZpZUVahZzlq3JFaxZDsnDx2Xizx8,310
+drf_to_mkdoc/templates/endpoints/detail/query_parameters.html,sha256=Dx_mM2qjwFcfMWTYoEoNyPS588V_wanrHS7qh-uUGUg,1075
+drf_to_mkdoc/templates/endpoints/detail/request_body.html,sha256=-9wacJIQOS-lC2zE31rPaeGs_SkOVm1tAJvebLW6zME,149
+drf_to_mkdoc/templates/endpoints/detail/responses.html,sha256=jDTkiCUAe8vbRT6fF2Igtr-26z7maeUYNYv4q-n9-9w,293
+drf_to_mkdoc/templates/endpoints/list/base.html,sha256=l4A4VmDvDkMKim15feh0DoJkCf2V83EoI4wISUjf4Kc,602
+drf_to_mkdoc/templates/endpoints/list/endpoint_card.html,sha256=PesI9Dlt2kAU1AKcMNGUzIA3lzGcncX-Na0HYiwbR28,1114
+drf_to_mkdoc/templates/endpoints/list/filter_section.html,sha256=oSc7UQazpQptYE_rZz_PHnOQPpQDOff0r4a0sYbtQnk,559
+drf_to_mkdoc/templates/endpoints/list/filters/app.html,sha256=vjY0GGg1UGKKb2JAIaw-kCWkoWiA7rQzvifa7pObPXU,225
+drf_to_mkdoc/templates/endpoints/list/filters/method.html,sha256=B9WHuuScIF45QRGv1wZVocCKMPUvyuEDg_gMaE02NXc,410
+drf_to_mkdoc/templates/endpoints/list/filters/path.html,sha256=ZKq50BJu9AYdjiY2TXxhM8c8ivz6M8J_aZIC_q2gVvE,180
+drf_to_mkdoc/templates/endpoints/list/filters/search.html,sha256=NbndD69M-iwFf-BXMo7rsHh1lrZnf6hiZGkPtGF1hU4,280
+drf_to_mkdoc/templates/model_detail/base.html,sha256=uJaGnFwfv68uJgWJA85Svs7MXPQ-dXi3-SJgR9GfiNM,731
+drf_to_mkdoc/templates/model_detail/choices.html,sha256=-DAbUpr5jXL_e8r--KkdRXGZuF94_TuVmN17WQDltk0,304
+drf_to_mkdoc/templates/model_detail/fields.html,sha256=dOYhfwFJThAuG65r8i6_A9budCTNsZ1pQRCGgAKdFAc,1163
+drf_to_mkdoc/templates/model_detail/meta.html,sha256=idbnQhV1dT_zLQDD3jZ21vXqLjCxLXIk4rdCiWHm04s,109
+drf_to_mkdoc/templates/model_detail/methods.html,sha256=QZzp8sGKxuyM6_6GXDNnpKUJw0n_cF5CljklduyALTo,143
+drf_to_mkdoc/templates/model_detail/relationships.html,sha256=GK7mip_-_4qxxM7MGmV3HXqiV6X9QkeBtz7oy4xZs4Q,796
+drf_to_mkdoc/templatetags/custom_filters.py,sha256=2QoestQNjNvA6WJpgnXQ0avJQPzKs3d9Mea0QQLwcD0,2974
+drf_to_mkdoc/utils/__init__.py,sha256=6dFTb07S6yIf-INMy0Mlgf5purNir687ZU9WZtITh4k,68
+drf_to_mkdoc/utils/endpoint_detail_generator.py,sha256=aVLYRUHW6dW8sVwSdM-iyyiJ3dXPjXimbUx1i37vVHs,24160
+drf_to_mkdoc/utils/endpoint_list_generator.py,sha256=yVX7qVUTuKF3TPFgm6FI-vVsVZQ7XHMXmZZalgSN8pk,3579
+drf_to_mkdoc/utils/model_detail_generator.py,sha256=_ac2PYSzSwRUgUn-J-nmg7mfQGn8SU_4vkMpMRIxgEU,2619
+drf_to_mkdoc/utils/model_list_generator.py,sha256=Ki-CwIYKmUbPm3_jUPLPosPfppyVLrZMkqbuPPO3Ycw,1988
+drf_to_mkdoc/utils/schema.py,sha256=sDhVITdIFp1TJYnqCd4wF69i-lwXGlTsNJ2-ngXkccc,10070
+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=5QY5_PGQ5XpXRL9ZLr0570ywPcygQ8ZxnlfnSCHhnF0,8540
+drf_to_mkdoc-0.2.2.dist-info/licenses/LICENSE,sha256=3n9_ckIREsH8ogCxWW6dFsw_WfGcluG2mHcgl9i_UU0,1068
+drf_to_mkdoc-0.2.2.dist-info/METADATA,sha256=GQZJJrWXIfIDC_oSm_Y4DqvfwWBamJs1AIK_LzbflX0,7563
+drf_to_mkdoc-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+drf_to_mkdoc-0.2.2.dist-info/top_level.txt,sha256=ZzJecR6j_tvLZiubUBEgawHflozC4DQy9ooNf1yDJ3Q,13
+drf_to_mkdoc-0.2.2.dist-info/RECORD,,

drf_to_mkdoc/management/commands/generate_docs.py

@@ -1,113 +0,0 @@
-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..."))
-
-        generate_models = not options["endpoints_only"]
-        generate_endpoints = not options["models_only"]
-        if not generate_models and not generate_endpoints:
-            self.stdout.write(
-                self.style.ERROR(
-                    "❌ No outputs selected: --models-only and --endpoints-only cannot be used together"
-                )
-            )
-            return
-        docs_dir = self._setup_docs_directory()
-        models_data = self._load_models_data() if generate_models else {}
-        schema_data = self._load_schema_data() if generate_endpoints else {}
-
-        if generate_models and models_data:
-            self._generate_models_documentation(models_data, docs_dir)
-
-        if generate_endpoints and schema_data:
-            self._generate_endpoints_documentation(schema_data, docs_dir)
-
-        self.stdout.write(self.style.SUCCESS("✅ Documentation generation complete!"))
-
-    def _setup_docs_directory(self):
-        docs_dir = Path(drf_to_mkdoc_settings.DOCS_DIR)
-        docs_dir.mkdir(parents=True, exist_ok=True)
-        return docs_dir
-
-    def _load_models_data(self):
-        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 models_data
-
-    def _load_schema_data(self):
-        try:
-            schema = get_schema()
-        except Exception as e:
-            self.stdout.write(self.style.ERROR(f"❌ Failed to load OpenAPI schema: {e}"))
-            return {}
-        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")
-
-        return {"paths": paths, "components": components}
-
-    def _generate_models_documentation(self, models_data, docs_dir):
-        self.stdout.write("📋 Generating model documentation...")
-
-        try:
-            generate_model_docs(models_data)
-            create_models_index(models_data, docs_dir)
-            self.stdout.write(self.style.SUCCESS("✅ Model documentation generated"))
-        except Exception as e:
-            self.stdout.write(self.style.WARNING(f"⚠️  Failed to generate model docs: {e}"))
-            if hasattr(self, "_generating_all"):
-                self.stdout.write(self.style.WARNING("Continuing with endpoint generation..."))
-            raise
-
-    def _generate_endpoints_documentation(self, schema_data, docs_dir):
-        self.stdout.write("🔗 Generating endpoint documentation...")
-
-        paths = schema_data["paths"]
-        components = schema_data["components"]
-
-        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"
-            )
-        )