Usage

Configuration uses standard TOML elements, and jobs can reference shared values, which will be interpolated at runtime:

[tool.thx.values]
module = "thx"

[tool.thx.jobs]
lint = [
    "flake8 {module}",
    "ufmt check {module}",
]
test = "python -m unittest -v {module}.tests"

The configuration above defines two jobs, “lint” and “test”; the “lint” job defines two steps, and these can optionally be run in parallel. Both jobs present themselves as separate commands in thx. Note the automatic replacement of {module} with the configured value thx when running jobs:

$ thx lint
> flake8 thx
> ufmt check thx

$ thx test
> python -m unittest thx.tests

They can also be run together in order, similar to makefiles:

$ thx test lint
> python -m unittest thx.tests
> flake8 thx
> ufmt check thx

By default, thx uses the active Python runtime for jobs, but can also run jobs on multiple runtimes in parallel:

[tool.thx]
python_versions = ["3.7", "3.8", "3.9"]

$ thx test
3.9> python -m unittest thx.tests
3.8> python -m unittest thx.tests
3.7> python -m unittest thx.tests

See the user guide for details on all available configuration options.

Install

thx is available on PyPI:

$ pip install thx

See the user guide for help getting started.

License

thx is copyright Amethyst Reese, and licensed under the MIT license. I am providing code in this repository to you under an open source license. This is my personal repository; the license you receive to my code is from me and not from my employer. See the LICENSE file for details.