Um Estado De Liberdade

Como configurar um ambiente com um estado de liberdade

O conceito de um estado de liberdade aparece quando você precisa que um serviço ou processo rode sem dependências rígidas de rede, banco de dados ou configurações externas. Na prática, é um comportamento que permite isolamento total durante testes, migrações ou execução em containers. Isto não é mágica. É uma combinação de variáveis de ambiente, arquivos de configuração locais e mocks que substituem integrações externas. A ideia básica é simples: tudo que seria fetch, query ou call para servidor terceiro é interceptado antes de sair da máquina.

Vantagens de um estado de liberdade

O maior ganho é velocidade. Um teste que antes demorava 40 segundos, porque acessava API de pagamento, pode rodar em 2 segundos quando o endpoint é fakeado. A segunda vantagem é reprodutibilidade. Você não depende do status de terceiros no momento do teste. O problema que eu encontrei na prática foi com um sistema de cache distribuído que, quando não havia rede, travava o processo inteiro em vez de cair em fallback. A solução foi configurar um mock server local que respondia com os códigos HTTP esperados, mas com latência zero. Usei local-credentials no Docker para passar o arquivo de configuração sem exposição.

Configuração passo a passo

Primeiro, identifique todas as dependências externas. Liste cada URL, credencial e endpoint que seu código consulta. Depois, crie um arquivo .env.local com variáveis como API_BASE_URL=http://localhost:9999 e ENABLE_MOCKS=true. Segundo, implemente o mock server. Pode ser com pytest-httpserver, responses ou até um script Node.js simples. Cada rota deve retornar o payload esperado. A recomendação é que o mock responda com o mesmo schema JSON do serviço real, incluindo headers como Content-Type e X-RateLimit-Remaining. Terceiro, ajuste o código para ler variáveis de ambiente com fallbacks seguros. Em Python, use os.getenv("API_KEY", "test-key"). Em JavaScript, process.env.API_KEY || "test-key". O fallback é o que garante o estado de liberdade quando a variável não existe.

Pegadinhas comuns

Muitos esquecem que algumas bibliotecas fazem validação síncrona no import. O requests.Session, por exemplo, não conecta na importação, mas o boto3 com configurações AWS padrão tenta cargar credenciais do sistema. A workaround é usar AWS_DEFAULT_REGION=us-east-1 e AWS_ACCESS_KEY_ID=fake no .env. Outro erro é confiar em mocks que só funcionam em testes unitários. Se o seu código chama uma função que por sua vez dispara um worker em background, o mock precisa simular também o retorno assíncrono. Testei isso com unittest.mock.patch e asyncio.sleep(0) para garantir que o loop de eventos não travasse.

Quando o estado de liberdade falha

O método não cobre integrais end-to-end com sistemas reais. Se você precisa validar comportamento de rede, como retry após timeout ou fallback entre regiões, o mock não substitui o serviço real. Neste caso, use um container leve com testcontainers que sobe um banco PostgreSQL ou Redis temporário, mas ainda assim evita dependência externa. A desvantagem principal é a dívida técnica. Mocks que cobrem muito código tendem a ficar defasados quando a API real muda. A recomendação é manter o número de mocks próximo ao mínimo necessário e usar contract tests uma vez por semana para detectar incompatibilidades.

Download e recursos

Um repositório de exemplo com configuração completa está disponível em github.com/example/freedom-state-template. O template inclui .env.sample, mocks em Python/Node e README com comandos de execução. Alternativamente, se seu projeto já usa docker-compose, adicione um serviço mock-server com a imagem wiremock/wiremock:latest e exponha a porta 8080. O arquivo de mapeamento fica em __files dentro do container. O conceito de um estado de liberdade é essencial quando se trabalha com CI/CD, testes automatizados ou desenvolvimento offline. A configuração leva cerca de 20 minutos na primeira vez, mas economiza horas por semana em execução de pipelines.