Poe the Poet is a modern and flexible task runner designed to integrate seamlessly with `poetry` and `uv` projects. It allows defining and running project-specific commands, scripts, and more complex workflows via `pyproject.toml`. As of version 0.44.0, it maintains an active development pace with frequent minor releases addressing new features, bug fixes, and occasional breaking changes.
pip install poethepoetVerified import paths — ran on the pinned version, not inferred.
Poe tasks are defined in your project's `pyproject.toml` file under `[tool.poe.tasks]`. Each task is a key-value pair, where the key is the task name and the value can be a simple command string or a dictionary for more complex configurations (e.g., adding help text). Tasks are executed via the `poe <task_name>` command in your terminal.
Review existing projects with nested 'include' statements (e.g., `include = ['path/to/another.toml']`) for unintended task or environment variable conflicts.
Consult the v0.43.0 release notes and documentation on task variables, boolean arguments, and private variables to adjust existing task definitions.
Follow the instructions in the official documentation to reinstall your shell's completion script after upgrading `poethepoet`.
Upgrade your project's Python interpreter to 3.10 or newer, or pin `poethepoet` to a version `<0.38.0`.
Ensure `poethepoet` is installed and activated within your project's virtual environment, or carefully manage your system's PATH to prioritize the desired `poe` command.
Use `cmd` for simple, atomic commands and `shell` when shell-specific syntax or features (e.g., `|`, `>`, `&&`) are required. If unsure, `shell` is often the more flexible default, but `cmd` can be more direct and portable.
No dependency data recorded yet.