by alanhamlett

Update the packages in a requirements.txt file.

445 Stars 16 Forks Last release: 9 months ago (5.3.0) Other 123 Commits 12 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

.. image:: https://travis-ci.org/alanhamlett/pip-update-requirements.svg?branch=master :target: https://travis-ci.org/alanhamlett/pip-update-requirements :alt: Tests

.. image:: https://coveralls.io/repos/alanhamlett/pip-update-requirements/badge.svg?branch=master&service=github :target: https://coveralls.io/github/alanhamlett/pip-update-requirements?branch=master :alt: Coverage

.. image:: https://img.shields.io/pypi/v/pur.svg :target: https://pypi.python.org/pypi/pur :alt: Version

.. image:: https://img.shields.io/pypi/pyversions/pur.svg :target: https://pypi.python.org/pypi/pur :alt: Supported Python Versions

.. image:: https://wakatime.com/badge/github/alanhamlett/pip-update-requirements.svg :target: https://wakatime.com/badge/github/alanhamlett/pip-update-requirements


Update the packages in a


.. image:: https://raw.githubusercontent.com/alanhamlett/pip-update-requirements/master/pur.gif :alt: Purring Cat



pip install pur


Give pur your

file and it updates all your packages to the latest versions.

For example, given a


Running pur on that file updates the packages to current latest versions::

$ pur -r requirements.txt
Updated flask: 0.9 -> 1.0.2
Updated sqlalchemy: 0.9.10 -> 1.2.8
Updated alembic: 0.8.4 -> 0.9.9
All requirements up-to-date.

Pur never modifies your environment or installed packages, it only modifies your


You can also use Pur directly from Python::

$ python
Python 3.6.1
>>> from pur import update_requirements
>>> print([x[0]['message'] for x in update_requirements(input_file='requirements.txt').values()])
['Updated flask: 0.9 -> 1.0.2', 'Updated sqlalchemy: 0.9.10 -> 1.2.8', 'Updated alembic: 0.8.4 -> 0.9.9']
>>> print(open('requirements.txt').read())


-r, --requirement PATH The requirements.txt file to update; Defaults to using requirements.txt from the current directory if it exist. -o, --output PATH Output updated packages to this file; Defaults to overwriting the input requirements.txt file. -i, --interactive Interactively prompts before updating each package. -f, --force Force updating packages even when a package has no version specified in the input requirements.txt file. -d, --dry-run Output changes to STDOUT instead of overwriting the requirements.txt file. -n, --no-recursive Prevents updating nested requirements files. -s, --skip TEXT Comma separated list of packages to skip updating. --index-url TEXT Base URL of the Python Package Index. Can be provided multiple times for extra index urls. --only TEXT Comma separated list of packages. Only these packages will be updated. -m, --minor TEXT Comma separated list of packages to only update minor versions, never major. Use "" to limit every package to minor version updates. -p, --patch TEXT Comma separated list of packages to only update patch versions, never major or minor. Use "" to limit every package to patch version updates. --pre TEXT Comma separated list of packages to allow updating to pre-release versions. Use "*" to allow all packages to be updated to pre-release versions. By default packages are only updated to stable versions. -z, --nonzero-exit-code Exit with status l0 when all packages up-to-date, 11 when some packages were updated. Defaults to exit status zero on success and non-zero on failure. --version Show the version and exit. --help Show this message and exit.


Before contributing a pull request, make sure tests pass::

virtualenv venv
. venv/bin/activate
pip install tox

Many thanks to all


We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.