Temario Lección 46 de 250 · Archivos, errores y módulos
Archivos, errores y módulos

Configuración y secretos

Los programas reales necesitan ajustes que no deben vivir en el código: claves de API, URLs de bases de datos, un indicador de depuración. Hay dos razones para dejarlos fuera. Primero, los secretos en el código fuente se filtran: en el momento en que haces commit de una clave de API en git, queda en el historial para siempre, y subirla a un repositorio público se la entrega al mundo. Segundo, el mismo código debería funcionar en sitios distintos (tu portátil, un servidor) con ajustes distintos.

La respuesta habitual son las variables de entorno: valores con nombre que el sistema operativo entrega a tu proceso. Python los lee de os.environ, que se comporta como un diccionario:

import os
key = os.environ["API_KEY"]              # raises KeyError if missing
debug = os.environ.get("DEBUG", "off")   # a safe default instead

En desarrollo los guardas en un archivo .env del que nunca haces commit (añades .env a .gitignore). Son simplemente líneas KEY=value:

API_KEY=sk-abc123
# a comment
MODEL=claude-opus-5-5
DEBUG=on

Bibliotecas como python-dotenv cargan ese archivo en os.environ por ti. Por dentro, analizan exactamente estas líneas. En este ejercicio escribirás ese analizador tú mismo, además de una función auxiliar que oculta un secreto para que se pueda imprimir sin riesgo en un registro.

La regla de oro: lee los secretos del entorno, regístralos ocultos y nunca los escribas en el código.

Tu turno

Crea tres funciones auxiliares. (1) load_env(text) analiza el contenido de un archivo .env y lo convierte en un dict. Omite las líneas en blanco y las líneas de comentario (que empiezan con #). Divide cada línea restante en el primer =. Elimina los espacios en blanco y quita un par de comillas alrededor del valor si existen. Mantén una línea solo si la clave es un nombre de entorno válido: todo en mayúsculas y un identificador de Python válido (letras, dígitos y guiones bajos, sin empezar con un dígito). (2) get_setting(env, key, default=None) devuelve env[key] si está presente, de lo contrario devuelve default. (3) redact(value) devuelve una cadena segura para registros que muestra solo los últimos 4 caracteres, por ejemplo, redact("sk-abc123") es "****c123"; los valores de 4 caracteres o menos se convierten en "****".

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.