… _commands:

Pipenv Commands

The commands reference for pipenv (incomplete)

install

$ pipenv install is used for installing packages into the pipenv virtual environment and updating your Pipfile and Pipfile.lock.

Along with the basic installation command, which takes the form:

$ pipenv install <package_name>

Running the above will install the package <package_name> and add it to the default packages section in the Pipfile.lock

The user can provide these additional parameters:

--python=<path/to/pyton> — Performs the installation in a virtualenv using the provided Python interpreter.

warning: The above commands should only be used when initially creating the environment.

The user can provide these additional parameters:

--dev — Install both develop and defaul` package categories from Pipfile.
--categories — Install packages to the category groups specified here.
--system — Install packages to the system site-packages rather than into your virtualenv.
--deploy — Verifies the _meta hash of the lock file is up to date with the ``Pipfile``, aborts install if not.
--ignore-pipfile — Install from the Pipfile.lock and completely ignore Pipfile information.
--skip-lock — Ignore the ``Pipfile.lock`` and install from the ``Pipfile``. In addition, do not write out a ``Pipfile.lock`` reflecting changes to the ``Pipfile``.  This is not recommended as you loose the security benefits of lock file hash verification.

General Interface Note:

Note

It has been confusing to many users of pipenv that running install will completely relock the lock file.
Based on feedback in pipenv issue reports, we are considering changing install to only relock when adding or changing a package.
For now, to install lock file versions (without modification of the lock file) use: pipenv sync
To modify only specific packages and their subdependencies use: pipenv update <package_name>

sync

$ pipenv sync installs dependencies from the Pipfile.lock without any alteration to the lockfile.

The user can provide these additional parameters:

--categories — Install packages from the category groups specified here.

uninstall

$ pipenv uninstall supports all of the parameters in pipenv install <#pipenv-install>_, as well as two additional options, --all and --all-dev.

- ``--all`` — This parameter will purge all files from the virtual environment,
  but leave the Pipfile untouched.

- ``--all-dev`` — This parameter will remove all of the development packages from
  the virtual environment, and remove them from the Pipfile.

lock

$ pipenv lock is used to update all dependencies of Pipfile.lock to their latest resolved versions based on your Pipfile specification.

update

$ pipenv update <package> will update the lock of specified dependency and sub-dependencies only and install the updates.

upgrade

$ pipenv upgarde <package> will update the lock of specified dependency and sub-dependencies only, but does not modify the environment.

run

run will run a given command from the virtualenv, with any arguments forwarded (e.g. $ pipenv run python or $ pipenv run pip freeze).

shell

shell will spawn a shell with the virtualenv activated. This shell can be deactivated by using exit.

graph

graph will show you a dependency graph of your installed dependencies where each root node is a specifier from the Pipfile.

check

check checks for security vulnerabilities and asserts that PEP 508 requirements are being met by the project’s lock file or current environment.