fix a bug where type aliases wouldn't be linked (#798)

Author: mhils

CHANGELOG.md

@@ -4,6 +4,8 @@
 
 ## Unreleased: pdoc next
 
+- Fix a bug where type aliases wouldn't be linked.
+  ([#798](https://github.com/mitmproxy/pdoc/pull/798), @mhils)
 - Fix a bug where invalid Numpydoc docstrings would raise an exception.
   ([#789](https://github.com/mitmproxy/pdoc/pull/789), @mhils)
 - Improve debuggability of docstring processing

pdoc/doc.py

@@ -1169,6 +1169,9 @@ def annotation_str(self) -> str:
         """The variable's type annotation as a pretty-printed str."""
         if self.annotation is not empty:
             formatted = formatannotation(self.annotation)
+            # type aliases don't include the module name in their __repr__, so we add it here.
+            if isinstance(self.annotation, TypeAliasType):
+                formatted = f"{self.annotation.__module__}.{formatted}"
             return f": {_remove_collections_abc(formatted)}"
         else:
             return ""

test/testdata/misc_py312.html

@@ -130,7 +130,7 @@ <h1 class="modulename">
                 </section>
                 <section id="foo">
                     <div class="attr variable">
-            <span class="name">foo</span><span class="annotation">: MyType</span>
+            <span class="name">foo</span><span class="annotation">: <a href="#MyType">MyType</a></span>
 
 
     </div>

test/testdata/misc_py312.txt

@@ -1,6 +1,6 @@
 <module misc_py312  # Testing features tha…
     <var MyType = int  # A custom Python 3.12…>
-    <var foo: MyType  # A custom type instan…>
+    <var foo: misc_py312.MyType  # A custom type instan…>
     <var MyTypeWithoutDocstring = int>
     <var MyTypeClassic: TypeAlias = int  # inherited from builtins.int, A "classic" typing.T…>
     <class misc_py312.NamedTupleExample  # An example for a typ…