Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

What is a virtualenv, and why should I use one?

I am trying to install a Python package with this command

pip install <name of package>

I'm getting permission errors and I'm not sure why. I could run it with sudo, but someone told me that was a bad idea, and I should use a virtualenv instead.

What is a virtualenv? What does it do for me?

like image 598
Kevin Avatar asked Feb 01 '17 05:02

Kevin


People also ask

Why should I use a virtual environment?

One of your projects might require a different version of an external library than another one. If you have only one place to install packages, then you can't work with two different versions of the same library. This is one of the most common reasons for the recommendation to use a Python virtual environment.

Do I need virtualenv?

So do you need a virtualenv? I would strongly recommend it. So you have Django working and you've imported some other libraries (i also strongly recommend pip) and everything is working on your machine. Your path is setup and your code can resolve to the code using PATH and PYTHON_PATH.

Should I use virtualenv or VENV?

If you need the additional features that virtualenv provides over venv, then you obviously should use virtualenv. If you're satisfied with your current setup with venv, then there's no reason to choose virtualenv.


4 Answers

Running with the system Python and libraries limits you to one specific Python version, chosen by your OS provider. Trying to run all Python applications on one Python installation makes it likely that version conflicts will occur among the collection of libraries. It's also possible that changes to the system Python will break other OS features that depend on it.

Virtual environments, or "virtualenvs" are lightweight, self-contained Python installations, designed to be set up with a minimum of fuss, and to "just work" without requiring extensive configuration or specialized knowledge.

virtualenv avoids the need to install Python packages globally. When a virtualenv is active, pip will install packages within the environment, which does not affect the base Python installation in any way.

In Python 3.3 or later, you can create a virtualenv as follows:

$ python3 -m venv ENV_DIR 

For Windows, you should replace python3 with the full path to python.exe:

>C:\Python34\python.exe -m venv ENV_DIR 

(This is a typical Python installation; your system may vary.)

In older versions of Python, including Python 2, one of the following commands should work in most cases:

$ virtualenv ENV_DIR $ venv ENV_DIR $ pyvenv ENV_DIR $ pyvenv3 ENV_DIR 

ENV_DIR should be a non-existent directory. The directory can have any name, but to keep these instructions simple, I will assume you have created your virtualenv in a directory called venv (e.g. with python3 -m venv ./venv).

To work in your virtualenv, you activate it:

$ . ./venv/bin/activate (venv)$  

Or use this if you have a windows system:

$ venv\Scripts\activate 

The (venv) in the shell prompt lets you know which virtualenv you have activated, but you can turn this feature off if you do not like it. You can run all the usual Python commands, and they will be local to your virtualenv:

(venv)$ pip install requests numpy [...] (venv)$ python [...] >>> import requests >>> import numpy as np >>>  

python will run the version of Python that you installed into your virtualenv, so (for example) you don't have to type python3 to get Python 3. The Python that it runs will have access to all the standard library modules and all the packages you installed into the virtualenv, but (by default) none of the packages installed in the system-wide site-packages directory.

This last rule is important: by restricting your virtualenv to only use locally-installed packages, you can ensure that you control exactly which dependencies your project is using, even if some new system-wide package gets installed or updated next week. If you like, you can get a listing of your installed packages:

(venv)$ pip freeze requests==2.13.0 numpy==1.12.0 (venv)$  

pip can also parse this format and install from it, and it will install the same versions, even if updates have been released in the meantime:

(venv)$ pip freeze >requirements.txt  (some-other-venv)$ pip install -r requirements.txt [...] (some-other-venv)$ python >>> import requests >>> import numpy as np >>>  

You can get out of the virtualenv by deactivating it:

(venv)$ deactivate $ python [...] >>> import requests Traceback (most recent call last):   File "<stdin>", line 1, in <module> ImportError: No module named 'requests' 

You can create as many virtualenvs as you like, and they won't interfere with each other, nor with your system packages. A virtualenv is "just" a directory with a bunch of binaries and scripts under it, so you can remove a virtualenv the same way you remove any directory (rm -r venv on Unix). If the virtualenv is activated when you remove it, you may confuse your shell, so it's probably a good idea to deactivate first in that case.

like image 154
4 revs, 4 users 93% Avatar answered Oct 02 '22 17:10

4 revs, 4 users 93%


Some times you are not given root privileges and you might end up not being able to use sudo. Many other times, it's not advisable to use sudo to install packages as it might overwrite some package which might be in use by some other applications.

Virtualenv can help you create a separate environment where you don't need root privileges as well as be able to tailor the environment according to your need. It consists of self-contained python installation which only interacts with your specific created environment.

So basically, it gives you a bit of freedom as well as avoid damaging (or modifying) the root environment which might be hosting many old functionalities of old applications.

Installation is pretty easy too.

like image 38
f3n1Xx Avatar answered Oct 02 '22 18:10

f3n1Xx


Installing packages with sudo pip will install packages globally, which may break some system tools.

By install globally it means you will install your packages in place like /usr/lib/python2.7/site-package so if some packages need a previous version of your python packages, this action may break it.

virtualenv allows you to avoid installing Python packages globally by making an isolated python environment. That means it will install packages just in your desire project folder.

On mac and linux

  • Install

    python3 -m pip install --user virtualenv
    
  • Creating a Virtual Env: Go to your desired project folder

    python3 -m virtualenv env
    
  • Activating a virtualenv: In your desired project folder

    source env/bin/activate
    

After activating you can install your packages using pip.

For more information about using it in Windows: How to use virtualenv in Windows

like image 31
Hadi Rasekh Avatar answered Oct 02 '22 17:10

Hadi Rasekh


I am going to break your question into two parts.

What is a virtualenv?

Python has its own way of downloading, storing, and resolving site packages. But Python can not differentiate between different versions in the site-package directory. Packages will be installed in one of the directories, whose name can be found by running the site.getsitepackages() commands.

>>> import site
>>> site.getsitepackages()

This means package_v2.0.1 and package_v3.0.1 have to be in the same directory with the same name i.e. package, which is obviously not possible. Now, you may ask why we would need the same package with different versions on our system. This is because multiple projects may require different versions of Python packages or even different Python versions themselves. So there was a need to have something which will resolve these conflicts and Virtualenv came into the picture to solve this issue.

What does it do for me?

It isolates the environment for Python projects so that each project can have its own dependencies.

like image 40
Akshay Katiha Avatar answered Oct 02 '22 18:10

Akshay Katiha