A task runner that works well with poetry.
Poe the Poet
A batteries included task runner that works well with poetry.
✅ Straight forward declaration of project tasks in your pyproject.toml
✅ Tasks are run in poetry's virtualenv (or another env you specify)
✅ Shell completion of task names (and global options too for zsh)
✅ The poe CLI can be used standalone, or as a plugin for poetry
✅ Concise commands with extra arguments passed to the task
poe [options] task [task_args]
✅ Easily define CLI arguments for your tasks
✅ Tasks can specify and reference environment variables, even without a shell
✅ Tasks are self documenting, with optional help messages (just run
poewith no arguments)
✅ Works with
✅ Can be used as a library to embed in other tools
pipx install poethepoet
- Define some tasks in your pyproject.toml
[tool.poe.tasks] test = "pytest --cov=my_app" # a simple command task serve.script = "my_app.service:run(debug=True)" # python script based task tunnel.shell = "ssh -N -L 0.0.0.0:8080:$PROD:8080 $PROD &" # (posix) shell based task
- Run your tasks via the CLI
$ poe test -v tests/unit # extra CLI arguments are appended to the underlying command Poe => pytest --cov=my_app ...
If you're using poetry, then poe will automatically use CLI tools and libraries from your poetry managed virtualenv without you having to run
poetry run or
Poe can also be used without poetry.
Also check out the CONTRIBUTING guide 🤓
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for poethepoet-0.23.0-py3-none-any.whl