Support indented arg descriptions

Author: staticf0x

docstring_to_markdown/google.py

@@ -1,6 +1,6 @@
 import re
 from textwrap import dedent
-from typing import Dict, List, Union
+from typing import List
 
 # All possible sections in Google style docstrings
 SECTION_HEADERS: List[str] = [
@@ -68,6 +68,7 @@ def _parse(self, content: str) -> None:
         # Format section
         for part in parts:
             indentation = ""
+            skip_first = False
 
             if ":" in part[0]:
                 spl = part[0].split(":")
@@ -76,11 +77,21 @@ def _parse(self, content: str) -> None:
                 description = ":".join(spl[1:]).lstrip()
                 indentation = (len(arg) + 6) * " "
 
-                self.content += "- `{}`: {}\n".format(arg, description)
+                if description:
+                    self.content += "- `{}`: {}\n".format(arg, description)
+                else:
+                    skip_first = True
+                    self.content += "- `{}`: ".format(arg)
             else:
                 self.content += "- {}\n".format(part[0])
 
-            for line in part[1:]:
+            for n, line in enumerate(part[1:]):
+                if skip_first and n == 0:
+                    # This ensures that indented args get moved to the
+                    # previous line
+                    self.content += "{}\n".format(line.lstrip())
+                    continue
+
                 self.content += "{}{}\n".format(indentation, line.lstrip())
 
         self.content = self.content.rstrip("\n")
@@ -89,7 +100,6 @@ def as_markdown(self) -> str:
         return "#### {}\n\n{}\n\n".format(self.name, self.content)
 
 
-
 class GoogleDocstring:
     def __init__(self, docstring: str) -> None:
         self.sections: list[Section] = []

tests/test_google.py

@@ -75,6 +75,9 @@
              spanning over several lines
         also with broken indentation
     b (str): Second arg
+    c (str):
+        On the next line
+        And also multiple lines
 """
 
 MULTILINE_ARG_DESCRIPTION_MD = """Example.
@@ -85,6 +88,8 @@
              spanning over several lines
              also with broken indentation
 - `b (str)`: Second arg
+- `c (str)`: On the next line
+             And also multiple lines
 """
 
 GOOGLE_CASES = {