1. Puesta a punto del entorno

Esta lección es un onboarding para dejar el ordenador listo antes de empezar. Está pensada para Windows. No cuenta como lección de clase: la sigues en casa y llegas al aula con todo funcionando.

No tengas prisa. La mitad de los problemas que arrastra la gente durante un curso entero vienen de un entorno mal montado el primer día.

Instalar las herramientas

Vamos a instalar dos cosas: uv y Python.

uv es la herramienta que lo une todo. Instala Python por ti y gestiona las dependencias del proyecto sin que tengas que pelearte con versiones. Si vienes de instalar Python a mano desde la web, olvida ese camino: con uv es más rápido y da menos problemas.

Una vez instalado uv, Python se instala con una sola orden, sin descargar nada de la web de Python:

uv python install

Cuando termines, comprueba que responde:

uv --version

Si te devuelve un número de versión, vas bien.

Configurar VSCode para Python

Recomendamos VSCode como editor. Es uno de los más usados, así que si te atascas es más fácil encontrar a alguien que te eche una mano. El editor viene bastante pelado de fábrica para Python, y aquí es donde mucha gente se queda a medias. Vamos a afinarlo.

• Instala la extensión oficial Python (de Microsoft) y Pylance, que te da autocompletado e inteligencia de código.
• Instala la extensión Ruff, que te avisa de problemas y formatea el código. Lee la configuración del pyproject.toml del proyecto, así que todo el equipo formatea igual.
• Selecciona el intérprete correcto: abre la paleta de comandos y busca Python: Select Interpreter, y elige el del entorno virtual .venv. La extensión suele detectarlo sola, pero conviene saber hacerlo a mano.
• Activa formatear al guardar (format on save) con Ruff como formateador por defecto. Así dejas de discutir sobre espacios: se ordena solo cada vez que guardas.
• Configura el panel de pruebas (Test Explorer): busca Python: Configure Tests, elige pytest y la carpeta tests/. A partir de ahí podrás ejecutar y depurar los tests desde la barra lateral, con un clic.
• Familiarízate con el depurador: pon un punto de interrupción (un clic en el margen izquierdo, junto al número de línea) y ejecuta paso a paso. Es muchísimo más útil que llenar el código de print, y lo veremos en detalle más adelante, en la lección de testing.

Toda esta configuración vive en el archivo .vscode/settings.json del proyecto, así que se puede compartir con el equipo y todos arrancáis igual.

Arrancar un proyecto

Con las herramientas puestas, crear un proyecto es cuestión de segundos:

uv init metocean-tools
cd metocean-tools

uv init crea la estructura básica y el pyproject.toml (la lista de dependencias del proyecto).

Después creamos y activamos el entorno virtual:

uv venv
.venv\Scripts\activate

Un entorno virtual es una carpeta que aísla las dependencias de este proyecto de las del resto del sistema. Así, si un proyecto necesita una versión de una librería y otro necesita otra, no se pelean.

Y añadimos dependencias cuando las necesitemos. Por ejemplo, una librería para validar datos de entrada:

uv add msgspec

uv add descarga la librería y anota la versión exacta en pyproject.toml. Ese detalle es oro: significa que un compañero puede copiar tu proyecto y reproducirlo sin esos errores raros de "en mi máquina funciona".

En la siguiente lección recuperamos este mismo entorno y lo usamos como punto de partida. No vamos a volver a instalar nada.