Skip to main content

Helper utilities for pip

Project description

Helper utilities for pip.

Installation

pip install --user pip-utils

Usage

usage: pip3-utils [-h] [--version]
                  {dependants,dependents,locate,outdated,parents} ...

Helper utilities for pip.

positional arguments:
  {dependants,dependents,locate,outdated,parents}
    dependants          list dependants of package
    dependents          list dependents of package
    locate              identify package that file belongs to
    outdated            list outdated packages that may be updated
    parents             list packages lacking dependants

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit

See `pip3-utils COMMAND --help` for help on a specific subcommand.

For Python 2, use pip2-utils. For Python 3, use pip3-utils. Or, use python -m pip_utils.

By default, pip-utils will interact with packages installed to the user site (e.g. via --user). If you wish to disable this, as would often be the case in a virtualenv or with the system installation, call pip-utils with Python’s -s option (e.g. python -sm pip_utils).

Commands

List dependants of a package:

$ pip3-utils dependants pexpect
ipython

List direct dependents of a package:

$ pip3-utils dependents ipython
backports.shutil-get-terminal-size
decorator
pexpect
pickleshare
setuptools
simplegeneric
traitlets

List direct dependents of a package with their version requirements:

$ pip3-utils dependents -i dataset
alembic>=0.6.2
normality>=0.2.2
PyYAML>=3.10
six
six>=1.7.3
sqlalchemy>=0.9.1

List all dependencies of a package recursively:

$ pip3-utils dependents -r dataset
alembic
Mako
MarkupSafe
normality
python-editor
PyYAML
six
SQLAlchemy

Identify package(s) that file belongs to:

$ pip3-utils locate ~/.local/bin/symilar
pylint

List outdated packages that may be updated. Note, this differ’s from pip’s --outdated flag in that it verifies that there are no conflicting dependencies that would otherwise make an update inadvisable.

pip3-utils outdated

List all outdated packages. Note, this is equivalent to pip’s --outdated flag.

pip3-utils outdated --all

List outdated packages unable to be updated due to dependency requirements:

pip3-utils outdated --pinned

List packages lacking dependants:

pip3-utils parents

Development

To run tests (automatically pulling in dependencies):

python setup.py test

To run tests directly, with verbose output:

python3 -m pytest -vv

License

Copyright (c) 2016 Six (brbsix@gmail.com).

Licensed under the GPLv3 license.

Project details


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