From 34bfcfc5872340f14b200d325e5741bae69917ad Mon Sep 17 00:00:00 2001 From: Taylor Barnett Date: Mon, 10 Nov 2014 20:12:04 -0600 Subject: [PATCH] Removed virtualenv and linked to central location --- docs/starting/install/win.rst | 43 +++++++---------------------------- 1 file changed, 8 insertions(+), 35 deletions(-) diff --git a/docs/starting/install/win.rst b/docs/starting/install/win.rst index 033a213..b6b1356 100644 --- a/docs/starting/install/win.rst +++ b/docs/starting/install/win.rst @@ -66,45 +66,18 @@ To install pip, run the Python script available here: `get-pip.py `_ -Virtualenv +Virtual Environments ---------- -After Setuptools & Pip, the next development tool that you should install is -`virtualenv `_. Use pip +A Virtual Environment is a tool to keep the dependencies required by different projects +in separate places, by creating virtual Python environments for them. It solves the +"Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps +your global site-packages directory clean and manageable. -.. code-block:: console - - > pip install virtualenv - -The virtualenv kit provides the ability to create virtual Python environments -that do not interfere with either each other, or the main Python installation. -If you install virtualenv before you begin coding then you can get into the -habit of using it to create completely clean Python environments for each -project. This is particularly important for Web development, where each -framework and application will have many dependencies. - - -To set up a new Python environment, change the working directory to wherever -you want to store the environment, and run the virtualenv utility in your -project's directory - -.. code-block:: console - - > virtualenv venv - -To use an environment, run the :file:`activate.bat` batch file in the :file:`Scripts` -subdirectory of that environment. Your command prompt will change to show the -active environment. Once you have finished working in the current virtual -environment, run the :file:`deactivate.bat` batch file to restore your settings to -normal. - -Each new environment automatically includes a copy of ``pip`` in the -:file:`Scripts` subdirectory, so that you can setup the third-party libraries and -tools that you want to use in that environment. Put your own code within a -subdirectory of the environment, however you wish. When you no longer need a -particular environment, simply copy your code out of it, and then delete the -main directory for the environment. +For example, you can work on a project which requires Django 1.3 while also +maintaining a project which requires Django 1.0. +To start using and see more information: `Virtual Environments `_ docs. --------------------------------