Django for Designers/Laptop setup/Linux virtualenv

From OpenHatch wiki
Jump to navigation Jump to search

Test if you have the required tools[edit]

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

  --version             show program's version number and exit

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

and save it inside the django-for-designers 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 django-for-designers folder[edit]

Open a command prompt, and use the cd command to find the django-for-designers folder.

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


and make sure you see a requirements.txt file.

Create a virtualenv[edit]

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 .

Eventually you will get your prompt back.

Activate the virtualenv[edit]

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 bin/activate

You should see your command prompt change to say django-for-designers; that is how you know you have it activated.

Install the requirements[edit]

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[edit]

« Return to laptop setup