Home

Awesome

pipdate

PyPi Version Anaconda Cloud PyPI pyversions GitHub stars PyPi downloads

gh-actions codecov Code style: black

pipdate is a collection of small pip update helpers. The command

pipdate
# or python3.9 -m pipdate

updates all your pip-installed packages. (Only works on Unix.)

There's a Python interface as well that can be used for update notifications. This

import pipdate

pipdate.check("matplotlib", "0.4.5")

will print

<img src="https://github.com/nschloe/pipdate/blob/assets/pipdate.png?raw=true" width="40%"/> <!-- ``` ╭──────────────────────────────────────────────╮ │ │ │ Update available 0.4.5 → 3.1.3 │ │ Run pip install -U matplotlib to update │ │ │ ╰──────────────────────────────────────────────╯ ``` -->

This can, for example, be used by package authors to notify users of upgrades of their own packages.

If you guard the check with

import pipdate

if pipdate.needs_checking("matplotlib"):
    pipdate.check("matplotlib", "0.4.5")

then it will be performed at most every k seconds, where k is specified in the config file $HOME/.config/pipdate/config.ini, e.g., once a day

[DEFAULT]
secondsbetweenchecks = 86400

Installation

pipdate is available from the Python Package Index, so simply type

pip install pipdate

Testing

To run the pipdate unit tests, check out this repository and type

pytest

License

This software is published under the GPLv3 license.