Conteúdo do curso Lição 46 de 250 · Arquivos, Erros e Módulos
Arquivos, Erros e Módulos

Configuração e segredos

Programas reais precisam de configurações que não devem ficar no código: chaves de API, URLs de banco de dados, uma flag de debug. Há dois motivos para mantê-las fora. Primeiro, segredos no código-fonte vazam: no momento em que você faz commit de uma chave de API no git, ela fica no histórico para sempre, e enviar para um repositório público a entrega ao mundo. Segundo, o mesmo código deve rodar em lugares diferentes (seu notebook, um servidor) com configurações diferentes.

A resposta padrão são as variáveis de ambiente: valores com nome que o sistema operacional entrega ao seu processo. O Python as lê de os.environ, que se comporta como um dict:

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

Durante o desenvolvimento, você as guarda em um arquivo .env que você nunca envia em um commit (você adiciona .env ao .gitignore). São só linhas KEY=value:

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

Bibliotecas como python-dotenv carregam esse arquivo em os.environ para você. Por baixo dos panos, elas interpretam exatamente essas linhas. Neste exercício você vai escrever esse parser, além de uma função auxiliar que oculta um segredo para que ele possa ser impresso com segurança em um log.

A regra de ouro: leia segredos do ambiente, registre-os ocultos e nunca os coloque fixos no código.

Sua vez

Crie três helpers. (1) load_env(text) analisa o conteúdo de um arquivo .env em um dicionário. Pule linhas em branco e linhas de comentário (começando com #). Divida cada linha restante no primeiro =. Remova espaços em branco e remova um par de aspas ao redor do valor se estiver presente. Mantenha uma linha apenas se a chave for um nome de ambiente válido: tudo em maiúsculas e um identificador Python válido (letras, dígitos e sublinhados, não começando com um dígito). (2) get_setting(env, key, default=None) retorna env[key] se presente, caso contrário default. (3) redact(value) retorna uma string segura para log mostrando apenas os últimos 4 caracteres, por exemplo redact("sk-abc123") é "****c123"; valores de 4 caracteres ou menos tornam-se "****".

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.