Práctica 1.5: Creación de entorno

P5 - Crear y utilizar un entorno virtual¶

Un entorno virtual permite que cada proyecto Python tenga su propio entorno de trabajo, separado de la instalación general de Python y de otros proyectos.

Dentro del entorno podremos instalar posteriormente las bibliotecas que necesite cada proyecto sin afectar al resto del sistema.

En esta práctica aprenderás a crear, activar, comprobar y desactivar un entorno virtual utilizando venv, que forma parte de Python.

1. Objetivos¶

Comprender para qué sirve un entorno virtual.
Crear un entorno virtual mediante venv.
Activar y desactivar el entorno.
Comprobar qué intérprete de Python estamos utilizando.
Evitar incluir el entorno virtual en el repositorio Git.
Comprender que el entorno puede eliminarse y volver a crearse cuando sea necesario.

2. Relación con RA1 y criterios de evaluación¶

La práctica apoya el RA1, especialmente CE b y CE c, porque prepara el proyecto y el entorno de desarrollo.

El entorno virtual es una herramienta instrumental y no se equipara a un criterio de evaluación independiente.

3. Pasos a seguir¶

3.1. Crear el proyecto¶

Crea una carpeta llamada practica5 y ábrela en VS Code.

Puedes hacerlo desde el explorador de archivos o desde una terminal:

mkdir practica5
cd practica5
code .

A partir de este momento, todos los comandos de la práctica se ejecutarán desde la carpeta del proyecto.

3.2. Comprobar Python¶

Antes de crear el entorno virtual, comprueba que Python está instalado.

Windows:

python --version

Linux y macOS:

python3 --version

También podemos comprobar qué ejecutable de Python estamos utilizando.

Windows:

python -c "import sys; print(sys.executable)"

Linux y macOS:

python3 -c "import sys; print(sys.executable)"

En este momento aparecerá la ruta de la instalación de Python disponible en el sistema.

Por ejemplo, en Windows podría ser similar a:

C:\Users\Usuario\AppData\Local\Programs\Python\Python314\python.exe

Guarda mentalmente esta idea: todavía estamos utilizando el Python instalado en el sistema.

3.3. Crear el entorno virtual¶

Crea un entorno virtual llamado .venv dentro del proyecto.

Windows:

python -m venv .venv

Linux y macOS:

python3 -m venv .venv

Ahora aparecerá una nueva carpeta:

practica5/
└── .venv/

Esta carpeta contiene un entorno Python propio para nuestro proyecto.

De forma simplificada:

Python instalado en el sistema
             │
             │ python -m venv .venv
             ▼
practica5/
└── .venv/
      │
      ├── intérprete de Python
      └── lugar donde se instalarán
          las bibliotecas del proyecto

No debemos modificar manualmente los archivos contenidos en .venv.

3.4. Activar el entorno virtual¶

Crear el entorno no significa que ya lo estemos utilizando. Antes debemos activarlo.

Utiliza el comando correspondiente a tu sistema y terminal.

Windows - Git Bash:

source .venv/Scripts/activate

Windows - PowerShell:

.venv\Scripts\Activate.ps1

Linux y macOS:

source .venv/bin/activate

Cuando el entorno está activo, normalmente aparecerá (.venv) al comienzo de la línea de la terminal:

(.venv) ...

Esto nos proporciona una indicación visual de que el entorno está activado.

3.5. Comprobar qué Python estamos utilizando¶

No debemos quedarnos únicamente con la aparición de (.venv). Vamos a comprobar qué intérprete está ejecutándose realmente:

python -c "import sys; print(sys.executable)"

Ahora la ruta debería apuntar al Python situado dentro de nuestro proyecto.

En Windows será similar a:

...\practica5\.venv\Scripts\python.exe

En Linux o macOS:

.../practica5/.venv/bin/python

Por tanto, al activar el entorno ha ocurrido:

ANTES de activar .venv

python
   ↓
Python instalado en el sistema


DESPUÉS de activar .venv

python
   ↓
practica5/.venv/.../python

A partir de este momento, mientras el entorno esté activo, el comando:

python

utilizará el intérprete del entorno virtual.

En VS Code selecciona también el intérprete de .venv mediante:

Python: Select Interpreter

y elige el intérprete situado dentro de .venv.

De esta forma, VS Code y la terminal utilizarán el mismo entorno Python.

3.6. El entorno virtual y Git¶

La carpeta .venv contiene muchos archivos propios del entorno y puede variar entre sistemas.

No debemos subir .venv al repositorio Git.

Cada desarrollador puede crear su propio entorno virtual a partir del proyecto.

Crea un archivo .gitignore en la carpeta principal:

.venv/
__pycache__/
*.pyc
.vscode/
.idea/
.DS_Store

Si el proyecto ya es un repositorio Git, comprueba:

git status

.venv/ no debería aparecer entre los archivos pendientes de añadir.

Podemos resumirlo así:

Proyecto
│
├── código Python          → SÍ se versiona
├── .gitignore             → SÍ se versiona
│
└── .venv/                 → NO se versiona

3.7. Desactivar el entorno virtual¶

Cuando terminemos de trabajar podemos desactivar el entorno:

deactivate

El indicador (.venv) desaparecerá.

Comprueba nuevamente:

python -c "import sys; print(sys.executable)"

La ruta ya no debería apuntar a:

practica5/.venv/...

sino nuevamente al Python instalado en el sistema.

Vuelve a activar el entorno utilizando el comando correspondiente:

Windows - Git Bash:

source .venv/Scripts/activate

Windows - PowerShell:

.venv\Scripts\Activate.ps1

Linux y macOS:

source .venv/bin/activate

Y comprueba de nuevo:

python -c "import sys; print(sys.executable)"

Deberá volver a apuntar al intérprete situado dentro de .venv.

3.8. Eliminar y volver a crear un entorno¶

El entorno virtual no contiene nuestro código fuente. Es un entorno auxiliar que podemos volver a crear cuando sea necesario.

Para eliminarlo basta con desactivarlo y borrar la carpeta:

deactivate

Después elimina:

.venv/

Nuestro proyecto seguirá existiendo:

practica5/
├── archivos Python
└── .gitignore

Podemos crear nuevamente el entorno ejecutando:

Windows:

python -m venv .venv

Linux y macOS:

python3 -m venv .venv

y activarlo normalmente.

Esto también explica por qué no necesitamos subir .venv a GitHub: cada equipo puede crear su propio entorno virtual.

En la siguiente práctica instalaremos dentro de este entorno las bibliotecas que necesite nuestro proyecto.

4. Comprobaciones de finalización¶

Al finalizar la práctica comprueba que:

Existe la carpeta .venv.
Puedes activar y desactivar el entorno virtual.
Al activarlo aparece normalmente (.venv) en la terminal.
python -c "import sys; print(sys.executable)" permite comprobar si estás utilizando el Python del sistema o el del entorno virtual.
VS Code utiliza el intérprete situado dentro de .venv.
.gitignore evita que .venv/ se incorpore al repositorio Git.
Comprendes que .venv puede eliminarse y volver a crearse.

La idea fundamental de la práctica es:

Proyecto A
└── .venv/
      └── entorno Python del proyecto A

Proyecto B
└── .venv/
      └── entorno Python del proyecto B

Cada proyecto puede disponer así de su propio entorno y de sus propias bibliotecas sin interferir con los demás.

5. Ejercicios y entregables¶

Crea el entorno virtual .venv.
Actívalo y comprueba mediante:
```
python -c "import sys; print(sys.executable)"
```
que estás utilizando su intérprete.
Desactiva el entorno y ejecuta nuevamente el mismo comando. Compara ambas rutas.
Vuelve a activar .venv.
Comprueba mediante:
```
git status
```
que .venv/ no se incluye en el repositorio.

Entregables¶

Estructura final del proyecto.
Comprobación del intérprete utilizado con el entorno activado y desactivado.
Comprobación de que .venv/ está excluido del repositorio Git.

Práctica 1.5: Creación de entorno

P5 - Crear y utilizar un entorno virtual¶

1. Objetivos¶

2. Relación con RA1 y criterios de evaluación¶

3. Pasos a seguir¶

3.1. Crear el proyecto¶

3.2. Comprobar Python¶

3.3. Crear el entorno virtual¶

3.4. Activar el entorno virtual¶

3.5. Comprobar qué Python estamos utilizando¶

3.6. El entorno virtual y Git¶

3.7. Desactivar el entorno virtual¶

3.8. Eliminar y volver a crear un entorno¶

4. Comprobaciones de finalización¶

5. Ejercicios y entregables¶

Entregables¶

Fuentes y referencias¶