157

Without going through with the installation, I want to quickly see all the packages that pip install would install.

2

11 Answers 11

148

Check out my project johnnydep!

Installation:

pip install johnnydep

Usage example:

$ johnnydep requests
name                       summary
-------------------------  ----------------------------------------------------------------------
requests                   Python HTTP for Humans.
├── certifi>=2017.4.17     Python package for providing Mozilla's CA Bundle.
├── chardet<3.1.0,>=3.0.2  Universal encoding detector for Python 2 and 3
├── idna<2.7,>=2.5         Internationalized Domain Names in Applications (IDNA)
└── urllib3<1.23,>=1.21.1  HTTP library with thread-safe connection pooling, file post, and more.

A more complex tree:

$ johnnydep ipython 
name                              summary
--------------------------------  -----------------------------------------------------------------------------
ipython                           IPython: Productive Interactive Computing
├── appnope                       Disable App Nap on OS X 10.9
├── decorator                     Better living through Python with decorators
├── jedi>=0.10                    An autocompletion tool for Python that can be used for text editors.
│   └── parso==0.1.1              A Python Parser
├── pexpect                       Pexpect allows easy control of interactive console applications.
│   └── ptyprocess>=0.5           Run a subprocess in a pseudo terminal
├── pickleshare                   Tiny 'shelve'-like database with concurrency support
├── prompt-toolkit<2.0.0,>=1.0.4  Library for building powerful interactive command lines in Python
│   ├── six>=1.9.0                Python 2 and 3 compatibility utilities
│   └── wcwidth                   Measures number of Terminal column cells of wide-character codes
├── pygments                      Pygments is a syntax highlighting package written in Python.
├── setuptools>=18.5              Easily download, build, install, upgrade, and uninstall Python packages
├── simplegeneric>0.8             Simple generic functions (similar to Python's own len(), pickle.dump(), etc.)
└── traitlets>=4.2                Traitlets Python config system
    ├── decorator                 Better living through Python with decorators
    ├── ipython-genutils          Vestigial utilities from IPython
    └── six                       Python 2 and 3 compatibility utilities
10
  • 8
    @so860 No, it does not require the packages to be installed. That's the whole point, it works in an isolated environment.
    – wim
    Aug 6, 2019 at 16:37
  • 4
    To be clear: installing johnnydep itself installs dependencies.
    – GPHemsley
    May 1, 2020 at 8:34
  • 3
    @wim: this project is pure brillance ! Love it ! Aug 25, 2020 at 23:57
  • 4
    @BenFarmer That's incorrect. It doesn't install packages, it reads the metadata from wheel files, which does require a package download- but not an installation. In the rare case that a project has published a source distribution but no compatible wheel is available, then pip will attempt to generate a wheel from the sdist (that is the only reliable way to get package metadata from sdist). In the most common case, there is no installation process.
    – wim
    Dec 22, 2020 at 2:03
  • 3
    @GPHemsley .. and it has quite some dependencies, see pip show: Requires: structlog, wheel, setuptools, wimpy, cachetools, anytree, distlib, tabulate, colorama, pip, packaging, toml, pkginfo, oyaml
    – Timo
    Jul 3, 2021 at 5:48
116

This was tested with pip versions 8.1.2, 9.0.1, 10.0.1, and 18.1.

To get the output without cluttering your current directory on Linux use

pip download [package] -d /tmp --no-binary :all: -v

-d tells pip the directory that download should put files in.

Better, just use this script with the argument being the package name to get only the dependencies as output:

#!/bin/sh

PACKAGE=$1
pip download $PACKAGE -d /tmp --no-binary :all:-v 2>&1 \
| grep Collecting \
| cut -d' ' -f2 \
| grep -Ev "$PACKAGE(~|=|\!|>|<|$)"

Also available here.

8
  • 5
    Some packages only provide binary, so --no-binary :all: is not a good idea. A project which only shipped wheel and not sdist would fail.
    – wim
    Apr 19, 2019 at 18:17
  • 8
    This end up download and compile for all the dependence packages which can be very slow....
    – Louis Yang
    Sep 4, 2019 at 20:36
  • 1
    Since recent versions of pip can be using PEP 517 / PEP 518, this may also start to turn up false positives because of the build-system requirements. Unreliable.
    – wim
    Jan 29, 2020 at 20:56
  • 2
    Note that this does not list dependencies that are already installed (which is fine for OP).
    – GPHemsley
    May 1, 2020 at 8:31
  • 2
    What if I want to do this for a local package I am working on? e.g. that I would install with "pip install -e ./mypackage"? Sometimes I just want to know what the full dependency tree is for a project that I am working on.
    – Ben Farmer
    Dec 22, 2020 at 3:37
28

If and only if the package is installed, you can use pip show <package>. Look for the Requires: field at the end of the output. Clearly, this breaks your requirement but might be useful nonetheless.

For example:

$ pip --version
pip 7.1.0 [...]
$ pip show pytest
---
Metadata-Version: 2.0
Name: pytest
Version: 2.7.2
Summary: pytest: simple powerful testing with Python
Home-page: http://pytest.org
Author: Holger Krekel, Benjamin Peterson, Ronny Pfannschmidt, Floris Bruynooghe and others
Author-email: holger at merlinux.eu
License: MIT license
Location: /home/usr/.tox/develop/lib/python2.7/site-packages
Requires: py
1
  • 4
    This only shows the direct requirements, all the transitive dependencies would be missing. And it requires an installation. So, it doesn't really answer the question.
    – wim
    Jun 18, 2019 at 13:58
18

Note: the feature used in this answer was deprecated in 2014 and removed in 2015. Please see other answers that apply to modern pip.

The closest you can get with pip directly is by using the --no-install argument:

pip install --no-install <package>

For example, this is the output when installing celery:

Downloading/unpacking celery                                                                                   
  Downloading celery-2.5.5.tar.gz (945Kb): 945Kb downloaded
  Running setup.py egg_info for package celery

    no previously-included directories found matching 'tests/*.pyc'
    no previously-included directories found matching 'docs/*.pyc'
    no previously-included directories found matching 'contrib/*.pyc'
    no previously-included directories found matching 'celery/*.pyc'
    no previously-included directories found matching 'examples/*.pyc'
    no previously-included directories found matching 'bin/*.pyc'
    no previously-included directories found matching 'docs/.build'
    no previously-included directories found matching 'docs/graffles'
    no previously-included directories found matching '.tox/*'
Downloading/unpacking anyjson>=0.3.1 (from celery)
  Downloading anyjson-0.3.3.tar.gz
  Running setup.py egg_info for package anyjson

Downloading/unpacking kombu>=2.1.8,<2.2.0 (from celery)
  Downloading kombu-2.1.8.tar.gz (273Kb): 273Kb downloaded
  Running setup.py egg_info for package kombu

Downloading/unpacking python-dateutil>=1.5,<2.0 (from celery)
  Downloading python-dateutil-1.5.tar.gz (233Kb): 233Kb downloaded
  Running setup.py egg_info for package python-dateutil

Downloading/unpacking amqplib>=1.0 (from kombu>=2.1.8,<2.2.0->celery)
  Downloading amqplib-1.0.2.tgz (58Kb): 58Kb downloaded
  Running setup.py egg_info for package amqplib

Successfully downloaded celery anyjson kombu python-dateutil amqplib

Admittedly, this does leave some cruft around in the form of temporary files, but it does accomplish the goal. If you're doing this with virtualenv (which you should be), the cleanup is as easy as removing the <virtualenv root>/build directory.

11
  • 8
    The reason for this is that the metadata doesn't exist outside of setup.py so unlike say with rpm or dpkg where you build a metadata index on top and query that pip and pypi don't work that way. So we have to pass over each requirement.
    – user146416
    Jun 22, 2012 at 15:40
  • 12
    I tried pip --no-install celery but I receive the error no such option: --no-install (pip 1.2.1) Dec 13, 2012 at 20:35
  • 4
    I think he meant pip install --no-install celery
    – entropy
    Jan 24, 2013 at 0:57
  • 23
    On my pip version (1.5.4) the --no-install flag is deprecated.
    – Jian
    May 9, 2014 at 6:26
  • 4
    For 1.5.4, use pip install --download=. --no-use-wheel celery
    – radtek
    Aug 5, 2014 at 20:27
12

I quote an alternative solution from @onnovalkering:

PyPi provides a JSON endpoint with package metadata:

>>> import requests
>>> url = 'https://pypi.org/pypi/{}/json'
>>> json = requests.get(url.format('pandas')).json()
>>> json['info']['requires_dist']
['numpy (>=1.9.0)', 'pytz (>=2011k)', 'python-dateutil (>=2.5.0)']
>>> json['info']['requires_python']
'>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*'

For a specific package version, add an additional version segment to the URL:

https://pypi.org/pypi/pandas/0.22.0/json

Also if you are using conda (as suggested by @ShpielMeister), you can use:

conda info package==X.X.X

to display information, including dependencies for a particular version or:

conda info package

to display information, including dependencies about all supported versions of that package.

2
  • 2
    I downvoted because this json endpoint is not reliable. For an example look at boto3, the requires_dist is null but that is a project which certainly has dependencies in the metadata.
    – wim
    Dec 18, 2019 at 3:07
  • 1
    The example for boto3 contains the required packages (curl -L 'https://pypi.python.org/pypi/boto3/json' | jq '.info.requires_dist'). So I am not sure if the critique is still valid.
    – p13rr0m
    Jul 27, 2022 at 8:40
9

Use pipdeptree ( pip install pipdeptree). Needs the package to be installed.

$ pipdeptree -p pandas
pandas==1.2.2
  - numpy [required: >=1.16.5, installed: 1.19.5]
  - python-dateutil [required: >=2.7.3, installed: 2.8.1]
    - six [required: >=1.5, installed: 1.15.0]
  - pytz [required: >=2017.3, installed: 2021.1]

Use johnnydep (pip install johnnydep). Slower because it download the wheels of the packages.

$ johnnydep pandas
2021-06-09 11:01:21 [info     ] init johnnydist                [johnnydep.lib] dist=pandas parent=None
2021-06-09 11:01:22 [info     ] init johnnydist                [johnnydep.lib] dist=numpy>=1.16.5 parent=pandas
2021-06-09 11:01:22 [info     ] init johnnydist                [johnnydep.lib] dist=python-dateutil>=2.7.3 parent=pandas
2021-06-09 11:01:23 [info     ] init johnnydist                [johnnydep.lib] dist=pytz>=2017.3 parent=pandas
2021-06-09 11:01:23 [info     ] init johnnydist                [johnnydep.lib] dist=six>=1.5 parent=python-dateutil>=2.7.3
name                        summary
--------------------------  -----------------------------------------------------------------------
pandas                      Powerful data structures for data analysis, time series, and statistics
├── numpy>=1.16.5           NumPy is the fundamental package for array computing with Python.
├── python-dateutil>=2.7.3  Extensions to the standard Python datetime module
│   └── six>=1.5            Python 2 and 3 compatibility utilities
└── pytz>=2017.3            World timezone definitions, modern and historical
3

Just an addendum on how to use johnnydep.

  1. If you want to have the dependencies in requirements.txt format:
johnnydep pandas --output-format=pinned
pandas==1.4.1
numpy==1.22.3
python-dateutil==2.8.2
pytz==2021.3
six==1.16.0

Above list will be written to stdout while the informational messages during collection are written to stderr (if you want to capture the output using bash or subprocess).

  1. Calling it from Python instead of the CLI:
import sys, johnnydep.cli
sys.argv = ["", "pandas"]
johnnydep.cli.main()
1
  • Thanks for pointing that out. I was having troubles with appending the standard "human" format to a file because of character conversions. Your solution worked though
    – RexBarker
    Jul 14, 2022 at 13:08
2

I think these answers are outdated and there's a better solution now. Original post here:

To generate requirements.txt for packages listed in install_requires in your setup.cfg or setup.py, you would need to install pip-tools.

pip install pip-tools
pip-compile

To generate a requirements.txt file that includes packages specified under extras_requires for tests and dev:

pip-compile --extra tests --extra devrequirements.txt file with packages listed under

Furthermore, you can also use requirements.in file instead of setup.cfg or setup.py to list your requirements.

pip-compile requirements.in
1

As an update to @Jmills answer, for newer pip versions that support the --dry-run option:

#!/bin/sh

PACKAGE=$1
pip install $PACKAGE --dry-run --ignore-installed  \
| grep Collecting \
| cut -d' ' -f2 \
| sed -E 's/([><=!]=|[><]).*//g'
1
  • 1
    This works, but this still downloads the packages. I have to run pip cache purge afterwards. I wish --dry-run would not actually download packages.
    – Al Conrad
    Jun 23 at 15:15
0

The command pip install <package> --download <path> should be used, as mentioned in comments by @radtek, since as of 7.0.0 (2015-05-21), --no-install is removed from pip. This will download the dependencies needed into <path>.

1
  • 12
    Ridiculously, --download has been deprecated as well. The canonical command now appears to be pip download <package> -d /tmp --no-binary :all: as suggested by The Card Cheat. Aug 9, 2016 at 5:03
-1

Another option is to use a helper script similar to this one which uses the pip.req.parse_requirements API to parse requirements.txt files and a distutils.core.setup replacement to parse setup.py files.

0

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.