Variáveis de Ambiente em Python: como acessar e modificar

Ana Maria Gomes
5 minutos de leitura

Conteúdos do tutorial

Acessar variáveis de ambiente é uma tarefa bastante comum ao trabalharmos com a linguagem de programação Python. Essas variáveis são frequentemente usadas para armazenar informações que não devem ser escritas diretamente nos seus scripts de Python, como chaves de API, caminhos de arquivos e configurações do sistema. Neste post do blog, vamos explorar como acessar e modificar variáveis de ambiente em Python.

Programador configurando variáveis de ambiente em Python.

Acessando Variáveis de Ambiente

Para acessar variáveis de ambiente em Python, você precisará usar o módulo os, que fornece uma maneira portátil de usar funcionalidades dependentes do sistema operacional.

Aqui está um exemplo simples de como acessar uma variável de ambiente:

import os
print(os.environ['HOME'])

O código acima imprimirá o valor da variável de ambiente HOME. É importante notar que, se a chave especificada não existir, Python gerará um KeyError.

Lidando com Chaves Ausentes

Para evitar um KeyError quando uma variável de ambiente pode não existir, você pode usar o método get:

# Retorna um valor None se a chave não existir
print(os.environ.get('CHAVE_QUE_PODE_EXISTIR'))

# Retorna 'valor_padrao' se a chave não existir
print(os.environ.get('CHAVE_QUE_PODE_EXISTIR', 'valor_padrao'))

Alternativamente, você pode usar o método getenv, que também permite fornecer um valor padrão:

# Retorna 'valor_padrao' se a chave não existir
print(os.getenv('CHAVE_QUE_PODE_EXISTIR', 'valor_padrao'))

Verificando a Existência de uma Chave

Se você simplesmente quer verificar se uma chave existe nas variáveis de ambiente, você pode usar o operador in:

'HOME' in os.environ

Isso retornará True se a variável HOME existir, e False caso contrário.

Definindo Variáveis de Ambiente

Você também pode definir variáveis de ambiente diretamente no seu script. Isso pode ser útil para definir um valor padrão se um não estiver presente:

os.environ['HOME'] = '/novo/valor'

Porém tome cuidado! Alterações feitas a variáveis de ambiente em scripts de Python não são mantidas após o script finalizar. Isso significa que se você adicionar ou alterar uma variável de ambiente dentro do seu script, os valores voltarão ao estado inicial assim que a execução do script acabar.

Listando Todas as Variáveis de Ambiente

Se você está interessado em ver todas as variáveis de ambiente disponíveis para você, pode imprimi-las assim:

for chave, valor in os.environ.items():
    print(f'{chave}: {valor}')

Resumo

Neste post, cobrimos como acessar, verificar e definir variáveis de ambiente em Python usando o módulo os. Lembre-se de usar os.environ para acessar as variáveis, os.environ.get ou os.getenv para recuperar com segurança um valor com um padrão, e in para verificar a existência de uma chave. Você também pode iterar sobre todas as variáveis de ambiente para ver o que está disponível no seu ambiente atual.

Com essas ferramentas, você pode gerenciar e utilizar efetivamente variáveis de ambiente em suas aplicações Python!

Inscreva-se gratuitamente e fique atualizado

Receba toda semana um resumo dos principais conteúdos da Asimov direto no seu e-mail. 100% livre de spam.

Áreas de interesse: