Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lothiraldan/balto
BAlto is a Language independent Test Orchestrator
https://github.com/lothiraldan/balto
test-runner testing testing-tools
Last synced: 3 days ago
JSON representation
BAlto is a Language independent Test Orchestrator
- Host: GitHub
- URL: https://github.com/lothiraldan/balto
- Owner: Lothiraldan
- License: mit
- Created: 2017-08-14T21:50:56.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-04T10:30:18.000Z (2 months ago)
- Last Synced: 2024-10-29T21:11:22.548Z (9 days ago)
- Topics: test-runner, testing, testing-tools
- Language: JavaScript
- Homepage: https://lothiraldan.github.io/balto/
- Size: 2.64 MB
- Stars: 21
- Watchers: 3
- Forks: 5
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
#  BALTO
[](#contributors-)
`BAlto is a Language independent Test Orchestrator` is an unique tool to drive
all your test-runners with one common interface.
## Installation
Install balto with [pipx](https://github.com/cs01/pipx):
```bash
pipx install balto
```
You should see at the end of the command:
```
These binaries are now globally available
- balto
- balto-curses
- balto-server
done! ✨ 🌟 ✨
```
It is highly recommended to avoid installing Balto in either your global Python environment or a virtual environment as it might causes conflicts with some dependencies.
## Usage
To use it, point balto to a directory containing a `.balto.toml` file:
```bash
balto tests/
```
The `.balto.toml` file should look like:
```toml
name = "Acceptance Test Suite Subprocess"
tool = "pytest"
```
If you just want to give Balto a try, you can use the `--tool` to indicate which tool you want to use. For example:
```
balto --tool pytest tests
```
The tool must be one of the supported one, you can see the list here: https://github.com/lothiraldan/litf#compatible-emitters
You can test balto against examples for supported test runners. Clone this repository and launch `balto` against one of the examples directories. For `pytest`, launch:
```bash
balto examples/pytest/
```
For more help:
```bash
balto --help
```
## Development
Balto is composed of two components: the server and the web interface.
> Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. Please report unacceptable behavior to [[email protected]]([email protected]).
### Balto-server
Balto-server is a Python 3.7 project using Asyncio. To build the development version, first create a virtualenv (or equivalent):
```bash
virtualenv .venv
source .venv/bin/activate
```
Install the project in development mode:
```bash
pip install -e .
```
Then start the server:
```bash
balto-server --debug examples/pytest/
```
The server will start on port 8889.
### Web interface
The web interface is a React project communicating with the server using WebSockets. You can start developing on it with these instructions:
```bash
cd balto/web_interfaces/balto_react
yarn start
```
The web interface is then available on http://localhost:3000/ and will connect to the server started before.
Warning: the WebSocket doesn't auto-reconnect yet, sometimes your React modification requires you to reload your browser tab.
## Contributors
Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
Boris Feld
💻 🎨 📖 🤔 📢
Elias Dorneles
💻 🐛
Paul Morelle
💻
This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification. Contributions of any kind welcome!