En el día a día de un desarrollador, es común trabajar con múltiples proyectos, cada uno con sus propias variables de entorno, rutas (PATH), versiones de herramientas o credenciales. La gestión manual de estas variables puede llevar a configuraciones desordenadas en tu .profile o .bashrc, o a errores por usar el entorno incorrecto. Aquí es donde direnv brilla, ofreciendo una solución elegante y automática.

¿Qué es direnv?¶

direnv es una extensión para tu shell (Bash, Zsh, Fish, etc.) que detecta automáticamente cuando cambias de directorio. Cuando entras en un directorio que contiene un archivo .envrc, direnv lo carga; cuando sales de él, lo descarga. Esto significa que tu entorno de shell se adapta dinámicamente a tu proyecto actual, sin que tengas que hacer nada manualmente.

¿Cómo funciona?¶

direnv se integra con tu shell a través de un hook en el comando cd. Cada vez que cambias de directorio, direnv comprueba si existe un archivo .envrc en el directorio actual o en alguno de sus ancestros. Si encuentra uno (y le has dado permiso para cargarlo), ejecuta los comandos definidos en ese archivo para modificar tu entorno. Al salir del directorio, revierte esos cambios, limpiando tu entorno.

Casos de Uso Comunes¶

• Gestión de PATH: Añadir binarios específicos de un proyecto a tu PATH temporalmente.
• Entornos Virtuales de Python: Activar automáticamente un virtualenv o uv venv al entrar en un proyecto Python.
• Credenciales y Claves API: Cargar variables de entorno con credenciales de bases de datos, claves API o tokens de forma segura (sin que queden en el historial del shell).
• Variables de Entorno Específicas del Proyecto: RAILS_ENV, NODE_ENV, etc.
• Cambio de Versiones de Herramientas: Integrar con herramientas como nvm o pyenv para cambiar automáticamente de versión de Node.js o Python.

Instalación Básica (ejemplo para Bash)¶

1. Instalar direnv: Puedes instalarlo desde tu gestor de paquetes (sudo apt install direnv, brew install direnv, etc.).

2. Activar el hook en tu shell: Añade la siguiente línea a tu ~/.bashrc (o ~/.zshrc):

   bash eval "$(direnv hook bash)"

3. Crear un archivo .envrc: En la raíz de tu proyecto, crea un archivo .envrc con las variables y comandos que quieras.

   ```bash

   .envrc en la raíz de tu proyecto Python¶

   layout python # Activa automáticamente un entorno virtual export MY_API_KEY="super_secreto_del_proyecto" ```

4. Permitir la carga: La primera vez que entres al directorio con un nuevo .envrc, direnv te pedirá confirmación:

   bash direnv: error .envrc is blocked. Run `direnv allow` to approve its contents Ejecuta direnv allow.

La Librería Estándar de direnv¶

direnv viene con una potente librería estándar que incluye funciones predefinidas para tareas comunes, como layout python (para gestionar virtualenvs), use nix, use node, etc., simplificando enormemente la configuración de tus .envrc.

Beneficios Clave¶

• Entornos limpios: Tu .profile permanece ordenado.
• Consistencia: Cada proyecto tiene exactamente el entorno que necesita.
• Productividad: No más source venv/bin/activate manual o recordar configurar variables.

direnv es una herramienta pequeña pero poderosa que transforma la forma en que gestionas tus entornos de desarrollo, haciendo tu vida en la terminal mucho más eficiente y libre de errores.

Artículo original: direnv homepage