enable the accommodation of multi-line docstring with --fixtures-per-test option

Author: kumiDa

src/_pytest/python.py

@@ -1433,7 +1433,7 @@ def write_fixture(fixture_def: fixtures.FixtureDef[object]) -> None:
         tw.line(funcargspec, green=True)
         fixture_doc = inspect.getdoc(fixture_def.func)
         if fixture_doc:
-            write_docstring(tw, fixture_doc.split("\n")[0])
+            write_docstring(tw, fixture_doc.split("\n\n")[0] if verbose<=0 else fixture_doc)
         else:
             tw.line("    no docstring available", red=True)
 

testing/python/show_fixtures_per_test.py

@@ -30,6 +30,7 @@ def test_arg1(arg1):
             "*fixtures used by test_arg1*",
             "*(test_fixtures_in_module.py:9)*",
             "arg1 -- test_fixtures_in_module.py:6",
+            "    arg1 docstring"
         ]
     )
     result.stdout.no_fnmatch_line("*_arg0*")
@@ -179,3 +180,73 @@ def foo():
     assert result.ret == 0
 
     result.stdout.fnmatch_lines(["*collected 2 items*"])
+
+def test_multiline_docstring_in_module(pytester: Pytester) -> None:
+    p = pytester.makepyfile(
+        '''
+        import pytest
+        @pytest.fixture
+        def arg1():
+            """Docstring content that spans across multiple lines,
+            through second line,
+            and through third line.
+            
+            Docstring content that extends into a second paragraph.
+            
+            Docstring content that extends into a third paragraph.
+            """
+        def test_arg1(arg1):
+            pass
+    '''
+    )
+
+    result = pytester.runpytest("--fixtures-per-test", p)
+    assert result.ret == 0
+
+    result.stdout.fnmatch_lines(
+        [
+            "*fixtures used by test_arg1*",
+            "*(test_multiline_docstring_in_module.py:13)*",
+            "arg1 -- test_multiline_docstring_in_module.py:3",
+            "    Docstring content that spans across multiple lines,",
+            "    through second line,",
+            "    and through third line."
+        ]
+    )
+
+def test_verbose_include_multiline_docstring(pytester: Pytester) -> None:
+    p = pytester.makepyfile(
+        '''
+        import pytest
+        @pytest.fixture
+        def arg1():
+            """Docstring content that spans across multiple lines,
+            through second line,
+            and through third line.
+
+            Docstring content that extends into a second paragraph.
+
+            Docstring content that extends into a third paragraph.
+            """
+        def test_arg1(arg1):
+            pass
+    '''
+    )
+
+    result = pytester.runpytest("--fixtures-per-test", "-v", p)
+    assert result.ret == 0
+
+    result.stdout.fnmatch_lines(
+        [
+            "*fixtures used by test_arg1*",
+            "*(test_verbose_include_multiline_docstring.py:13)*",
+            "arg1 -- test_verbose_include_multiline_docstring.py:3",
+            "    Docstring content that spans across multiple lines,",
+            "    through second line,",
+            "    and through third line.",
+            "    ",
+            "    Docstring content that extends into a second paragraph.",
+            "    ",
+            "    Docstring content that extends into a third paragraph."
+        ]
+    )