Skip to content

docs: record parallel fork budget and the mktemp-uniqueness constraint#814

Merged
Chemaclass merged 1 commit into
mainfrom
docs/fork-budget-parallel-update
Jul 16, 2026
Merged

docs: record parallel fork budget and the mktemp-uniqueness constraint#814
Chemaclass merged 1 commit into
mainfrom
docs/fork-budget-parallel-update

Conversation

@Chemaclass

Copy link
Copy Markdown
Member

🤔 Background

Follow-up to #812/#813: the fork-budget rule predates the parallel-mode profiling and says "per-test cost is fork-free", which is inaccurate for --parallel (one mktemp per test remains, for a provable reason).

💡 Changes

  • Adds the perf(runner): stop forking per test when publishing parallel results #813 replacement patterns (parent pre-creates the workers' dir; skip sanitizing on empty input) and the measured parallel budget (61 → 21 forks per 10-test run).
  • Documents why the per-test mktemp can't become a deterministic name on Bash 3 ($$/RANDOM shared by subshells, BASHPID is 4.0+) and two explicit don't-fix notes (wait_for_job_slot, spinner).

Updates the fork-budget rule with the #813 results: the parallel per-test
publishing patterns (parent pre-creates the workers' dir; skip sanitizing on
empty input), the measured parallel budget (61 -> 21 forks per 10-test run),
why the remaining per-test mktemp cannot become a deterministic name on Bash 3
(subshells share $$ and RANDOM state; BASHPID is 4.0+), and two explicit
don't-fix notes (wait_for_job_slot, spinner).
@Chemaclass Chemaclass added the documentation Improvements or additions to documentation label Jul 16, 2026
@Chemaclass Chemaclass self-assigned this Jul 16, 2026
@Chemaclass Chemaclass merged commit a88dc86 into main Jul 16, 2026
6 checks passed
@Chemaclass Chemaclass deleted the docs/fork-budget-parallel-update branch July 16, 2026 03:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant