{ "info": { "author": "Boris Feld", "author_email": "lothiraldan@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "#  BALTO\n[](#contributors-)\n\n`BAlto is a Language independent Test Orchestrator` is an unique tool to drive\nall your test-runners with one common interface.\n\n## Installation\n\nInstall balto with [pipx](https://github.com/cs01/pipx):\n\n```bash\npipx install balto\n```\n\nYou should see at the end of the command:\n\n```\n These binaries are now globally available\n - balto\n - balto-curses\n - balto-server\ndone! \u2728 \ud83c\udf1f \u2728\n\n```\n\nIt 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.\n\n## Usage\n\nTo use it, point balto to a directory containing a `.balto.toml` file:\n \n```bash\nbalto tests/\n```\n\nThe `.balto.toml` file should look like:\n\n```toml\nname = \"Acceptance Test Suite Subprocess\"\ntool = \"pytest\"\n\n```\n\nIf you just want to give Balto a try, you can use the `--tool` to indicate which tool you want to use. For example:\n\n```\nbalto --tool pytest tests\n```\n\nThe tool must be one of the supported one, you can see the list here: https://github.com/lothiraldan/litf#compatible-emitters\n\nYou can test balto against examples for supported test runners. Clone this repository and launch `balto` against one of the examples directories. For `pytest`, launch:\n\n```bash\nbalto examples/pytest/\n```\n\nFor more help:\n\n```bash\nbalto --help\n```\n\n\n## Development\n\nBalto is composed of two components: the server and the web interface.\n\n> 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 [lothiraldan@gmail.com](lothiraldan@gmail.com).\n\n### Balto-server\n\nBalto-server is a Python 3.7 project using Asyncio. To build the development version, first create a virtualenv (or equivalent):\n\n```bash\nvirtualenv .venv\nsource .venv/bin/activate\n```\n\nInstall the project in development mode:\n\n```bash\npip install -e .\n```\n\nThen start the server:\n\n```bash\nbalto-server --debug examples/pytest/\n```\n\nThe server will start on port 8889.\n\n### Web interface\n\nThe web interface is a React project communicating with the server using WebSockets. You can start developing on it with these instructions:\n\n```bash\ncd balto/web_interfaces/balto_react\nyarn start\n```\n\nThe web interface is then available on http://localhost:3000/ and will connect to the server started before.\n\nWarning: the WebSocket doesn't auto-reconnect yet, sometimes your React modification requires you to reload your browser tab.\n\n## Contributors\n\nThanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):\n\n\n\n\n
Boris Feld \ud83d\udcbb \ud83c\udfa8 \ud83d\udcd6 \ud83e\udd14 \ud83d\udce2 | \n Elias Dorneles \ud83d\udcbb \ud83d\udc1b | \n Paul Morelle \ud83d\udcbb | \n