Registry / devops / poetry-exec-plugin

poetry-exec-plugin

library1.0.1pypypiunverified

A Poetry plugin that allows executing scripts defined in pyproject.toml under the [tool.poetry.scripts] table, similar to npm run or pipenv run. Current version: 1.0.1, supports Poetry 2.x. Release cadence is sporadic.

devops

pip install poetry-exec-plugin

github ↗package ↗

INSTALL

IMPORT

SIG · POETRY-EXEC-PLUGIN

poetry-exec-plugin

devopspythonv1.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Define scripts in pyproject.toml and run them via `poetry exec <script-name>`.

# After installing the plugin, add scripts to pyproject.toml: # [tool.poetry.scripts] # greet = { callable = "my_package.module:greet_func", help = "Prints a greeting", args = "[name]" } # Then run: # poetry exec greet Alice

poetry --version

Debug

Known issues

breakingVersion 1.0.0 dropped support for Poetry 1.x. If you are on Poetry 1.x, pin to version 0.3.6.

fix

For Poetry 1.x: pip install 'poetry-exec-plugin<1.0.0' (e.g., 0.3.6).

affects: >=1.0.0

gotchaScripts must be defined under [tool.poetry.scripts] (not [tool.poetry.scripts.exec] or [tool.poetry.exec]).

fix

Use the correct TOML key: [tool.poetry.scripts].

affects: all

deprecatedThe previous script syntax using [tool.poetry.scripts.<name>] = "module:function" still works but the official docs now recommend the dict form with 'callable', 'help', and 'args'.

fix

Update to dict form: greet = { callable = "...", help = "...", args = "..." }.

affects: >=1.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'poetry_exec'

Missing import, but this plugin is not imported directly; it's activated via Poetry plugin mechanism. The error may appear when trying to import the plugin mistakenly.

fix

Do not import the plugin. Install it and run `poetry exec` as a CLI command.

AttributeError: module 'poetry' has no attribute 'exec'

The plugin is not installed or not activated in Poetry's environment. Poetry 2.x requires explicit plugin installation; `poetry self add` or install in the same environment.

fix

Run `poetry self add poetry-exec-plugin` (Poetry 2.x) or `pip install poetry-exec-plugin` in the same environment as poetry.

Plugin poetry-exec-plugin is not installed

The plugin is missing from Poetry's environment. It needs to be installed where Poetry is installed.

fix

Use `poetry self add poetry-exec-plugin` (Poetry 2.x) or reinstall with `pip install poetry-exec-plugin` in the Poetry environment.

Upgrade

Version history

1.0.1latest on PyPI · released Mar 17, 2025

Audit

Dependencies

poetryrequiredThe plugin operates as a Poetry plugin; must be installed in the same environment as Poetry.

Agent activity

5 hits · last 30 days

node

Bingbot

Resources

githubhttps://github.com/keattang/poetry-exec-plugin ↗

packagehttps://pypi.org/project/poetry-exec-plugin/ ↗