Metadata-Version: 2.1 Name: pip-review Version: 1.3.0 Summary: pip-review lets you smoothly manage all available PyPI updates. Home-page: https://github.com/jgonggrijp/pip-review Author: Julian Gonggrijp, Vincent Driessen Author-email: j.gonggrijp@gmail.com License: BSD Description: .. image:: https://travis-ci.org/jgonggrijp/pip-review.svg?branch=master :alt: Build status :target: https://secure.travis-ci.org/jgonggrijp/pip-review pip-review ========== *Looking for a new maintainer! See https://github.com/jgonggrijp/pip-review/issues/76.* ``pip-review`` is a convenience wrapper around ``pip``. It can list available updates by deferring to ``pip list --outdated``. It can also automatically or interactively install available updates for you by deferring to ``pip install``. Example, report-only: .. code:: console $ pip-review requests==0.13.4 is available (you have 0.13.2) redis==2.4.13 is available (you have 2.4.9) rq==0.3.2 is available (you have 0.3.0) Example, actually install everything: .. code:: console $ pip-review --auto ... Example, run interactively, ask to upgrade for each package: .. code:: console $ pip-review --interactive requests==0.14.0 is available (you have 0.13.2) Upgrade now? [Y]es, [N]o, [A]ll, [Q]uit y ... redis==2.6.2 is available (you have 2.4.9) Upgrade now? [Y]es, [N]o, [A]ll, [Q]uit n rq==0.3.2 is available (you have 0.3.0) Upgrade now? [Y]es, [N]o, [A]ll, [Q]uit y ... Run ``pip-review -h`` for a complete overview of the options. Note: If you want to pin specific packages to prevent them from automatically being upgraded, you can use a constraint file (similar to ``requirements.txt``): .. code:: console $ export PIP_CONSTRAINT="${HOME}/constraints.txt $ cat $PIP_CONSTRAINT pyarrow==0.14.1 pandas<0.24.0 $ pip-review --auto ... Set this variable in ``.bashrc`` or ``.zshenv`` to make it persistent. Alternatively, this option can be specified in ``pip.conf``, e.g.: * Linux: .. code:: console $ cat ~/.config/pip/pip.conf [global] constraint = /home/username/constraints.txt * Windows: .. code:: console $ cat $HOME\AppData\Roaming\pip\pip.ini [global] constraint = '$HOME\Roaming\pip\constraints.txt' The conf file are dependent of the user, so If you use multiple users you must define config file for each of them. https://pip.pypa.io/en/stable/user_guide/#constraints-files Since version 0.5, you can also invoke pip-review as ``python -m pip_review``. This can be useful if you are using multiple versions of Python next to each other. Before version 1.0, ``pip-review`` had its own logic for finding package updates instead of relying on ``pip list --outdated``. Like ``pip``, ``pip-review`` updates **all** packages, including ``pip`` and ``pip-review``. Installation ============ To install, simply use pip: .. code:: console $ pip install pip-review Decide for yourself whether you want to install the tool system-wide, or inside a virtual env. Both are supported. Testing ======= To test with your active Python version: .. code:: console $ ./run-tests.sh To test under all (supported) Python versions: .. code:: console $ tox The tests run quite slow, since they actually interact with PyPI, which involves downloading packages, etc. So please be patient. Origins ======= ``pip-review`` was originally part of pip-tools_ but has been discontinued_ as such. See `Pin Your Packages`_ by Vincent Driessen for the original introduction. Since there are still use cases, the tool now lives on as a separate package. .. _pip-tools: https://github.com/nvie/pip-tools/ .. _discontinued: https://github.com/nvie/pip-tools/issues/185 .. _Pin Your Packages: http://nvie.com/posts/pin-your-packages/ .. _cram: https://bitheap.org/cram/ Platform: any Classifier: Development Status :: 5 - Production/Stable Classifier: Programming Language :: Python Classifier: Programming Language :: Python :: 2 Classifier: Programming Language :: Python :: 2.7 Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.3 Classifier: Programming Language :: Python :: 3.4 Classifier: Programming Language :: Python :: 3.5 Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Intended Audience :: Developers Classifier: Intended Audience :: System Administrators Classifier: License :: OSI Approved :: BSD License Classifier: Operating System :: OS Independent Classifier: Topic :: System :: Systems Administration Requires-Python: >=2.7, !=3.0, !=3.1, !=3.2 Description-Content-Type: text/x-rst