| Name | pip-check JSON |
| Version |
3.2.1
JSON |
| download |
| home_page | None |
| Summary | Display installed pip packages and their update status. |
| upload_time | 2025-08-27 18:15:10 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://github.com/bartTC/pip-check/actions/workflows/test.yml)
[](https://pypi.org/project/pip-check/)

# 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:
```bash
$ 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.
```
uv sync # Create a .venv and install dependencies
uv build # Build distribution packages
uvx uv-publish # Publish on Pypi
```
### Testing:
Test against a variation of Python versions:
```bash
$ uv run nox
```
## Recommended Similar Tools
- [pip-date](https://github.com/E3V3A/pip-date) - Show the installation or modification times of all your pip packages
- [pip-chill](https://github.com/rbanffy/pip-chill) - Lists only the dependencies (or not) of installed packages
# Changelog
v3.2 (2025-08-27):
v3.2.1 (2025-08-27):
- Fix 'uv' support to work with latest UV version.
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.
Raw data
{
"_id": null,
"home_page": null,
"name": "pip-check",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Martin Mahner <martin@mahner.org>",
"download_url": "https://files.pythonhosted.org/packages/2a/a4/9631bcc958863aa57ac619a2b67c0f73c48412bec5bd958fe2e70d35238d/pip_check-3.2.1.tar.gz",
"platform": null,
"description": "[](https://github.com/bartTC/pip-check/actions/workflows/test.yml)\n[](https://pypi.org/project/pip-check/)\n\n\n# pip-check\n\npip-check gives you a quick overview of all installed packages and their\nupdate status. Under the hood it calls `pip list --outdated --format=columns`\nand transforms it into a more user-friendly table.\n\npip-check also supports uv, or pip at any location. Pass the `pip`\ncommand using `--cmd`:\n\n```\npip-check -c pip3\npip-check -c \".venv/bin/pip\"\npip-check -c \"uv pip\"\n```\n\n\n\n## Installation:\n\n```\npip install pip-check\n```\n \nOr Install the last version that runs on Python 2.7 or 3.4:\n\n```\npip install pip-check==2.5.2\n``` \n\n## Usage:\n\n```bash\n$ pip-check -h\nusage: __init__.py [-h] [-a] [-c PIP_CMD] [-l] [-r] [-f] [-H] [-u] [-U]\n\nA quick overview of all installed packages and their update status. Supports `pip` or `uv pip`.\n\noptions:\n -h, --help show this help message and exit\n -a, --ascii Display as ASCII Table\n -c, --cmd PIP_CMD The [uv] pip executable to run. E.g.: `/path/to/pip` or `uv pip`. Default: `pip`\n -l, --local Show only virtualenv installed packages. (pip only)\n -r, --not-required List only packages that are not dependencies of installed packages. (pip only)\n -f, --full-version Show full version strings.\n -H, --hide-unchanged Do not show \"unchanged\" packages.\n -u, --show-update Show update instructions for updatable packages. (pip only)\n -U, --user Show only user installed packages. (pip only)\n```\n\n## Local Development\n\npip-check uses `uv` for local development.\n\n```\nuv sync # Create a .venv and install dependencies\nuv build # Build distribution packages\nuvx uv-publish # Publish on Pypi\n```\n\n### Testing:\n\nTest against a variation of Python versions:\n\n```bash\n$ uv run nox\n```\n\n## Recommended Similar Tools\n\n- [pip-date](https://github.com/E3V3A/pip-date) - Show the installation or modification times of all your pip packages\n- [pip-chill](https://github.com/rbanffy/pip-chill) - Lists only the dependencies (or not) of installed packages\n\n\n# Changelog\n\nv3.2 (2025-08-27):\nv3.2.1 (2025-08-27):\n\n- Fix 'uv' support to work with latest UV version.\n\nv3.1 (2025-04-14):\n\n- Adopted **uv** and **hatchling** as the primary build tools.\n- Implemented **nox** as the test runner.\n- Migrated all documentation from **reStructuredText** to **Markdown** for improved readability and accessibility.\n- Introduced **Ruff** as a linter and optimized code to align with the current set of Ruff rules.\n- Added type annotations throughout the codebase.\n- Test against **Python 3.14**.\n\nv3.0 (2025-04-11):\n\n- Added support for ``uv``. Use ``--cmd=\"uv pip\"`` to utilize uv.\n\nv2.10 (2025-04-11):\n\n- Resolve the issue of missing line breaks when no packages are found.\n- Test against Python 3.13.\n\nv2.9 (2024-09-01):\n\n- Show current Python and pip version upon load.\n- Test against Python 3.12.\n\nv2.8.1 (2022-11-06):\n\n- Fixes issue with packages not correctly sorted into \"Major\" category.\n\nv2.8 (2022-11-06):\n\n- Added support for Python 3.11.\n- Replaced deprecated \"distutils\" with \"packaging\" module.\n\nv2.7 (2021-11-16):\n\n- Drop support for Python 2.7, 3.4 and 3.5\n- Added support for Python 3.9 and 3.10.\n- Removed 'colorclass' as a dependency and with that the shell argument\n `--disable-colors`.\n\nv2.6 (2019-12-12):\n\n- Requires Python 3.5 or higher.\n- Command error is shown if pip exits with a status code 1 (or larger).\n- Error message is shown if pip is not able to load packages in case of\n network problems.\n- Update instructions will now add ``--user`` in case the pip-check command\n should only show user packages as well.\n\nv2.5.2 (2019-08-08):\n\n- This is the last version that runs on Python 2.7. Install it with\n ``pip install pip-check==2.5.2``\n- Windows color fixes.\n\nv2.5.1 (2019-08-08):\n\n- Windows script fixes.\n\nv2.5 (2019-08-08):\n\n- A more robust installation that installs pip-check as a proper console script.\n- Added new ``--disable-colors`` argument.\n- Added tests for Python 3.7 and 3.8.\n- Fixed Syntax warning happening with no outdated packages.\n- Cleanup of the entire codebase.\n\nv2.4 (2019-07-23):\n\n- Added support to only show packages from the ``user`` or ``local`` package\n namespace.\n\nv2.3.3 (2018-02-19):\n\n- Visual fixes around ``--show-update``\n\nv2.3.2 (2018-02-18):\n\n- New ``--show-update`` argument.\n- Fixed ``--full-versions`` argument.\n- Minor UI improvements.\n\nv2.1 (2018-02-18):\n\n- Complete new architecture. It now calls ``pip`` directly and parses it output\n which should be more reliable.\n- It's also using distutils for the version comparision now, which is more\n reliable as well.\n- Lots of features and bug fixes.\n\nv0.2 (2016-02-09):\n\n- Fixes issues with older pip versions.\n- Truncates extremly long version numbers.\n\nv0.1 (2016-02-06):\n\n- Very first version, and yet with very limited features.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Display installed pip packages and their update status.",
"version": "3.2.1",
"project_urls": {
"Homepage": "https://github.com/bartTC/pip-check/",
"Issues": "https://github.com/bartTC/pip-check/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "32eca9b389fe563075c2460b51c9742e4c298c63961d8b2bf207b7609424cb7b",
"md5": "d9b48d2f13162da17438ce650848c58d",
"sha256": "5438ec867fb02d0ad9fefb90f060c025def709cb938a555b1c7cba93602000fe"
},
"downloads": -1,
"filename": "pip_check-3.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d9b48d2f13162da17438ce650848c58d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9225,
"upload_time": "2025-08-27T18:15:09",
"upload_time_iso_8601": "2025-08-27T18:15:09.500508Z",
"url": "https://files.pythonhosted.org/packages/32/ec/a9b389fe563075c2460b51c9742e4c298c63961d8b2bf207b7609424cb7b/pip_check-3.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2aa49631bcc958863aa57ac619a2b67c0f73c48412bec5bd958fe2e70d35238d",
"md5": "41a86fa103b2b2aa3791643b3e872a46",
"sha256": "623c0c0cfd793ef8593adf3d5364c7b9287f82e2937e57e790e4596c038e57b3"
},
"downloads": -1,
"filename": "pip_check-3.2.1.tar.gz",
"has_sig": false,
"md5_digest": "41a86fa103b2b2aa3791643b3e872a46",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 24566,
"upload_time": "2025-08-27T18:15:10",
"upload_time_iso_8601": "2025-08-27T18:15:10.565184Z",
"url": "https://files.pythonhosted.org/packages/2a/a4/9631bcc958863aa57ac619a2b67c0f73c48412bec5bd958fe2e70d35238d/pip_check-3.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-27 18:15:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bartTC",
"github_project": "pip-check",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pip-check"
}