Link to subclass documentation (#68)

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
+----------
+- Add ability to link to subclass documentation (:issue:`68`)
+
 0.6.0 (2021-11-21)
 ------------------
 - Remove text decoration from produced links (:issue:`3`)

src/sphinx_codeautolink/extension/resolve.py

@@ -31,6 +31,7 @@ def locate_type(
     remaining = components[index:]
     location = '.'.join(components[:index])
 
+    prev_val = None
     for component in remaining:
         value = getattr(value, component, None)
         location += '.' + component
@@ -44,6 +45,14 @@ def locate_type(
                 # Odd construct encountered: don't try to be clever but continue
                 pass
 
+        if isinstance(prev_val, type) and location not in inventory:
+            for val in prev_val.mro():
+                loc = fully_qualified_name(val) + '.' + component
+                if loc in inventory:
+                    return locate_type(tuple(loc.split('.')), inventory, ends_with_call)
+
+        prev_val = value
+
     # A possible function / method call needs to be last in the chain.
     # Otherwise we might follow return types on function attribute access.
     if (

tests/extension/ref/ref_inherited.txt

@@ -0,0 +1,22 @@
+test_project
+test_project.Child.meth
+test_project.Child
+meth
+test_project.Child.attr
+test_project.Child
+attr
+# split
+# split
+Test project
+============
+
+.. code:: python
+
+   import test_project
+   test_project.Child.meth()
+   test_project.Child().meth()
+   test_project.Child.attr
+   test_project.Child().attr
+
+.. automodule:: test_project
+   :no-inherited-members:

tests/extension/src/test_project/__init__.py

@@ -33,3 +33,7 @@ def optional() -> Optional[Foo]:
 
 def compile():
     """Shadows built in compile function."""
+
+
+class Child(Foo):
+    """Foo child class."""