Work around pydoctor bug parsing binary .so files

pydoctor's _parseFile only catches SyntaxError, but binary .so files
raise UnicodeDecodeError via tokenize.open(), leaving the `parsed`
variable unassigned and crashing in the finally block with
UnboundLocalError. Patch the installed pydoctor to also catch
UnicodeDecodeError so introspection can fall back to importing.

Author: jelmer

.github/workflows/pydoctor.yml

@@ -37,9 +37,12 @@ jobs:
         pip install pydoctor
     - name: Build API docs
       run: |
-        # Remove non-Python .so files (Rust proc-macro build artifacts) that
-        # confuse pydoctor's introspection
+        # Remove Rust proc-macro .so build artifacts that confuse pydoctor
         find subvertpy -name 'lib*.so' -delete
+        # Work around pydoctor bug: _parseFile only catches SyntaxError but
+        # binary .so files raise UnicodeDecodeError, causing an UnboundLocalError crash.
+        sed -i 's/except SyntaxError/except (SyntaxError, UnicodeDecodeError)/g' \
+          "$(python -c 'import pydoctor.astbuilder; print(pydoctor.astbuilder.__file__)')"
         pydoctor --introspect-c-modules -c subvertpy.cfg --make-html subvertpy
     - name: Upload Pages artifact
       uses: actions/upload-pages-artifact@v3