chore(deps): update dependency poethepoet to ^0.48.0

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
poethepoet (changelog)	^0.24.0 → ^0.48.0

---

Release Notes

nat-n/poethepoet (poethepoet)

v0.48.0: 0.48.0

Compare Source

Enhancements

• Add uses_env task option for loading variables from another task's output like an env file by @​nat-n in #​407

Full Changelog: nat-n/poethepoet@v0.47.1...v0.48.0

v0.47.1: 0.47.1

Compare Source

Fixes

• Restore default value propagation for absent multiple positional args by @​nat-n in #​409

Full Changelog: nat-n/poethepoet@v0.47.0...v0.47.1

v0.47.0: 0.47.0

Compare Source

Enhancements

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

Fixes

• Executor config validation now rejects unknown keys by @​nat-n in #​391
• Support src-layout python path resolution for script, expr, and include_script by @​nat-n in #​397
• Fully support all three CLI styles for multi-value args by @​nat-n in #​402

AI Agent Skill 🤖

• The poethepoet skill is now documented and ready for use @​nat-n in #​404
• Improve coverage of expr/switch config semantics and edge cases by @​nat-n in #​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)

2. From github via npx skills

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

Full Changelog: nat-n/poethepoet@v0.46.0...v0.47.0

v0.46.0: 0.46.0

Compare Source

Enhancements

• Experimental Claude Code skill and bump-version task by @​nat-n in #​387
• Use AST parser for all templating to support :- and :+ param expansion operators everywhere by @​nat-n in #​386

Fixes

• Make uv and poetry executors check for bat files to handle shutdown quirks on windows by @​nat-n in #​385
• Strip underscore prefix in documentation for private positional args by @​nat-n in #​383
• Use AST for $POE_EXTRA_ARGS detection and cache parsed content by @​nat-n in #​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)

2. From github via npx skills

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

Full Changelog: nat-n/poethepoet@v0.45.0...v0.46.0

v0.45.0: 0.45.0

Compare Source

Enhancements

• Add support for forwarding free arguments via $POE_EXTRA_ARGS by @​timrid in #​380

Fixes

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

New Contributors

• @​timrid made their first contribution in #​378

Full Changelog: nat-n/poethepoet@v0.44.0...v0.45.0

v0.44.0: 0.44.0

Compare Source

Enhancements

• Add support for recursive include #​317 by @​nat-n in #​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: nat-n/poethepoet@v0.43.0...v0.44.0

v0.43.0: 0.43.0

Compare Source

Enhancements

• Add task groups for grouping tasks under a heading in help output by @​brolewis in #​354
• Treat false boolean args as unset env vars and add private vars by @​kzrnm in #​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 #​354

Full Changelog: nat-n/poethepoet@v0.42.1...v0.43.0

v0.42.1: 0.42.1

Compare Source

Enhancements

• Add exact option for uv executor by @​charlesbmi in #​365

Completion script fixes

• Isolate zsh completion task options from global options by @​nat-n in #​364
• Fix completion script edge case handling by @​nat-n in #​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 #​365

Full Changelog: nat-n/poethepoet@v0.42.0...v0.42.1

v0.42.0: 0.42.0

Compare Source

Enhancements

• Better zsh completion caaching with max hits per cache and proper TTL before refresh by @​nat-n in #​360
• Officially Support Python 3.14 by @​gruebel in #​362
• Add completion script for PowerShell by @​NSPC911 in #​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 #​362
• @​NSPC911 made their first contribution in #​358

Full Changelog: nat-n/poethepoet@v0.41.0...v0.42.0

v0.41.0: 0.41.0

Compare Source

Enhancements

• Full shell completions for global and task arguments in zsh and bash by @​nat-n in #​355

Full Changelog: nat-n/poethepoet@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.

v0.40.0: 0.40.0

Compare Source

Enhancements

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

Fixes

• Handle SIGHUP and SIGBREAK signals to stop tasks by @​nat-n in #​344
• Accept string for type name in global executor option by @​kzrnm in #​340

Code improvements

• Modernize type annotations by @​nat-n in #​339
• Ensure test virtual environments are always cleaned up by @​kzrnm in #​346

Full Changelog: nat-n/poethepoet@v0.39.0...v0.40.0

v0.39.0: 0.39.0

Compare Source

Enhancements

• Add support for uv executor options by @​rochacbruno and @​nat-n in #​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 #​327

Full Changelog: nat-n/poethepoet@v0.38.0...v0.39.0

v0.38.0: 0.38.0

Compare Source

Enhancements

• feat: Add parallel task type by @​nat-n in #​323

Breaking changes

• Drop support for python 3.9 by @​nat-n in #​329

Internal changes

• refactor: executor options by @​nat-n in #​328

Full Changelog: nat-n/poethepoet@v0.37.0...v0.38.0

v0.37.0: 0.37.0

Compare Source

Enhancements

• Support configuring task level verbosity by @​nat-n in #​304
• Direct most non-task output to stderr by @​nat-n in #​304

Full Changelog: nat-n/poethepoet@v0.36.0...v0.37.0

v0.36.0: 0.36.0

Compare Source

Breaking changes

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

Full Changelog: nat-n/poethepoet@v0.35.1...v0.36.0

v0.35.1: 0.35.1

Compare Source

Fixes

• Fix issue with locating sh.exe when git is installed in a custom location by @​per11235813 in #​311

New Contributors

• @​per11235813 made their first contribution in #​311

Full Changelog: nat-n/poethepoet@v0.35.0...v0.35.1

v0.35.0: 0.35.0

Compare Source

Enhancements

• Support script tasks that run packages with a __main__ module by @​nat-n in #​300
• Allow virtualenv location to reference special git related env vars by @​nat-n in #​302
• Simplify CLI help page header by @​nat-n in #​291

Fixes

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

Full Changelog: nat-n/poethepoet@v0.34.0...v0.35.0

v0.34.0: 0.34.0

Compare Source

Enhancements

• Add task packages feature by @​nat-n in #​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: nat-n/poethepoet@v0.33.1...v0.34.0

v0.33.1: 0.33.1

Compare Source

Fixes

• Don't resolve symlinks to uv in UvExecutor by @​sewi-cpan in #​283
• Make UvExecutor set directory and project options on uv run by @​nat-n in #​285

New Contributors

• @​sewi-cpan made their first contribution in #​284

Full Changelog: nat-n/poethepoet@v0.33.0...v0.33.1

v0.33.0: 0.33.0

Compare Source

Enhancements

• Implemented first version of UvExecutor by @​AKuederle in #​271
• Support displaying help for a single task by @​nat-n in #​280

Fixes

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

New Contributors

• @​AKuederle made their first contribution in #​271

Full Changelog: nat-n/poethepoet@v0.32.2...v0.33.0

v0.32.2: 0.32.2

Compare Source

Fixes

• Improve detection of poetry 2.0 projects via the build-system table by @​nat-n in #​274
• Fix usage without Poetry doc link in the readme by @​johnthagen in #​273

New Contributors

• @​johnthagen made their first contribution in #​273

Full Changelog: nat-n/poethepoet@v0.32.1...v0.32.2

v0.32.1: 0.32.1

Compare Source

Enhancements

• feat: Upgrade poetry dependency to make the poetry plugin work with poetry 2.0 by @​nat-n in #​269

Full Changelog: nat-n/poethepoet@v0.32.0...v0.32.1

v0.32.0: 0.32.0

Compare Source

Enhancements

• Make command parsing support default value and alternate value operations on param expansions by @​nat-n in #​266

  • See feature 📖 documentation for more details

• Explicitly disallow capture_stdout option on sequence tasks by @​nat-n in #​265

Full Changelog: nat-n/poethepoet@v0.31.1...v0.32.0

v0.31.1: 0.31.1

Compare Source

Fixes

• fix: Explicitly disallow capture_stdout option on sequence tasks by @​nat-n in #​261
• fix: Allow env var defaults in included task files by @​nat-n in #​263

Full Changelog: nat-n/poethepoet@v0.31.0...v0.31.1

v0.31.0: 0.31.0

Compare Source

Enhancements

• Various improvements to config validation logic and error handling in general by @​nat-n in #​251
• Drop support for python 3.8 and start testing 3.13 by @​nat-n in #​255

Fixes

• Make task autocompletion work again in sub-directories by @​nat-n in #​258

Full Changelog: nat-n/poethepoet@v0.30.0...v0.31.0

v0.30.0: 0.30.0

Compare Source

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 #​250 📖

Fixes

• Fix handling of ignore_fail option in nested sequence tasks by @​nat-n in #​243
• Fix typo in debug message by @​cclauss in #​245

Full Changelog: nat-n/poethepoet@v0.29.0...v0.30.0

v0.29.0: 0.29.0

Compare Source

Enhancements

• Add support for poe_tasks.toml or yaml or json files by @​nat-n in #​241 📖
• Add support for help messages spanning multiple lines by @​taconi in #​240
• Only depend on tomli for python<3.11 by @​nat-n in #​243

New Contributors

• @​taconi made their first contribution in #​240

Full Changelog: nat-n/poethepoet@v0.28.0...v0.29.0

v0.28.0: 0.28.0

Compare Source

Enhancements

• Document support for global tasks and improve completion scripts by @​nat-n in #​235
• Add --executor CLI option to override the executor at runtime. by @​nat-n in #​238

Full Changelog: nat-n/poethepoet@v0.27.0...v0.28.0

v0.27.0: 0.27.0

Compare Source

Enhancements

• Add support for POE_GIT_DIR and POE_GIT_ROOT variables in config by @​nat-n in #​229

Fixes

• Fix handling of comments in multiline cmd tasks @​snejus in #​225
• Fix ordered substitution of templated variables in env vars config #​223 by @​dbohdan in #​227
• Fix typos in docs and code by @​kianmeng in #​228

New Contributors

• @​kianmeng made their first contribution in #​228
• @​snejus made their first contribution in #​225
• @​dbohdan made their first contribution in #​227

Full Changelog: nat-n/poethepoet@v0.26.1...v0.27.0

v0.26.1

Compare Source

Fixes

• Fix faulty validation of subtask names in sequence tasks by @​nat-n in #​219

Full Changelog: nat-n/poethepoet@v0.26.0...v0.26.1

v0.26.0

Compare Source

Enhancements and Fixes

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

New Contributors

• @​jeraymond made their first contribution in #​213

Full Changelog: nat-n/poethepoet@v0.25.1...v0.26.0

v0.25.1

Compare Source

Fixes

• Fixes Windows error message due to incorrect type comparison. by @​BertrandBordage in #​205
• Make poetry plugin work with the --directory option on the poetry cli by @​worldworm in #​211

New Contributors

• @​BertrandBordage made their first contribution in #​205
• @​worldworm made their first contribution in #​211

Full Changelog: nat-n/poethepoet@v0.25.0...v0.25.1

v0.25.0

Compare Source

Enhancements

• Make args work as expected on ref tasks by @​nat-n in #​201

Full Changelog: nat-n/poethepoet@v0.24.4...v0.25.0

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[renovate]

⚠️ Artifact update problem

Renovate failed to update an artifact related to this branch. You probably do not want to merge this PR as-is.

♻ Renovate will retry this branch, including artifacts, only when one of the following happens:

• any of the package files in this branch needs updating, or
• the branch becomes conflicted, or
• you click the rebase/retry checkbox if found above, or
• you rename this PR's title to start with "rebase!" to trigger it manually

The artifact failure details are included below:

File name: poetry.lock

The currently activated Python version 3.11.15 is not supported by the project (>=3.8,<=3.11).
Trying to find and use a compatible version. 

Poetry was unable to find a compatible version. If you have one, you can explicitly use it via the "env use" command.