pip-check


Namepip-check JSON
Version 3.2.1 PyPI version JSON
download
home_pageNone
SummaryDisplay installed pip packages and their update status.
upload_time2025-08-27 18:15:10
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![Testsuite](https://github.com/bartTC/pip-check/actions/workflows/test.yml/badge.svg)](https://github.com/bartTC/pip-check/actions/workflows/test.yml)
[![PyPi Version](https://img.shields.io/pypi/v/pip-check
)](https://pypi.org/project/pip-check/)
![Monthly Downloads](https://img.shields.io/pypi/dm/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"
```

![Screenshot of pip-check in action](https://d.pr/i/ZDPuw5.png)

## 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": "[![Testsuite](https://github.com/bartTC/pip-check/actions/workflows/test.yml/badge.svg)](https://github.com/bartTC/pip-check/actions/workflows/test.yml)\n[![PyPi Version](https://img.shields.io/pypi/v/pip-check\n)](https://pypi.org/project/pip-check/)\n![Monthly Downloads](https://img.shields.io/pypi/dm/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![Screenshot of pip-check in action](https://d.pr/i/ZDPuw5.png)\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"
}
        
Elapsed time: 2.05054s