diff --git a/README.rst b/README.rst index 62a76ca5..48edbd4e 100644 --- a/README.rst +++ b/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... diff --git a/docs/index.rst b/docs/index.rst index 81bc535d..0dcecdbe 100644 --- a/docs/index.rst +++ b/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. diff --git a/pipenv/core.py b/pipenv/core.py index 1576dbc8..5a2857d0 100644 --- a/pipenv/core.py +++ b/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)