Fix false positive of google convention missing args descriptions (#619)

Author: stinovlas

docs/release_notes.rst

@@ -5,6 +5,13 @@ Release Notes
 `Semantic Versioning <http://semver.org/>`_ specification.
 
 
+Current development version
+---------------------------
+
+Bug Fixes
+
+* Fix false positives of D417 in google convention docstrings (#619).
+
 6.2.1 - January 3rd, 2023
 ---------------------------
 

src/pydocstyle/checker.py

@@ -862,8 +862,22 @@ def _check_args_section(docstring, definition, context):
                     y: Ut enim ad minim veniam
         """
         docstring_args = set()
+
         # normalize leading whitespace
-        args_content = dedent("\n".join(context.following_lines)).strip()
+        if context.following_lines:
+            # any lines with shorter indent than the first one should be disregarded
+            first_line = context.following_lines[0]
+            leading_whitespaces = first_line[: -len(first_line.lstrip())]
+
+        args_content = dedent(
+            "\n".join(
+                [
+                    line
+                    for line in context.following_lines
+                    if line.startswith(leading_whitespaces) or line == ""
+                ]
+            )
+        ).strip()
 
         args_sections = []
         for line in args_content.splitlines(keepends=True):

src/tests/test_cases/sections.py

@@ -318,6 +318,17 @@ def test_method(self, test, another_test, _):  # noqa: D213, D407
 
         """
 
+    def test_detailed_description(self, test, another_test, _):  # noqa: D213, D407
+        """Test a valid args section.
+
+        Args:
+            test: A parameter.
+            another_test: Another parameter.
+
+        Detailed description.
+
+        """
+
     @expect("D417: Missing argument descriptions in the docstring "
             "(argument(s) test, y, z are missing descriptions in "
             "'test_missing_args' docstring)", arg_count=5)