noxfile: Add additional args, support no-parallel

- Pass positional arguments to pytest

- --no-parallel makes tests not run in parallel

- manually handle -n and add maxschedchunk

Author: datalogics-kam

noxfile.py

@@ -1,3 +1,5 @@
+import argparse
+
 import nox
 
 nox.options.default_venv_backend = "uv"
@@ -7,6 +9,24 @@
 
 @nox.session(name="tests", python=python_versions, reuse_venv=True)
 def tests(session: nox.Session) -> None:
+    # Define only custom flags
+    parser = argparse.ArgumentParser(add_help=False)
+    parser.add_argument("--no-parallel", action="store_true")
+    parser.add_argument(
+        "-n", "--workers", "--numprocesses"
+    )  # e.g., -n 4 to set workers
+    custom, remaining = parser.parse_known_args(session.posargs)
+
+    pytest_args = list(remaining)
+
+    # Default to parallel unless disabled or overridden
+    if custom.no_parallel:
+        pass
+    elif custom.workers:
+        pytest_args[:0] = ["-n", custom.workers, "--maxschedchunk", "2"]
+    else:
+        pytest_args[:0] = ["-n", "8", "--maxschedchunk", "2"]
+
     session.run_install(
         "uv",
         "sync",
@@ -20,8 +40,5 @@ def tests(session: nox.Session) -> None:
         "pytest",
         "--cov=pdfrest",
         "--cov-report=term-missing",
-        "--numprocesses",
-        "8",
-        "--maxschedchunk",
-        "2",
+        *pytest_args,
     )