Prevent a TypeError: 'NoneType' object is not callable when ``shu…

…til_rmtree`` is called without an ``onexc`` parameter on Python<=3.11

newsfragments/4382.bugfix.rst

@@ -0,0 +1 @@
+Prevent a ``TypeError: 'NoneType' object is not callable`` when ``shutil_rmtree`` is called without an ``onexc`` parameter on Python<=3.11 -- by :user:`Avasam`

setuptools/compat/py311.py

@@ -1,12 +1,26 @@
-import sys
+from __future__ import annotations
+
 import shutil
+import sys
+from typing import TYPE_CHECKING
+from collections.abc import Callable
+from typing import Any
+
+if TYPE_CHECKING:
+    from _typeshed import StrOrBytesPath, ExcInfo
 
 
-def shutil_rmtree(path, ignore_errors=False, onexc=None):
+def shutil_rmtree(
+    path: StrOrBytesPath,
+    ignore_errors: bool = False,
+    onexc: shutil._OnExcCallback | None = None,
+) -> None:
     if sys.version_info >= (3, 12):
         return shutil.rmtree(path, ignore_errors, onexc=onexc)
 
-    def _handler(fn, path, excinfo):
-        return onexc(fn, path, excinfo[1])
+    def _handler(fn: Callable[..., Any], path: str, excinfo: ExcInfo) -> None:
+        if onexc:
+            # type-ignore fixed in https://github.com/python/typeshed/pull/12002
+            onexc(fn, path, excinfo[1])  # type: ignore[arg-type]
 
     return shutil.rmtree(path, ignore_errors, onerror=_handler)