From 6a8feb001c038db165809445b2ed1222cf2cdc28 Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Wed, 30 Aug 2017 18:25:47 -0400 Subject: [PATCH] Update virtualenvs.rst --- docs/dev/virtualenvs.rst | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/docs/dev/virtualenvs.rst b/docs/dev/virtualenvs.rst index 71307da..3f2bb50 100644 --- a/docs/dev/virtualenvs.rst +++ b/docs/dev/virtualenvs.rst @@ -1,7 +1,7 @@ .. _virtualenvironments-ref: -Virtual Environments -==================== +Pipenv & Virtual Environments +============================= A Virtual Environment is a tool to keep the dependencies required by different projects in separate places, by creating virtual Python environments for them. @@ -11,6 +11,22 @@ dilemma, and keeps your global site-packages directory clean and manageable. For example, you can work on a project which requires Django 1.10 while also maintaining a project which requires Django 1.8. + +Pipenv +------ + +**Pipenv** is a project that aims to bring the best of all packaging worlds to the Python world. It harnesses `Pipfile `_, `pip `_, and `virtualenv `_ into one single toolchain. It features very pretty terminal colors. + +It automatically creates and manages a virtualenv for your projects, as well as adds/removes packages from your ``Pipfile`` as you install/uninstall packages. The ``lock`` command generates a lockfile (``Pipfile.lock``). + + +Install Pipenv with pip:: + + $ pip install pipenv + ✨🍰✨ + + + virtualenv ---------- @@ -18,6 +34,8 @@ virtualenv isolated Python environments. virtualenv creates a folder which contains all the necessary executables to use the packages that a Python project would need. +It can be used standalone, in place of Pipenv. + Install virtualenv via pip: .. code-block:: console