feat: P1 developer experience improvements#599
Merged
Chemaclass merged 7 commits intomainfrom Mar 8, 2026
Merged
Conversation
Adds -j/--jobs <N> flag that enables parallel mode with a maximum of N concurrent jobs. Uses a job-slot mechanism that polls running background jobs before spawning new ones. Prevents resource exhaustion on systems with limited memory when running large test suites in parallel.
Adds -w/--watch flag that monitors test and source files for changes and automatically re-runs the test suite when modifications are detected. Uses file modification times for efficient polling.
When a test fails, the failure summary now shows the assertion lines from the test function, making it easier to identify which assertion caused the failure without opening the source file.
Adds TAP version 13 compliant output with --output tap flag. Includes test plan, ok/not ok lines, YAML diagnostics for failures, and proper SKIP/TODO directives.
Contributor
✅ Contributor ReportUser: @Chemaclass This user is on the trusted contributors list and was automatically approved. |
Merge origin/main into feat/p1-developer-experience. Combines --jobs wait_for_job_slot with cached function discovery parameter, and merges CHANGELOG entries.
JesusValeraDev
approved these changes
Mar 8, 2026
| --exclude-tag <name> Skip tests with matching @tag (repeatable, exclude wins) | ||
| --log-junit <file> Write JUnit XML report | ||
| -p, --parallel Run tests in parallel | ||
| -j, --jobs <N> Run tests in parallel with max N concurrent jobs |
Collaborator
There was a problem hiding this comment.
Is the documentation updated?
Member
Author
There was a problem hiding this comment.
Updated! Added --jobs documentation to both docs/command-line.md (options table + dedicated section) and docs/configuration.md (BASHUNIT_PARALLEL_JOBS env var).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Developer experience improvements focused on workflow and debugging:
--jobs Nflag — Limit parallel test concurrency to N jobs (e.g.,--jobs 4)--watchmode — Automatically re-run tests when files change (--watch)--output tapfor CI/CD integrationCommits
feat(cli): add --jobs N flag to limit parallel concurrencyfeat(cli): add --watch mode for automatic test re-runsfeat(runner): show source context in failure summaryfeat(cli): add TAP output format via --output tapTest plan
[[]]used only where existing)