README.md

PoetryUp

PoetryUp updates dependencies and bumps their version in both poetry.lock as well as in pyproject.toml file. Dependencies version constraints are respected, unless the --latest flag is passed, in which case dependencies will be updated to their latest available version. PoetryUp runs poetry commands, thus it's required to be installed. The difference between running poetry update and poetryup, is that the latter also modifies the pyproject.toml file.

Usage

Show help message and exit

poetryup --help

Update all dependencies with respect to their version constraints specified in the pyproject.toml file

poetryup

Update all dependencies to their latest available version

poetryup --latest

Update all dependencies to their latest available version except for packages with an exact version

poetryup --latest --skip-exact

Update dependencies in the default and dev group to their latest available version

poetryup --latest --group default --group dev

Update the foo and bar dependencies to their latest available version

poetryup --latest --name foo --name bar

Update all dependencies to their latest available version except the foo and bar dependencies

poetryup --latest --exclude-name foo --exclude-name bar

Automate Dependency Updates with GitHub Actions

Use PoetryUp with GitHub actions to automate the process of updating dependencies, for reference see this project's workflow configuration.

Contributing

Contributions are welcome via pull requests.

Issues

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

Develop

Activate virtual environment

poetry shell

Install dependencies

poetry install --remove-untracked

Install git hooks

pre-commit install --hook-type pre-commit

Run tests

pytest tests

Run linter

flake8 .

Format code

black .

Sort imports

isort .

Install current project from branch

poetry add git+https://github.com/MousaZeidBaker/poetryup.git#branch-name