Gerenciadores de contexto Python explicados: A instrução with, contextlib e usos reais
A instrução with garante que a configuração sempre corresponda à limpeza, mesmo quando algo dá errado. Aprenda como funcionam os gerenciadores de contexto, como escrever os seus próprios de duas maneiras e as surpresas que encontramos ao testá-los.
- Um gerenciador de contexto combina configuração com limpeza. A instrução
withexecuta ambos, mesmo quando ocorre uma exceção. - Escreva um como uma classe com
__enter__e__exit__ou como um gerador com@contextlib.contextmanager. - Em gerenciadores baseados em geradores, coloque limpeza em
try/finally, ou ela será ignorada em caso de erros. Nós provamos isso. - Retornar
Truede__exit__engole a exceção, então faça isso apenas de propósito.
Abrir um arquivo, bloquear, iniciar uma transação de banco de dados, alterar uma configuração para um teste: cada um deles possui um “desfazer” correspondente que deve acontecer posteriormente. Esqueça ou deixe uma exceção ignorá-la e você vazará identificadores de arquivo, travará threads ou deixará o banco de dados meio atualizado. A instrução with do Python existe para tornar esse desfazer automático.
Executamos todos os exemplos abaixo com Python 3.13 e os resultados mostrados são dessa execução.
O problema que os gerentes de contexto resolvem
Sem with, a limpeza segura precisa de um try/finally sempre:
f = open("notes.txt", "w")
try:
f.write("hello")
finally:
f.close()
Funciona, mas é fácil esquecer, e a limpeza acaba ficando longe do setup. A versão with diz a mesma coisa em duas linhas:
with open("notes.txt", "w") as f:
f.write("hello")
Forçamos um erro dentro do bloco, com raise ValueError("boom"), e depois verificamos o arquivo. A saída foi closed: True | content: hello. O arquivo foi fechado e os dados salvos, mesmo que o bloqueio tenha falhado.
Como funciona a instrução with
Qualquer objeto com dois métodos especiais pode ser usado em uma instrução with:
- Python chama o método
__enter__()do objeto. Tudo o que ele retorna está vinculado ao nome apósas. - O bloco recuado é executado.
- Python chama
__exit__(exc_type, exc, tb), independentemente de o bloco ter terminado normalmente, retornado antecipadamente ou gerado uma exceção.
Esse terceiro passo é a garantia. Ele é executado em return, break, continue e também em exceções, o que o torna mais confiável do que o código de limpeza escrito no final de um bloco.
Escrevendo um gerenciador de contexto baseado em classe
import time
class Timer:
def __enter__(self):
self.start = time.perf_counter()
return self
def __exit__(self, exc_type, exc, tb):
self.elapsed = time.perf_counter() - self.start
print(f"took {self.elapsed:.3f}s, exception: {exc_type.__name__ if exc_type else None}")
return False
with Timer() as t:
time.sleep(0.05)
# took 0.050s, exception: None
__enter__ retorna self, então o bloco e o código posterior podem ler t.elapsed. A forma de classe é melhor quando o gerenciador carrega estado ou oferece métodos extras, como uma sessão de banco de dados ou um servidor de teste.
Exceções e o valor de retorno de __exit__
__exit__ recebe detalhes de qualquer exceção e seu valor de retorno decide o que acontece a seguir:
with Timer():
1 / 0
# took 0.000s, exception: ZeroDivisionError
# ZeroDivisionError still raised
Nosso Timer retornou False, então a exceção continuou para o chamador após a impressão do tempo. Retornar True informa ao Python que a exceção foi tratada:
class Swallow:
def __enter__(self): return self
def __exit__(self, *a): return True
with Swallow():
raise KeyError("hidden")
print("program continued")
O KeyError desapareceu completamente. Ocasionalmente é isso que você deseja, mas geralmente esconde bugs. Observe que retornar None, que é o que um método sem return faz, conta como falso e permite a passagem da exceção. Esse é o padrão seguro. Nosso guia para tratamento de exceções em Python explica por que engolir erros silenciosamente é perigoso.
A maneira mais fácil: contextlib.contextmanager
Para casos simples, uma função geradora com um yield é mais curta que uma classe. Tudo antes de yield é configurado, o valor obtido vai para as e tudo depois é limpo:
import contextlib, os
@contextlib.contextmanager
def temp_env(name, value):
old = os.environ.get(name)
os.environ[name] = value
try:
yield
finally:
if old is None:
del os.environ[name]
else:
os.environ[name] = old
with temp_env("APP_MODE", "test"):
print(os.environ["APP_MODE"]) # test
print(os.environ.get("APP_MODE")) # None
A variável existia dentro do bloco e foi removida posteriormente, restaurando o estado original. Este padrão é perfeito para alterar temporariamente variáveis de ambiente, o diretório de trabalho ou uma configuração global.
A armadilha finalmente desaparecida
Aqui está o erro que quase todo mundo comete uma vez:
@contextlib.contextmanager
def broken():
print("setup")
yield
print("cleanup (never runs on error)")
with broken():
raise RuntimeError("x")
# setup
# (cleanup skipped)
Quando o bloco aumenta, a exceção é lançada no gerador na linha yield. Sem try/finally, o código após yield nunca é executado. Nossa linha de limpeza nunca foi impressa. Sempre envolva yield em try/finally quando a limpeza precisar acontecer, como em temp_env acima.
Dica: Um bom teste para qualquer gerenciador de contexto que você escrever é gerar uma exceção dentro do bloco with e verificar se a limpeza ainda aconteceu. São necessárias duas linhas e captura exatamente esse bug.
Gerenciadores de contexto integrados úteis
| Gerente | O que ele lida |
|---|---|
open() |
Fecha o arquivo |
threading.Lock() |
Adquire e libera o bloqueio |
sqlite3.connect() |
Confirma ou reverte uma transação |
tempfile.TemporaryDirectory() |
Exclui a pasta depois |
contextlib.suppress(Error) |
Ignora um tipo de exceção específico |
contextlib.chdir(path) |
Muda o diretório e volta (Python 3.11+) |
decimal.localcontext() |
Precisão decimal temporária |
unittest.mock.patch() |
Substituição temporária em testes |
Com um cadeado, nosso cheque imprimiu locked: True dentro do bloco e released: True depois dele. contextlib.suppress(FileNotFoundError) vamos deletar um arquivo que pode não existir sem um try/except. Use suppress apenas para erros que você realmente espera e com os quais não se importa.
Você também pode abrir vários gerenciadores em um único extrato, como em with open(a) as x, open(b) as y:. Nosso teste leu os dois arquivos e fechou ambos.
ExitStack: um número variável de gerentes
Quando você não sabe antecipadamente quantos recursos você precisa, ExitStack os coleta e limpa todos eles no final:
with contextlib.ExitStack() as stack:
files = [stack.enter_context(open(n, "w")) for n in names]
for i, fh in enumerate(files):
fh.write(str(i))
print(all(fh.closed for fh in files)) # True
Todos os três arquivos foram fechados. Se a abertura do terceiro tivesse falhado, os dois primeiros ainda teriam sido fechados, o que é difícil de acertar manualmente. ExitStack também possui um método callback() para registrar qualquer função de limpeza.
Transações de banco de dados: um detalhe surpreendente
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE t (x INT)")
with conn:
conn.execute("INSERT INTO t VALUES (1)")
raise ValueError("abort")
# rows after error: 0
with conn:
conn.execute("INSERT INTO t VALUES (2)")
# rows after success: 1
Uma conexão sqlite3 usada em with é confirmada se o bloco for bem-sucedido e revertida se falhar, exatamente o que uma transação deveria fazer. Mas observe o que não faz: a conexão ainda estava aberta depois. Ao contrário de open(), o gerenciador de contexto da conexão sqlite3 gerencia a transação, não a conexão. Feche-o separadamente, por exemplo com contextlib.closing(conn). Sempre verifique o que o gerenciador de contexto de uma biblioteca realmente faz; o nome da coisa não é suficiente.
Gerenciadores de contexto assíncronos
O código assíncrono usa async with e os métodos __aenter__ e __aexit__ ou @contextlib.asynccontextmanager. Você os encontrará com sessões de cliente HTTP, pools de banco de dados e asyncio.TaskGroup, que abordamos em nosso guia assíncrono.
Gerenciadores de contexto em testes
Os testes dependem muito de mudanças temporárias que devem ser desfeitas: correção de funções, configuração de variáveis de ambiente, criação de arquivos temporários. unittest.mock.patch funciona como um gerenciador de contexto, conforme mostrado em nosso guia de simulação, e o raises do pytest também é um deles: with pytest.raises(ValueError): .... Os fixtures pytest com yield seguem o mesmo formato setup-yield-cleanup, descrito em nosso guia de fixtures pytest.
Erros comuns
- Não
try/finallyem torno deyieldem um gerenciador baseado em gerador. - Retornando
Truede__exit__por acidente, que esconde todas as exceções. - Usando o recurso após o bloco. Um objeto de arquivo ainda existe após
with, mas está fechado. - Supondo que a limpeza aconteça. Assim como no sqlite3, leia a documentação.
- Redendo mais de uma vez em uma função
@contextmanager, que gera umRuntimeError.
Quando escrever seu próprio gerenciador de contexto
Procure um par de ações que devem acontecer sempre juntas, onde a segunda é fácil de esquecer. Bons sinais incluem:
- O mesmo bloco
try/finallyaparece em vários lugares. - O código altera algum estado global, como uma configuração, um diretório de trabalho ou um sinalizador de recurso, e deve restaurá-lo.
- Um recurso é adquirido de um pool e deve ser retornado, como uma conexão ou uma conta temporária em um ambiente de teste.
- Você deseja cronometrar, rastrear ou registrar um bloco de código de forma consistente.
Se a limpeza for uma chamada única que já possui um gerenciador de contexto, como open() ou um bloqueio, use-o em vez de escrever um novo. E se a “limpeza” precisar de dados produzidos dentro do bloco, um gerenciador de contexto pode esconder demais; uma função simples com etapas explícitas pode ser mais clara. O objetivo é menos maneiras de esquecer a limpeza, e não a inteligência.
Considerações finais
Os gerenciadores de contexto transformam o “lembre-se de limpar” em uma garantia. Use with para cada arquivo, bloqueio, conexão e alteração temporária. Ao escrever o seu próprio, escolha um gerador com try/finally para casos simples e uma classe quando precisar de estado, e teste-os levantando uma exceção dentro do bloco.
Perguntas frequentes
O que é um gerenciador de contexto em Python?
É um objeto que define configuração e limpeza através dos métodos __enter__ e __exit__. A instrução with chama ambos, executando a limpeza mesmo quando ocorre uma exceção.
Como faço para criar um gerenciador de contexto?
Escreva uma classe com __enter__ e __exit__ ou decore uma função geradora com @contextlib.contextmanager e produza uma vez, com limpeza em um bloco final.
Fecha o arquivo se ocorrer uma exceção?
Sim. Em nosso teste, o arquivo foi fechado e seu conteúdo salvo mesmo que o bloco tenha gerado um ValueError.
O que acontece se __exit__ retornar True?
A exceção é suprimida e a execução continua após o bloco with. Retorne False ou None para permitir a propagação de exceções.
Com sqlite3.connect() fecha a conexão?
Não. Ele confirma ou reverte a transação, mas a conexão permanece aberta. Feche-o separadamente ou use contextlib.closing.
Continue aprendendo
Precisa de ajuda com testes, WordPress ou SEO?
Ajudamos as equipes a fornecer software melhor e a expandir seus sites. Conte-nos no que você está trabalhando e sugeriremos um próximo passo claro.
Mais guias sobre testes, IA e desenvolvimento moderno
Gostou deste artigo? Escolha um tópico e vá direto para nossos tutoriais mais recentes.
Estratégias de chunking RAG explicadas: fixo, sobreposição, frase, recursivo e títulos, medidos
Estratégias de chunking RAG comparadas em um documento com tiktoken 0.14: tamanho fixo, sobreposição, empacotamento de frases, divisão recursiva e p…
Leia o artigo →Desenvolvimento de softwareExplicação da idempotência da API: chaves de idempotência e novas tentativas seguras, testadas
A idempotência da API explicada com um servidor e cliente Python que executamos: uma resposta perdida causava uma cobrança dupla sem uma chave e uma…
Leia o artigo →DevOpsGit Stash explicado: salvar, aplicar, abrir e não rastrear arquivos, testado
Git stash explicado com comandos que executamos no Git 2.56: push com uma mensagem, arquivos não rastreados, listar e mostrar, aplicar vs pop, mante…
Leia o artigo →Teste de softwareExplicação do teste em pares: como todos os pares reduzem 216 testes para 13, testados
Testes em pares explicados com um gerador que executamos em Python 3.13: um checkout com 216 combinações cobertas por 13 testes, cobertura verificad…
Leia o artigo →Automação de testesDuplas de teste explicadas: Dummy, Stub, Spy, Mock e Fake, com código Python testado
O teste duplo é explicado com um exemplo de Python executado no pytest 9.2: dummy, stub, spy, mock e fake, quando usar cada um, verificações de esta…
Leia o artigo →Bancos de dados e SQLSQL COALESCE explicado: padrões, NULLIF, IFNULL vs ISNULL e traps, testados
SQL COALESCE explicado com consultas que executamos no SQLite 3.50: primeiros valores não nulos, strings vazias, NULL em matemática, NULLIF para div…
Leia o artigo →Bancos de dados e SQLSQL Self Join explicado: funcionário-gerente, comparações de pares e linhas, testado
Auto-junção SQL explicada com consultas que executamos no SQLite 3.50: funcionário e gerente, ganhando mais que o gerente, pares únicos, alterações …
Leia o artigo →Desenvolvimento de softwareExplicação do operador JavaScript Spread: Spread vs Rest, cópias e pegadinhas, testado
O operador de propagação JavaScript explicado com o código que executamos no Nó 24: arrays, objetos, cópias superficiais, parâmetros restantes, o li…
Leia o artigo →Desenvolvimento de softwareMódulo de coleções Python explicado: contador, defaultdict, deque e mais, testado
Coleções Python explicadas com código que executamos em Python 3.13: Counter, defaultdict, deque, nomeadotuple, OrderedDict e ChainMap, além de um t…
Leia o artigo →Inteligência artificialJanela de contexto LLM explicada: tokens, limites e como ajustar mais, medidos
A janela de contexto do LLM explicada com contagens de tokens que medimos usando tiktoken: palavras versus tokens para prosa, código e hindi, orçame…
Leia o artigo →Desenvolvimento de softwareWebhooks explicados: como funcionam e como recebê-los com segurança
Webhooks explicados com um receptor e remetente que executamos em Python: push vs polling, assinaturas HMAC-SHA256, rejeição de solicitações adulter…
Leia o artigo →DevOpsGit Cherry-Pick explicado: copie o commit que você precisa, com segurança e testado
Git cherry-pick explicado com comandos que executamos no Git 2.56: copiar um hotfix para um branch de lançamento, novos hashes e patch-ids, -x, -n, …
Leia o artigo →Automação de testesExplicação do teste instantâneo: como funciona, quando ajuda e quando dói
O teste de instantâneo foi explicado com uma demonstração pytest e xaroposa que executamos: criação de instantâneos, leitura da diferença após uma a…
Leia o artigo →Teste de softwareExplicação do teste de mutação: por que a cobertura de 100% ainda não percebeu nosso bug
Os testes de mutação explicados com uma pequena ferramenta de mutação que construímos e executamos: 14 mutantes, um conjunto de testes com 100% de c…
Leia o artigo →Inteligência artificialExplicação da injeção imediata: como os aplicativos de IA são enganados e como defendê-los
Injeção imediata explicada para construtores: ataques diretos e indiretos, por que os filtros de palavras-chave falham (nosso teste bloqueou 1 de 4)…
Leia o artigo →DevOpsRegistros DNS explicados: A, AAAA, CNAME, MX, TXT e TTL com pesquisas reais
Registros DNS explicados com pesquisas que executamos: como funciona a resolução, A e AAAA, regras CNAME, MX e MX nulo, TXT para SPF e verificação, …
Leia o artigo →DevOpsSinalizadores de recursos explicados: lançamentos seguros, lançamentos graduais e higiene de sinalizadores
Sinalizadores de recursos explicados com uma simulação de implementação que executamos: tipos de sinalizadores, implementações percentuais com hashi…
Leia o artigo →Automação de testesGeração de dados de teste com Python Faker: dados realistas, repetíveis e seguros
Teste a geração de dados com Python Faker, execute e meça: propagação de dados repetíveis, localidades, valores exclusivos, registros em formato de …
Leia o artigo →Teste de softwareExplicação do teste Shift-Left: Encontre bugs mais cedo, sem atrasar a equipe
O teste shift-left explicou: o que significa, por que os defeitos iniciais são mais baratos, práticas desde revisões de requisitos até verificações …
Leia o artigo →Bancos de dados e SQLFunções de string SQL explicadas: TRIM, SUBSTR, REPLACE, CONCAT e limpeza de dados
Funções de string SQL explicadas com consultas que executamos: concatenação e NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, preenchimento, com…
Leia o artigo →Bancos de dados e SQLExplicação dos gatilhos SQL: gatilhos ANTES e DEPOIS, registros de auditoria e armadilhas
Gatilhos SQL explicados com gatilhos que executamos: ANTES vs DEPOIS, ANTIGO e NOVO, logs de auditoria, validação, atualizações de estoque, condiçõe…
Leia o artigo →Desenvolvimento de softwareMódulo JSON Python explicado: dumps, carregamentos, tipos personalizados e erros comuns
O módulo Python JSON explicado com o código que executamos: dumps e carregamentos, arquivos, conversões de tipo, datas e decimais, codificadores per…
Leia o artigo →Desenvolvimento de softwareMódulos ES vs CommonJS: como funcionam as importações de JavaScript em Node.js, testado
Módulos ES vs CommonJS explicados com código que executamos em Node.js: sintaxe de importação e exportação, require, vinculações ativas, cache, espe…
Leia o artigo →Desenvolvimento de softwarePython Regex explicado: padrões, grupos, antecipações e armadilhas, testados
Regex Python explicado com padrões que executamos: pesquisa vs correspondência, findall, grupos e grupos nomeados, ganancioso vs preguiçoso, sub, lo…
Leia o artigo →Inteligência artificialExplicação da saída estruturada do LLM: obtendo JSON confiável de modelos de IA
Saída estruturada do LLM explicada com validação que executamos no Pydantic: modo JSON e esquemas, decodificação restrita, formas de quebra de saída…
Leia o artigo →DevOpsChaves SSH explicadas: como funcionam, ssh-keygen, Ed25519 e hábitos seguros
Chaves SSH explicadas com chaves que geramos: chaves públicas versus privadas, ssh-keygen, Ed25519 versus RSA, impressões digitais, senhas, agente s…
Leia o artigo →DevOpsCache HTTP explicado: controle de cache, ETag e respostas 304, com um teste ao vivo
Cache HTTP explicado com um pequeno servidor que executamos: diretivas Cache-Control, idade máxima, sem cache vs sem armazenamento, revalidação de E…
Leia o artigo →Automação de testesTeste de contrato de API explicado: detecte alterações importantes antes de serem enviadas
O teste de contrato de API foi explicado com uma verificação de esquema que executamos: o que é um contrato, contratos orientados ao consumidor, Pac…
Leia o artigo →Teste de softwareTestes baseados em riscos explicados: avalie os riscos, construa uma matriz e teste o que é importante
Testes baseados em riscos explicados passo a passo: identificação de riscos, pontuação de probabilidade e impacto, construção de uma matriz de risco…
Leia o artigo →Bancos de dados e SQLRestrições SQL explicadas: NOT NULL, UNIQUE, CHECK e FOREIGN KEY, testadas
Restrições SQL explicadas com testes que executamos: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY e FOREIGN KEY, as lacunas NULL, configuração de chave…
Leia o artigo →Bancos de dados e SQLFunções de data SQL explicadas: adicionando, comparando e agrupando datas sem bugs
Funções de data SQL explicadas com consultas que executamos: adição de intervalos, surpresas de final de mês, diferenças de data, armadilha BETWEEN,…
Leia o artigo →Desenvolvimento de softwarePython assíncio explicado: assíncrono, espera, coleta e TaskGroup com Real Timings
Python asyncio explicado com código que cronometramos: corrotinas, espera, coleta, TaskGroup, tratamento de erros, tempos limite, limitação de simul…
Leia o artigo →Desenvolvimento de softwareDebounce vs Throttle em JavaScript: como funcionam, quando usar cada um, testado
Debounce vs. acelerador em JavaScript explicado com tempos que medimos em Node.js: como cada um funciona, implementações simples, chamadas iniciais …
Leia o artigo →Desenvolvimento de softwareGerenciadores de contexto Python explicados: a instrução with, contextlib e usos reais
Os gerenciadores de contexto Python explicados com o código que executamos: como funciona, __enter__ e __exit__, contextlib.contextmanager, supressã…
Leia o artigo →Inteligência artificialTemperatura LLM e Top-p explicados: como os modelos de IA escolhem sua próxima palavra
Temperatura LLM e top-p explicados com uma simulação que executamos: como as probabilidades são remodeladas, o que top-p mantém, configurações recom…
Leia o artigo →DevOpsYAML explicado: sintaxe, o problema da Noruega e outras armadilhas que testamos
YAML explicado com um teste de analisador: sintaxe básica, listas e mapas, o problema da Noruega, versões que se transformam em carros flutuantes, c…
Leia o artigo →DevOpsCron Jobs explicado: sintaxe, programações reais e os erros que os quebram
Cron jobs explicados com cronogramas que verificamos: os cinco campos, operadores, exemplos reais, a armadilha do dia do mês OU do dia da semana, pr…
Leia o artigo →Inteligência artificialExplicação das alucinações de IA: por que os modelos de linguagem inventam as coisas e como reduzi-las
Explicação das alucinações de IA: o que são, por que os modelos de linguagem as produzem, tipos comuns, como reduzi-las com aterramento e instruções…
Leia o artigo →DevOpsVariáveis de ambiente explicadas: arquivos .env, segredos e configuração bem feitos
Variáveis de ambiente explicadas com exemplos de Python que executamos: leitura e configuração, por que cada valor é uma string, arquivos .env, hera…
Leia o artigo →Desenvolvimento de softwareExplicação da limitação de taxa de API: algoritmos, cabeçalhos e tratamento de erros 429
Limitação de taxa de API explicada com uma simulação que executamos: token bucket, janela fixa, janela deslizante, 429 respostas, cabeçalhos de limi…
Leia o artigo →Automação de testesZombando em Python: unittest.mock, patch e os erros que fazem os testes mentirem
Zombaria em Python com unittest.mock, testado: Mock e return_value, side_effect, patch onde um nome é usado, especificação e autospec, zombaria de d…
Leia o artigo →Teste de softwareCobertura de código explicada: cobertura de linha versus filial e o que 100% realmente significa
Cobertura de código explicada com uma execução cobertura.py real: cobertura de linha, ramal e condição, leitura de um relatório, por que 100% de cob…
Leia o artigo →Bancos de dados e SQLDELETE vs TRUNCATE vs DROP em SQL: diferenças, reversão e quando usar cada um
DELETE vs TRUNCATE vs DROP explicado com SQL testado: o que cada um remove, rollback, aciona, redefinição de identidade, velocidade e como PostgreSQ…
Leia o artigo →Bancos de dados e SQLExibições SQL explicadas: crie, use e evite as armadilhas, com exemplos
Visualizações SQL explicadas com consultas que executamos: criação de uma visualização, resultados ao vivo, ocultação de colunas, desempenho, visual…
Leia o artigo →Desenvolvimento de softwareInterface TypeScript vs tipo: diferenças reais, testadas com o compilador
Interface TypeScript versus tipo, verificada com o compilador real: o que ambos podem fazer, o que apenas um pode fazer, mesclagem de declarações, e…
Leia o artigo →Desenvolvimento de softwarePython *args e **kwargs explicados: funções flexíveis com exemplos claros
Python *args e **kwargs explicados com o código que executamos: empacotamento e descompactação, ordem dos parâmetros, argumentos somente de palavras…
Leia o artigo →Desenvolvimento de softwareFunções Python Lambda: sintaxe, usos reais e quando não usá-los
Funções lambda do Python explicadas com o código que executamos: sintaxe, classificação com chave, mapa e filtro, fechamentos, armadilha de ligação …
Leia o artigo →Inteligência artificialO que são agentes de IA? Como eles funcionam, com um loop de agente simples que você pode executar
O que são agentes de IA? Um guia simples para o loop do agente, ferramentas, memória e proteções, com um pequeno loop Python que executamos, riscos …
Leia o artigo →DevOpsMonitoramento versus observabilidade: a verdadeira diferença, com logs, métricas e rastreamentos
Explicação do monitoramento versus observabilidade: falhas conhecidas e desconhecidas, logs, métricas e rastreamentos, um passo a passo do incidente…
Leia o artigo →DevOpsDocker Volumes vs Bind Mounts: persista os dados do contêiner da maneira certa
Volumes Docker versus montagens de ligação explicadas: por que os dados do contêiner desaparecem, volumes nomeados, montagens de ligação, tmpfs, exe…
Leia o artigo →Automação de testesTDD vs BDD: principais diferenças, um recurso criado de ambas as maneiras e quando usar cada um
TDD vs BDD explicado com um recurso de desconto construído em ambos os sentidos: refatoração vermelho-verde com o código que executamos, cenários da…
Leia o artigo →Teste de softwareTeste de aceitação do usuário (UAT): processo, lista de verificação e exemplos reais
Explicação do teste de aceitação do usuário: quem o executa, como ele difere do controle de qualidade, um processo de sete etapas, um modelo de caso…
Leia o artigo →Bancos de dados e SQLValores SQL NULL explicados: IS NULL, COALESCE, NULLIF e as armadilhas a serem evitadas
Valores SQL NULL explicados com consultas que executamos: lógica de três valores, IS NULL, COALESCE, NULLIF, como agregações, junções e classificaçã…
Leia o artigo →Bancos de dados e SQLInstrução SQL CASE WHEN: sintaxe, exemplos reais e erros comuns
SQL CASE WHEN explicado com consultas que executamos: formulários simples e pesquisados, ordem de condição, pivôs com SUM, truques COUNT, classifica…
Leia o artigo →Desenvolvimento de softwareO que é JWT? JSON Web Tokens explicados com um exemplo prático
O que é JWT? JSON Web Tokens explicados: as três partes, um token construído e adulterado no código que executamos, JWT vs sessões, armazenamento, t…
Leia o artigo →Desenvolvimento de softwareLoop de eventos JavaScript explicado: pilha de chamadas, microtarefas e temporizadores com exemplos
O loop de eventos JavaScript explicado com o código que executamos: pilha de chamadas, filas de tarefas e microtarefas, por que setTimeout 0 não é i…
Leia o artigo →Desenvolvimento de softwareGeradores Python e rendimento explicado: economize memória com exemplos reais
Geradores Python e rendimento explicados com o código que executamos: como eles pausam e reiniciam, medem economia de memória, pipelines, sequências…
Leia o artigo →Inteligência artificialO que são incorporações? Similaridade de vetores e cossenos explicada de forma simples
O que são incorporações? Um guia em linguagem simples para vetores, similaridade de cossenos e pesquisa semântica, com um pequeno exemplo que execut…
Leia o artigo →DevOpsImplantação azul-verde vs canário: diferenças, compensações e como escolher
Explicação da implantação azul-verde versus canário: como cada um funciona, custo, risco e reversão, agrupamento estável de usuários que testamos, m…
Leia o artigo →Automação de testesTestes instáveis: o que os causa e como corrigi-los para sempre
Testes instáveis explicados com demonstrações que executamos: as principais causas, como confirmar e diagnosticar uma, soluções adequadas para tempo…
Leia o artigo →Teste de softwareTeste de carga versus teste de estresse: diferenças, métricas e exemplos k6
Teste de carga versus teste de estresse explicado: o que cada um prova, testes de pico e absorção, as métricas que importam, por que as médias engan…
Leia o artigo →Teste de softwareCaso de teste versus cenário de teste: principais diferenças, exemplos e quando usar cada um
Caso de teste vs cenário de teste explicado: definições claras, uma tabela lado a lado, um recurso de redefinição de senha retirado de cenários para…
Leia o artigo →Bancos de dados e SQLOtimização de consultas SQL: leia planos de execução e corrija consultas lentas, com intervalos
Otimização de consulta SQL testada em um milhão de linhas: leia planos de execução, adicione os índices corretos, corrija filtros não sargáveis, use…
Leia o artigo →Bancos de dados e SQLSQL UNION vs UNION ALL: diferenças, exemplos e desempenho testado
SQL UNION vs UNION ALL explicado com consultas que executamos: duplicatas, as regras que ambos seguem, um bug de dados real, desempenho medido, INTE…
Leia o artigo →Desenvolvimento de softwareTutorial da API JavaScript Fetch: GET, POST, tratamento de erros e tempos limite
Um tutorial da API JavaScript Fetch testado em um servidor local: GET e POST, por que 404 não lança, um auxiliar reutilizável, strings de consulta, …
Leia o artigo →Desenvolvimento de softwareManipulação de arquivos Python: leitura, gravação, CSV, JSON e pathlib com exemplos
Manipulação de arquivos Python explicada com código que executamos: modos abertos, com, leitura de arquivos grandes, CSV, JSON, pathlib, arquivos bi…
Leia o artigo →Desenvolvimento de softwareClasses e objetos Python: tutorial OOP com exemplos reais
Classes e objetos Python explicados com código que executamos: __init__, métodos, atributos de classe vs instância, herança, propriedades, métodos d…
Leia o artigo →Inteligência artificialO que é um modelo de linguagem grande? Como funcionam os LLMs, explicado sem exageros
O que é um modelo de linguagem grande? LLMs explicados em linguagem simples: tokens, incorporações, atenção, treinamento, temperatura e janelas de c…
Leia o artigo →DevOpsComandos Linux para iniciantes: o guia essencial do terminal com exemplos
Comandos Linux para iniciantes, agrupados por tarefa: navegação, arquivos, visualização de logs, grep, pipes, permissões, processos e arquivos, com …
Leia o artigo →Automação de testesSelenium vs Playwright: principais diferenças, código comparado e qual escolher
Selenium vs Playwright comparado: arquitetura, espera, suporte a navegador e linguagem, depuração, o mesmo teste em ambas as ferramentas, conselhos …
Leia o artigo →Teste de softwareParticionamento de equivalência: técnica de design de teste explicada com exemplos resolvidos
Explicação do particionamento de equivalência: como encontrar partições válidas e inválidas, exemplos resolvidos para idades, senhas e cupons, teste…
Leia o artigo →Teste de softwareGravidade vs Prioridade em Testes de Software: Diferenças, Matriz e Exemplos Reais
Explicação da gravidade versus prioridade em testes de software: definições claras, uma matriz de quatro vias com exemplos, escalas de nível, quem d…
Leia o artigo →Bancos de dados e SQLTutorial de subconsultas SQL: tipos, subconsultas correlacionadas e EXISTS com exemplos
Um tutorial de subconsultas SQL com consultas que executamos: subconsultas escalares, IN, FROM e SELECT, subconsultas correlacionadas, EXISTS, a arm…
Leia o artigo →Bancos de dados e SQLTransações SQL e ACID explicados: COMMIT, ROLLBACK e níveis de isolamento
Transações SQL e ACID explicadas com uma transferência bancária que executamos: COMMIT, ROLLBACK, savepoints, locks, níveis de isolamento, leituras …
Leia o artigo →Desenvolvimento de softwareFolha de dicas dos comandos do Git: os comandos que você realmente usa, com exemplos
Uma folha de dicas de comandos Git agrupada por tarefa: configuração, preparação, ramificações, controles remotos, stash, histórico e desfazer erros…
Leia o artigo →Desenvolvimento de softwareExplicação das promessas de JavaScript: então, catch, Promise.all e erros comuns
Promessas JavaScript explicadas com o código que executamos: estados, cadeias then e catch, tratamento de erros, Promise.all, allSettled, race e any…
Leia o artigo →Desenvolvimento de softwareTutorial do dicionário Python: métodos, exemplos e padrões comuns
Um tutorial de dicionário Python com código que executamos: criar, ler e atualizar dictos, métodos-chave, mesclagem, compreensão, padrões de contage…
Leia o artigo →Inteligência artificialO que é RAG? Geração aumentada de recuperação explicada com um exemplo prático
O que é RAG? Geração aumentada de recuperação explicada passo a passo: indexação, chunking, embeddings, recuperação, um pequeno exemplo funcional de…
Leia o artigo →DevOpsTutorial Terraform para iniciantes: infraestrutura como código do primeiro arquivo aos módulos
Um tutorial do Terraform para iniciantes: comece sem conta na nuvem, aprenda como iniciar, planejar e aplicar, depois variáveis, saídas, estado, mód…
Leia o artigo →DevOpsDocker vs Kubernetes: principais diferenças, como eles funcionam juntos e o que você precisa
Docker vs Kubernetes explicado: o que cada um faz, o mesmo aplicativo rodando com ambos, Docker Compose e Swarm comparados, a mudança do dockershim …
Leia o artigo →Automação de testesTutorial Pytest para iniciantes: luminárias, parametrização e exemplos reais
Um tutorial pytest para iniciantes com testes que executamos no pytest 9.2: asserções, fixtures, parametrizar, conftest, marcadores, tmp_path, monke…
Leia o artigo →Teste de softwareCiclo de vida de teste de software (STLC): 6 fases, critérios de entrada e saída, exemplo
O ciclo de vida de teste de software explicou: seis fases do STLC com critérios de entrada e saída, resultados, um exemplo de recurso de login funci…
Leia o artigo →Desenvolvimento de softwareGit merge vs rebase: diferenças, exemplos e quando usar cada um
Git merge vs rebase explicado com saída real do log, uma tabela comparativa, a regra de ouro do rebase e um fluxo de trabalho seguro para equipes.
Leia o artigo →Desenvolvimento de softwareList comprehension em Python: sintaxe, exemplos e quando evitar
List comprehension em Python explicada: sintaxe, filtros, if-else, laços aninhados, tempos medidos e quando um laço for comum é a melhor escolha.
Leia o artigo →Bancos de dados e SQLSQL JOIN explicado com exemplos (Inner, Left, Right, Full)
Entenda os joins SQL passo a passo com tabelas e consultas de exemplo: INNER, LEFT, RIGHT, FULL, CROSS e SELF, além de erros comuns e dicas de desem…
Leia o artigo →