**Warning: this project is still in very early development!**
npm install fairspliceWarning: this project is still in very early development!
Fairsplice is a CLI tool designed to optimize test distribution across multiple workers. By intelligently splitting and saving test cases, Fairsplice ensures a balanced workload distribution for your CI/CD pipelines, making tests run time more predictable.
We found Github Actions lacking when compared to CircleCI which has tests splitting based on timings.
There are a number of projects like Split tests but they require uploading and downloading Junit XML files and merging them, or committing the Junit files to have them when running the tests.
This tool uses instead a Redis server to store the last 10 timings for each test file and uses the average of these to split tests. It is easy to setup if you have a Redis server running.
This project is built using Bun and Redis.
Ensure you have Bun installed.
To launch it, run
``bash`
bunx fairsplice
Before using Fairsplice, set the environment variable FAIRSPLICE_REDIS_URL to your Redis server URL. This is necessary for storing and retrieving test case information.
`bash`
export FAIRSPLICE_REDIS_URL='redis://myuser:mypassword@your-redis-url.upstash.io:33683'
Fairsplice supports two main commands: save and split.
To save test results:
`bash`
fairsplice save --from
- --from : Specify the file path to read test results from.
Example:
`bash`
fairsplice save --from results/junit.xml
To split test cases for execution:
`bash`
fairsplice split --pattern "
- --pattern ": Pattern to match test files. Can be used multiple times to specify multiple patterns.--total
- : Total number of workers in the test environment.--out
- : File to write split test files to (newline separated)--replace-from
- : Substring to replace in the file paths (can be used multiple times)--replace-to
- : Replacement for the substring (can be used multiple times but must match the number of --replace-from)
Example:
`bash`
fairsplice split --pattern "test_.py" --pattern "tests.py" --total 3 --out split.json
For a detailed list of commands and options, use the help command:
`bash`
fairsplice --help
Contributions are welcome! Please fork the repository and submit a pull request with your improvements.
Launch the development version with:
`bash`
bun run index.ts
Launch the following command to run tests:
`bash``
bun test [--watch]
Fairsplice is open-source software licensed under the MIT license.