drf-to-mkdoc 0.1.8__tar.gz → 0.1.9__tar.gz

{drf_to_mkdoc-0.1.8 → drf_to_mkdoc-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drf-to-mkdoc
-Version: 0.1.8
+Version: 0.1.9
 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.1.8 → drf_to_mkdoc-0.1.9}/drf_to_mkdoc/conf/defaults.py

@@ -5,6 +5,8 @@ DEFAULTS = {
     "MODEL_DOCS_FILE": "docs/model-docs.json",  # Path to model documentation JSON file
     "DOC_CONFIG_FILE": "docs/configs/doc_config.json",  # Path to documentation configuration file
     "CUSTOM_SCHEMA_FILE": "docs/configs/custom_schema.json",  # Path to custom schema file
+    "PATH_PARAM_SUBSTITUTE_FUNCTION": None,
+    "PATH_PARAM_SUBSTITUTE_MAPPING": {},
     # Django apps - required, no default
     "DJANGO_APPS": None,  # List of Django app names to process
 }

{drf_to_mkdoc-0.1.8 → drf_to_mkdoc-0.1.9}/drf_to_mkdoc/utils/common.py

@@ -174,39 +174,44 @@ def get_custom_schema():
 def convert_to_django_path(path: str, parameters: list[dict[str, Any]]) -> str:
     """
     Convert a path with {param} to a Django-style path with <type:param>.
-    If PATH_PARAM_SUBSTITUTOR is set, use that function instead.
+    If PATH_PARAM_SUBSTITUTE_FUNCTION is set, use that function instead.
     """
     function = None
-    func_path = getattr(drf_to_mkdoc_settings, "PATH_PARAM_SUBSTITUTOR", None)
+    func_path = drf_to_mkdoc_settings.PATH_PARAM_SUBSTITUTE_FUNCTION
 
     if func_path:
         try:
             function = import_string(func_path)
         except ImportError:
-            logger.warning("PATH_PARAM_SUBSTITUTOR is not a valid import path")
+            logger.warning("PATH_PARAM_SUBSTITUTE_FUNCTION is not a valid import path")
 
     # If custom function exists and returns a valid value, use it
+    PATH_PARAM_SUBSTITUTE_MAPPING = drf_to_mkdoc_settings.PATH_PARAM_SUBSTITUTE_MAPPING
     if callable(function):
         try:
-            value = function(path, parameters)
-            if isinstance(value, str) and value.strip():
-                return value
+            result = function(path, parameters)
+            if result and isinstance(result, dict):
+                PATH_PARAM_SUBSTITUTE_MAPPING.update(result)
         except Exception as e:
             logger.exception("Error in custom path substitutor: %s", e)
 
     # Default Django path conversion
     def replacement(match):
         param_name = match.group(1)
-        param_info = next((p for p in parameters if p.get("name") == param_name), {})
-        param_type = param_info.get("schema", {}).get("type")
-        param_format = param_info.get("schema", {}).get("format")
-
-        if param_type == "integer":
-            converter = "int"
-        elif param_type == "string" and param_format == "uuid":
-            converter = "uuid"
+        custom_param_type = PATH_PARAM_SUBSTITUTE_MAPPING.get(param_name)
+        if custom_param_type and custom_param_type in ("int", "uuid", "str"):
+            converter = custom_param_type
         else:
-            converter = "str"
+            param_info = next((p for p in parameters if p.get("name") == param_name), {})
+            param_type = param_info.get("schema", {}).get("type")
+            param_format = param_info.get("schema", {}).get("format")
+
+            if param_type == "integer":
+                converter = "int"
+            elif param_type == "string" and param_format == "uuid":
+                converter = "uuid"
+            else:
+                converter = "str"
 
         return f"<{converter}:{param_name}>"
 

{drf_to_mkdoc-0.1.8 → drf_to_mkdoc-0.1.9}/drf_to_mkdoc.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drf-to-mkdoc
-Version: 0.1.8
+Version: 0.1.9
 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>