Display installed pip packages and their update status.
Project description
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"
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
orlocal
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
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
fccd9df3ad83c6d56054503a43445b08bbaea2ce8941b00342dd63e0def8b693
|
|
MD5 |
a089921d87e25bb7c4cfc93684c50546
|
|
BLAKE2b-256 |
37351ae1bbaef7bb1aba2b93807982f23d5d3c215de4bdd9460b3d3c29932bba
|
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
Algorithm | Hash digest | |
---|---|---|
SHA256 |
9011d542f62031a3c8a03722de017cfce036fcf20d7267bbfc9d5d43e271838d
|
|
MD5 |
0dab08ccdba12a58e86a9112c491099d
|
|
BLAKE2b-256 |
7a6c3fade7a8111f400e32aa3a449154b75fef967529908659a7e48a133503f7
|