More type annotation futzing

apsw.no_change is impossible to reference in a way
that keeps sphinx and mypy happy

Author: rogerbinns

doc/conf.py

@@ -25,6 +25,11 @@ def split(self, input):
     "sphinx.ext.autosummary",
 ]
 
+# this shows shorter names like Buffer instead of collections.abc.Buffer
+python_use_unqualified_type_names = True
+# less verbose Literal [ "one", "two"] -> "one" : "two"
+python_display_short_literal_types = True
+
 autodoc_preserve_defaults = True
 
 extlinks = {

src/session.c

@@ -1018,7 +1018,7 @@ APSWTableChange_indirect(PyObject *self_, void *Py_UNUSED(unused))
 }
 
 /** .. attribute:: new
-  :type: tuple[SQLiteValue | typing.Literal[apsw.no_change], ...] | None
+  :type: tuple[SQLiteValue | Literal[no_change], ...] | None
 
   :class:`None` if not applicable (like a DELETE).  Otherwise a
   tuple of the new values for the row, with :attr:`apsw.no_change`
@@ -1067,7 +1067,7 @@ APSWTableChange_new(PyObject *self_, void *Py_UNUSED(unused))
 }
 
 /** .. attribute:: old
-  :type: tuple[SQLiteValue | typing.Literal[apsw.no_change], ...] | None
+  :type: tuple[SQLiteValue | Literal[no_change], ...] | None
 
   :class:`None` if not applicable (like an INSERT).  Otherwise a tuple
   of the old values for the row before this change, with

tools/code2rst.py

@@ -229,6 +229,8 @@ def do_methods():
 
         # insert index stuff
         op.extend(indexop)
+        # we need full buffer name
+        dec = re.sub(r"\bBuffer\b", "collections.abc.Buffer", dec)
         # insert classname into dec
         if curclass:
             dec = re.sub(r"^(\.\.\s+(method|attribute)::\s+)()", r"\1" + curclass + ".", dec)