fix: Fix getting return type from parent property when parsing Sphinx docstrings

Issue-125: #125

Author: pawamoy

src/griffe/docstrings/sphinx.py

@@ -340,7 +340,7 @@ def _read_return(docstring: Docstring, offset: int, parsed_values: ParsedValues,
         annotation = parsed_values.return_type
     else:
         try:
-            annotation = docstring.parent.returns  # type: ignore[union-attr]
+            annotation = docstring.parent.annotation  # type: ignore[union-attr]
         except AttributeError:
             _warn(docstring, 0, f"No return type or annotation at '{parsed_directive.line}'")
             annotation = None

tests/test_docstrings/test_sphinx.py

@@ -996,7 +996,7 @@ def test_parse__raise_no_name__error(parse_sphinx: ParserType) -> None:
     assert "Failed to parse exception directive from" in warnings[0]
 
 
-def test_parse_module_attributes_section__expected_attributes_section(parse_sphinx: ParserType) -> None:
+def test_parse__module_attributes_section__expected_attributes_section(parse_sphinx: ParserType) -> None:
     """Parse attributes section in modules.
 
     Parameters:
@@ -1035,3 +1035,20 @@ def test_parse_module_attributes_section__expected_attributes_section(parse_sphi
     for index, expected in enumerate(expected_kwargs):
         assert_attribute_equal(attr_section.value[index], DocstringAttribute(**expected))  # type: ignore[arg-type]
     assert not warnings
+
+
+def test_parse__properties_return_type(parse_sphinx: ParserType) -> None:
+    """Parse attributes section in modules.
+
+    Parameters:
+        parse_sphinx: Fixture parser.
+    """
+    docstring = """
+        Property that returns True for explaining the issue.
+
+        :return: True
+    """
+    prop = Attribute("example", annotation="bool")
+    sections, warnings = parse_sphinx(docstring, parent=prop)
+    assert not warnings
+    assert sections[1].value[0].annotation == "bool"