Point contributors at scripts/test; keep a test's quoted tutorial line in sync

maxisbey · maxisbey · commit 1bc867059bc3 · 2026-08-14T13:42:57.000Z
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -86,10 +86,10 @@ uv tool install pre-commit --with pre-commit-uv --force-reinstall
 
 3. Make your changes
 
-4. Ensure tests pass:
+4. Ensure tests pass (`scripts/test` runs them the way CI does, with coverage):
 
 ```bash
-uv run pytest
+./scripts/test
 ```
 
 5. Run type checking:
diff --git a/tests/docs_src/test_uri_templates.py b/tests/docs_src/test_uri_templates.py
@@ -129,7 +129,7 @@ def test_dotdot_is_a_component_check_not_a_substring_scan() -> None:
 async def test_safe_join_serves_a_file_inside_the_base_directory(
     tmp_path: Path, monkeypatch: pytest.MonkeyPatch
 ) -> None:
-    """tutorial002: `safe_join(DOCS_ROOT, path).read_text()` returns the file under the base."""
+    """tutorial002: `safe_join(DOCS_ROOT, path).read_text(encoding="utf-8")` returns the file under the base."""
     (tmp_path / "printing").mkdir()
     (tmp_path / "printing" / "setup.md").write_text("# Printer setup", encoding="utf-8")
     monkeypatch.setattr(tutorial002, "DOCS_ROOT", tmp_path)
