Skip to main content

Display installed pip packages and their update status.

Project description

Testsuite PyPi Version Monthly Downloads

pip-check

pip-check gives you a quick overview of all installed packages and their update status. Under the hood it calls pip list --outdated --format=columns and transforms it into a more user-friendly table.

pip-check also supports uv, or pip at any location. Pass the pip command using --cmd:

pip-check -c pip3
pip-check -c ".venv/bin/pip"
pip-check -c "uv pip"

Screenshot of pip-check in action

Installation:

pip install pip-check

Or Install the last version that runs on Python 2.7 or 3.4:

pip install pip-check==2.5.2

Usage:

$ pip-check -h
usage: __init__.py [-h] [-a] [-c PIP_CMD] [-l] [-r] [-f] [-H] [-u] [-U]

A quick overview of all installed packages and their update status. Supports `pip` or `uv pip`.

options:
  -h, --help            show this help message and exit
  -a, --ascii           Display as ASCII Table
  -c, --cmd PIP_CMD     The [uv] pip executable to run. E.g.: `/path/to/pip` or `uv pip`. Default: `pip`
  -l, --local           Show only virtualenv installed packages. (pip only)
  -r, --not-required    List only packages that are not dependencies of installed packages. (pip only)
  -f, --full-version    Show full version strings.
  -H, --hide-unchanged  Do not show "unchanged" packages.
  -u, --show-update     Show update instructions for updatable packages. (pip only)
  -U, --user            Show only user installed packages. (pip only)

Local Development

pip-check uses uv for local development.

$ pip install -U uv
uv sync     # Create a .venv and install dependencies
uv build    # Build distribution packages
uv publish  # Publish on Pypi

Testing:

Test against a variation of Python versions:

$ uv run nox

Recommended Similar Tools

  • pip-date - Show the installation or modification times of all your pip packages
  • pip-chill - Lists only the dependencies (or not) of installed packages

Changelog

v3.1 (2025-04-14):

  • Adopted uv and hatchling as the primary build tools.
  • Implemented nox as the test runner.
  • Migrated all documentation from reStructuredText to Markdown for improved readability and accessibility.
  • Introduced Ruff as a linter and optimized code to align with the current set of Ruff rules.
  • Added type annotations throughout the codebase.
  • Test against Python 3.14.

v3.0 (2025-04-11):

  • Added support for uv. Use --cmd="uv pip" to utilize uv.

v2.10 (2025-04-11):

  • Resolve the issue of missing line breaks when no packages are found.
  • Test against Python 3.13.

v2.9 (2024-09-01):

  • Show current Python and pip version upon load.
  • Test against Python 3.12.

v2.8.1 (2022-11-06):

  • Fixes issue with packages not correctly sorted into "Major" category.

v2.8 (2022-11-06):

  • Added support for Python 3.11.
  • Replaced deprecated "distutils" with "packaging" module.

v2.7 (2021-11-16):

  • Drop support for Python 2.7, 3.4 and 3.5
  • Added support for Python 3.9 and 3.10.
  • Removed 'colorclass' as a dependency and with that the shell argument --disable-colors.

v2.6 (2019-12-12):

  • Requires Python 3.5 or higher.
  • Command error is shown if pip exits with a status code 1 (or larger).
  • Error message is shown if pip is not able to load packages in case of network problems.
  • Update instructions will now add --user in case the pip-check command should only show user packages as well.

v2.5.2 (2019-08-08):

  • This is the last version that runs on Python 2.7. Install it with pip install pip-check==2.5.2
  • Windows color fixes.

v2.5.1 (2019-08-08):

  • Windows script fixes.

v2.5 (2019-08-08):

  • A more robust installation that installs pip-check as a proper console script.
  • Added new --disable-colors argument.
  • Added tests for Python 3.7 and 3.8.
  • Fixed Syntax warning happening with no outdated packages.
  • Cleanup of the entire codebase.

v2.4 (2019-07-23):

  • Added support to only show packages from the user or local package namespace.

v2.3.3 (2018-02-19):

  • Visual fixes around --show-update

v2.3.2 (2018-02-18):

  • New --show-update argument.
  • Fixed --full-versions argument.
  • Minor UI improvements.

v2.1 (2018-02-18):

  • Complete new architecture. It now calls pip directly and parses it output which should be more reliable.
  • It's also using distutils for the version comparision now, which is more reliable as well.
  • Lots of features and bug fixes.

v0.2 (2016-02-09):

  • Fixes issues with older pip versions.
  • Truncates extremly long version numbers.

v0.1 (2016-02-06):

  • Very first version, and yet with very limited features.

Project details


Download files

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

Source Distribution

pip_check-3.1.tar.gz (22.2 kB view details)

Uploaded Source

Built Distribution

pip_check-3.1-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file pip_check-3.1.tar.gz.

File metadata

  • Download URL: pip_check-3.1.tar.gz
  • Upload date:
  • Size: 22.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for pip_check-3.1.tar.gz
Algorithm Hash digest
SHA256 fccd9df3ad83c6d56054503a43445b08bbaea2ce8941b00342dd63e0def8b693
MD5 a089921d87e25bb7c4cfc93684c50546
BLAKE2b-256 37351ae1bbaef7bb1aba2b93807982f23d5d3c215de4bdd9460b3d3c29932bba

See more details on using hashes here.

File details

Details for the file pip_check-3.1-py3-none-any.whl.

File metadata

  • Download URL: pip_check-3.1-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for pip_check-3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9011d542f62031a3c8a03722de017cfce036fcf20d7267bbfc9d5d43e271838d
MD5 0dab08ccdba12a58e86a9112c491099d
BLAKE2b-256 7a6c3fade7a8111f400e32aa3a449154b75fef967529908659a7e48a133503f7

See more details on using hashes here.

Supported by

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