Skip to main content

pip-tools keeps your pinned dependencies fresh.

Project description

[![Build status](https://secure.travis-ci.org/nvie/pip-tools.png?branch=master)](https://secure.travis-ci.org/nvie/pip-tools)

pip-tools = pip-review + pip-dump

A set of two command line tools to help you keep your pip-based packages fresh, even when you’ve pinned them.

[You _do_ pin them, right?][0]

![pip-tools overview](http://cloud.github.com/downloads/nvie/pip-tools/pip-tools.png)

pip-review

pip-review checks PyPI and reports available updates. It uses the list of currently installed packages to check for updates, it does not use any requirements.txt

Example, report-only:

`console $ pip-review requests==0.13.4 available (you have 0.13.2) redis==2.4.13 available (you have 2.4.9) rq==0.3.2 available (you have 0.3.0) `

Example, actually install everything:

`console $ pip-review --auto ... <pip install output> `

Example, run interactively, ask to upgrade for each package:

`console $ pip-review --interactive requests==0.14.0 available (you have 0.13.2) Upgrade now? [Y]es, [N]o, [A]ll, [Q]uit y ... redis==2.6.2 available (you have 2.4.9) Upgrade now? [Y]es, [N]o, [A]ll, [Q]uit n rq==0.3.2 available (you have 0.3.0) Upgrade now? [Y]es, [N]o, [A]ll, [Q]uit y ... `

pip-dump

pip-dump dumps the exact versions of installed packages in your active environment to your requirements.txt file. If you have more than one file matching the *requirements.txt pattern (for example dev-requirements.txt), it will update each of them smartly.

Example:

`console $ cat requirements.txt Flask $ cat dev-requirements.txt ipython $ pip-dump $ cat requirements.txt Flask==0.9 Jinja2==2.6 Werkzeug==0.8.3 $ cat dev-requirements.txt ipython==0.13 `

Packages that you don’t want to dump but want to have installed locally nonetheless can be put in an optional file called .pipignore.

Installation

To install, simply use pip:

`console $ pip install pip-tools `

Decide for yourself whether you want to install the tools system-wide, or inside a virtual env. Both are supported.

Testing

To test with your active Python version:

`console $ ./run-tests.sh `

To test under all (supported) Python versions:

`console $ tox `

The tests run quite slow, since they actually interact with PyPI, which involves downloading packages, etc. So please be patient.

[![Flattr this][2]][1]

[0]: http://nvie.com/posts/pin-your-packages/ [1]: https://flattr.com/thing/882478/Pin-Your-Packages [2]: http://api.flattr.com/button/button-static-50x60.png [3]: https://bitheap.org/cram/

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pip-tools-0.3.6.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

pip_tools-0.3.6-cp27-none-macosx_10_10_x86_64.whl (6.8 kB view details)

Uploaded CPython 2.7 macOS 10.10+ x86-64

File details

Details for the file pip-tools-0.3.6.tar.gz.

File metadata

  • Download URL: pip-tools-0.3.6.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pip-tools-0.3.6.tar.gz
Algorithm Hash digest
SHA256 355d8c6db47291651b32756821c894101bff0aa4b4163bcc32ac567616f32265
MD5 931183954992b1f381aaff688be6a227
BLAKE2b-256 3a06191680311eaf7cfea185a21faf0954e1ea110592db9b417b221f38501b28

See more details on using hashes here.

File details

Details for the file pip_tools-0.3.6-cp27-none-macosx_10_10_x86_64.whl.

File metadata

File hashes

Hashes for pip_tools-0.3.6-cp27-none-macosx_10_10_x86_64.whl
Algorithm Hash digest
SHA256 fea53b632ccb1b8d0a1964242eaf66af1150dc534644df64d1b044e6204ecb8c
MD5 1dc0c5fb17b817cfc8bc1a355be2a11c
BLAKE2b-256 d1647918bc97abcadf8310a6d44fa5b930a3a038d12729263bcc3b5f7cf9a544

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page