Fix typing, lint, and docs checks

Author: tobiasraabe

pyproject.toml

@@ -33,7 +33,7 @@ docs = [
     "matplotlib",
     "myst-parser",
     "nbsphinx",
-    "sphinx",
+    "sphinx<9",
     "sphinx-autobuild",
     "sphinx-click",
     "sphinx-copybutton",

src/pytask_parallel/backends.py

@@ -29,7 +29,7 @@
     "set_worker_root",
 ]
 
-_WORKER_ROOT: str | None = None
+_WORKER_STATE: dict[str, str | None] = {"root": None}
 
 
 def set_worker_root(path: os.PathLike[str] | str) -> None:
@@ -40,9 +40,8 @@ def set_worker_root(path: os.PathLike[str] | str) -> None:
     task modules are importable by reference, which avoids pickling module globals.
 
     """
-    global _WORKER_ROOT
     root = os.fspath(path)
-    _WORKER_ROOT = root
+    _WORKER_STATE["root"] = root
     if root not in sys.path:
         sys.path.insert(0, root)
     # Ensure custom process backends can import task modules by reference.
@@ -117,14 +116,18 @@ def _get_dask_executor(n_workers: int) -> Executor:
 def _get_loky_executor(n_workers: int) -> Executor:
     """Get a loky executor."""
     return get_reusable_executor(
-        max_workers=n_workers, initializer=_configure_worker, initargs=(_WORKER_ROOT,)
+        max_workers=n_workers,
+        initializer=_configure_worker,
+        initargs=(_WORKER_STATE["root"],),
     )
 
 
 def _get_process_pool_executor(n_workers: int) -> Executor:
     """Get a process pool executor."""
     return _CloudpickleProcessPoolExecutor(
-        max_workers=n_workers, initializer=_configure_worker, initargs=(_WORKER_ROOT,)
+        max_workers=n_workers,
+        initializer=_configure_worker,
+        initargs=(_WORKER_STATE["root"],),
     )
 
 

src/pytask_parallel/wrappers.py

@@ -217,7 +217,7 @@ def _render_traceback_to_string(
     traceback = Traceback(exc_info, show_locals=show_locals)
     segments = console.render(cast("Any", traceback), options=console_options)
     text = "".join(segment.text for segment in segments)
-    return (*exc_info[:2], text)  # ty: ignore[invalid-return-type]
+    return (*exc_info[:2], text)
 
 
 def _handle_function_products(