02. Configuración Inicial

Python y Entorno Virtual (venv)

Python y entorno virtual (venv)

Antes de empezar

Es importante que, si no has trabajado con Python antes, hagas esta guía que te pongo a continuación.

https://nieva.team/es/courses/python-installation-guide

Esta guía es la instalación desde cero con Python.

Nosotros comenzaremos creando el proyecto desde cero pero necesitamos que ya tengas toda la instalación y configuración realizada.

Dicho esto, comencemos.


Paso 1. Crear la carpeta del proyecto

En este paso se creará la estructura base del proyecto, el entorno virtual y se preparará el espacio donde se instalarán las dependencias.

El objetivo es tener una carpeta limpia, organizada y aislada, tal como se haría en un entorno profesional de desarrollo backend.

Abre Visual Studio Code.

Abre tu terminal y navega hasta la carpeta donde quieras guardar tu proyecto.

Luego, ejecuta a continuación:

bash
mkdir movie-catalog-api

Esto crea una carpeta llamada movie-catalog-api.

Accede a la misma con Visual Studio Code, abriendo una nueva ventana y seleccionando la carpeta creada.

Estaremos en una interfaz similar a esta.


Paso 2. Crear el entorno virtual

En esta carpeta, genera un entorno virtual (donde vivirán las librerías del proyecto) a través de la terminal.

bash
python -m venv .venv

.venv es el nombre estándar para el entorno virtual.

Este comando crea una carpeta oculta que contiene su propio intérprete de Python y un espacio aislado para dependencias.

Dependiendo de tu sistema operativo, configuración o shell, es probable que debas escribir python o python3. En este caso y en los siguientes contenidos, lo haré con python, pero recuerda que puede ser python3 si es tu caso específico.

Esto generará una carpeta llamada .venv.


Paso 3. Activar el entorno virtual

La activación depende del tipo de terminal que uses y tu sistema operativo.

Con PowerShell:

powershell
.venv\Scripts\Activate.ps1

Con Bash o Git Bash:

bash
source .venv/bin/activate

Al hacerlo, observaremos en nuestra terminal que el .venv está activado.


Paso 4. Crear archivos iniciales

Crearemos ahora los primeros dos archivos iniciales:

  • requirements.txt
  • main.py

Nuestro archivo main.py incluirá este código:

python
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"message": "Hello World"}

Posteriormente, estableceremos el archivo requirements.txt, el cual no tendrá nada por ahora. Más adelante veremos cómo trabajarlo.

Listo esto, vamos a probar nuestro primer archivo.

Ejecuta este comando.

bash
python main.py

No deberá pasar nada. Eso significa que vamos bien.

Como dato, si notas en el código una "alerta", eso significa que necesitamos seleccionar instalar fastapi.

Es lo que haremos en el siguiente contenido.