Mongo

Esta guía te muestra cómo trabajar con MongoDB localmente usando Docker Compose, MongoEngine y Python. Este lab demuestra operaciones CRUD básicas usando diferentes herramientas de ejecución y validación.

Prerrequisitos

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

Cómo ejecutar

1. Configurar el entorno:

   Dev Container (recomendado)

   Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:

   > Dev Containers: Reopen in Container

   Manual
   1. Ejecuta el script de configuración para instalar herramientas y dependencias:

      scripts/setup.sh

   2. Iniciar la infraestructura: Lanza el contenedor de MongoDB:

      docker compose up -d

2. Ejecutar el ejemplo:

   Python

   python main.py

   mongosh
   1. Accede al shell:

      scripts/mongosh.sh

   2. Ejecuta: Copia y pega el script de playgrounds/users.mongodb.js en el shell.
   MongoDB for VS Code
   • Instala: MongoDB for VS Code.
   • Conecta: Conecta usando MONGO_URI definido en tu .env.
   • Abre: Abre playgrounds/users.mongodb.js.
   • Ejecuta: Haz clic en el icono Play en la parte superior derecha del editor.
   MongoDB Compass
   • Instala: MongoDB Compass.
   • Conecta: Conecta usando MONGO_URI definido en tu .env.
   • Navega: Navega a my_db → users.
   • Ejecuta: Abre el Mongosh integrado y pega el script de playgrounds/users.mongodb.js.

Cómo depurar

1. main.py:

   • Abre: Abre main.py.
   • Breakpoints: Añade breakpoints en el código.
   • Ejecuta: Pulsa F5 para iniciar la depuración.

2. Tests:

   • Abre: Abre un archivo de test (p. ej., tests/test_user.py).
   • Breakpoints: Añade breakpoints en el código de test.
   • Ejecuta: Usa la pestaña Testing de VS Code y haz clic en el icono Debug Test junto al test que quieras depurar.

Cómo testear

• Todos los tests: Ejecuta el script automatizado:

  scripts/run_tests.sh

• Individualmente: Usa la pestaña Testing de VS Code para ejecutar o depurar casos de test específicos.

Validar resultados

mongosh

1. Accede al shell:

   scripts/mongosh.sh

2. Ejecuta la siguiente consulta para ver todos los usuarios:

   db.getSiblingDB('my_db').users.find().pretty()

MongoDB for VS Code

• Instala: MongoDB for VS Code.
• Conecta: Conecta usando MONGO_URI definido en tu .env.
• Verifica: Navega a my_db → users.
• Interactivo: Usa Playgrounds para ejecutar consultas interactivas.

MongoDB Compass

• Instala: MongoDB Compass.
• Conecta: Conecta usando MONGO_URI definido en tu .env.
• Verifica: Navega a my_db → users.
• Interactivo: Usa el Mongosh integrado para ejecutar consultas interactivas.

Limpieza

docker compose down -v

Siguientes pasos

• Explora el Lab relacionado No-SQL Writer (Azure).
• Explora el Lab relacionado No-SQL Writer (GCP).
• Explora el Lab relacionado Metabase.