Enhancements

• Add buffer output_mode for parallel tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/400
• Generate official JSON Schema for poe section in pyproject based on PoeOptions and improve some validation edge cases by @nat-n in https://github.com/nat-n/poethepoet/pull/392 https://github.com/nat-n/poethepoet/pull/389 https://github.com/nat-n/poethepoet/pull/398
• Support declared args on script tasks targeting modules by @nat-n in https://github.com/nat-n/poethepoet/pull/396
• Respect the FORCE_COLOR environment variable by @nat-n in https://github.com/nat-n/poethepoet/pull/403

Fixes

• Executor config validation now rejects unknown keys by @nat-n in https://github.com/nat-n/poethepoet/pull/391
• Support src-layout python path resolution for script, expr, and include_script by @nat-n in https://github.com/nat-n/poethepoet/pull/397
• Fully support all three CLI styles for multi-value args by @nat-n in https://github.com/nat-n/poethepoet/pull/402

AI Agent Skill 🤖

• The poethepoet skill is now documented and ready for use @nat-n in https://github.com/nat-n/poethepoet/pull/404
• Improve coverage of expr/switch config semantics and edge cases by @nat-n in https://github.com/nat-n/poethepoet/pull/401

Install the skill via one of the following methods:

1. Via a built in poe task (similar to how shell completions are installed):

poe _install_skill                          # auto-detects .claude/.codex/.pi/.agents and prompts
poe _install_skill ~/.claude/skills         # explicit path (substitute your agent's dir)
poe _install_skill <skills-dir> --upgrade   # non-interactive upgrade (skips if same/newer)

1. From github via npx skills

npx skills add https://github.com/nat-n/poethepoet/tree/v0.46.0/poethepoet/skills/poethepoet

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.46.0...v0.47.0

Enhancements

• Experimental Claude Code skill and bump-version task by @nat-n in https://github.com/nat-n/poethepoet/pull/387
• Use AST parser for all templating to support :- and :+ param expansion operators everywhere by @nat-n in https://github.com/nat-n/poethepoet/pull/386
• Add support for environment variable parameter expansion within env files @nat-n in https://github.com/nat-n/poethepoet/pull/386

Fixes

• Make uv and poetry executors check for bat files to handle shutdown quirks on windows by @nat-n in https://github.com/nat-n/poethepoet/pull/385
• Strip underscore prefix in documentation for private positional args by @nat-n in https://github.com/nat-n/poethepoet/pull/383
• Use AST for $POE_EXTRA_ARGS detection and cache parsed content by @nat-n in https://github.com/nat-n/poethepoet/pull/388

Experimental agent skill

This release ships an experimental agent skill that gives AI coding agents contextual knowledge of poe's task API when working in projects that use it. It works with any agent that supports the skills convention and aims to improve agent abilities when it comes to leveraging and authoring poe tasks.

Please try it out and provide feedback!

Two install methods:

1. Via a built in poe task (similar to how shell completions are installed):

poe _install_skill                          # auto-detects .claude/.codex/.pi/.agents and prompts
poe _install_skill ~/.claude/skills         # explicit path (substitute your agent's dir)
poe _install_skill <skills-dir> --upgrade   # non-interactive upgrade (skips if same/newer)

1. From github via npx skills

npx skills add https://github.com/nat-n/poethepoet/tree/v0.46.0/poethepoet/skills/poethepoet

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.45.0...v0.46.0

Enhancements

• Add support for forwarding free arguments via $POE_EXTRA_ARGS by @timrid in https://github.com/nat-n/poethepoet/pull/380

Fixes

• Handle cancelled tasks correctly by @timrid in https://github.com/nat-n/poethepoet/pull/378
• Preserve quotes in :+/:- operator arguments (#333) by @nat-n in https://github.com/nat-n/poethepoet/pull/377
• Handle ctrl+c attempt on windows if running bat/cmd scripts by @NSPC911 in https://github.com/nat-n/poethepoet/pull/382

New Contributors

• @timrid made their first contribution in https://github.com/nat-n/poethepoet/pull/378

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.44.0...v0.45.0

Enhancements

• Add support for recursive include #317 by @nat-n in https://github.com/nat-n/poethepoet/pull/372

Breaking changes**

• Transitive includes are now loaded by default. Previously, if an included config file contained its own include entries, those second-order includes were silently ignored. They are now followed recursively using depth-first loading. This may cause previously ignored config files to be loaded, potentially introducing new tasks or environment variables. To preserve the old behavior for a specific include, set recursive = false on that include entry. See the include guide for details.

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.43.0...v0.44.0

Enhancements

• Add task groups for grouping tasks under a heading in help output by @brolewis in https://github.com/nat-n/poethepoet/pull/354
• Treat false boolean args as unset env vars and add private vars by @kzrnm in https://github.com/nat-n/poethepoet/pull/359

Breaking changes

This release includes a refactor of how task variables are managed, improving boolean arg semantics and introducing private variables. These changes may affect a small number of existing configurations:

• Boolean args now produce unset env vars when false. Previously false mapped to the string "False"; now the env var is removed entirely. This gives consistent falsy behavior across shells and parameter expansion operators (:-, :+). Tasks checking for the literal string "False" or using os.environ["flag"] will need updating.

• Private env vars are filtered from subprocesses. Variables starting with _ and containing no uppercase characters (e.g. _secret) are now treated as private — available for config-time interpolation but excluded from the task subprocess environment. This is unlikely to affect existing configurations, but any task that relies on a subprocess reading a _lowercase env var will need to rename it.

• Private arg option names strip leading underscores. An arg named _flag with no explicit options now generates --flag instead of --_flag. A new validation rejects duplicate CLI options across args.

See the migration guide for details and recommended fixes.

New Contributors

• @brolewis made their first contribution in https://github.com/nat-n/poethepoet/pull/354

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.42.1...v0.43.0

Enhancements

• Add exact option for uv executor by @charlesbmi in https://github.com/nat-n/poethepoet/pull/365

Completion script fixes

• Isolate zsh completion task options from global options by @nat-n in https://github.com/nat-n/poethepoet/pull/364
• Fix completion script edge case handling by @nat-n in https://github.com/nat-n/poethepoet/pull/366

[!IMPORTANT] You must follow the instructions to (re)install the completion script for your preferred shell environment to benefit from the completion script fixes

New Contributors

• @charlesbmi made their first contribution in https://github.com/nat-n/poethepoet/pull/365

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.42.0...v0.42.1

Enhancements

• Better zsh completion caaching with max hits per cache and proper TTL before refresh by @nat-n in https://github.com/nat-n/poethepoet/pull/360
• Officially Support Python 3.14 by @gruebel in https://github.com/nat-n/poethepoet/pull/362
• Add completion script for PowerShell by @NSPC911 in https://github.com/nat-n/poethepoet/pull/358

[!IMPORTANT] You must follow the instructions to (re)install the completion script for your preferred shell environment to benefit from the enhancements for zsh or PowerShell

New Contributors

• @gruebel made their first contribution in https://github.com/nat-n/poethepoet/pull/362
• @NSPC911 made their first contribution in https://github.com/nat-n/poethepoet/pull/358

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.41.0...v0.42.0

Enhancements

• Full shell completions for global and task arguments in zsh and bash by @nat-n in https://github.com/nat-n/poethepoet/pull/355

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.40.0...v0.41.0

[!IMPORTANT] You must follow the instructions to (re)install the completion script for your preferred shell environment to benefit from the revamped tab completion covering task arguments.

Enhancements

• Allow optional envfiles without warnings by @cnaples79 in https://github.com/nat-n/poethepoet/pull/337
• Add support for the capture_output option in ref tasks by @kzrnm in https://github.com/nat-n/poethepoet/pull/343
• Set uv to quiet mode during shell completion to avoid console spam by @nat-n in https://github.com/nat-n/poethepoet/pull/338
• Support ignore_fail on execution task types and ref tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/347
• Add choices option to constrain named arguments by @nat-n in https://github.com/nat-n/poethepoet/pull/348

Fixes

• Handle SIGHUP and SIGBREAK signals to stop tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/344
• Accept string for type name in global executor option by @kzrnm in https://github.com/nat-n/poethepoet/pull/340

Code improvements

• Modernize type annotations by @nat-n in https://github.com/nat-n/poethepoet/pull/339
• Ensure test virtual environments are always cleaned up by @kzrnm in https://github.com/nat-n/poethepoet/pull/346

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.39.0...v0.40.0

Enhancements

• Add support for uv executor options by @rochacbruno and @nat-n in https://github.com/nat-n/poethepoet/pull/327
  • feat: add various options to the uv executor to be passed to the uv run command
  • feat: allow task executor to be configure with just the type as a string
  • feat executor options to be set at runtime via the new --executor-opt cli global option
  • feat: allow inheritance of compatible executor options from global to task to runtime
  • refactor: extend PoeOptions to support annotating config fields with a config_name to parse, separate from the attribute name
  • refactor: some micro-optimizations to PoeOptions and AnnotationType
  • doc: Add guide for replacing tox with poe + uv
  • doc: tidy up executor docs
  • doc: fix typo in doc for expr task
  • test: improve test coverage of PoeOptions
  • test: disable some test cases on windows that are too flaky

New Contributors

• @rochacbruno made their first contribution in https://github.com/nat-n/poethepoet/pull/327

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.38.0...v0.39.0

Enhancements

• feat: Add parallel task type by @nat-n in https://github.com/nat-n/poethepoet/pull/323

Breaking changes

• Drop support for python 3.9 by @nat-n in https://github.com/nat-n/poethepoet/pull/329

Internal changes

• refactor: executor options by @nat-n in https://github.com/nat-n/poethepoet/pull/328

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.37.0...v0.38.0

Pre-release for parallel tasks

Adds new parallel task type that runs subtasks in parallel and multiplexes subprocess outputs with a line prefix

• Major refactor of task orchestration to use asyncio
• Rewrite of signal handling logic to improve subprocess cleanup

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.37.0...v0.38.0-beta

Enhancements

• Support configuring task level verbosity by @nat-n in https://github.com/nat-n/poethepoet/pull/304
• Direct most non-task output to stderr by @nat-n in https://github.com/nat-n/poethepoet/pull/304

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.36.0...v0.37.0

Breaking changes

• Improve handling of unmatched glob patterns in cmd tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/315
  • See this discussion for details: https://github.com/nat-n/poethepoet/discussions/314

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.35.1...v0.36.0

Fixes

• Fix issue with locating sh.exe when git is installed in a custom location by @per11235813 in https://github.com/nat-n/poethepoet/pull/311

New Contributors

• @per11235813 made their first contribution in https://github.com/nat-n/poethepoet/pull/311

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.35.0...v0.35.1

Enhancements

• Support script tasks that run packages with a __main__ module by @nat-n in https://github.com/nat-n/poethepoet/pull/300
• Allow virtualenv location to reference special git related env vars by @nat-n in https://github.com/nat-n/poethepoet/pull/302
• Simplify CLI help page header by @nat-n in https://github.com/nat-n/poethepoet/pull/291

Fixes

• Don't register hidden tasks with poetry plugin by @nat-n in https://github.com/nat-n/poethepoet/pull/292
• Don't resolve symlinks to poetry in PoetryExecutor by @nat-n in https://github.com/nat-n/poethepoet/pull/293
• Crash with invalid help option on task by @nat-n in https://github.com/nat-n/poethepoet/pull/294
• Always validate task args when loading config by @nat-n in https://github.com/nat-n/poethepoet/pull/295
• Coerce switch case values to string to avoid errors by @nat-n in https://github.com/nat-n/poethepoet/pull/296
• Always print help when no arguments provided by @nat-n in https://github.com/nat-n/poethepoet/pull/299
• Suppress useless global options in the poetry plugin cli by @nat-n in https://github.com/nat-n/poethepoet/pull/301

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.34.0...v0.35.0

Enhancements

• Add task packages feature by @nat-n in https://github.com/nat-n/poethepoet/pull/286

  This adds a major new capability in Poe the Poet by allowing tasks to be defined and distributed for reuse in python modules. 📖 Read the docs for more details

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.33.1...v0.34.0

Fixes

• Don't resolve symlinks to uv in UvExecutor by @sewi-cpan in https://github.com/nat-n/poethepoet/pull/283
• Make UvExecutor set directory and project options on uv run by @nat-n in https://github.com/nat-n/poethepoet/pull/285

New Contributors

• @sewi-cpan made their first contribution in https://github.com/nat-n/poethepoet/pull/284

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.33.0...v0.33.1

Enhancements

• Implemented first version of UvExecutor by @AKuederle in https://github.com/nat-n/poethepoet/pull/271
• Support displaying help for a single task by @nat-n in https://github.com/nat-n/poethepoet/pull/280

Fixes

• Fix argument parsing issues in poetry 2.0 plugin by @nat-n in https://github.com/nat-n/poethepoet/pull/277
• Use python3 or sys.executable if python is not on the path by @nat-n in https://github.com/nat-n/poethepoet/pull/278
• Tighten poetry-core dependency for non-wheel based installation methods

New Contributors

• @AKuederle made their first contribution in https://github.com/nat-n/poethepoet/pull/271

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.32.2...v0.33.0

Fixes

• Improve detection of poetry 2.0 projects via the build-system table by @nat-n in https://github.com/nat-n/poethepoet/pull/274
• Fix usage without Poetry doc link in the readme by @johnthagen in https://github.com/nat-n/poethepoet/pull/273

New Contributors

• @johnthagen made their first contribution in https://github.com/nat-n/poethepoet/pull/273

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.32.1...v0.32.2

Enhancements

• feat: Upgrade poetry dependency to make the poetry plugin work with poetry 2.0 by @nat-n in https://github.com/nat-n/poethepoet/pull/269

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.32.0...v0.32.1

Enhancements

• Make command parsing support default value and alternate value operations on param expansions by @nat-n in https://github.com/nat-n/poethepoet/pull/266

  • See feature 📖 documentation for more details

• Explicitly disallow capture_stdout option on sequence tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/265

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.31.1...v0.32.0

Fixes

• fix: Explicitly disallow capture_stdout option on sequence tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/261
• fix: Allow env var defaults in included task files by @nat-n in https://github.com/nat-n/poethepoet/pull/263

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.31.0...v0.31.1

Enhancements

• Various improvements to config validation logic and error handling in general by @nat-n in https://github.com/nat-n/poethepoet/pull/251
• Drop support for python 3.8 and start testing 3.13 by @nat-n in https://github.com/nat-n/poethepoet/pull/255

Fixes

• Make task autocompletion work again in sub-directories by @nat-n in https://github.com/nat-n/poethepoet/pull/258

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.30.0...v0.31.0

Notice

This will be the last release to support python 3.8.

Enhancements

• Add poethepoet.script package with rm function for use in script tasks @nat-n in https://github.com/nat-n/poethepoet/pull/250 📖

Fixes

• Fix handling of ignore_fail option in nested sequence tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/243
• Fix typo in debug message by @cclauss in https://github.com/nat-n/poethepoet/pull/245

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.29.0...v0.30.0

Enhancements

• Add support for poe_tasks.toml or yaml or json files by @nat-n in https://github.com/nat-n/poethepoet/pull/241 📖
• Add support for help messages spanning multiple lines by @taconi in https://github.com/nat-n/poethepoet/pull/240
• Only depend on tomli for python<3.11 by @nat-n in https://github.com/nat-n/poethepoet/pull/243

New Contributors

• @taconi made their first contribution in https://github.com/nat-n/poethepoet/pull/240

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.28.0...v0.29.0

Enhancements

• Document support for global tasks and improve completion scripts by @nat-n in https://github.com/nat-n/poethepoet/pull/235
• Add --executor CLI option to override the executor at runtime. by @nat-n in https://github.com/nat-n/poethepoet/pull/238

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.27.0...v0.28.0

Enhancements

• Add support for POE_GIT_DIR and POE_GIT_ROOT variables in config by @nat-n in https://github.com/nat-n/poethepoet/pull/229

Fixes

• Fix handling of comments in multiline cmd tasks @snejus in https://github.com/nat-n/poethepoet/pull/225
• Fix ordered substitution of templated variables in env vars config #223 by @dbohdan in https://github.com/nat-n/poethepoet/pull/227
• Fix typos in docs and code by @kianmeng in https://github.com/nat-n/poethepoet/pull/228

New Contributors

• @kianmeng made their first contribution in https://github.com/nat-n/poethepoet/pull/228
• @snejus made their first contribution in https://github.com/nat-n/poethepoet/pull/225
• @dbohdan made their first contribution in https://github.com/nat-n/poethepoet/pull/227

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.26.1...v0.27.0

Fixes

• Fix faulty validation of subtask names in sequence tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/219

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.26.0...v0.26.1

Enhancements and Fixes

• Major refactor of config classes and config include logic by @nat-n in https://github.com/nat-n/poethepoet/pull/214
  • Fixes issue with POE_ROOT/POE_PWD env vars not being usable from global env config: https://github.com/nat-n/poethepoet/issues/198
• Use -C and --directory for pyproject.toml directory path (#212) by @jeraymond in https://github.com/nat-n/poethepoet/pull/213
• Add POE_PROJECT_DIR env var as default for -C option by @nat-n in https://github.com/nat-n/poethepoet/pull/215
• Allow poetry plugin with empty command prefix to run tasks included from another file by @nat-n in https://github.com/nat-n/poethepoet/pull/216

Breaking changes

• Relative paths for envfiles imported from within an included tasks file will now be resolved relative to the cwd path configured on the include (if any) https://github.com/nat-n/poethepoet/issues/160

New Contributors

• @jeraymond made their first contribution in https://github.com/nat-n/poethepoet/pull/213

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.25.1...v0.26.0

Fixes

• Fixes Windows error message due to incorrect type comparison. by @BertrandBordage in https://github.com/nat-n/poethepoet/pull/205
• Make poetry plugin work with the --directory option on the poetry cli by @worldworm in https://github.com/nat-n/poethepoet/pull/211

New Contributors

• @BertrandBordage made their first contribution in https://github.com/nat-n/poethepoet/pull/205
• @worldworm made their first contribution in https://github.com/nat-n/poethepoet/pull/211

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.25.0...v0.25.1

Enhancements

• Make args work as expected on ref tasks by @nat-n in https://github.com/nat-n/poethepoet/pull/201

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.24.4...v0.25.0

Fixes

• Make switch task work as expected with uses option by @nat-n in https://github.com/nat-n/poethepoet/pull/186

Enhancements

• Improve, test, and document capture_stdout option by @nat-n in https://github.com/nat-n/poethepoet/pull/188

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.24.3...v0.24.4

What's Changed

• Run tasks in project_root dir by default #180 by @nat-n in https://github.com/nat-n/poethepoet/pull/181

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.24.2...v0.24.3

Fixes

• Make subtasks of sequence inherit cwd option by default #160 (#51a6fd79)
• Open env files in utf-8 mode explicitly (#179) (#8f8c3e68)
• Fix error message when the cwd directory does not exist by @kzrnm in https://github.com/nat-n/poethepoet/pull/174
• By default only use PoetryExecutor if poetry cli can be found by @kzrnm in https://github.com/nat-n/poethepoet/pull/175
• Fix faulty cmd tokenization by @nat-n in https://github.com/nat-n/poethepoet/pull/178

Documentation

• Fix typos on switch task documentation by @kzrnm in https://github.com/nat-n/poethepoet/pull/172
• Add tip about referencing env vars for args in powershell by @mason3k in https://github.com/nat-n/poethepoet/pull/173

New Contributors

• @mason3k made their first contribution in https://github.com/nat-n/poethepoet/pull/173
• @kzrnm made their first contributions in https://github.com/nat-n/poethepoet/pull/172, https://github.com/nat-n/poethepoet/pull/174 and https://github.com/nat-n/poethepoet/pull/175

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.24.1...v0.24.2

Enhancements

• Show helpful error message when task executable is not on the path (#dfb8cabe)

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.24.0...v0.24.1

Enhancements

• Use quotes to improve accuracy of logged commands #169 (#21c523eb)

Fixes

• Make task dependencies work as expected for referenced tasks #168 (#8f73c778)

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.23.0...v0.24.0

Enhancements

• New AST parser for cmd tasks to replace quirky shlex based tokenization (#d0192621)
  • This brings cmd syntax for parameter expansions, pattern matching, whitespace, escaping, and quoting very close to being a strict subset of bash
  • This is a breaking change for some scenarios, for example parameter expansion no longer works inside single quotes.
  • This fixes some surprising quirks, that previously existed such as not being able to apply quotes to just a part of a token.
  • Pattern matching is still constrained to what the python standard library glob module can support
• Respect NO_COLOR environment variable to disable ANSI color codes by default (#e6e031be)
• Improve virtualenv activation logic to work with _OLD_VIRTUAL_PATH and _OLD_VIRTUAL_PYTHONHOME env vars (#f487993f)
• Allow expr tasks to use the use_exec option (#143e9075)

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.22.1...v0.23.0

Fixes

• Fix typo by @m-roberts in https://github.com/nat-n/poethepoet/pull/164
• Fix premature validation of included tasks (fa660101) #165

New Contributors

• @m-roberts made their first contribution in https://github.com/nat-n/poethepoet/pull/164

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.22.0...v0.22.1

Enhancements

• Support configuring tasks to run in the original working directory by @Spiffyk in https://github.com/nat-n/poethepoet/pull/161

Fixes

• Fix issue with string task declarations in included task files by @rjaduthie in https://github.com/nat-n/poethepoet/pull/159

New Contributors

• @rjaduthie made their first contribution in https://github.com/nat-n/poethepoet/pull/159
• @Spiffyk made their first contribution in https://github.com/nat-n/poethepoet/pull/161

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.21.1...v0.22.0

Fixes

• Fix broken links in README #157

Enhancements

• Add program_name and config_name arguments to PoeThePoet to improve support for embedding within another tool https://github.com/nat-n/poethepoet/pull/149

Fixes

• cmd task: Strip quotes from token on Windows by @ameily in https://github.com/nat-n/poethepoet/pull/145

New Contributors

• @jannismain made their first contribution in https://github.com/nat-n/poethepoet/pull/148
• @sitbon made their first contribution in https://github.com/nat-n/poethepoet/pull/149

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.20.0...v0.21.0

Enhancements

• Launch new documentation website

Fixes

• win32: Resolve Executable to Absolute Path if not found in venv by @ameily in https://github.com/nat-n/poethepoet/pull/142

Breaking changes

• Drop support for python 3.7

New Contributors

• @ameily made their first contribution in https://github.com/nat-n/poethepoet/pull/142
• @usr-ein made their first contribution in https://github.com/nat-n/poethepoet/pull/139

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.19.0...v0.20.0

Enhancements

• Display the default value of args in help #126
• Append additional arguments after the first -- to the end of a cmd task #69
• Make script tasks work with async functions (#6d9fed4)
• Add support for envfile paths relative to the user home dir #125

Fixes

• Improve logic to locate poetry executable #121
• Make ref task pass extra arguments from the definition to the referenced task #130
• Always attempt to resolve executable path #119
• Fix handling of hidden tasks in the plugin #133

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.18.1...v0.19.0

Fixes

• Always attempt to resolve the full path of an executable using shutil.which before creating the subprocess (or execv) for a task #119

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.18.2-beta.1...v0.18.2-beta.2

Fixes

• Improve logic for finding the poetry executable #121

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.18.1...v0.18.2-beta.1

Fixes

• Fix error when running switch tasks or tasks with the 'uses' option in dry-run mode #115
• Fix handling of backslashes for escaping when parsing envfiles #118

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.18.0...v0.18.1

Enhancements

• Add new expr task type for evaluating a single python expression as a task.

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.17.1...v0.18.0

Fixes

• Fix handling of Keyboardinterrupt when running a task on windows #42

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.17.0...v0.17.1

Enhancements

• Support for interpolating env vars into task arg default values (#3c994684)
• Support providing a cwd for tasks included from another file #110
• Add new switch task type for running different versions of a task depending on the result of a control task #83

Fixes

• Set PYTHONIOENCODING to utf-8 before invoking poetry env info -p #112

New Contributors

• @privet-kitty made their first contribution in https://github.com/nat-n/poethepoet/pull/112

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.16.5...v0.17.0

Fixes

• Restore changes from v0.16.1 that were reverted in v0.16.2
• Fix various issues on windows #106
• docs: use poe --group dev instead of poe --dev by @ubmit in https://github.com/nat-n/poethepoet/pull/98
• Only use tomli in python<3.11 by @KotlinIsland in https://github.com/nat-n/poethepoet/pull/100
• Add python 3.11 to the CI and update 'dev-dependencies' to 'group.dev.dependencies' by @KotlinIsland in https://github.com/nat-n/poethepoet/pull/101
• Format code with isort by @KotlinIsland in https://github.com/nat-n/poethepoet/pull/102
• Fix typo in --help output by @howeaj in https://github.com/nat-n/poethepoet/pull/105

New Contributors

• @ubmit made their first contribution in https://github.com/nat-n/poethepoet/pull/98
• @KotlinIsland made their first contribution in https://github.com/nat-n/poethepoet/pull/100
• @howeaj made their first contribution in https://github.com/nat-n/poethepoet/pull/105

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.16.4...v0.16.5

Fixes

• Fix bug to allow ref tasks to pass arguments again by @nat-n in https://github.com/nat-n/poethepoet/pull/97

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.16.3...v0.16.4

Fixes

• Return cleo application exit code from monkeymatch by @monim67 in https://github.com/nat-n/poethepoet/pull/92
• Minor reliability improvements on windows (#b3490be7)

New Contributors

• @monim67 made their first contribution in https://github.com/nat-n/poethepoet/pull/92

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.16.2...v0.16.3

Fixes

• Revert all changes in v0.16.1 to address bug reported in #88

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.16.1...v0.16.2

Enhancements

• When poetry virtualenv creation is disabled via an environment variable and no poetry virtualenv exists then don't try to execute tasks with poetry run #65

Fixes

• Fixed issue when running poe from inside a poetry env with the --root global option targeting another project, the target project env was not always used.

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.16.0...v0.16.1

Enhancements

• Add print_result option for script tasks (#61)

Fixes

• Fix validation to always check the configured type for an arg (#80)
• Fix poetry plugin crash on windows when no pyproject.toml is present (#81)

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.15.0...v0.16.0

Enhancements

• Add use_exec option to execute cmd or script tasks with exec instead of a subprocess on supported systems (#47)
• Add cwd task option to support setting the working directory for a task (#ab134327)
• Remove new lines from captured task output when adding it to the env (#29d91de6)

Fixes

• Refactor generated python scripts to avoid new lines which may have been causing errors on windows (#51)
• Fix bug preventing use of correct python interpreter in shell tasks (#62b5b3dc )

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.14.0...v0.15.0

Enhancements

• Add option to specify that a named argument should accept multiple values (#70)
• The envfile option now also accept lists of files to load. (#a4a21bb9)
• Included config files no-longer have to be under the project directory. This improves support for mono-repos. (#2a2b856b)
• Improve validation of sequence tasks (#e8159be5)

Breaking changes

• Drop support for python 3.6 (#4987b1f2)

Full Changelog: https://github.com/nat-n/poethepoet/compare/v0.13.1...v0.14.0