https://github.com/juliatesting/paralleltestrunner.jl
https://github.com/juliatesting/paralleltestrunner.jl
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/juliatesting/paralleltestrunner.jl
- Owner: JuliaTesting
- License: other
- Created: 2025-10-06T12:16:55.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-11T09:25:10.000Z (8 months ago)
- Last Synced: 2025-10-11T12:14:22.136Z (8 months ago)
- Language: Julia
- Size: 44.9 KB
- Stars: 4
- Watchers: 4
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ParallelTestRunner.jl
[](https://juliatesting.github.io/ParallelTestRunner.jl/)
[](https://juliatesting.github.io/ParallelTestRunner.jl/dev)
Simple parallel test runner for Julia tests with autodiscovery.
## Usage
The main entry point of `ParallelTestRunner` is the exported function `runtests`, which takes two mandatory arguments:
* the module for which you want to run the tests
* the list of arguments passed to the test script, as a `Vector{String}`, this will typically be [`Base.ARGS`](https://docs.julialang.org/en/v1/base/constants/#Base.ARGS).
With the `--help` flag you can print a help message:
```julia
julia> using ParallelTestRunner
julia> ParallelTestRunner.runtests(ParallelTestRunner, ["--help"])
Usage: runtests.jl [--help] [--list] [--jobs=N] [TESTS...]
--help Show this text.
--list List all available tests.
--verbose Print more information during testing.
--quickfail Fail the entire run as soon as a single test errored.
--jobs=N Launch `N` processes to perform tests.
Remaining arguments filter the tests that will be executed.
```
## Setup
`ParallelTestRunner` runs each file inside your `test/` concurrently and isolated.
First you should remove all `include` statements that you added.
Then in your `test/runtests.jl` add:
```julia
using MyModule
using ParallelTestRunner
runtests(MyModule, ARGS)
```
## Documentation
For more details about the use of this package, read the [documentation](https://juliatesting.github.io/ParallelTestRunner.jl/).
## Inspiration
Based on [@maleadt](https://github.com/maleadt) test infrastructure for [CUDA.jl](https://github.com/JuliaGPU/CUDA.jl).