Merge pull request #1467 from dradetsky/docs-you-can-use-pip-srsly

document pip commands from pipenv

README.rst

@@ -151,6 +151,9 @@ Fish is the best shell. You should use it.
        Install a local setup.py into your virtual environment/Pipfile:
        $ pipenv install -e .
 
+       Use a lower-level pip command to get info about a package:
+       $ pipenv run pip show requests
+
     Commands:
       check      Checks for security vulnerabilities and...
       graph      Displays currently–installed dependency graph...

docs/index.rst

@@ -109,7 +109,7 @@ Other Commands
 
 - ``graph`` will show you a dependency graph, of your installed dependencies.
 - ``shell`` will spawn a shell with the virtualenv activated.
-- ``run`` will run a given command from the virtualenv, with any arguments forwarded (e.g. ``$ pipenv run python``).
+- ``run`` will run a given command from the virtualenv, with any arguments forwarded (e.g. ``$ pipenv run python``). Notably, ``run`` can be used to invoke various pip utility commands, as in ``$ pipenv run pip show requests``.
 - ``check`` checks for security vulnerabilities and asserts that PEP 508 requirements are being met by the current environment.
 
 

pipenv/core.py

@@ -1537,6 +1537,9 @@ Usage Examples:
    Install a local setup.py into your virtual environment/Pipfile:
    $ {5}
 
+   Use a lower-level pip command to get info about a package:
+   $ {8}
+
 Commands:""".format(
         crayons.red('pipenv --three'),
         crayons.red('pipenv --python 3.6'),
@@ -1546,6 +1549,7 @@ Commands:""".format(
         crayons.red('pipenv install -e .'),
         crayons.red('pipenv lock --pre'),
         crayons.red('pipenv check'),
+        crayons.red('pipenv run pip show requests'),
     )
 
     help = help.replace('Commands:', additional_help)