Improve test runner speed

.github/copilot-instructions.md

@@ -50,10 +50,10 @@ pip install flask sanic tornado
 
 **Run Python Tests:**
 
--   `hatch test` -- takes 10-30 seconds for basic tests. NEVER CANCEL. Set timeout to 60+ minutes for full test suite. **All tests must always pass - failures are never expected or allowed.**
--   `hatch test --cover` -- run tests with coverage reporting (used in CI)
--   `hatch test -k test_name` -- run specific tests
--   `hatch test tests/test_config.py` -- run specific test files
+-   `hatch test --parallel` -- takes 10-30 seconds for basic tests. NEVER CANCEL. Set timeout to 2 minutes for full test suite. **All tests must always pass - failures are never expected or allowed.**
+-   `hatch test --parallel --cover` -- run tests with coverage reporting (used in CI)
+-   `hatch test --parallel -k test_name` -- run specific tests
+-   `hatch test --parallel tests/test_config.py` -- run specific test files
 
 **Run Python Linting and Formatting:**
 
@@ -152,7 +152,7 @@ print(f"✓ Hook-based component: {type(counter)}")
 -   `hatch run javascript:check` -- Ensure JavaScript passes linting (never expected to fail)
 -   Test basic component creation and rendering as shown above
 -   Test server creation if working on server-related features
--   Run relevant tests with `hatch test` -- **All tests must always pass - failures are never expected or allowed**
+-   Run relevant tests with `hatch test --parallel` -- **All tests must always pass - failures are never expected or allowed**
 
 **Integration Testing:**
 
@@ -263,9 +263,9 @@ The following are key commands for daily development:
 ### Development Commands
 
 ```bash
-hatch test                          # Run all tests (**All tests must always pass**)
-hatch test --cover                  # Run tests with coverage (used in CI)
-hatch test -k test_name             # Run specific tests
+hatch test --parallel                          # Run all tests (**All tests must always pass**)
+hatch test --parallel --cover                  # Run tests with coverage (used in CI)
+hatch test --parallel -k test_name             # Run specific tests
 hatch fmt                           # Format code with all formatters
 hatch fmt --check                   # Check formatting without changes
 hatch run python:type_check         # Run Python type checker
@@ -303,7 +303,7 @@ Follow this step-by-step process for effective development:
 3. **Run formatting**: `hatch fmt` to format code (~1 second)
 4. **Run type checking**: `hatch run python:type_check` for type checking (~10 seconds)
 5. **Run JavaScript linting** (if JavaScript was modified): `hatch run javascript:check` (~10 seconds)
-6. **Run relevant tests**: `hatch test` with specific test selection if needed. **All tests must always pass - failures are never expected or allowed.**
+6. **Run relevant tests**: `hatch test --parallel` with specific test selection if needed. **All tests must always pass - failures are never expected or allowed.**
 7. **Validate component functionality** manually using validation tests above
 8. **Build JavaScript** (if modified): `hatch run javascript:build` (~15 seconds)
 9. **Update documentation** when making changes to Python source code (required)
@@ -365,7 +365,7 @@ Modern dependency management via pyproject.toml:
 
 The repository uses GitHub Actions with these key jobs:
 
--   `test-python-coverage` -- Python test coverage with `hatch test --cover`
+-   `test-python-coverage` -- Python test coverage with `hatch test --parallel --cover`
 -   `lint-python` -- Python linting and type checking via `hatch fmt --check` and `hatch run python:type_check`
 -   `test-python` -- Cross-platform Python testing across Python 3.10-3.13 and Ubuntu/macOS/Windows
 -   `lint-javascript` -- JavaScript linting and type checking

.github/workflows/.hatch-run.yml

@@ -35,13 +35,20 @@ jobs:
         runs-on: ${{ matrix.runs-on }}
         steps:
             - uses: actions/checkout@v4
+            - if: runner.os == 'Windows'
+              name: Cache Playwright Install
+              uses: actions/cache@v5
+              with:
+                  path: C:\Users\runneradmin\AppData\Local\ms-playwright\
+                  key: ${{ runner.os }}-playwright
             - uses: oven-sh/setup-bun@v2
               with:
                   bun-version: latest
             - name: Use Python ${{ matrix.python-version }}
               uses: actions/setup-python@v5
               with:
                   python-version: ${{ matrix.python-version }}
+                  cache: "pip"
             - name: Install Python Dependencies
               run: pip install hatch
             - name: Run Scripts

.github/workflows/check.yml

@@ -15,7 +15,7 @@ jobs:
         uses: ./.github/workflows/.hatch-run.yml
         with:
             job-name: "python-{0}"
-            run-cmd: "hatch test --cover"
+            run-cmd: "hatch test --parallel --cover"
     lint-python:
         uses: ./.github/workflows/.hatch-run.yml
         with:
@@ -25,7 +25,7 @@ jobs:
         uses: ./.github/workflows/.hatch-run.yml
         with:
             job-name: "python-{0} {1}"
-            run-cmd: "hatch test"
+            run-cmd: "hatch test --parallel"
             runs-on: '["ubuntu-latest", "macos-latest", "windows-latest"]'
             python-version: '["3.11", "3.12", "3.13", "3.14"]'
     test-documentation:

.github/workflows/publish.yml

@@ -10,7 +10,7 @@ jobs:
         uses: ./.github/workflows/.hatch-run.yml
         with:
             job-name: "Publish to PyPI"
-            run-cmd: "hatch build --clean && hatch publish --yes"
+            run-cmd: "hatch run javascript:build && hatch build --clean && hatch publish --yes"
         secrets:
             pypi-username: ${{ secrets.PYPI_USERNAME }}
             pypi-password: ${{ secrets.PYPI_PASSWORD }}

pyproject.toml

@@ -1,6 +1,6 @@
 [build-system]
 build-backend = "hatchling.build"
-requires = ["hatchling", "hatch-build-scripts"]
+requires = ["hatchling", "hatch-build-scripts", "hatch"]
 
 ##############################
 # >>> Hatch Build Config <<< #
@@ -71,28 +71,34 @@ installer = "uv"
 reactpy = "reactpy._console.cli:entry_point"
 
 [[tool.hatch.build.hooks.build-scripts.scripts]]
-# Note: `hatch` can't be called within `build-scripts` when installing packages in editable mode, so we have to write the commands long-form
-commands = [
-  'python "src/build_scripts/clean_js_dir.py"',
-  'bun install --cwd "src/js/packages/event-to-object"',
-  'bun run --cwd "src/js/packages/event-to-object" build',
-  'bun install --cwd "src/js/packages/@reactpy/client"',
-  'bun run --cwd "src/js/packages/@reactpy/client" build',
-  'bun install --cwd "src/js/packages/@reactpy/app"',
-  'bun run --cwd "src/js/packages/@reactpy/app" build',
-  'python "src/build_scripts/copy_dir.py" "src/js/node_modules/@pyscript/core/dist" "src/reactpy/static/pyscript"',
-  'python "src/build_scripts/copy_dir.py" "src/js/node_modules/morphdom/dist" "src/reactpy/static/morphdom"',
-]
+commands = []
 artifacts = []
 
 #############################
 # >>> Hatch Test Runner <<< #
 #############################
+[tool.hatch.envs.hatch-test.scripts]
+run = [
+  'hatch --env default run "src/build_scripts/install_playwright.py"',
+  "hatch --env default run javascript:build --dev",
+  "hatch --env default build -t wheel",
+  "pytest{env:HATCH_TEST_ARGS:} {args} --max-worker-restart 10",
+]
+run-cov = [
+  'hatch --env default run "src/build_scripts/install_playwright.py"',
+  "hatch --env default run javascript:build --dev",
+  "hatch --env default build -t wheel",
+  'hatch --env default run "src/build_scripts/delete_old_coverage.py"',
+  "coverage run -m pytest{env:HATCH_TEST_ARGS:} {args} --max-worker-restart 10",
+]
+cov-combine = "coverage combine"
+cov-report = "coverage report"
 
 [tool.hatch.envs.hatch-test]
 extra-dependencies = [
   "pytest-sugar",
   "pytest-asyncio",
+  "pytest-timeout",
   "responses",
   "exceptiongroup",
   "jsonpointer",
@@ -115,8 +121,10 @@ filterwarnings = """
 testpaths = "tests"
 xfail_strict = true
 asyncio_mode = "auto"
-asyncio_default_fixture_loop_scope = "function"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
 log_cli_level = "INFO"
+timeout = 120
 
 #######################################
 # >>> Hatch Documentation Scripts <<< #
@@ -162,6 +170,7 @@ extra-dependencies = [
   "types-requests",
   "types-lxml",
   "jsonpointer",
+  "pytest",
 ]
 
 [tool.hatch.envs.python.scripts]
@@ -177,33 +186,28 @@ detached = true
 [tool.hatch.envs.javascript.scripts]
 check = [
   'hatch run javascript:build',
-  'bun install --cwd "src/js"',
   'bun run --cwd "src/js" lint',
   'bun run --cwd "src/js/packages/event-to-object" checkTypes',
   'bun run --cwd "src/js/packages/@reactpy/client" checkTypes',
   'bun run --cwd "src/js/packages/@reactpy/app" checkTypes',
 ]
 fix = ['bun install --cwd "src/js"', 'bun run --cwd "src/js" format']
-test = ['hatch run javascript:build_event_to_object', 'bun test']
+test = ['hatch run javascript:build_event_to_object --dev', 'bun test']
 build = [
   'hatch run "src/build_scripts/clean_js_dir.py"',
   'bun install --cwd "src/js"',
-  'hatch run javascript:build_event_to_object',
-  'hatch run javascript:build_client',
-  'hatch run javascript:build_app',
+  'hatch run javascript:build_event_to_object {args}',
+  'hatch run javascript:build_client {args}',
+  'hatch run javascript:build_app {args}',
+  'hatch --env default run "src/build_scripts/copy_dir.py" "src/js/node_modules/@pyscript/core/dist" "src/reactpy/static/pyscript"',
+  'hatch --env default run "src/build_scripts/copy_dir.py" "src/js/node_modules/morphdom/dist" "src/reactpy/static/morphdom"',
+
 ]
 build_event_to_object = [
-  'bun install --cwd "src/js/packages/event-to-object"',
-  'bun run --cwd "src/js/packages/event-to-object" build',
-]
-build_client = [
-  'bun install --cwd "src/js/packages/@reactpy/client"',
-  'bun run --cwd "src/js/packages/@reactpy/client" build',
-]
-build_app = [
-  'bun install --cwd "src/js/packages/@reactpy/app"',
-  'bun run --cwd "src/js/packages/@reactpy/app" build',
+  'hatch run "src/build_scripts/build_js_event_to_object.py" {args}',
 ]
+build_client = ['hatch run "src/build_scripts/build_js_client.py" {args}']
+build_app = ['hatch run "src/build_scripts/build_js_app.py" {args}']
 publish_event_to_object = [
   'hatch run javascript:build_event_to_object',
   'cd "src/js/packages/event-to-object" && bun publish --access public',

src/build_scripts/build_js_app.py

@@ -0,0 +1,30 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+import pathlib
+import subprocess
+import sys
+
+dev_mode = "--dev" in sys.argv
+root_dir = pathlib.Path(__file__).parent.parent.parent
+build_commands = [
+    [
+        "bun",
+        "install",
+        "--cwd",
+        "src/js/packages/@reactpy/app",
+        *([] if dev_mode else ["--production"]),
+    ],
+    [
+        "bun",
+        "run",
+        "--cwd",
+        "src/js/packages/@reactpy/app",
+        "buildDev" if dev_mode else "build",
+    ],
+]
+
+for command in build_commands:
+    print(f"Running command: '{command}'...")  # noqa: T201
+    subprocess.run(command, check=True, cwd=root_dir)  # noqa: S603

src/build_scripts/build_js_client.py

@@ -0,0 +1,30 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+import pathlib
+import subprocess
+import sys
+
+dev_mode = "--dev" in sys.argv
+root_dir = pathlib.Path(__file__).parent.parent.parent
+build_commands = [
+    [
+        "bun",
+        "install",
+        "--cwd",
+        "src/js/packages/@reactpy/client",
+        *([] if dev_mode else ["--production"]),
+    ],
+    [
+        "bun",
+        "run",
+        "--cwd",
+        "src/js/packages/@reactpy/client",
+        "build",
+    ],
+]
+
+for command in build_commands:
+    print(f"Running command: '{command}'...")  # noqa: T201
+    subprocess.run(command, check=True, cwd=root_dir)  # noqa: S603

src/build_scripts/build_js_event_to_object.py

@@ -0,0 +1,30 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+import pathlib
+import subprocess
+import sys
+
+dev_mode = "--dev" in sys.argv
+root_dir = pathlib.Path(__file__).parent.parent.parent
+build_commands = [
+    [
+        "bun",
+        "install",
+        "--cwd",
+        "src/js/packages/event-to-object",
+        *([] if dev_mode else ["--production"]),
+    ],
+    [
+        "bun",
+        "run",
+        "--cwd",
+        "src/js/packages/event-to-object",
+        "build",
+    ],
+]
+
+for command in build_commands:
+    print(f"Running command: '{command}'...")  # noqa: T201
+    subprocess.run(command, check=True, cwd=root_dir)  # noqa: S603

src/build_scripts/clean_js_dir.py

@@ -11,6 +11,8 @@
 import pathlib
 import shutil
 
+print("Cleaning JS source directory...")  # noqa: T201
+
 # Get the path to the JS source directory
 js_src_dir = pathlib.Path(__file__).parent.parent / "js"
 static_output_dir = pathlib.Path(__file__).parent.parent / "reactpy" / "static"

src/build_scripts/copy_dir.py

@@ -31,6 +31,7 @@ def copy_files(source: Path, destination: Path) -> None:
     root_dir = Path(__file__).parent.parent.parent
     src = Path(root_dir / sys.argv[1])
     dest = Path(root_dir / sys.argv[2])
+    print(f"Copying files from '{sys.argv[1]}' to '{sys.argv[2]}'...")  # noqa: T201
 
     if not src.exists():
         logging.error("Source directory %s does not exist", src)

src/build_scripts/delete_old_coverage.py

@@ -0,0 +1,21 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+
+import logging
+from glob import glob
+from pathlib import Path
+
+# Delete old `.coverage*` files in the project root
+print("Deleting old coverage files...")  # noqa: T201
+root_dir = Path(__file__).parent.parent.parent
+coverage_files = glob(str(root_dir / ".coverage*"))
+
+for path in coverage_files:
+    coverage_file = Path(path)
+    if coverage_file.exists():
+        try:
+            coverage_file.unlink()
+        except Exception as e:
+            logging.error(f"Failed to delete {coverage_file}: {e}")

src/build_scripts/install_playwright.py

@@ -0,0 +1,17 @@
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
+
+import subprocess
+
+print("Installing Playwright browsers...")  # noqa: T201
+
+# Install Chromium browser for Playwright, and fail if it cannot be installed
+subprocess.run(["playwright", "install", "chromium"], check=True)  # noqa: S607
+
+# Try to install system dependencies. We don't generate an exception if this fails
+# as *nix systems (such as WSL) return a failure code if there are *any* dependencies
+# that could be cleaned up via `sudo apt autoremove`. This occurs even if we weren't
+# the ones to install those dependencies in the first place.
+subprocess.run(["playwright", "install-deps"], check=False)  # noqa: S607

src/js/package.json

@@ -1,7 +1,8 @@
 {
   "workspaces": [
-    "packages/*",
-    "packages/@reactpy/*"
+    "packages/event-to-object",
+    "packages/@reactpy/app",
+    "packages/@reactpy/client"
   ],
   "catalog": {
     "preact": "^10.27.2",

src/js/packages/@reactpy/app/package.json

@@ -13,7 +13,8 @@
   "license": "MIT",
   "name": "@reactpy/app",
   "scripts": {
-    "build": "bun build \"src/index.ts\" \"src/react.ts\" \"src/react-dom.ts\" \"src/react-jsx-runtime.ts\" --outdir=\"../../../../reactpy/static/\" --minify --sourcemap=\"linked\" --splitting",
+    "build": "bun build \"src/index.ts\" \"src/preact.ts\" \"src/preact-dom.ts\" \"src/preact-jsx-runtime.ts\"  --outdir=\"../../../../reactpy/static/\" --minify --production --sourcemap=\"linked\" --splitting",
+    "buildDev": "bun build \"src/index.ts\" \"src/preact.ts\" \"src/preact-dom.ts\" \"src/preact-jsx-runtime.ts\" --outdir=\"../../../../reactpy/static/\" --sourcemap=\"linked\" --splitting",
     "checkTypes": "tsc --noEmit"
   }
 }

src/js/packages/@reactpy/app/src/preact-jsx-runtime.ts

@@ -0,0 +1 @@
+export * from "preact/compat/jsx-runtime";