A virtual environment is a setup that installs the dependencies of a project in an isolated manner. This tool is quite handy when handling many projects that require different versions of a specific dependency. For instance, take a scenario where you are building two python projects where one requires Django 2.2 and the other one needs Django 3.0. You cannot install the different modules globally because python cannot differentiate the two versions, actually, they will get installed bearing the same name making it difficult to differentiate them. That’s why you need to create a virtual environment.
Step by step guide on how to create a virtual environment
There are several tools that you can use to create a virtual environment such as venv, virtualvenv, and virtualenvwrapper. We will discuss how to create a virtual environment using virtualenvwrapper
Step 1: Check if you have all the requirements
To create a virtual environment you must have python, and pip installed. Fortunately, python3 comes along with pip. You can check the python official documentation downloads page.
Use the following commands to confirm if you have installed python and pip.
Python –version
Pip list
Step 2: Install the virtual environment
We will be using virtualenwrapper-win which organizes all your virtual environments in one place and gives you a single command to switch between the environments.
Run the following command to in the command prompt
pip install virtualenvwrapper-win
C:\Users\ERICA WANJA>pip install virtualenvwrapper-win
Collecting virtualenvwrapper-win
Downloading virtualenvwrapper-win-1.2.6.tar.gz (21 kB)
….
Installing collected packages: virtualenvwrapper-win
Running setup.py install for virtualenvwrapper-win ... done
Successfully installed virtualenvwrapper-win-1.2.6
Step 3: Create the virtual environment
Once you have installed the virtual environment, you can create the virtual environment using mkvirtualenv command
mkvirtualenv djangosampleproject
C:\Users\ERICA WANJA>mkvirtualenv djangosampleproject
C:\Users\ERICA WANJA\Envs is not a directory, creating
created virtual environment CPython3.9.7.final.0-64 in 19728ms
...
BashActivator,BatchActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator
(djangosampleproject) C:\Users\ERICA WANJA>
Step 4: Install Django
Run the below command to install the Django version that you require. In this case, we will be installing django2.2
pip install django~=2.2
(djangosampleproject) C:\Users\ERICA WANJA>pip install django~=2.2
Collecting django~=2.2
Using cached Django-2.2.24-py3-none-any.whl (7.5 MB)
Collecting sqlparse>=0.2.2
Using cached sqlparse-0.4.2-py3-none-any.whl (42 kB)
Collecting pytz
Using cached pytz-2021.3-py2.py3-none-any.whl (503 kB)
Installing collected packages: sqlparse, pytz, django
Successfully installed django-2.2.24 pytz-2021.3 sqlparse-0.4.2
Step 5: create your first Django project
To fully see your efforts in work, we will create our first Django project.
Create a folder and navigate into it.
mkdir django_test
cd django_test
Next, we will use Django-admin tool to create a project and navigate into it.
django-admin startproject mysite
cd mysite
Run the python server to view your project
python manage.py runserver
Conclusion
You have learnt how to create a virtual environment for a Django project.
These are the commands we have used in their respective order;
pip install virtualenvwrapper-win
mkvirtualenv djangosampleproject
pip install django~=2.2
mkdir django_sample
django-admin startproject mysite
python manage.py runserver
Next we will learn how to create views in Django.
Top comments (0)