Handle weird return types safely in resolving (#159)

Author: felix-hilden

docs/src/release_notes.rst

@@ -8,6 +8,10 @@ These release notes are based on
 sphinx-codeautolink adheres to
 `Semantic Versioning <https://semver.org>`_.
 
+Unreleased
+----------
+- Fix regression in not handling malformed return types (:issue:`159`)
+
 0.16.1 (2025-01-15)
 -------------------
 - Fix regression in not handling invalid return type hints (:issue:`158`)

src/sphinx_codeautolink/extension/resolve.py

@@ -120,7 +120,7 @@ def get_return_annotation(func: Callable) -> type | None:
     """Determine the target of a function return type hint."""
     try:
         annotation = get_type_hints(func).get("return")
-    except NameError as e:
+    except (NameError, TypeError) as e:
         msg = f"Unable to follow return annotation of {get_name_for_debugging(func)}."
         raise CouldNotResolve(msg) from e
 

tests/extension/ref/ref_invalid_func.txt

@@ -0,0 +1,18 @@
+numpy
+np.concatenate
+# split
+extensions = [
+    "sphinx.ext.intersphinx",
+    "sphinx_codeautolink",
+]
+intersphinx_mapping = {"numpy": ("https://numpy.org/doc/stable/", None)}
+codeautolink_warn_on_failed_resolve = False
+# split
+Test project
+============
+
+.. code:: python
+
+   import numpy as np
+
+   np.concatenate().mean()