fix: Increase maximum recursion limit in case of deeply nested ASTs (rare occurrence)

pawamoy · pawamoy · commit 6004ccf3576c · 2025-08-24T19:28:53.000+02:00
Issue-griffe-402: mkdocstrings/griffe#402
diff --git a/src/mkdocstrings_handlers/python/_internal/handler.py b/src/mkdocstrings_handlers/python/_internal/handler.py
@@ -408,6 +408,10 @@ def get_handler(
     Returns:
         An instance of `PythonHandler`.
     """
+    # In rare cases, Griffe hits the recursion limit because of deeply-nested ASTs.
+    # We therefore increase the limit here, once, before Griffe is used to collect or render stuff.
+    sys.setrecursionlimit(max(sys.getrecursionlimit(), 2000))
+
     base_dir = Path(tool_config.config_file_path or "./mkdocs.yml").parent
     if "inventories" not in handler_config and "import" in handler_config:
         warn("The 'import' key is renamed 'inventories' for the Python handler", FutureWarning, stacklevel=1)
