Variables de Entorno¶

Una variable de entorno (también conocida como "env var") es una variable que vivefuera del código de Python, en elsistema operativo, y podría ser leída por tu código de Python (o por otros programas también).

Las variables de entorno pueden ser útiles para manejarconfiguraciones de aplicaciones, como parte de lainstalación de Python, etc.

Crear y Usar Variables de Entorno¶

Puedescrear y usar variables de entorno en lashell (terminal), sin necesidad de Python:

// Podrías crear una env var MY_NAME con$exportMY_NAME="Wade Wilson"// Luego podrías usarla con otros programas, como$echo"Hello$MY_NAME"Hello Wade Wilson

// Crea una env var MY_NAME$$Env:MY_NAME="Wade Wilson"// Úsala con otros programas, como$echo"Hello$Env:MY_NAME"Hello Wade Wilson

Leer Variables de Entorno en Python¶

También podrías crear variables de entornofuera de Python, en la terminal (o con cualquier otro método), y luegoleerlas en Python.

Por ejemplo, podrías tener un archivomain.py con:

importosname=os.getenv("MY_NAME","World")print(f"Hello{name} from Python")

Luego podrías llamar a ese programa Python:

// Aquí todavía no configuramos la env var$pythonmain.py// Como no configuramos la env var, obtenemos el valor por defectoHello World from Python// Pero si creamos una variable de entorno primero$exportMY_NAME="Wade Wilson"// Y luego llamamos al programa nuevamente$pythonmain.py// Ahora puede leer la variable de entornoHello Wade Wilson from Python

// Aquí todavía no configuramos la env var$pythonmain.py// Como no configuramos la env var, obtenemos el valor por defectoHello World from Python// Pero si creamos una variable de entorno primero$$Env:MY_NAME="Wade Wilson"// Y luego llamamos al programa nuevamente$pythonmain.py// Ahora puede leer la variable de entornoHello Wade Wilson from Python

Dado que las variables de entorno pueden configurarse fuera del código, pero pueden ser leídas por el código, y no tienen que ser almacenadas (committed engit) con el resto de los archivos, es común usarlas para configuraciones oajustes.

También puedes crear una variable de entorno solo para unainvocación específica de un programa, que está disponible solo para ese programa, y solo durante su duración.

Para hacer eso, créala justo antes del programa en sí, en la misma línea:

// Crea una env var MY_NAME en línea para esta llamada del programa$MY_NAME="Wade Wilson"pythonmain.py// Ahora puede leer la variable de entornoHello Wade Wilson from Python// La env var ya no existe después$pythonmain.pyHello World from Python

Tipos y Validación¶

Estas variables de entorno solo pueden manejarstrings de texto, ya que son externas a Python y deben ser compatibles con otros programas y el resto del sistema (e incluso con diferentes sistemas operativos, como Linux, Windows, macOS).

Esto significa quecualquier valor leído en Python desde una variable de entornoserá unstr, y cualquier conversión a un tipo diferente o cualquier validación tiene que hacerse en el código.

Aprenderás más sobre cómo usar variables de entorno para manejarconfiguraciones de aplicación en laGuía del Usuario Avanzado - Ajustes y Variables de Entorno.

Variable de EntornoPATH¶

Hay una variable de entornoespecial llamadaPATH que es utilizada por los sistemas operativos (Linux, macOS, Windows) para encontrar programas a ejecutar.

El valor de la variablePATH es un string largo que consiste en directorios separados por dos puntos: en Linux y macOS, y por punto y coma; en Windows.

Por ejemplo, la variable de entornoPATH podría verse así:

/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32

Cuando escribes uncomando en la terminal, el sistema operativobusca el programa encada uno de esos directorios listados en la variable de entornoPATH.

Por ejemplo, cuando escribespython en la terminal, el sistema operativo busca un programa llamadopython en elprimer directorio de esa lista.

Si lo encuentra, entonces loutilizará. De lo contrario, continúa buscando en losotros directorios.

Instalando Python y Actualizando elPATH¶

Cuando instalas Python, se te podría preguntar si deseas actualizar la variable de entornoPATH.

/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin

C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin

Entonces, si escribes:

$python

$/opt/custompython/bin/python

$C:\opt\custompython\bin\python

Esta información será útil al aprender sobreEntornos Virtuales.

Conclusión¶

Con esto deberías tener una comprensión básica de qué son lasvariables de entorno y cómo usarlas en Python.

También puedes leer más sobre ellas en laWikipedia para Variable de Entorno.

En muchos casos no es muy obvio cómo las variables de entorno serían útiles y aplicables de inmediato. Pero siguen apareciendo en muchos escenarios diferentes cuando estás desarrollando, así que es bueno conocerlas.

Por ejemplo, necesitarás esta información en la siguiente sección, sobreEntornos Virtuales.