PostgreSQL

Esta guía te muestra cómo trabajar con PostgreSQL localmente usando Docker Compose, SQLAlchemy y Python. Este lab demuestra cómo configurar una base de datos en contenedor con inicialización automática del esquema.

Prerrequisitos

Docker instalado y en ejecución.
Dev Containers extension instalada (opcional).

Cómo ejecutar

Configurar el entorno:
- Dev Container (recomendado)
- Manual
Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:
Ventana de terminal
> Dev Containers: Reopen in Container
1. Iniciar la infraestructura: Lanza el contenedor de PostgreSQL:
  Ventana de terminal
  docker compose up -d
2. Ejecuta el script de configuración para instalar herramientas y dependencias:
  Ventana de terminal
  scripts/setup.sh
Ejecutar el ejemplo:
Ventana de terminal
```
python main.py
```

Cómo depurar

Script de Python (main.py):
- Abre la pestaña Run and Debug en VS Code.
- Selecciona la configuración Python: Main e inicia la depuración.

Cómo testear

All tests: Ejecuta el script automatizado: scripts/run_tests.sh
Individually: Usa la pestaña Testing de VS Code para ejecutar o depurar tests específicos.

Ejecuta el siguiente comando para consultar la base de datos directamente (credenciales en .env):

docker exec -it postgres_local psql -U admin -d testdb -c "SELECT * FROM users;"

Conecta usando SQLTools (preconfigurado en el Dev Container) o DBeaver con los detalles de conexión definidos en .env y ejecuta:

SELECT * FROM users;

Limpieza

docker compose down -v