Merge branch 'master' into post-processors-priority

.github/workflows/unit.yaml

@@ -46,7 +46,7 @@ jobs:
         tox -e test
 
     - name: Run unit tests with latest Twisted version
-      if: matrix.python-version != '3.6' && matrix.python-version != 'pypy-3.6'
+      if: matrix.python-version != '3.7' && matrix.python-version != '3.6' && matrix.python-version != 'pypy-3.6'
       run: |
         tox -e test-latest-twisted
 

README.rst

@@ -88,6 +88,7 @@ in development
 * Improve the class hierarchy such that it links top level names with intersphinx when possible.
 * Add highlighting when clicking on "View In Hierarchy" link from class page.
 * Recognize variadic generics type variables (PEP 646).
+* Fix support for introspection of cython3 generated modules.
 
 pydoctor 23.4.1
 ^^^^^^^^^^^^^^^

pydoctor/model.py

@@ -1257,8 +1257,11 @@ def _introspectThing(self, thing: object, parent: CanContainImportsDocumentable,
         for k, v in thing.__dict__.items():
             if (isinstance(v, func_types)
                     # In PyPy 7.3.1, functions from extensions are not
-                    # instances of the abstract types in func_types
-                    or (hasattr(v, "__class__") and v.__class__.__name__ == 'builtin_function_or_method')):
+                    # instances of the abstract types in func_types, it will have the type 'builtin_function_or_method'.
+                    # Additionnaly cython3 produces function of type 'cython_function_or_method', 
+                    # so se use a heuristic on the class name as a fall back detection.
+                    or (hasattr(v, "__class__") and 
+                        v.__class__.__name__.endswith('function_or_method'))):
                 f = self.Function(self, k, parent)
                 f.parentMod = parentMod
                 f.docstring = v.__doc__

pydoctor/sphinx_ext/build_apidocs.py

@@ -49,7 +49,7 @@ def on_build_finished(app: Sphinx, exception: Exception) -> None:
 
     runs = app.config.pydoctor_args
     placeholders = {
-        'outdir': app.outdir,
+        'outdir': str(app.outdir),
         }
 
     if not isinstance(runs, Mapping):
@@ -86,7 +86,7 @@ def on_builder_inited(app: Sphinx) -> None:
         raise ConfigError("Missing 'pydoctor_args'.")
 
     placeholders = {
-        'outdir': app.outdir,
+        'outdir': str(app.outdir),
         }
 
     runs = config.pydoctor_args

readthedocs.yml

@@ -4,9 +4,12 @@ version: 2
 sphinx:
   fail_on_warning: false
 
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
 python:
-  version: 3.8
-  system_packages: false
   install:
     - method: pip
       path: .

setup.cfg

@@ -66,9 +66,9 @@ test =
     coverage
     pytest
     hypothesis
-    cython-test-exception-raiser==1.0.0
+    cython-test-exception-raiser
     bs4
-    Sphinx>=3.5
+    Sphinx<7.0.0
     pytest-subtests
 
 [options.entry_points]