Gerenciadores de contexto Python explicados: a instrução with, contextlib e usos reais

  1. Início
  2. Blog
  3. Desenvolvimento de software

Desenvolvimento de Software

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.

10 min de leitura
Explicação dos gerenciadores de contexto Python: a instrução with, contextlib e usos reais

Principais pontos

  • Um gerenciador de contexto combina configuração com limpeza. A instrução with executa 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 True de __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:

  1. Python chama o método __enter__() do objeto. Tudo o que ele retorna está vinculado ao nome após as.
  2. O bloco recuado é executado.
  3. 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/finally em torno de yield em um gerenciador baseado em gerador.
  • Retornando True de __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 um RuntimeError.

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/finally aparece 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

Trabalhe com Stack Quora

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.

Continue lendo

Mais guias sobre testes, IA e desenvolvimento moderno

Gostou deste artigo? Escolha um tópico e vá direto para nossos tutoriais mais recentes.

Inteligência artificial

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 software

Explicaçã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 →
DevOps

Git 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 software

Explicaçã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 testes

Duplas 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 SQL

SQL 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 SQL

SQL 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 software

Explicaçã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 software

Mó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 artificial

Janela 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 software

Webhooks 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 →
DevOps

Git 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 testes

Explicaçã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 software

Explicaçã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 artificial

Explicaçã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 →
DevOps

Registros 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 →
DevOps

Sinalizadores 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 testes

Geraçã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 software

Explicaçã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 SQL

Funçõ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 SQL

Explicaçã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 software

Mó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 software

Mó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 software

Python 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 artificial

Explicaçã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 →
DevOps

Chaves 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 →
DevOps

Cache 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 testes

Teste 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 software

Testes 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 SQL

Restriçõ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 SQL

Funçõ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 software

Python 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 software

Debounce 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 software

Gerenciadores 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 artificial

Temperatura 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 →
DevOps

YAML 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 →
DevOps

Cron 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 artificial

Explicaçã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 →
DevOps

Variá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 software

Explicaçã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 testes

Zombando 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 software

Cobertura 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 SQL

DELETE 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 SQL

Exibiçõ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 software

Interface 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 software

Python *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 software

Funçõ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 artificial

O 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 →
DevOps

Monitoramento 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 →
DevOps

Docker 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 testes

TDD 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 software

Teste 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 SQL

Valores 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 SQL

Instruçã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 software

O 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 software

Loop 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 software

Geradores 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 artificial

O 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 →
DevOps

Implantaçã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 testes

Testes 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 software

Teste 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 software

Caso 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 SQL

Otimizaçã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 SQL

SQL 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 software

Tutorial 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 software

Manipulaçã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 software

Classes 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 artificial

O 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 →
DevOps

Comandos 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 testes

Selenium 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 software

Particionamento 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 software

Gravidade 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 SQL

Tutorial 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 SQL

Transaçõ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 software

Folha 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 software

Explicaçã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 software

Tutorial 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 artificial

O 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 →
DevOps

Tutorial 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 →
DevOps

Docker 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 testes

Tutorial 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 software

Ciclo 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 software

Git 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 software

List 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 SQL

SQL 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 →