Categoría: Python

Introducción

En cualquier proyecto, gestionar configuraciones sensibles o variables que cambian según el entorno (como claves API, credenciales de base de datos, etc.) es crucial. Una buena práctica es mantener estas variables en un archivo .env y luego cargarlas en tu aplicación sin hardcodearlas. En Python, esto es extremadamente sencillo gracias a la librería python-dotenv.

Pero, ¿qué pasa si tu archivo .env no está en la raíz del proyecto? No te preocupes, aquí te mostraremos cómo cargar este archivo desde cualquier ubicación y aprovechar las bondades de python-dotenv.

¿Por qué usar un archivo .env?

El archivo .env permite mantener variables de entorno de manera organizada y segura. Al usarlo, evitas incluir datos sensibles en tu código fuente. Es ideal para manejar configuraciones específicas del entorno como:

• Claves API
• Credenciales de bases de datos
• Configuraciones de correo electrónico
• Opciones de depuración

Esto es especialmente útil cuando trabajas en diferentes entornos (desarrollo, staging, producción).

Instalación de python-dotenv

Para cargar las variables de entorno en Python, primero necesitamos instalar la librería python-dotenv. Puedes hacerlo de manera muy sencilla desde tu terminal:

pip install python-dotenv

Esta librería nos permitirá leer el archivo .env y cargar automáticamente sus valores como variables de entorno.

Crea tu archivo .env

Un archivo .env es simplemente un archivo de texto que contiene pares clave-valor. Un ejemplo típico podría ser algo como esto:

# .env
API_KEY=12345abcdef
DB_HOST=localhost
DB_PORT=5432

Este archivo normalmente se coloca en la raíz del proyecto, pero como veremos más adelante, puedes ubicarlo en cualquier carpeta.

Cargar el archivo .env en tu código Python

En tu script de Python, debes cargar el archivo .env para acceder a las variables. Aquí es donde entra en juego python-dotenv.

Si el archivo .env está en la raíz de tu proyecto, simplemente puedes usar:

from dotenv import load_dotenv
import os

# Cargar las variables desde el archivo .env
load_dotenv()

# Acceder a las variables de entorno
api_key = os.getenv('API_KEY')
db_host = os.getenv('DB_HOST')
db_port = os.getenv('DB_PORT')

print(f"API Key: {api_key}")
print(f"Database Host: {db_host}")
print(f"Database Port: {db_port}")

¿Y si el archivo .env está en otra ubicación?

Si el archivo .env no está en la raíz de tu proyecto, ¡no te preocupes! python-dotenv también permite especificar la ubicación del archivo .env. Esto es útil cuando tienes diferentes configuraciones según entornos o simplemente prefieres mantener tus archivos de configuración organizados en carpetas específicas.

Supongamos que tienes tu archivo .env en una carpeta llamada config/ dentro de tu proyecto. Solo necesitas especificar la ruta al cargar el archivo:

from dotenv import load_dotenv
import os
from pathlib import Path

# Define la ruta del archivo .env (cambia 'config/.env' por la ubicación correcta)
env_path = Path('config/.env')

# Cargar las variables desde el archivo .env
load_dotenv(dotenv_path=env_path)

# Acceder a las variables de entorno
api_key = os.getenv('API_KEY')
db_host = os.getenv('DB_HOST')
db_port = os.getenv('DB_PORT')

print(f"API Key: {api_key}")
print(f"Database Host: {db_host}")
print(f"Database Port: {db_port}")

¿Por qué usar Path de pathlib?

Usar pathlib te permite manejar rutas de archivos de una forma más robusta y multiplataforma. Así no tendrás que preocuparte por los diferentes formatos de rutas entre Windows y Unix.

Mantén tu .env seguro

Recuerda que los archivos .env suelen contener información sensible. Asegúrate de no incluirlos en el control de versiones añadiendo una línea en tu archivo .gitignore:

# Ignorar archivo .env
.env

Conclusión

Utilizar un archivo .env en tus proyectos Python es una excelente manera de gestionar configuraciones de manera segura y flexible. Además, con python-dotenv, puedes cargar este archivo desde cualquier lugar de tu proyecto, lo que te da aún más control sobre cómo organizas tus configuraciones.

Ya sea que estés trabajando con diferentes entornos o simplemente quieras evitar hardcodear datos sensibles, esta técnica te ahorrará muchos dolores de cabeza. ¡Así que adelante, organiza y protege tus configuraciones de forma sencilla!