drf-to-mkdoc 0.3.0__tar.gz → 0.3.1__tar.gz

drf_to_mkdoc-0.3.1/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: drf-to-mkdoc
+Version: 0.3.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>
+License: MIT
+Project-URL: Homepage, https://github.com/shayestehhs/drf-to-mkdoc
+Project-URL: Repository, https://github.com/shayestehhs/drf-to-mkdoc
+Project-URL: Documentation, https://github.com/shayestehhs/drf-to-mkdoc#readme
+Project-URL: Bug Tracker, https://github.com/shayestehhs/drf-to-mkdoc/issues
+Keywords: django,django-rest-framework,documentation,mkdocs,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django<6.0,>=3.2
+Requires-Dist: djangorestframework<4.0,>=3.12
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: drf-spectacular>=0.26.0
+Requires-Dist: mkdocs>=1.4.0
+Requires-Dist: mkdocs-material>=9.0.0
+Requires-Dist: coreapi>=2.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-django>=4.5.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# DRF to MkDocs
+
+Unlock effortless API documentation for your Django REST Framework project. Automatically generate beautiful, interactive, and maintainable docs that accelerate developer onboarding and streamline your team's workflow.
+
+---
+
+## Why DRF to MkDocs?
+
+`DRF to MkDocs` bridges the gap between your API's OpenAPI schema and user-friendly, maintainable documentation. It introspects your Django models and DRF views to automatically generate a polished, feature-rich documentation site that stays in sync with your codebase, empowering your team to build better APIs, faster.
+
+-   **Effortless Documentation**: Automate the entire process of generating and updating your API docs. Say goodbye to manual work and outdated information.
+-   **Accelerate Onboarding**: Provide new joiners with interactive, easy-to-navigate documentation. The "Try-it-out" feature and clear model relationships help them become productive from day one.
+-   **Deeply Integrated with DRF**: Leverages `drf-spectacular` for accurate schema generation, ensuring your documentation is a true reflection of your API.
+-   **Enhance Developer Experience**: Features like the interactive API console and in-depth model pages streamline development, testing, and debugging for the entire team.
+-   **Beautiful & Professional**: Built on MkDocs with the Material theme for a clean, modern, and responsive UI that you'll be proud to share.
+
+## Gallery
+
+<details>
+<summary>🚀 Interactive Endpoint List & Filtering</summary>
+<img width="1434" height="943" alt="List-EndPoint" src="https://github.com/user-attachments/assets/f886fc7f-afa0-4faa-b9c2-d6f754ca3597" />
+</details>
+
+<details>
+<summary>🔬 Detailed Endpoint View with "Try-it-out"</summary>
+<img width="958" height="887" alt="Detail-EndPoint" src="https://github.com/user-attachments/assets/9d9e3d4b-cb92-4ece-831e-aef45ceec768" />
+<img width="532" height="804" alt="Try-it-out" src="https://github.com/user-attachments/assets/0f483922-60c4-4f62-8fb4-bc7372e82a03" />
+</details>
+
+<details>
+<summary>📚 Rich Model Documentation</summary>
+<img width="906" height="885" alt="Model-fields" src="https://github.com/user-attachments/assets/a1ca369c-ad40-4b05-83ec-ceb1f80aab23" />
+<img width="848" height="886" alt="Model" src="https://github.com/user-attachments/assets/683d6d26-a8e4-4c05-8b5f-11a61a62cb0c" />
+</details>
+
+<details>
+<summary>📈 Entity-Relationship Diagrams</summary>
+<img width="953" height="606" alt="ER-Diagram" src="https://github.com/user-attachments/assets/3d0b1cb0-7ebf-4d4a-a181-1b7dbc9c6a01" />
+</details>
+
+## Key Features
+
+| Feature                          | Description                                                                                                                              |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| 🚀 **Interactive API Console**     | Test endpoints directly from the documentation with a "Try-it-out" feature, complete with a request builder and response viewer.         |
+| 🔍 **Advanced Filtering & Search** | Instantly find endpoints with multi-criteria filtering by app, method, path, and a real-time search.                                   |
+| 📚 **In-Depth Model Pages**        | Automatically generate detailed pages for each model, including fields, relationships, choices, and methods.                           |
+| 📊 **Entity-Relationship Diagrams** | Visualize model relationships with auto-generated, interactive ER diagrams for each app and for the entire project.                    |
+| 🎨 **Modern & Responsive UI**      | A beautiful and intuitive interface powered by MkDocs Material, featuring light/dark themes and full mobile support.                   |
+| 🔧 **Highly Customizable**         | Override templates, configure settings, and use custom functions to tailor the documentation to your project's specific needs.         |
+| ⚙️ **Simple Integration**         | Works seamlessly with existing DRF projects and `drf-spectacular` without requiring complex setup.                                     |
+| 🤖 **AI-Powered Enhancements**     | (Working on it...) Leverage AI to generate smarter examples and more descriptive documentation for your API.                                     |
+
+## Getting Started
+
+### 1. Installation
+
+```bash
+pip install drf-to-mkdoc
+```
+
+### 2. Configure Your Django Project
+
+In your `settings.py`:
+
+```python
+# settings.py
+
+INSTALLED_APPS = [
+    # ... your other apps
+    'drf_to_mkdoc',
+    'drf_spectacular',  # Required for schema generation
+]
+
+# Required for OpenAPI schema generation
+REST_FRAMEWORK = {
+    'DEFAULT_SCHEMA_CLASS': 'drf_to_mkdoc.utils.schema.AutoSchema',
+}
+
+SPECTACULAR_SETTINGS = {
+    'TITLE': 'Your API',
+    'DESCRIPTION': 'Your API description',
+    'VERSION': '1.0.0',
+}
+
+# DRF to MkDocs specific settings
+DRF_TO_MKDOC = {
+    'DJANGO_APPS': [
+        'users',
+        'products',
+        # ... list all apps you want to document
+    ],
+}
+```
+
+### 3. Create MkDocs Configuration
+
+Create an `mkdocs.yml` file in your project root. You can start with the [default configuration](docs/mkdocs.yml) and customize it.
+
+### 4. Build Your Documentation
+
+```bash
+python manage.py build_docs
+```
+
+For more detailed instructions, see the full [Installation and Setup Guide](docs/installation.md).
+
+## Usage and Customization
+
+### Building Your Documentation
+
+To build the entire documentation site, run the following command. This will generate a static site in your `site/` directory.
+
+```bash
+python manage.py build_docs
+```
+
+For more granular control, `DRF to MkDocs` provides several commands, such as `build_endpoint_docs` and `build_model_docs`.
+
+### Serving Docs with Django
+
+You can serve your documentation directly from your Django application, protecting it with Django's authentication system. This is ideal for private or internal APIs.
+
+For a complete guide, see [Serving Docs with Django](docs/serving_docs_with_django.md).
+
+### Customizing the OpenAPI Schema
+
+`DRF to MkDocs` allows you to override and extend the auto-generated OpenAPI schema by providing a custom JSON file. This gives you fine-grained control over the final documentation, enabling you to add examples, descriptions, or even custom endpoints.
+
+For more details, refer to the [Customizing Endpoints](docs/customizing_endpoints.md) guide.
+
+### Best Practices
+
+For better project organization, we recommend creating a separate `docs_settings.py` for documentation-specific configurations and using the `--settings` flag:
+
+```bash
+python manage.py build_docs --settings=my_project.docs_settings
+```
+
+This keeps your production settings clean and your documentation configuration isolated.
+
+## Configuration
+
+You can customize the behavior of `DRF to MkDocs` by configuring the `DRF_TO_MKDOC` dictionary in your settings file.
+
+| Key                              | Description                                                                    | Default                               |
+| -------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------- |
+| `DJANGO_APPS` (required)         | A list of Django app names to process.                                         | `[]`                                  |
+| `DOCS_DIR`                       | The base directory where documentation will be generated.                      | `'docs'`                              |
+| `ER_DIAGRAMS_DIR`                | The directory for ER diagrams, relative to `DOCS_DIR`.                         | `'er_diagrams'`                       |
+| `FIELD_GENERATORS`               | Custom field value generators for creating better examples.                    | `{}`                                  |
+| `ENABLE_AI_DOCS`                 | A flag to enable AI-powered documentation features.                            | `False`                               |
+| `PATH_PARAM_SUBSTITUTE_FUNCTION` | A custom function for substituting path parameters in URLs.                    | `None`                                |
+| `PATH_PARAM_SUBSTITUTE_MAPPING`  | A mapping for substituting common path parameters (e.g., `{'pk': 1}`).        | `{}`                                  |
+
+## How It Works
+
+`DRF to MkDocs` operates in a few stages:
+
+1.  **Model Introspection**: It deeply analyzes your Django models, mapping out their fields, relationships (like ForeignKeys and ManyToManyFields), and metadata.
+2.  **Schema Generation**: It uses `drf-spectacular` to generate a detailed OpenAPI schema for your API endpoints.
+3.  **Template Rendering**: It renders Jinja2 templates for each endpoint, model, and ER diagram, creating Markdown files.
+4.  **MkDocs Build**: Finally, it invokes MkDocs to build a static HTML site from the generated Markdown files.
+
+This process ensures that your documentation is always an accurate and comprehensive reflection of your codebase.
+
+## Contributing
+
+Contributions are welcome! Whether it's a bug report, a new feature, or an improvement to the documentation, we appreciate your help. To ensure code quality, we use **CoderabbitAI** for automated code reviews on all pull requests.
+
+Please see our [Contributing Guidelines](CONTRIBUTING.md) to get started.
+
+### Development Setup
+
+```bash
+git clone https://github.com/Shayestehhs/drf-to-mkdoc.git
+cd drf-to-mkdoc
+pip install -e ".[dev]"
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

drf_to_mkdoc-0.3.1/README.md

@@ -0,0 +1,183 @@
+# DRF to MkDocs
+
+Unlock effortless API documentation for your Django REST Framework project. Automatically generate beautiful, interactive, and maintainable docs that accelerate developer onboarding and streamline your team's workflow.
+
+---
+
+## Why DRF to MkDocs?
+
+`DRF to MkDocs` bridges the gap between your API's OpenAPI schema and user-friendly, maintainable documentation. It introspects your Django models and DRF views to automatically generate a polished, feature-rich documentation site that stays in sync with your codebase, empowering your team to build better APIs, faster.
+
+-   **Effortless Documentation**: Automate the entire process of generating and updating your API docs. Say goodbye to manual work and outdated information.
+-   **Accelerate Onboarding**: Provide new joiners with interactive, easy-to-navigate documentation. The "Try-it-out" feature and clear model relationships help them become productive from day one.
+-   **Deeply Integrated with DRF**: Leverages `drf-spectacular` for accurate schema generation, ensuring your documentation is a true reflection of your API.
+-   **Enhance Developer Experience**: Features like the interactive API console and in-depth model pages streamline development, testing, and debugging for the entire team.
+-   **Beautiful & Professional**: Built on MkDocs with the Material theme for a clean, modern, and responsive UI that you'll be proud to share.
+
+## Gallery
+
+<details>
+<summary>🚀 Interactive Endpoint List & Filtering</summary>
+<img width="1434" height="943" alt="List-EndPoint" src="https://github.com/user-attachments/assets/f886fc7f-afa0-4faa-b9c2-d6f754ca3597" />
+</details>
+
+<details>
+<summary>🔬 Detailed Endpoint View with "Try-it-out"</summary>
+<img width="958" height="887" alt="Detail-EndPoint" src="https://github.com/user-attachments/assets/9d9e3d4b-cb92-4ece-831e-aef45ceec768" />
+<img width="532" height="804" alt="Try-it-out" src="https://github.com/user-attachments/assets/0f483922-60c4-4f62-8fb4-bc7372e82a03" />
+</details>
+
+<details>
+<summary>📚 Rich Model Documentation</summary>
+<img width="906" height="885" alt="Model-fields" src="https://github.com/user-attachments/assets/a1ca369c-ad40-4b05-83ec-ceb1f80aab23" />
+<img width="848" height="886" alt="Model" src="https://github.com/user-attachments/assets/683d6d26-a8e4-4c05-8b5f-11a61a62cb0c" />
+</details>
+
+<details>
+<summary>📈 Entity-Relationship Diagrams</summary>
+<img width="953" height="606" alt="ER-Diagram" src="https://github.com/user-attachments/assets/3d0b1cb0-7ebf-4d4a-a181-1b7dbc9c6a01" />
+</details>
+
+## Key Features
+
+| Feature                          | Description                                                                                                                              |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| 🚀 **Interactive API Console**     | Test endpoints directly from the documentation with a "Try-it-out" feature, complete with a request builder and response viewer.         |
+| 🔍 **Advanced Filtering & Search** | Instantly find endpoints with multi-criteria filtering by app, method, path, and a real-time search.                                   |
+| 📚 **In-Depth Model Pages**        | Automatically generate detailed pages for each model, including fields, relationships, choices, and methods.                           |
+| 📊 **Entity-Relationship Diagrams** | Visualize model relationships with auto-generated, interactive ER diagrams for each app and for the entire project.                    |
+| 🎨 **Modern & Responsive UI**      | A beautiful and intuitive interface powered by MkDocs Material, featuring light/dark themes and full mobile support.                   |
+| 🔧 **Highly Customizable**         | Override templates, configure settings, and use custom functions to tailor the documentation to your project's specific needs.         |
+| ⚙️ **Simple Integration**         | Works seamlessly with existing DRF projects and `drf-spectacular` without requiring complex setup.                                     |
+| 🤖 **AI-Powered Enhancements**     | (Working on it...) Leverage AI to generate smarter examples and more descriptive documentation for your API.                                     |
+
+## Getting Started
+
+### 1. Installation
+
+```bash
+pip install drf-to-mkdoc
+```
+
+### 2. Configure Your Django Project
+
+In your `settings.py`:
+
+```python
+# settings.py
+
+INSTALLED_APPS = [
+    # ... your other apps
+    'drf_to_mkdoc',
+    'drf_spectacular',  # Required for schema generation
+]
+
+# Required for OpenAPI schema generation
+REST_FRAMEWORK = {
+    'DEFAULT_SCHEMA_CLASS': 'drf_to_mkdoc.utils.schema.AutoSchema',
+}
+
+SPECTACULAR_SETTINGS = {
+    'TITLE': 'Your API',
+    'DESCRIPTION': 'Your API description',
+    'VERSION': '1.0.0',
+}
+
+# DRF to MkDocs specific settings
+DRF_TO_MKDOC = {
+    'DJANGO_APPS': [
+        'users',
+        'products',
+        # ... list all apps you want to document
+    ],
+}
+```
+
+### 3. Create MkDocs Configuration
+
+Create an `mkdocs.yml` file in your project root. You can start with the [default configuration](docs/mkdocs.yml) and customize it.
+
+### 4. Build Your Documentation
+
+```bash
+python manage.py build_docs
+```
+
+For more detailed instructions, see the full [Installation and Setup Guide](docs/installation.md).
+
+## Usage and Customization
+
+### Building Your Documentation
+
+To build the entire documentation site, run the following command. This will generate a static site in your `site/` directory.
+
+```bash
+python manage.py build_docs
+```
+
+For more granular control, `DRF to MkDocs` provides several commands, such as `build_endpoint_docs` and `build_model_docs`.
+
+### Serving Docs with Django
+
+You can serve your documentation directly from your Django application, protecting it with Django's authentication system. This is ideal for private or internal APIs.
+
+For a complete guide, see [Serving Docs with Django](docs/serving_docs_with_django.md).
+
+### Customizing the OpenAPI Schema
+
+`DRF to MkDocs` allows you to override and extend the auto-generated OpenAPI schema by providing a custom JSON file. This gives you fine-grained control over the final documentation, enabling you to add examples, descriptions, or even custom endpoints.
+
+For more details, refer to the [Customizing Endpoints](docs/customizing_endpoints.md) guide.
+
+### Best Practices
+
+For better project organization, we recommend creating a separate `docs_settings.py` for documentation-specific configurations and using the `--settings` flag:
+
+```bash
+python manage.py build_docs --settings=my_project.docs_settings
+```
+
+This keeps your production settings clean and your documentation configuration isolated.
+
+## Configuration
+
+You can customize the behavior of `DRF to MkDocs` by configuring the `DRF_TO_MKDOC` dictionary in your settings file.
+
+| Key                              | Description                                                                    | Default                               |
+| -------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------- |
+| `DJANGO_APPS` (required)         | A list of Django app names to process.                                         | `[]`                                  |
+| `DOCS_DIR`                       | The base directory where documentation will be generated.                      | `'docs'`                              |
+| `ER_DIAGRAMS_DIR`                | The directory for ER diagrams, relative to `DOCS_DIR`.                         | `'er_diagrams'`                       |
+| `FIELD_GENERATORS`               | Custom field value generators for creating better examples.                    | `{}`                                  |
+| `ENABLE_AI_DOCS`                 | A flag to enable AI-powered documentation features.                            | `False`                               |
+| `PATH_PARAM_SUBSTITUTE_FUNCTION` | A custom function for substituting path parameters in URLs.                    | `None`                                |
+| `PATH_PARAM_SUBSTITUTE_MAPPING`  | A mapping for substituting common path parameters (e.g., `{'pk': 1}`).        | `{}`                                  |
+
+## How It Works
+
+`DRF to MkDocs` operates in a few stages:
+
+1.  **Model Introspection**: It deeply analyzes your Django models, mapping out their fields, relationships (like ForeignKeys and ManyToManyFields), and metadata.
+2.  **Schema Generation**: It uses `drf-spectacular` to generate a detailed OpenAPI schema for your API endpoints.
+3.  **Template Rendering**: It renders Jinja2 templates for each endpoint, model, and ER diagram, creating Markdown files.
+4.  **MkDocs Build**: Finally, it invokes MkDocs to build a static HTML site from the generated Markdown files.
+
+This process ensures that your documentation is always an accurate and comprehensive reflection of your codebase.
+
+## Contributing
+
+Contributions are welcome! Whether it's a bug report, a new feature, or an improvement to the documentation, we appreciate your help. To ensure code quality, we use **CoderabbitAI** for automated code reviews on all pull requests.
+
+Please see our [Contributing Guidelines](CONTRIBUTING.md) to get started.
+
+### Development Setup
+
+```bash
+git clone https://github.com/Shayestehhs/drf-to-mkdoc.git
+cd drf-to-mkdoc
+pip install -e ".[dev]"
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

drf_to_mkdoc-0.3.1/docs/serving_docs_with_django.md

@@ -0,0 +1,118 @@
+# Serving MkDocs with Django
+
+This guide explains how to serve your generated MkDocs documentation directly from your Django application, allowing you to protect it with Django's authentication system.
+
+## 1. Add Views to Your Project
+
+First, create a `views.py` file in your main project directory (the same directory as `settings.py` and `urls.py`) if one doesn't already exist. Then, add the following code to handle serving the static documentation files.
+
+```python
+# your_project/views.py
+
+import mimetypes
+from pathlib import Path
+
+from django.conf import settings
+from django.contrib.admin.views.decorators import staff_member_required
+from django.http import Http404, HttpResponse, HttpResponseRedirect
+from django.utils.decorators import method_decorator
+from django.views import View
+
+@staff_member_required
+def documentation_root(request):
+    """Redirects the root documentation URL to index.html."""
+    return HttpResponseRedirect("index.html")
+
+@method_decorator(staff_member_required, name="dispatch")
+class DocumentationView(View):
+    """
+    Serves static files from the MkDocs `site` directory.
+    This view is protected by staff_member_required.
+    """
+
+    def get(self, request, path):
+        # The base directory where MkDocs builds the site
+        site_dir = Path(settings.BASE_DIR) / "site"
+
+        # If no path is specified, default to index.html
+        if not path:
+            path = "index.html"
+        # If the path is a directory, append index.html
+        elif not Path(path).suffix:
+            path = path.rstrip("/") + "/index.html"
+
+        # Security check: prevent directory traversal attacks
+        if ".." in path or path.startswith("/"):
+            raise Http404("Invalid path specified.")
+
+        # Construct the full file path
+        file_path = site_dir / path
+
+        # Ensure the requested file exists and is within the site directory
+        try:
+            # Resolve paths to prevent symbolic link traversal
+            file_path = file_path.resolve()
+            site_dir = site_dir.resolve()
+
+            if not str(file_path).startswith(str(site_dir)):
+                raise Http404("Access denied.")
+
+            if not file_path.exists() or not file_path.is_file():
+                raise Http404("Documentation file not found.")
+
+        except (OSError, ValueError):
+            raise Http404("Invalid file path.")
+
+        # Guess the content type of the file
+        content_type, _ = mimetypes.guess_type(str(file_path))
+        if content_type is None:
+            content_type = "application/octet-stream"
+
+        # Open and serve the file
+        try:
+            with file_path.open("rb") as f:
+                response = HttpResponse(f.read(), content_type=content_type)
+        except OSError:
+            raise Http404("Could not read documentation file.")
+        
+        return response
+```
+
+## 2. Update Your Project's URLs
+
+Next, open your project's root `urls.py` file to integrate the documentation views.
+
+```python
+# your_project/urls.py
+
+from django.urls import path, re_path, include
+from . import views  # Import the views.py you just created
+
+# Define the URL patterns for the documentation
+docs_urlpatterns = [
+    path("", views.documentation_root, name="root"),
+    re_path(r"^(?P<path>.*)$", views.DocumentationView.as_view(), name="documentation"),
+]
+
+urlpatterns = [
+    # ... your other admin and app URLs
+    path("docs/", include((docs_urlpatterns, "docs"), namespace="docs")),
+]
+```
+
+## 3. Build and Serve
+
+With the views and URLs configured, the process to build and serve your documentation is straightforward:
+
+1.  **Build the docs**:
+    ```bash
+    python manage.py build_docs
+    ```
+    This will generate the static site in the `site/` directory.
+
+2.  **Run the Django server**:
+    ```bash
+    python manage.py runserver
+    ```
+
+Now, you can navigate to `/docs/` in your browser. If you are logged in as a staff user, you will see your documentation. Otherwise, you'll be redirected to the Django admin login page.

{drf_to_mkdoc-0.3.0 → drf_to_mkdoc-0.3.1}/drf_to_mkdoc/conf/defaults.py

@@ -14,6 +14,5 @@ DEFAULTS = {
     "AI_CONFIG_DIR_NAME": "ai_code",  # Directory name for AI-generated code files
     "AI_OPERATION_MAP_FILE": "docs/configs/operation_map.json",  # Path to operation map file
     "SERIALIZERS_INHERITANCE_DEPTH": 1,  # Maximum depth for class inheritance analysis
-    # Django apps - required, no default
-    "DJANGO_APPS": None,  # List of Django app names to process
+    "DJANGO_APPS": [],  # If it is empty list, there is no any exclusion
 }

{drf_to_mkdoc-0.3.0 → drf_to_mkdoc-0.3.1}/drf_to_mkdoc/conf/settings.py

@@ -7,13 +7,14 @@ from drf_to_mkdoc.conf.defaults import DEFAULTS
 
 
 class DRFToMkDocSettings:
-    required_settings: ClassVar[list[str]] = ["DJANGO_APPS"]
+    required_settings: ClassVar[list[str]] = []
     project_settings: ClassVar[dict[str, Any]] = {"PROJECT_NAME": "drf-to-mkdoc"}
 
     settings_types: ClassVar[dict[str, type]] = {
         "ENABLE_AI_DOCS": bool,
         "AI_CONFIG_DIR_NAME": str,
         "SERIALIZERS_INHERITANCE_DEPTH": int,
+        "DJANGO_APPS": list,
     }
 
     settings_ranges: ClassVar[dict[str, tuple[int, int]]] = {

{drf_to_mkdoc-0.3.0 → drf_to_mkdoc-0.3.1}/drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/request-executor.js

@@ -160,9 +160,25 @@ const RequestExecutor = {
             }
         }
 
-        // Get method
+        // Get method - try multiple sources for reliability
+        let method = 'GET'; // Default fallback
+        
+        // First try: method badge data attribute
         const methodBadge = document.querySelector('.method-badge');
-        const method = methodBadge?.dataset.method || 'GET';
+        if (methodBadge?.dataset.method) {
+            method = methodBadge.dataset.method;
+        } else {
+            // Second try: try-out form data attribute
+            const tryOutForm = document.querySelector('.try-out-form');
+            if (tryOutForm?.dataset.method) {
+                method = tryOutForm.dataset.method.toUpperCase();
+            } else {
+                // Third try: method badge text content
+                if (methodBadge?.textContent) {
+                    method = methodBadge.textContent.trim();
+                }
+            }
+        }
 
         return {
             url: fullUrl,

{drf_to_mkdoc-0.3.0 → drf_to_mkdoc-0.3.1}/drf_to_mkdoc/utils/endpoint_detail_generator.py

@@ -742,7 +742,7 @@ def parse_endpoints_from_schema(paths: dict[str, Any]) -> dict[str, list[dict[st
 
     for path, methods in paths.items():
         app_name = extract_app_from_operation_id(next(iter(methods.values()))["operationId"])
-        if app_name not in django_apps:
+        if django_apps and app_name not in django_apps:
             continue
 
         for method, endpoint_data in methods.items():

{drf_to_mkdoc-0.3.0 → drf_to_mkdoc-0.3.1}/drf_to_mkdoc/utils/schema.py

@@ -2,7 +2,7 @@ import inspect
 import logging
 from importlib import import_module
 from types import SimpleNamespace
-from typing import Any
+from typing import Any, List
 
 from drf_spectacular.openapi import AutoSchema as SpectacularAutoSchema
 from drf_spectacular.plumbing import ComponentRegistry
@@ -208,6 +208,15 @@ class AutoSchema(SpectacularAutoSchema):
     directly to the operation during schema generation instead of using a postprocessing hook.
     """
 
+    def __init__(self, *args, **kwargs):
+        self.tags = kwargs.pop("tags", [])
+        super().__init__()
+
+    def get_tags(self) -> List[str]:
+        if self.tags:
+            return self.tags
+        return super().get_tags()
+
     def get_operation(
         self,
         path: str,