bug: python try/except with multiple error codes leads to collection errors

[SirUli]

Description of the bug

When having a try / except with multiple error conditions to be catched, the formatting needs to be very particular to work. Unfortunately ruff 0.15.0 (currently latest) is also very particular to not accept (on Python 3.14 and later) the one that mkdocstring wants. See here. Background. As of Python 3.14, you're allowed to omit the parentheses around groups of exceptions, as long as there's no as binding.

What ruff wants: except KeyError, TypeError:
What mkdocstrings wants: except (KeyError, TypeError):

To Reproduce

Example:

 ```
try:
   ... do something ...
except KeyError, TypeError:
   ... dump the error ...
 ```

Full traceback

Full traceback

ERROR   -  mkdocstrings: some.file.core could not be found
ERROR   -  Error reading page 'reference/some/file/core.md':
ERROR   -  Could not collect 'same.file.core'

Expected behavior

Both ways work.

Environment information

python -m mkdocstrings._internal.debug  # | xclip -selection clipboard

• System: Linux-6.16.10-200.fc42.aarch64-aarch64-with
• Python: cpython 3.11.14 (/usr/local/bin/python)
• Environment variables:
• Installed packages:
  • mkdocstrings v1.0.2

[pawamoy]

Thanks for the report @SirUli 🙂 can you please include verbose logs?

mkdocstrings (Griffe) doesn't want any particular syntax: it parses code using ast. If you're making use of 3.14+ syntax, you should run mkdocstrings (Griffe) with Python 3.14+, and ast will parse those correctly, without raising SyntaxError.

[SirUli]

THANK YOU. That makes sense then and also brings a number of challenges since the container of mkdocs-material (which i used as a base) is based on a python 3.11 build. And Zensical isn't far enough to replace it. I'll dig around how i can enable python 3.14 then - most likely that is related. If that doesn't work out, i'll reopen by then :)