Registry / devops / poetry-plugin-shell

poetry-plugin-shell

JSON →
cli1.0.1pypypiunverified

The `poetry-plugin-shell` is an official Poetry plugin that extends the Poetry CLI with a `shell` command. This command allows users to open a subshell with their project's virtual environment automatically activated, making it easy to interact with installed project dependencies. It is currently at version 1.0.1 and generally releases updates to ensure compatibility with new Poetry versions.

poetry self add poetry-plugin-shell
INSTALL
IMPORT
SIG · POETRY-PLUGIN-SHEL
P
poetry-plugin-shell
devopspythonv1.0.1
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

After installing the plugin using `poetry self add`, navigate to a Poetry-managed project directory and run `poetry shell`. This will open a new subshell (e.g., bash, zsh, cmd) with your project's virtual environment activated, allowing you to run project executables or Python scripts directly.

poetry shell
poetry --version
Debug
Known issues
breakingThis plugin requires Poetry version 1.2.0 or newer. Installing it with older Poetry versions will result in a plugin load error.
fix
Upgrade your Poetry installation to a compatible version using `poetry self update` before adding the plugin.
affects: <1.2.0
gotchaThe `poetry-plugin-shell` must be installed as a Poetry self-plugin for the Poetry CLI, not within a project's virtual environment using `pip install`.
fix
Always use `poetry self add poetry-plugin-shell` to install the plugin. Do not try `pip install poetry-plugin-shell` in a project's virtual environment or globally.
affects: All versions
Errors
Common errors & fixes
Command `shell` not found.
The `poetry-plugin-shell` plugin is either not installed for your Poetry CLI, or your Poetry installation is too old to support the plugin system.
fix
Ensure Poetry is updated to at least 1.2.0 (`poetry self update`) and then install the plugin using `poetry self add poetry-plugin-shell`.
poetry.plugins.exceptions.PluginLoadError: Plugin `poetry-plugin-shell` could not be loaded because of an incompatible Poetry version.
Your Poetry CLI version is older than the required 1.2.0, which introduced the plugin system and required API.
fix
Upgrade your Poetry installation to version 1.2.0 or newer using `poetry self update`.
Upgrade
Version history
1.0.1latest on PyPI · released Jan 5, 2025
Audit
Dependencies

No dependency data recorded yet.

Agent activity
26 hits · last 30 days
node
20
OpenAI (training)
2
Resources
poetry-plugin-shell — pip install poetry-plugin-shell · libregistry