README.md

Poetry Plugin: upgrade

This package is a plugin that updates dependencies and bumps their versions in pyproject.toml file. The version constraints are respected, unless the --latest flag is passed, in which case dependencies are updated to the latest available compatible versions.

This plugin provides similar features as the existing update command with additional features.

Installation

The easiest way to install the upgrade plugin is via the self add command of Poetry.

poetry self add poetry-plugin-upgrade

If you used pipx to install Poetry you can add the plugin via the pipx inject command.

pipx inject poetry poetry-plugin-upgrade

Otherwise, if you used pip to install Poetry you can add the plugin packages via the pip install command.

pip install poetry-plugin-upgrade

Usage

The plugin provides an upgrade command to update dependencies

poetry upgrade --help

Update dependencies

poetry upgrade

Update dependencies to the latest available compatible versions

poetry upgrade --latest

Update the foo and bar packages

poetry upgrade foo bar

Update packages only in the main group

poetry upgrade --only main

Update packages but ignore the dev group

poetry upgrade --without dev

Example Usage

To Add poetry-plugin-upgrade to poetry using the latest version and to bump all your dev dependencies without modifying transitive dependencies you can run

poetry self add poetry-plugin-upgrade

poetry upgrade --only=dev --latest --pinned --no-interaction --no-install

Contributing

Contributions are welcome! See the Contributing Guide.

Issues

If you encounter any problems, please file an issue along with a detailed description.