Repolode
Enviar
theskumar

theskumar/python-dotenv

Biblioteca de Python que carga pares clave-valor de un archivo .env en variables de entorno y sigue las prácticas de las aplicaciones de 12 factores.

Ver en GitHubSitio web
Estrellas
8,916
Forks
619
Issues abiertos
126
Último commit
hace 10 días

¿Qué es?

python-dotenv lee pares clave-valor de un archivo .env y los establece como variables de entorno. Está pensado para aplicaciones de 12 factores, que obtienen su configuración del entorno, de modo que los desarrolladores pueden guardar esos ajustes en un archivo local durante el desarrollo sin tener que exportarlos cada vez en la shell.

El punto de entrada principal es load_dotenv(), que busca un archivo .env de forma predeterminada, añade sus valores a os.environ y mantiene las variables existentes sin cambios, a menos que se pase override=True. dotenv_values() devuelve los valores parseados como un dict sin modificar el entorno, y ambas funciones pueden leer de un stream en lugar de un archivo. La herramienta de línea de comandos dotenv permite establecer y listar variables, así como ejecutar comandos con las variables cargadas desde el archivo.

El formato del archivo es similar al de Bash y admite comillas, comentarios, el prefijo export, valores multilínea y la expansión de ${VAR}. El paquete se puede instalar con pip e incluye una extensión para IPython.

Funciones clave

  • 01Carga los valores de un archivo .env en os.environ sin sobrescribir las variables existentes de forma predeterminada.
  • 02Devuelve los valores parseados como un dict mediante dotenv_values(), sin modificar el entorno.
  • 03Lee la configuración tanto de streams como de archivos.
  • 04Admite una sintaxis similar a la de Bash, con comillas, comentarios, el prefijo export y valores multilínea.
  • 05Expande las variables escritas como ${VAR} dentro de los valores.
  • 06Incluye una CLI de dotenv para establecer y listar variables, así como ejecutar comandos con las variables cargadas.
  • 07Incluye una extensión de IPython para cargar archivos .env.

Casos de uso

  • Guardar URLs de bases de datos y claves de API de una aplicación web de Python en un archivo .env local durante el desarrollo.
  • Cargar la configuración en un programa de Python desde una fuente que no sea el sistema de archivos, como un stream de red.
  • Ejecutar un script con variables de un archivo .env mediante el comando dotenv run.
  • Leer los valores de .env en un dict para combinar configuraciones sin modificar os.environ.

Inicio rápido

  1. 1

    Instala la biblioteca desde PyPI

    pip install python-dotenv
  2. 2

    Crea un archivo .env en la raíz del proyecto con tus ajustes

  3. 3

    Llama a load_dotenv() al iniciar la aplicación

Antes de usarlo

  • El formato del archivo .env no está especificado formalmente y puede cambiar con el tiempo.

Temas

#python#configuration#environment-variables#dotenv#12-factor#devops#12-factor-app#devops-tools#env

Preguntas frecuentes

¿Qué es python-dotenv?
Biblioteca de Python que carga pares clave-valor de un archivo .env en variables de entorno y sigue las prácticas de las aplicaciones de 12 factores. python-dotenv lee pares clave-valor de un archivo .env y los establece como variables de entorno. Está pensado para aplicaciones de 12 factores, que obtienen su configuración del entorno, de modo que los desarrolladores pueden guardar esos ajustes en un archivo local durante el desarrollo sin tener que exportarlos cada vez en la shell.
¿python-dotenv es gratuito? ¿Qué licencia tiene?
python-dotenv es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿python-dotenv sigue mantenido?
Mantenimiento activo. El último commit de python-dotenv fue el 28 oct 2026.
¿Para qué puedo usar python-dotenv?
Guardar URLs de bases de datos y claves de API de una aplicación web de Python en un archivo .env local durante el desarrollo. Cargar la configuración en un programa de Python desde una fuente que no sea el sistema de archivos, como un stream de red. Ejecutar un script con variables de un archivo .env mediante el comando dotenv run. Leer los valores de .env en un dict para combinar configuraciones sin modificar os.environ.
¿Cómo se instala python-dotenv?
Instala la biblioteca desde PyPI: pip install python-dotenv Crea un archivo .env en la raíz del proyecto con tus ajustes Llama a load_dotenv() al iniciar la aplicación
¿Dónde consigo python-dotenv?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/theskumar/python-dotenv

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados