Django for Designers/Laptop setup/Linux virtualenv: Difference between revisions

From OpenHatch wiki
imported>Paulproteus
No edit summary
Line 43: Line 43:
 
A virtualenv is a limited Python environment that permits you to install whatever Python code you like without impacting other Python programs.
 
A virtualenv is a limited Python environment that permits you to install whatever Python code you like without impacting other Python programs.
   
First, we will have to create the virtualenv. In your command prompt, type:
+
First, we will have to create the virtualenv. In your command prompt, type this command. The '''.''' at the end does matter, so be sure to type it!
   
 
<pre>
 
<pre>
virtualenv env
+
virtualenv .
 
</pre>
 
</pre>
   
Line 52: Line 52:
   
 
<pre>
 
<pre>
python virtualenv.py env
+
python virtualenv.py .
 
</pre>
 
</pre>
   

Revision as of 20:30, 8 March 2013

Test if you have the required tools

In this step, we test if you have the virtualenv tool.

Take this moment to open up a command prompt. Enter the command:

virtualenv --help

You should see a help message that looks something like this:

Usage: virtualenv [OPTIONS] DEST_DIR

Options:
  --version             show program's version number and exit

If you don't see that friendly message, download virtualenv.py from here:

and save it inside the pages-to-apps folder.

Also, if you use Ubuntu or Debian, run the following command:

sudo apt-get install python-dev

It installs development-related tools that virtualenv relies on.

Navigate to the pages-to-apps folder

Open a command prompt, and use the cd command to find the pages-to-apps folder.

You can use the ls command to list the folder. Run this command:

ls

and make sure you see a requirements.txt file.

Create a virtualenv

A virtualenv is a limited Python environment that permits you to install whatever Python code you like without impacting other Python programs.

First, we will have to create the virtualenv. In your command prompt, type this command. The . at the end does matter, so be sure to type it!

virtualenv .

If you get a command not found error, type this instead:

python virtualenv.py .

Eventually you will get your prompt back.

Activate the virtualenv

When you activate a virtualenv, it gives you access to the Python code within the virtualenv. (By contrast, your system Python does not have access to the code within the virtualenv.)

Run this command:

source env/bin/activate

You should see your command prompt change to say env; that is how you know you have it activated.

Install the requirements

You need to use the pip package manager within your virtualenv to install all the code required to have a successful tutorial. To do that, first make sure your command prompt has the virtualenv activated.

Then run:

pip install -r requirements.txt

This will run for a few minutes, downloading code. Eventually, you will get your prompt back. Success!

Return to laptop setup

« Return to laptop setup