DEV Community

Cover image for Python virtualenv tutorial básico en linux
Eduardo Zepeda
Eduardo Zepeda

Posted on • Originally published at coffeebytes.dev

Python virtualenv tutorial básico en linux

#python #tutorial #spanish

Si no tienes ni idea de para que sirve un entorno virtual tengo una entrada donde explico para que sirven los entornos virtuales. Hoy vengo a traerte un pequeño tutorial de Python virtualenv donde instalaremos un par de paquetes en un entorno virtual y veremos como se comportan. Asegúrate de tener instalado Python y Pip porque los necesitaremos.

Preparativos para usar virtualenv

Empecemos primero creando un directorio nuevo, puedes ponerlo donde tu prefieras.

mkdir entornoVirtual; cd entornoVirtual
Enter fullscreen mode Exit fullscreen mode

Una vez que estemos adentro de este nuevo directorio verificaremos nuestra instalación de Python:

Python3
Enter fullscreen mode Exit fullscreen mode

Dentro del interprete de Python intentaremos importar la libreria requests, usada para hacer peticiones web:

>>> import requests
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: No module named 'requests'
Enter fullscreen mode Exit fullscreen mode

Como no la tenemos instalada en nuestro sistema operativo nos salta un error, por supuesto, que listos que somos. Salgamos del intérprete de Python:

>>>exit()
Enter fullscreen mode Exit fullscreen mode

Podríamos instalar requests en nuestro sistema operativo, pero eso nos obligaría a utilizar siempre la misma versión, por lo que en su lugar instalaremos virtualenv, para poder usar entornos virtuales. Para hacerlo utilizaremos pip.

sudo pip install virtualenv
# pip3 install virtualenv
# Collecting virtualenv
#  Downloading https://files.pythonhosted.org/packages/db/9e/df208b2baad146fe3fbe750eacadd6e49bcf2f2c3c1117b7192a7b28aec4/virtualenv-16.7.2-py2.py3-none-any.whl # (3.3MB)
#  100% |████████████████████████████████| 3.3MB 3.6MB/s 
# Installing collected packages: virtualenv
# Successfully installed virtualenv-16.7.2
Enter fullscreen mode Exit fullscreen mode

Crear un entorno virtual en python

Para crear un entorno virtual utilizaremos el comando virtualenv, especificaremos una version de Python con la opción -p y le daremos un nombre a nuestro entorno virtual, por razones de simplicidad lo llamaré 'virtual', pero puedes llamarlo como quieras.

virtualenv -p python3 virtual
# Running virtualenv with interpreter
# Already using interpreter /usr/bin/python3
# Using base prefix '/usr'
# New python executable in /tu/ruta/virtual/bin/python3
# Also creating executable in /tu/ruta/virtual/bin/python
# Installing setuptools, pip, wheel...
# done.
Enter fullscreen mode Exit fullscreen mode

Una vez que termine de ejecutarse el comando se habrá creado una carpeta en nuestro directorio actual. Esta carpeta contiene todos los archivos necesarios para poder usar el entorno virtual. Los paquetes que instalemos mientras estemos utilizando el entorno virtual se irán al interior de esa carpeta. He abreviado el contenido por razones de simplicidad, pero puedes revisar el interior de la carpeta tu mismo para conocerla completamente.


└── virtual
    ├── bin
    │   ├── activate
    │   ├── activate.csh
    │   ├── activate.fish
    │   ├── activate.ps1
    │   ├── activate_this.py
    │   ├── activate.xsh
    │   ├── easy_install
    │   ├── easy_install-3.5
    │   ├── pip
    │   ├── pip3
    │   ├── pip3.5
    │   ├── python -> python3
    │   ├── python3
    │   ├── python3.5 -> python3
    │   ├── python-config
    │   └── wheel
    ├── include
    │   └── python3.5m -> /usr/include/python3.5m
    └── lib
        └── python3.5
            ├── abc.py -> /usr/lib/python3.5/abc.py
            ├── ...
Enter fullscreen mode Exit fullscreen mode

Activar un entorno virtual

En el esquema anterior la parte importante es el archivo llamado activate, el cual usaremos para activar nuestro entorno virtual de la siguiente manera. Recuerda reemplazar la palabra virtual si le pusiste otro nombre a tu entorno virtual:

source virtual/bin/activate
Enter fullscreen mode Exit fullscreen mode

Si el comando anterior se ejecutó sin problemas podremos ver como el intérprete de nuestra terminal cambió:

(virtual) user@localhost $
Enter fullscreen mode Exit fullscreen mode

Pero no solo cambio el aspecto de la terminal. Además podremos ver que ahora estamos ejecutando nuestro comando python3 desde otra ubicación:

which python3
#  /tu/ruta/virtual/bin/python3
Enter fullscreen mode Exit fullscreen mode

Instalar un paquete en un entorno virtual

Mientras el interprete se vea así, todos los paquetes que instalemos usando pip se instalarán en nuestro entorno virtual y los permisos de administrador ya no serán necesarios, nota la ausencia del comando sudo:

pip install requests
# Collecting requests
#  Downloading https://files.pythonhosted.org/packages/51/bd/23c926cd341ea6b7dd0b2a00aba99ae0f828be89d72b2190f27c11d4b7fb/requests-2.22.0-py2.py3-none-any.whl (57kB)
#  |████████████████████████████████| 61kB 690kB/s 
# Collecting certifi>=2017.4.17 (from requests)
#  Downloading https://files.pythonhosted.org/packages/69/1b/b853c7a9d4f6a6d00749e94eb6f3a041e342a885b87340b79c1ef73e3a78/certifi-2019.6.16-py2.py3-none-any.whl # (157kB)
#  |████████████████████████████████| 163kB 1.2MB/s 
# Collecting chardet<3.1.0,>=3.0.2 (from requests)
#  Using cached https://files.pythonhosted.org/packages/bc/a9/01ffebfb562e4274b6487b4bb1ddec7ca55ec7510b22e4c51f14098443b8/chardet-3.0.4-py2.py3-none-any.whl
# Collecting urllib3!=1.25.0,!=1.25.1,<1.26,>=1.21.1 (from requests)
#  Downloading https://files.pythonhosted.org/packages/e6/60/247f23a7121ae632d62811ba7f273d0e58972d75e58a94d329d51550a47d/urllib3-1.25.3-py2.py3-none-any.whl (150kB)
#  |████████████████████████████████| 153kB 1.7MB/s 
# Collecting idna<2.9,>=2.5 (from requests)
#  Using cached https://files.pythonhosted.org/packages/14/2c/cd551d81dbe15200be1cf41cd03869a46fe7226e7450af7a6545bfc474c9/idna-2.8-py2.py3-none-any.whl
# Installing collected packages: certifi, chardet, urllib3, idna, requests
--Successfully installed certifi-2019.6.16 chardet-3.0.4 idna-2.8 requests-2.22.0 urllib3-1.25.3
Enter fullscreen mode Exit fullscreen mode

El paquete que se instaló se fué a la carpeta que se creó al ejecutar el comando virtualenv:

...
            │   ├── requests
            │   │   ├── adapters.py
            │   │   ├── api.py
            │   │   ├── auth.py
            │   │   ├── certs.py
            │   │   ├── compat.py
...
Enter fullscreen mode Exit fullscreen mode

Ahora ingresemos al intérprete de Python:

Python3
Enter fullscreen mode Exit fullscreen mode

Si todo sale bien deberíamos poder importar el paquete requests:

>>> import requests
>>>
Enter fullscreen mode Exit fullscreen mode

¡Ya no nos salta el error al importarlo! Ahora ya podemos usarla libremente y lo mejor es que el paquete está en la carpeta donde estamos trabajando, no en el sistema operativo. Por lo que, en caso de ser necesario, podremos trabajar con diferentes versiones de requests fácilmente, cada una en su entorno virtual.

Respaldar paquetes de un entorno virtual

Ahora que estamos en nuestro entorno virtual y hemos instalado un paquete, puede que deseemos respaldar nuestra lista de paquetes, por si en algún momento queremos reinstalar los paquetes de nuestro actual entorno virtual. Para esto pip viene perfecto. Ejecutando pip, seguido de la palabra freeze y mandando esa información a un archivo tendremos una archivo con una lista de los paquetes instalados:

pip freeze > requirements.txt
Enter fullscreen mode Exit fullscreen mode

Con el archivo anterior creado podemos instalar nuestros paquetes en cualquier otro entorno virtual que tengamos utilizando pip. Nota la ausencia del comando sudo.

pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode

Desactivar un entorno virtual

Vamos ahora a abandonar el entorno virtual que hemos creado. ¿Recuerdas que usamos activate para entrar en el entorno virtual? Pues bastará que utilicemos el comando deactivate en nuestra terminal.

deactivate
Enter fullscreen mode Exit fullscreen mode

Nota como nuestra terminal ha regresado a su estado anterior.

user@localhost $
Enter fullscreen mode Exit fullscreen mode

Ahora, solo para corroborar que todo salió bien, ingresemos nuevamente a nuestro intérprete Python,

Python3
Enter fullscreen mode Exit fullscreen mode

Notaremos que el paquete requests NO está instalado; todos los cambios que hicimos fueron hechos únicamente en nuestro entorno virtual, no en el sistema operativo.

>>> import requests
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ImportError: No module named 'requests'
Enter fullscreen mode Exit fullscreen mode

Borrar un entorno virtual

Si quieres borrar por completo el entorno virtual basta con que elimines el directorio donde se ha creado el entorno virtual. Esto dejará la carpeta como estaba y todos los paquetes que estaban instalados dentro del entorno virtual se perderán. Por favor usa este comando con precaución, evita borrar el directorio root.

rm -rf EntornoVirtual/
Enter fullscreen mode Exit fullscreen mode

Pipenv

Existe otro paquete que une pip y virtualenv, te permite manejar los entornos virtuales de manera bastante sencilla y cuenta con bastantes mejoras respecto a virtualenv. Si quieres saber más al respecto visita mi tutorial donde te explico que es y como usar Pipenv.

Sígueme en twitter, publico cosas sobre programación y linux o suscríbete aquí para recibir un resumen mensual de mis publicaciones.

Top comments (0)

Read next

epakconsultant profile image

AI Enchantment with Python

sajjad hussain -

dionarodrigues profile image

Docker networking, how to connect different containers

Diona Rodrigues -

icarossio profile image

[Webinar] How to secure GraphQL

Antoine Carossio -

cre8stevedev profile image

Building a Full Stack Web Application using Flask (Python Web Framework) - Part One

Stephen Omoregie -