# Poetry Plugin: upgrade
![release](https://github.com/apoclyps/poetry-plugin-upgrade/actions/workflows/release.yml/badge.svg)
![test](https://github.com/apoclyps/poetry-plugin-upgrade/actions/workflows/test.yml/badge.svg)
[![license](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
![python_version](https://img.shields.io/badge/Python-%3E=3.11-blue)
![poetry_version](https://img.shields.io/badge/Poetry-%3E=1.6-blue)
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.
```shell
poetry self add poetry-plugin-upgrade
```
If you used `pipx` to install Poetry you can add the plugin via the `pipx inject` command.
```shell
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.
```shell
pip install poetry-plugin-upgrade
```
## Usage
The plugin provides an `upgrade` command to update dependencies
```shell
poetry upgrade --help
```
Update dependencies
```shell
poetry upgrade
```
Update dependencies to the latest available compatible versions
```shell
poetry upgrade --latest
```
Update the `foo` and `bar` packages
```shell
poetry upgrade foo bar
```
Update packages only in the `main` group
```shell
poetry upgrade --only main
```
Update packages but ignore the `dev` group
```shell
poetry upgrade --without dev
```
## Contributing
Contributions are welcome! See the [Contributing Guide](https://github.com/apoclyps/poetry-plugin-upgrade/blob/master/CONTRIBUTING.md).
## Issues
If you encounter any problems, please file an [issue](https://github.com/apoclyps/poetry-plugin-upgrade/issues) along with a
detailed description.
Raw data
{
"_id": null,
"home_page": "https://github.com/apoclyps/poetry-plugin-upgrade",
"name": "poetry-plugin-upgrade",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "packaging,dependency,poetry,update,upgrade",
"author": "Kyle Harrison",
"author_email": "kyle.harrison.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/6d/43/cc48200060a1508ba5c9aee47dc510f54a766958c518fec2d0b2021ad08f/poetry_plugin_upgrade-0.2.0.tar.gz",
"platform": null,
"description": "# Poetry Plugin: upgrade\n\n![release](https://github.com/apoclyps/poetry-plugin-upgrade/actions/workflows/release.yml/badge.svg)\n![test](https://github.com/apoclyps/poetry-plugin-upgrade/actions/workflows/test.yml/badge.svg)\n[![license](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)\n![python_version](https://img.shields.io/badge/Python-%3E=3.11-blue)\n![poetry_version](https://img.shields.io/badge/Poetry-%3E=1.6-blue)\n\nThis 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.\n\nThis plugin provides similar features as the existing `update` command with additional features.\n\n## Installation\n\nThe easiest way to install the `upgrade` plugin is via the `self add` command of Poetry.\n\n```shell\npoetry self add poetry-plugin-upgrade\n```\n\nIf you used `pipx` to install Poetry you can add the plugin via the `pipx inject` command.\n\n```shell\npipx inject poetry poetry-plugin-upgrade\n```\n\nOtherwise, if you used `pip` to install Poetry you can add the plugin packages via the `pip install` command.\n\n```shell\npip install poetry-plugin-upgrade\n```\n\n## Usage\n\nThe plugin provides an `upgrade` command to update dependencies\n\n```shell\npoetry upgrade --help\n```\n\nUpdate dependencies\n\n```shell\npoetry upgrade\n```\n\nUpdate dependencies to the latest available compatible versions\n\n```shell\npoetry upgrade --latest\n```\n\nUpdate the `foo` and `bar` packages\n\n```shell\npoetry upgrade foo bar\n```\n\nUpdate packages only in the `main` group\n\n```shell\npoetry upgrade --only main\n```\n\nUpdate packages but ignore the `dev` group\n\n```shell\npoetry upgrade --without dev\n```\n\n## Contributing\n\nContributions are welcome! See the [Contributing Guide](https://github.com/apoclyps/poetry-plugin-upgrade/blob/master/CONTRIBUTING.md).\n\n## Issues\n\nIf you encounter any problems, please file an [issue](https://github.com/apoclyps/poetry-plugin-upgrade/issues) along with a\ndetailed description.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Poetry plugin that updates dependencies and bumps their versions in pyproject.toml file",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/apoclyps/poetry-plugin-upgrade",
"Repository": "https://github.com/apoclyps/poetry-plugin-upgrade"
},
"split_keywords": [
"packaging",
"dependency",
"poetry",
"update",
"upgrade"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5469c86aa42f506d8ea3051cc57810f6702a6e5c85599a52102ee660f8749830",
"md5": "b39dbcf3ecbfd0898da70f1c58232647",
"sha256": "379d18a31a9e7d849481890381c77818c13f10dec1322c7f630cd8490e41b822"
},
"downloads": -1,
"filename": "poetry_plugin_upgrade-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b39dbcf3ecbfd0898da70f1c58232647",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 7149,
"upload_time": "2023-12-05T16:30:42",
"upload_time_iso_8601": "2023-12-05T16:30:42.056225Z",
"url": "https://files.pythonhosted.org/packages/54/69/c86aa42f506d8ea3051cc57810f6702a6e5c85599a52102ee660f8749830/poetry_plugin_upgrade-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6d43cc48200060a1508ba5c9aee47dc510f54a766958c518fec2d0b2021ad08f",
"md5": "4fa7bbc9309afe2c831f97d3dbb440eb",
"sha256": "acaa0eda684d20613dda3775d6a6836549e01eec36ee22e5c26d27953db9b6d3"
},
"downloads": -1,
"filename": "poetry_plugin_upgrade-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "4fa7bbc9309afe2c831f97d3dbb440eb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 6733,
"upload_time": "2023-12-05T16:30:46",
"upload_time_iso_8601": "2023-12-05T16:30:46.714164Z",
"url": "https://files.pythonhosted.org/packages/6d/43/cc48200060a1508ba5c9aee47dc510f54a766958c518fec2d0b2021ad08f/poetry_plugin_upgrade-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-05 16:30:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "apoclyps",
"github_project": "poetry-plugin-upgrade",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "poetry-plugin-upgrade"
}