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

drf_to_mkdoc/utils/model_detail_generator.py

@@ -1,5 +1,6 @@
 from typing import Any
 
+from django.template.loader import render_to_string
 from django.templatetags.static import static
 
 from drf_to_mkdoc.conf.settings import drf_to_mkdoc_settings
@@ -27,216 +28,35 @@ def generate_model_docs(models_data: dict[str, Any]) -> None:
             write_file(file_path, content)
 
 
-def render_column_fields_table(fields: dict[str, Any]) -> str:
-    """Render the fields table for a model."""
-    content = "## Fields\n\n"
-    content += "| Field | Type | Description | Extra |\n"
-    content += "|-------|------|-------------|-------|\n"
-
-    for field_name, field_info in fields.items():
-        field_type = field_info.get("type", "Unknown")
-        verbose_name = field_info.get("verbose_name", field_name)
-        help_text = field_info.get("help_text", "")
-
-        display_name = field_name
-        if field_type in ["ForeignKey", "OneToOneField"]:
-            display_name = f"{field_name}_id"
-
-        extra_info = []
-        if field_info.get("null"):
-            extra_info.append("null=True")
-        if field_info.get("blank"):
-            extra_info.append("blank=True")
-        if field_info.get("unique"):
-            extra_info.append("unique=True")
-        if field_info.get("primary_key"):
-            extra_info.append("primary_key=True")
-        if field_info.get("default"):
-            extra_info.append(f"default={field_info['default']}")
-
-        field_specific = field_info.get("field_specific", {})
-        for key, value in field_specific.items():
-            if key not in ["related_name", "related_query_name", "to"]:
-                extra_info.append(f"{key}={value}")
-
-        extra_str = ", ".join(extra_info) if extra_info else ""
-        description_str = help_text or verbose_name
-
-        content += f"| `{display_name}` | {field_type} | {description_str} | {extra_str} |\n"
-
-    return content
-
-
-def render_choices_tables(fields: dict[str, Any]) -> str:
-    """Render choice tables for fields with choices."""
-    choice_tables = []
-
-    for field_name, field_info in fields.items():
-        choices = field_info.get("choices")
-        if choices:
-            table = f"### {field_name} Choices\n\n"
-            table += "| Label | Value |\n"
-            table += "|-------|--------|\n"
-            for choice in choices:
-                table += f"| {choice['display']} | `{choice['value']}` |\n"
-            table += "\n"
-            choice_tables.append(table)
-
-    if choice_tables:
-        return "## Choices\n\n" + "\n".join(choice_tables)
-    return ""
-
-
 def create_model_page(model_info: dict[str, Any]) -> str:
     """Create a model documentation page from model info"""
     name = model_info.get("name", "Unknown")
     app_label = model_info.get("app_label", "unknown")
     table_name = model_info.get("table_name", "")
     description = get_model_description(name)
+    column_fields = model_info.get("column_fields", {})
 
-    content = _create_model_header(name, app_label, table_name, description)
-    content += _add_fields_section(model_info)
-    content += _add_relationships_section(model_info)
-    content += _add_methods_section(model_info)
-    content += _add_meta_options_section(model_info)
-
-    return content
-
+    # Check if any fields have choices
+    has_choices = any(field_info.get("choices") for field_info in column_fields.values())
 
-def _create_model_header(name: str, app_label: str, table_name: str, description: str) -> str:
-    """Create the header section of the model documentation."""
     stylesheets = [
-        "stylesheets/models/variables.css",
-        "stylesheets/models/base.css",
-        "stylesheets/models/model-tables.css",
-        "stylesheets/models/responsive.css",
+        static(f"{drf_to_mkdoc_settings.PROJECT_NAME}/stylesheets/models/variables.css"),
+        static(f"{drf_to_mkdoc_settings.PROJECT_NAME}/stylesheets/models/base.css"),
+        static(f"{drf_to_mkdoc_settings.PROJECT_NAME}/stylesheets/models/model-tables.css"),
+        static(f"{drf_to_mkdoc_settings.PROJECT_NAME}/stylesheets/models/responsive.css"),
     ]
-    prefix_path = f"{drf_to_mkdoc_settings.PROJECT_NAME}/"
-    css_links = "\n".join(
-        f'<link rel="stylesheet" href="{static(prefix_path + path)}">' for path in stylesheets
-    )
-    return f"""# {name}
-
-<!-- inject CSS directly -->
-{css_links}
-
-**App:** {app_label}
-**Table:** `{table_name}`
-
-## Description
-
-{description}
-
-"""
-
-
-def _add_fields_section(model_info: dict[str, Any]) -> str:
-    """Add the fields section to the model documentation."""
-    column_fields = model_info.get("column_fields", {})
-    if not column_fields:
-        return ""
-
-    content = ""
-
-    column_fields_content = render_column_fields_table(column_fields)
-    if column_fields_content:
-        content += column_fields_content
-        content += "\n"
-
-    choices_content = render_choices_tables(column_fields)
-    if choices_content:
-        content += choices_content
-        content += "\n"
-
-    return content
-
-
-def _add_relationships_section(model_info: dict[str, Any]) -> str:
-    """Add the relationships section to the model documentation."""
-    relationship_fields = model_info.get("relationships", {})
-    if not relationship_fields:
-        return ""
-
-    content = "## Relationships\n\n"
-    content += "| Field | Type | Related Model |\n"
-    content += "|-------|------|---------------|\n"
-
-    content += _render_relationship_fields(relationship_fields)
-    content += _render_relationships_from_section(relationship_fields)
-    content += "\n"
-
-    return content
-
-
-def _render_relationship_fields(relationship_fields: dict[str, Any]) -> str:
-    """Render relationship fields from the fields section."""
-    content = ""
-    for field_name, field_info in relationship_fields.items():
-        field_type = field_info.get("type", "Unknown")
-        field_specific = field_info.get("field_specific", {})
-        to_model = field_specific.get("to", "")
-
-        if to_model:
-            model_link = _create_model_link(to_model)
-            content += f"| `{field_name}` | {field_type} | {model_link}|\n"
-
-    return content
-
-
-def _render_relationships_from_section(relationships: dict[str, Any]) -> str:
-    """Render relationships from the relationships section."""
-    content = ""
-    for rel_name, rel_info in relationships.items():
-        rel_type = rel_info.get("type", "Unknown")
-
-        app_label = rel_info["app_label"]
-        table_name = rel_info["table_name"]
-        verbose_name = rel_info["verbose_name"]
-
-        model_link = f"[{verbose_name.capitalize()}](../../{app_label}/{table_name}/)"
-
-        content += f"| `{rel_name}` | {rel_type} | {model_link} | \n"
-
-    return content
-
-
-def _create_model_link(to_model: str) -> str:
-    """Create a link to a related model."""
-    if "." in to_model:
-        related_app, related_model = to_model.split(".", 1)
-        return f"[{related_model}](../{related_app}/{related_model.lower()}/)"
-    return f"[{to_model}]({to_model.lower()}/)"
-
-
-def _add_methods_section(model_info: dict[str, Any]) -> str:
-    """Add the methods section to the model documentation."""
-    methods = model_info.get("methods", [])
-    if not methods:
-        return ""
-
-    content = "## Methods\n\n"
-    for method in methods:
-        method_name = method.get("name", "")
-        docstring = method.get("docstring", "")
-
-        content += f"### `{method_name}()`\n\n"
-        if docstring:
-            content += f"{docstring}\n\n"
-        else:
-            content += "No documentation available.\n\n"
-
-    return content
-
-
-def _add_meta_options_section(model_info: dict[str, Any]) -> str:
-    """Add the meta options section to the model documentation."""
-    meta_options = model_info.get("meta_options", {})
-    if not meta_options:
-        return ""
-
-    content = "## Meta Options\n\n"
-    for option, value in meta_options.items():
-        content += f"- **{option}:** {value}\n"
-    content += "\n"
 
-    return content
+    context = {
+        "name": name,
+        "app_label": app_label,
+        "table_name": table_name,
+        "description": description,
+        "stylesheets": stylesheets,
+        "fields": column_fields,  # Changed from column_fields to fields for template consistency
+        "has_choices": has_choices,  # Added choices flag
+        "relationships": model_info.get("relationships", {}),
+        "methods": model_info.get("methods", []),
+        "meta_options": model_info.get("meta_options", {}),
+    }
+
+    return render_to_string("model_detail/base.html", context)

drf_to_mkdoc/utils/model_list_generator.py

@@ -1,8 +1,7 @@
-from html import escape
 from pathlib import Path
 from typing import Any
-from urllib.parse import quote
 
+from django.template.loader import render_to_string
 from django.templatetags.static import static
 
 from drf_to_mkdoc.conf.settings import drf_to_mkdoc_settings
@@ -12,44 +11,22 @@ from drf_to_mkdoc.utils.commons.model_utils import get_app_descriptions
 def create_models_index(models_data: dict[str, Any], docs_dir: Path) -> None:
     """Create the main models index page that lists all models organized by app."""
     stylesheets = [
-        "stylesheets/models/variables.css",
-        "stylesheets/models/base.css",
-        "stylesheets/models/model-cards.css",
-        "stylesheets/models/responsive.css",
-        "stylesheets/models/animations.css",
+        static(f"{drf_to_mkdoc_settings.PROJECT_NAME}/{path}")
+        for path in [
+            "stylesheets/models/variables.css",
+            "stylesheets/models/base.css",
+            "stylesheets/models/model-cards.css",
+            "stylesheets/models/responsive.css",
+            "stylesheets/models/animations.css",
+        ]
     ]
-    prefix_path = f"{drf_to_mkdoc_settings.PROJECT_NAME}/"
-    css_links = "\n".join(
-        f'<link rel="stylesheet" href="{static(prefix_path + path)}">' for path in stylesheets
-    )
-    content = f"""# Django Models
-
-This section contains documentation for all Django models in the system, organized by Django application.
-
-<!-- inject CSS directly -->
-{css_links}
-
-<div class="models-container">
-"""
-
-    app_descriptions = get_app_descriptions()
 
+    sorted_models = []
     for app_name, models in sorted(models_data.items()):
-        app_desc = escape(
-            app_descriptions.get(
-                app_name, f"{app_name.replace('_', ' ').title()} application models"
-            )
-        )
-        app_title = escape(app_name.replace("_", " ").title())
-        content += f'<div class="app-header">{app_title} App</div>\n'
-        content += f'<div class="app-description">{app_desc}</div>\n\n'
-
-        content += '<div class="model-cards">\n'
-
         model_names = sorted(
             [
                 (
-                    str(mi.get("verbose_name") or mk),
+                    str(mi.get("verbose_name") or mk).capitalize(),
                     str(mi.get("table_name") or mk),
                 )
                 for mk, mi in models.items()
@@ -57,18 +34,23 @@ This section contains documentation for all Django models in the system, organiz
             ],
             key=lambda x: x[0].casefold(),
         )
-        for verbose_name, table_name in model_names:
-            content += f"""
-            <a href="{quote(app_name, safe="")}/{quote(table_name, safe="")}/"
-             class="model-card">{escape(verbose_name)}</a>\n
-"""
-
-        content += "</div>\n\n"
-
-    content += """</div>
+        sorted_models.append((app_name, model_names))
 
+    app_descriptions = get_app_descriptions()
+    for app_name, _ in sorted_models:
+        if app_name not in app_descriptions:
+            app_descriptions[app_name] = (
+                f"{app_name.replace('_', ' ').title()} application models"
+            )
 
-Each model page contains detailed field documentation, method signatures, and relationships to other models."""
+    content = render_to_string(
+        "models_index.html",
+        {
+            "stylesheets": stylesheets,
+            "sorted_models": sorted_models,
+            "app_descriptions": app_descriptions,
+        },
+    )
 
     models_index_path = docs_dir / "models" / "index.md"
     models_index_path.parent.mkdir(parents=True, exist_ok=True)

drf_to_mkdoc/utils/schema.py

@@ -58,7 +58,7 @@ class ViewMetadataExtractor:
 
         try:
             serializer_cls = self.view_instance.get_serializer_class()
-        except (AttributeError, TypeError, ImportError) as e:
+        except Exception as e:
             logger.debug(f"Failed to get serializer from view instance: {e}")
             return None
         else:

{drf_to_mkdoc-0.2.1.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.1
+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>

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

@@ -2,7 +2,7 @@ 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=BruquzEGvGzJ3YhXnWHn4gxxZA6Ed1Twtry8rokgdUI,5557
+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
@@ -36,12 +36,32 @@ drf_to_mkdoc/static/drf-to-mkdoc/stylesheets/models/model-cards.css,sha256=IppCO
 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=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/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
@@ -58,10 +78,8 @@ drf_to_mkdoc/utils/commons/path_utils.py,sha256=Pi9g1xXDPsRzmn4kTeNSVtXG9v6n1h2Z
 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/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.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-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/utils/md_generators/query_parameters_generators.py

@@ -1,72 +0,0 @@
-from typing import Any
-
-
-def _md_query_parameters_format_error_section(query_params: dict[str, Any]) -> str:
-    if "error" in query_params:
-        return f"**Error:** {query_params['error']}\n\n"
-    return ""
-
-
-def _md_query_parameters_format_search_section(query_params: dict[str, Any]) -> str:
-    search_fields = query_params.get("search_fields", [])
-    if search_fields:
-        content = "### Search Parameters\n\n"
-        for field in search_fields:
-            content += f"- `{field}`\n"
-        content += "\n"
-        return content
-    return ""
-
-
-def _md_query_parameters_format_filter_section(query_params: dict[str, Any]) -> str:
-    filter_fields = query_params.get("filter_fields", [])
-    if filter_fields:
-        content = "### Filter Parameters\n\n"
-        for field in filter_fields:
-            content += f"- `{field}`\n"
-        content += "\n"
-        return content
-    return ""
-
-
-def _md_query_parameters_format_ordering_section(query_params: dict[str, Any]) -> str:
-    ordering_fields = query_params.get("ordering_fields", [])
-    if ordering_fields:
-        content = "### Ordering Parameters\n\n"
-        for field in ordering_fields:
-            content += f"- `{field}`\n"
-        content += "\n"
-        return content
-    return ""
-
-
-def _md_query_parameters_format_pagination_section(query_params: dict[str, Any]) -> str:
-    pagination_fields = query_params.get("pagination_fields", [])
-    if pagination_fields:
-        content = "### Pagination Parameters\n\n"
-        for field in pagination_fields:
-            content += f"- `{field}`\n"
-        content += "\n"
-        return content
-    return ""
-
-
-def _md_query_parameters_format_filter_backends_section(query_params: dict[str, Any]) -> str:
-    filter_backends = query_params.get("filter_backends", [])
-    if filter_backends:
-        return f"**Filter Backends:** {', '.join(filter_backends)}\n\n"
-    return ""
-
-
-def generate_query_parameters_md(query_params: dict[str, Any]) -> str:
-    """Format query parameters into markdown documentation"""
-    if "error" in query_params:
-        return _md_query_parameters_format_error_section(query_params)
-
-    content = ""
-    content += _md_query_parameters_format_search_section(query_params)
-    content += _md_query_parameters_format_filter_section(query_params)
-    content += _md_query_parameters_format_ordering_section(query_params)
-    content += _md_query_parameters_format_pagination_section(query_params)
-    content += _md_query_parameters_format_filter_backends_section(query_params)
-    return content