Skip to content
Back to top
View this page

# pip show

## Usage

Unix/macOS

    python -m pip show [options] <package> ...

Windows

    py -m pip show [options] <package> ...

## Description

Show information about one or more installed packages.

The output is in RFC-compliant mail header format.

## Options

-f, --files

  Show the full list of installed files for each package.

  (environment variable: `PIP_FILES`)

## Examples

1. Show information about a package:

   Unix/macOS

       $ python -m pip show sphinx
       Name: Sphinx
       Version: 1.4.5
       Summary: Python documentation generator
       Home-page: http://sphinx-doc.org/
       Author: Georg Brandl
       Author-email: georg@python.org
       License: BSD
       Location: /my/env/lib/python2.7/site-packages
       Requires: docutils, snowballstemmer, alabaster, Pygments, imagesize, Jinja2, babel, six

   Windows

       C:\> py -m pip show sphinx
       Name: Sphinx
       Version: 1.4.5
       Summary: Python documentation generator
       Home-page: http://sphinx-doc.org/
       Author: Georg Brandl
       Author-email: georg@python.org
       License: BSD
       Location: /my/env/lib/python2.7/site-packages
       Requires: docutils, snowballstemmer, alabaster, Pygments, imagesize, Jinja2, babel, six

2. Show all information about a package

   Unix/macOS

       $ python -m pip show --verbose sphinx
       Name: Sphinx
       Version: 1.4.5
       Summary: Python documentation generator
       Home-page: http://sphinx-doc.org/
       Author: Georg Brandl
       Author-email: georg@python.org
       License: BSD
       Location: /my/env/lib/python2.7/site-packages
       Requires: docutils, snowballstemmer, alabaster, Pygments, imagesize, Jinja2, babel, six
       Metadata-Version: 2.0
       Installer:
       Classifiers:
          Development Status :: 5 - Production/Stable
          Environment :: Console
          Environment :: Web Environment
          Intended Audience :: Developers
          Intended Audience :: Education
          License :: OSI Approved :: BSD License
          Operating System :: OS Independent
          Programming Language :: Python
          Programming Language :: Python :: 2
          Programming Language :: Python :: 3
          Framework :: Sphinx
          Framework :: Sphinx :: Extension
          Framework :: Sphinx :: Theme
          Topic :: Documentation
          Topic :: Documentation :: Sphinx
          Topic :: Text Processing
          Topic :: Utilities
       Entry-points:
          [console_scripts]
          sphinx-apidoc = sphinx.apidoc:main
          sphinx-autogen = sphinx.ext.autosummary.generate:main
          sphinx-build = sphinx:main
          sphinx-quickstart = sphinx.quickstart:main
          [distutils.commands]
          build_sphinx = sphinx.setup_command:BuildDoc

   Windows

       C:\> py -m pip show --verbose sphinx
       Name: Sphinx
       Version: 1.4.5
       Summary: Python documentation generator
       Home-page: http://sphinx-doc.org/
       Author: Georg Brandl
       Author-email: georg@python.org
       License: BSD
       Location: /my/env/lib/python2.7/site-packages
       Requires: docutils, snowballstemmer, alabaster, Pygments, imagesize, Jinja2, babel, six
       Metadata-Version: 2.0
       Installer:
       Classifiers:
          Development Status :: 5 - Production/Stable
          Environment :: Console
          Environment :: Web Environment
          Intended Audience :: Developers
          Intended Audience :: Education
          License :: OSI Approved :: BSD License
          Operating System :: OS Independent
          Programming Language :: Python
          Programming Language :: Python :: 2
          Programming Language :: Python :: 3
          Framework :: Sphinx
          Framework :: Sphinx :: Extension
          Framework :: Sphinx :: Theme
          Topic :: Documentation
          Topic :: Documentation :: Sphinx
          Topic :: Text Processing
          Topic :: Utilities
       Entry-points:
          [console_scripts]
          sphinx-apidoc = sphinx.apidoc:main
          sphinx-autogen = sphinx.ext.autosummary.generate:main
          sphinx-build = sphinx:main
          sphinx-quickstart = sphinx.quickstart:main
          [distutils.commands]
          build_sphinx = sphinx.setup_command:BuildDoc