Configurando tu Ambiente de Desarrollo Local
Este proyecto utiliza el gestor de paquetes uv
para las dependencias de Python. Para comenzar, necesitarás instalar uv
y luego crear y activar un entorno virtual para tu proyecto.
-
Requisitos previos: Asegúrate de tener Python 3.12 o posterior instalado en tu sistema. Puedes verificar tu versión de Python ejecutando
python --version
opython3 --version
en tu terminal. -
Instalar
uv
: Abre tu terminal y ejecuta el siguiente comando:curl -LsSf https://astral.sh/uv/install.sh | sh
También puedes utilizar el sistema de paquetes de tu distribución de linux o usar pipx
.
-
Navega al directorio de tu proyecto. Utiliza el comando
cd
en tu terminal para navegar al directorio donde tienes los archivos de tu proyecto, incluyendo el archivopyproject.toml
. -
Crea el entorno virtual: Ejecuta el siguiente comando en tu terminal:
uv venv
Esto creará un nuevo entorno virtual llamado
.venv
en tu directorio de proyecto. El entorno virtual aísla las dependencias de tu proyecto de la instalación de Python de tu sistema. -
Activa el entorno virtual: El proceso de activación depende de tu sistema operativo:
-
Windows: Ejecuta el siguiente comando:
.venv\Scripts\activate.bat
-
macOS/Linux: Ejecuta el siguiente comando:
source .venv/bin/activate
Tu terminal mostrará el nombre del entorno virtual activo (por ejemplo,
(limpieza-datos)
) para indicar que está activado.Si estás trabajando en vscode selecciona el python dentro del entorno como el intérprete del proyecto.
-
Una vez que hayas activado el entorno virtual, puedes instalar las dependencias del proyecto usando uv
:
uv pip install -r pyproject.toml
Este comando leerá el archivo pyproject.toml
e instalará todos los paquetes requeridos (jupyterlab
, matplotlib
, pandas
, etc.) en tu entorno virtual.
Notas adicionales:
-
Para desactivar el entorno virtual, simplemente ejecuta el siguiente comando en tu terminal:
deactivate
-
Recuerda activar el entorno virtual cada vez que quieras trabajar en el proyecto para asegurarte de que estás utilizando el conjunto correcto de dependencias.