Pytest Xdist: execute testes em paralelo e reduza o tempo de teste

  1. Início
  2. Blog
  3. Automação de testes

Automação de Teste

Pytest Xdist: Execute testes em paralelo e reduza o tempo de teste

pytest-xdist executa seu conjunto pytest em vários núcleos de CPU ao mesmo tempo. Aprenda como instalá-lo, escolha o número de trabalhadores, escolha um modo de distribuição e corrija os bugs de estado compartilhado que as execuções paralelas expõem, com tempos e falhas de execuções reais.

9 min de leitura
Pytest xdist: execute testes em paralelo e reduza o tempo de teste

Principais pontos

  • pytest xdist adiciona -n: pytest -n auto inicia um processo de trabalho por núcleo da CPU.
  • Nosso conjunto de 16 testes caiu de 8,05 s para 3,41 s com 4 trabalhadores, cerca de 2,4 vezes mais rápido.
  • Testes que compartilham arquivos, bancos de dados ou globais podem falhar em paralelo. Nosso teste de arquivo compartilhado falhou em todas as execuções paralelas.
  • Para suítes pequenas e rápidas, a inicialização do trabalhador custa mais do que economiza: 0,11 s tornou-se 1,43 s.

Um conjunto de testes que leva 20 minutos muda a forma como uma equipe trabalha. As pessoas param de executá-lo localmente, as solicitações pull aguardam no CI e os bugs escapam. Se seus testes passam a maior parte do tempo esperando por E/S, navegadores ou cálculos lentos, executá-los em paralelo costuma ser a maior aceleração disponível e, para usuários de pytest, a ferramenta padrão é pytest-xdist.

Executamos todos os exemplos em Python 3.13.6, pytest 9.2.0 e pytest-xdist 3.8.0, em uma máquina com 4 núcleos de CPU. Novo no pytest? Leia nosso tutorial pytest primeiro.

O que é pytest-xdist?

pytest-xdist é o plugin oficial do pytest para testes distribuídos. Ele inicia vários processos de trabalho, coleta os testes de cada um e distribui os testes aos trabalhadores para que sejam executados ao mesmo tempo. Cada trabalhador é um processo Python separado com sua própria memória, portanto, os testes vinculados à CPU obtêm paralelismo real, não apenas threads aguardando o bloqueio global do interpretador.

Instalando pytest-xdist

pip install pytest-xdist
pytest --version
python -c "import xdist; print(xdist.__version__)"   # 3.8.0

Não há arquivo de configuração para editar. Uma vez instalado, o plugin se registra e o pytest ganha novas opções de linha de comando. Sem -n, seus testes são executados exatamente como antes.

Executando testes em paralelo com -n

pytest -n 4          # four workers
pytest -n auto       # one worker per CPU core
pytest -n logical    # one per logical CPU (hyper-threads)
pytest -n 0          # xdist installed but disabled

-n auto é a escolha usual. Ele usa o número de núcleos físicos da CPU quando pode detectá-los e, caso contrário, recorre às CPUs lógicas. Você também pode colocá-lo em sua configuração para que todos recebam por padrão:

# pytest.ini
[pytest]
addopts = -n auto

Nossos tempos: serial vs paralelo

Nosso arquivo de teste tinha 16 testes parametrizados, cada um dormindo por meio segundo para simular uma chamada de API lenta:

import time, pytest

@pytest.mark.parametrize("n", range(16))
def test_slow_api_call(n):
    time.sleep(0.5)
    assert n * 2 == n + n
Comando Resultado Acelerar
pytest 16 passaram em 8,05s 1.0x
pytest -n 2 16 passaram em 4,94s 1.6x
pytest -n 4 16 passou em 3,41s 2.4x
pytest -n automático 16 passou em 3,45s 2.3x

O ideal com 4 trabalhadores seria 2 segundos (8 segundos de sono divididos em quatro partes). O resto é o custo fixo de abertura de trabalhadores e coleta de exames em cada um deles, cerca de um segundo ou mais aqui. Esse custo fixo é o motivo pelo qual suítes maiores apresentam resultados mais próximos do ideal e por que suítes pequenas podem ficar mais lentas, como mostramos a seguir.

Como funciona o pytest-xdist

  1. O processo principal, denominado controlador, inicia N trabalhadores denominados gw0, gw1 e assim por diante.
  2. Cada trabalhador coleta o conjunto completo de testes de forma independente. O controlador verifica se todos os trabalhadores encontraram os mesmos testes na mesma ordem.
  3. O controlador envia IDs de teste aos trabalhadores de acordo com o modo de distribuição.
  4. Os trabalhadores executam seus testes e relatam os resultados, e o controlador imprime um relatório combinado.

Como cada trabalhador coleta de forma independente, a coleta de testes deve ser determinística. A geração de valores parametrizados a partir de uma fonte aleatória não propagada ou de um conjunto com ordem imprevisível pode fazer com que a coleta seja diferente entre os trabalhadores e abortar a execução.

Modos de distribuição com –dist

Modo Como os testes são compartilhados Usar quando
load (padrão) Testes pendentes vão para qualquer trabalhador livre Testes independentes
escopo de carga Os testes no mesmo módulo ou turma permanecem juntos Módulo caro ou acessórios de classe
carregar arquivo Os testes no mesmo arquivo permanecem juntos Arquivos que compartilham configuração ou estado
grupo de carga Testes marcados como xdist_group(name) permanecem juntos Grupos escolhidos a dedo
roubo de trabalho Trabalhadores ociosos fazem testes com os ocupados Testes com durações muito desiguais

Manter os testes relacionados em um trabalhador permite que os acessórios de módulo e classe sejam criados uma vez, em vez de uma vez por trabalhador, e evita que testes que tocam o mesmo recurso sejam executados no mesmo momento.

O verdadeiro problema: estado compartilhado

As execuções paralelas assumem que seus testes são independentes. Muitas suítes não são, e ninguém percebe até que o xdist as execute ao mesmo tempo. Escrevemos três testes que usam um arquivo JSON como banco de dados falso:

DB = pathlib.Path("shared_db.json")

def test_create_user():
    _save({"users": ["asha"]})
    time.sleep(0.3)
    assert _load()["users"] == ["asha"]

def test_reset_db():
    _save({"users": []})
    time.sleep(0.3)
    assert _load()["users"] == []

Em série, todos os três passaram. Com -n 3 nós os executamos seis vezes. Cinco execuções terminaram com 2 falhas, 1 aprovação e uma execução com todas as 3 falhas, com erros como:

E   json.decoder.JSONDecodeError: Extra data: line 1 column 14 (char 13)

Dois trabalhadores escreveram o arquivo ao mesmo tempo e o deixaram parcialmente sobrescrito. Em um conjunto real, a mesma corrida aparece como falhas intermitentes que desaparecem quando executadas novamente, o que é exatamente o que torna os testes instáveis tão caros.

Corrigindo estado compartilhado

Opção 1: isolar cada teste. Dê a cada teste seu próprio recurso. O fixture interno tmp_path do pytest cria um diretório exclusivo por teste:

def test_create_user_isolated(tmp_path):
    db = tmp_path / "db.json"
    db.write_text(json.dumps({"users": ["asha"]}))
    assert json.loads(db.read_text())["users"] == ["asha"]

Esta versão foi aprovada em três de três execuções com -n 2. A mesma ideia se aplica a bancos de dados (um esquema ou banco de dados por trabalhador), portas (ligadas à porta 0) e contas de teste (nomes exclusivos por teste).

Opção 2: manter os testes conflitantes juntos. A execução do arquivo original com -n 3 --dist loadfile foi aprovada em três de três execuções, porque todos os três testes foram para um trabalhador e foram executados um após o outro. Esta é uma solução rápida que sacrifica o paralelismo dentro do arquivo. O isolamento é melhor a longo prazo.

Dica: antes de adicionar -n auto ao CI, execute o conjunto em paralelo várias vezes localmente. Uma única corrida verde prova pouco quando as corridas dependem do tempo.

Os fixtures da sessão são executados uma vez por trabalhador

Um acessório scope="session" normalmente funciona uma vez por teste. No xdist, cada trabalhador tem sua própria sessão, então o fixture é executado uma vez por trabalhador. Se ele criar um banco de dados, semear dados ou iniciar um servidor, você obterá N cópias. Projete-o para ser por trabalhador, por exemplo, usando o ID do trabalhador nos nomes, ou siga o padrão de documentação xdist de usar um bloqueio de arquivo para que apenas o primeiro trabalhador faça a configuração compartilhada. Não executamos o padrão de bloqueio de arquivo aqui. Nosso guia de fixtures pytest cobre os escopos em detalhes.

Saber em qual trabalhador você está

def test_which_worker(worker_id):
    assert worker_id in ("master", "gw0", "gw1", "gw2", "gw3")

O fixture worker_id retorna gw0, gw1 e assim por diante em xdist, e master quando os testes são executados sem trabalhadores. Confirmamos que foi impresso running on master com -n 0. Com -p no:xdist o plugin não é carregado, então um teste que solicita worker_id apresenta erros; vimos exatamente isso. Os trabalhadores também recebem uma variável de ambiente PYTEST_XDIST_WORKER. Use-os para criar nomes de bancos de dados, portas ou pastas de saída por trabalhador.

Quando o xdist torna os testes mais lentos

# 200 trivial assertions
pytest fast/          # 200 passed in 0.11s
pytest -n 4 fast/     # 200 passed in 1.43s

Iniciar quatro processos Python e coletar o conjunto quatro vezes demorou mais do que simplesmente executar 200 pequenos testes. O xdist compensa quando os testes são lentos: chamadas de rede, navegadores, bancos de dados ou computação pesada. Para um conjunto de unidades rápido, mantenha-o serial ou ative o xdist apenas no CI para o conjunto de integração lenta. Use --durations=10 para descobrir para onde o tempo realmente vai antes de paralelizar.

Saída, -s e depuração

  • imprimir saída: os trabalhadores capturam stdout, então -s a saída não apareceu em nossa execução paralela. Depure com -n 0 ou -p no:xdist.
  • Ordem: os testes terminam fora de ordem, portanto, não confie na execução de um teste antes do outro. Se um teste precisar que outro seja executado primeiro, corrija o teste.
  • -x: parar na primeira falha ainda funciona, mas os testes já em execução em outros trabalhadores podem terminar primeiro.
  • Cobertura: pytest-cov combina dados de trabalhadores automaticamente; consulte cobertura do pytest.
  • Marcadores: mantenha os testes lentos ou somente seriais separados com marcadores pytest e execute-os em um segundo comando não paralelo.

Usando pytest-xdist em CI

Os executores de CI geralmente têm de 2 a 4 núcleos, portanto -n auto oferece ganhos modestos por trabalho, mas eles somam centenas de execuções por dia. Combine xdist dentro de um trabalho com a divisão do conjunto em vários trabalhos para grandes conjuntos. Observe a memória: cada trabalhador importa todo o seu projeto, então quatro trabalhadores usam aproximadamente quatro vezes a memória. Nosso guia de CI/CD de ações do GitHub mostra um pipeline típico.

Lista de verificação Pytest xdist

  • Meça primeiro com --durations; paralelize suítes lentas, não rápidas.
  • Torne os testes independentes: sem arquivos, linhas, globais ou portas compartilhadas.
  • Use tmp_path e nomes por trabalhador criados a partir de worker_id.
  • Lembre-se de que os fixtures de sessão são executados uma vez por trabalhador.
  • Mantenha a coleção determinística, especialmente parametrize valores.
  • Use --dist loadfile ou loadgroup como solução provisória para testes que ainda não podem ser isolados.
  • Execute o conjunto paralelo várias vezes antes de confiar nele.

Considerações finais

pytest-xdist está a uma instalação e a um sinalizador de um conjunto mais rápido: nossos testes lentos foram executados 2,4 vezes mais rápido em 4 núcleos. A bandeira é fácil; o verdadeiro trabalho é tornar os testes independentes, que as execuções paralelas expõem imediatamente. Isole o estado com recursos tmp_path e por trabalhador, agrupe o que ainda não pode ser isolado e mantenha pequenos conjuntos seriais. Feito dessa forma, o pytest-xdist transforma longas esperas em feedback rápido.

Perguntas frequentes

Como executo testes pytest em paralelo?

Instale o plug-in com pip install pytest-xdist e execute pytest -n auto para iniciar um trabalhador por núcleo da CPU ou pytest -n 4 para um número fixo de trabalhadores.

Por que meus testes falham apenas com pytest xdist?

Normalmente, os testes compartilham estados como um arquivo, linhas de banco de dados, uma variável global ou uma porta, e os trabalhadores agora tocam neles ao mesmo tempo. Isole cada teste, por exemplo, com tmp_path, ou mantenha os testes relacionados juntos com o modo loadfile.

O que n auto significa em pytest?

Ele diz ao pytest-xdist para iniciar tantos trabalhadores quantos núcleos de CPU houver, usando núcleos físicos quando eles puderem ser detectados e CPUs lógicas caso contrário.

O pytest xdist sempre torna os testes mais rápidos?

Não. A contratação de trabalhadores tem um custo fixo. Em nossa execução, 200 pequenos testes levaram 0,11 segundos em série e 1,43 segundos com quatro trabalhadores. Ajuda mais com testes lentos.

Os equipamentos com escopo de sessão funcionam com pytest xdist?

Eles funcionam, mas cada trabalhador tem sua própria sessão, portanto, um dispositivo de sessão é executado uma vez por trabalhador, em vez de uma vez no geral. Projete-o para ser executado com segurança várias vezes ou use um bloqueio de arquivo para configuração compartilhada.

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.

Desenvolvimento de software

Cookies HTTP explicados: seguros, HttpOnly, SameSite e escopo

Cookies HTTP explicados: Set-Cookie, Path, Domain, expiration, Secure, HttpOnly, SameSite, prefixos, exclusão de cookies e uma receita de sessão seg…

Leia o artigo →
DevOps

Git Rebase Interactive: Squash, Fixup, Reword e Autosquash

Git rebase interativo explicado passo a passo: escolher, reformular, esmagar, consertar, editar, descartar, autosquash, conflitos e desfazer um reba…

Leia o artigo →
Teste de software

Teste Alfa vs Beta: Principais diferenças, critérios de saída e lista de verificação

Testes alfa e beta comparados: quem testa, o que cada fase encontra, critérios de entrada e saída, como executar um beta e um exemplo prático de dad…

Leia o artigo →
Automação de testes

Pytest Monkeypatch: 10 exemplos testados para Env Vars, Time e APIs

Pytest monkeypatch explicado com 10 testes de aprovação: variáveis de ambiente, funções, configuração, tempo, suspensão, caminhos, bloqueio de rede …

Leia o artigo →
Bancos de dados e SQL

Incremento automático de SQL: MySQL, PostgreSQL, SQL Server e SQLite

Incremento automático de SQL em MySQL, PostgreSQL, SQL Server e SQLite: sintaxe, leitura do novo ID, porque aparecem lacunas, reutilização de ID, re…

Leia o artigo →
Bancos de dados e SQL

SQL BETWEEN: intervalos inclusivos e a armadilha de data explicada

SQL BETWEEN explicado com consultas testadas: intervalos inclusivos, limites invertidos, NULLs, armadilha de data do último dia, intervalos semiaber…

Leia o artigo →
Desenvolvimento de software

Literais de modelo JavaScript: 10 exemplos, incluindo modelos marcados

Literais de modelo JavaScript explicados com 10 exemplos testados: interpolação, strings multilinha, escape, modelos marcados para HTML e SQL seguro…

Leia o artigo →
Desenvolvimento de software

Heapq Python: filas prioritárias, N principais e heaps explicados

Python heapq explicou: heappush, heappop, heapify, filas de prioridade com desempates, max heaps, nlargest e merge, com tempos reais em relação à cl…

Leia o artigo →
Desenvolvimento de software

Operador Python Walrus (:=) explicado com 8 exemplos reais

O operador Python walrus := explicado com 8 exemplos testados: if checks, regex matches, while loops, compreensões, regras de escopo, precedência e …

Leia o artigo →
Inteligência artificial

Função Softmax explicada: fórmula, código Python e versão estável

A função softmax explicada: fórmula, exemplo resolvido, código NumPy, a versão estável que evita NaN, temperatura, entropia cruzada e softmax vs sig…

Leia o artigo →
Desenvolvimento de software

CORS explicado: solicitações de comprovação, cabeçalhos e como corrigir erros de CORS

CORS explicado: origens, solicitações simples e de simulação, os cabeçalhos de resposta que seu servidor deve enviar, credenciais e como corrigir er…

Leia o artigo →
DevOps

Git Diff explicado: mudanças faseadas, ramificações e commits

Git diff explicado: leia a saída, compare alterações não preparadas e preparadas, commits e ramificações, dois pontos versus três pontos e sinalizad…

Leia o artigo →
Automação de testes

Pytest Xdist: execute testes em paralelo e reduza o tempo de teste

Execute testes pytest em paralelo com pytest-xdist: instalação, a opção -n, modos de distribuição, tempos reais e como corrigir falhas de estado com…

Leia o artigo →
Teste de software

Verificação vs Validação em Teste de Software: Exemplo e Tabela

Verificação versus validação em testes de software explicada com uma tabela de comparação e um exemplo de cupom testado onde todos os testes de espe…

Leia o artigo →
Inteligência artificial

BM25 explicado: como a pesquisa por palavra-chave classifica os resultados, com código Python e pesquisa híbrida

BM25 explicou com uma implementação Python pura que executamos: a fórmula, IDF, saturação de termo, os parâmetros k1 e b, por que supera a contagem …

Leia o artigo →
Desenvolvimento de software

Métodos HTTP explicados: GET, POST, PUT, PATCH, DELETE, testados em um servidor Live

Métodos HTTP explicados com um pequeno servidor que executamos: GET, POST, PUT, PATCH, DELETE, HEAD e OPTIONS, seguro vs idempotente, PUT vs PATCH, …

Leia o artigo →
DevOps

Git Bisect explicado: encontre o commit que quebrou seu código, manual ou automaticamente

Git bisect explicado com um repositório testado: encontre o commit incorreto entre 41 em 5 execuções de teste, automatize-o com git bisect run, pule…

Leia o artigo →
Automação de testes

Marcadores pytest explicados: marcas personalizadas, filtros skip, skipif, xfail e -m

marcadores pytest explicados com um conjunto testado: registre marcas personalizadas, execute apenas testes de fumaça com -m, combine filtros com e,…

Leia o artigo →
Teste de software

Testes Positivos vs Negativos: Diferenças, 24 Casos de Teste Reais e uma Lista de Verificação

Testes positivos versus negativos explicados com um formulário de inscrição real: 6 casos de teste positivos e 18 negativos executados em pytest, a …

Leia o artigo →
Bancos de dados e SQL

SQL ORDER BY Várias Colunas: ASC, DESC, NULLS LAST, Case e Ordem Personalizada

SQL ORDER BY com múltiplas colunas explicadas com consultas testadas: ASC e DESC mistos, desempates, NULLS FIRST e LAST, classificação sem distinção…

Leia o artigo →
Bancos de dados e SQL

Total em execução do SQL: SUM OVER, totais por grupo, somas móveis e armadilha RANGE

Como calcular um total de execução SQL com SUM() OVER: totais por grupo, somas cumulativas diárias, somas móveis, porcentagem do total, armadilha de…

Leia o artigo →
Desenvolvimento de software

Matriz de classificação JavaScript: números, objetos, strings e por que 10 vem antes de 5

Como classificar um array em JavaScript corretamente: números com função de comparação, objetos por um ou mais campos, strings com localeCompare, da…

Leia o artigo →
Desenvolvimento de software

Métodos de string Python: folha de dicas, exemplos reais e a armadilha strip()

Métodos de string Python com exemplos testados: split, join, strip, replace, find, startupswith, is-methods, casefold, partition e translate, além d…

Leia o artigo →
Inteligência artificial

Explicação da similaridade de cossenos: fórmula, exemplo resolvido e código Python

A similaridade de cosseno é explicada de forma simples: a fórmula, um exemplo trabalhado à mão, código Python e NumPy puro, cosseno versus distância…

Leia o artigo →
Desenvolvimento de software

Codificação UTF-8 explicada: como o texto se transforma em bytes e como corrigir texto ilegível

Codificação UTF-8 explicada com exemplos em nível de byte que executamos em Python: como os caracteres se tornam de 1 a 4 bytes, por que café se tra…

Leia o artigo →
Automação de testes

parametrização pytest explicada: 7 padrões com exemplos testados

parametrização pytest explicada com 7 padrões testados: casos básicos, ids legíveis, decoradores empilhados, pytest.param com xfail e skip, fixtures…

Leia o artigo →
Teste de software

Reteste versus teste de regressão: 8 diferenças principais com um exemplo real de correção de bug

Reteste versus teste de regressão explicado com uma correção de bug real executada em pytest: o reteste confirmou a correção, a execução de regressã…

Leia o artigo →
Bancos de dados e SQL

Excluir linhas duplicadas em SQL: 5 métodos seguros, testados passo a passo

Como excluir linhas duplicadas no SQL com segurança: encontre-as, visualize-as e remova-as com ROW_NUMBER, MIN(id), EXISTS, rowid ou uma nova tabela…

Leia o artigo →
Bancos de dados e SQL

SQL RANK vs DENSE_RANK vs ROW_NUMBER: diferenças com exemplos testados

SQL RANK vs DENSE_RANK vs ROW_NUMBER em uma tabela: como cada um lida com empates, N principais por grupo, a segunda armadilha salarial mais alta e …

Leia o artigo →
Desenvolvimento de software

Encadeamento opcional de JavaScript (?.) Explicado: 8 exemplos, ?? Padrões e armadilhas

O encadeamento opcional de JavaScript interrompe erros “Não é possível ler propriedades de indefinidos”. 8 exemplos testados para propriedades, arra…

Leia o artigo →
Desenvolvimento de software

Python enumerate() explicado: 7 exemplos, start=1 e erros a evitar

Python enumerate() fornece o índice e o valor em um loop limpo. 7 exemplos testados, o truque start=1, dicionários, arquivos, números rápidos e 3 er…

Leia o artigo →
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

Functools Python explicado: lru_cache, parcial, redução, wraps e muito mais, testado

Functools do Python explicados com código que executamos no Python 3.13: lru_cache e cache, parcial, redução, wraps, cached_property, singledispatch…

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 →
Bancos de dados e SQL

Funções SQL JSON explicadas: consulta, atualização e indexação JSON em SQL, testadas

Funções SQL JSON explicadas com consultas que executamos no SQLite 3.50: json_extract, os operadores -> e ->>, json_each, json_set, json_pa…

Leia o artigo →
Bancos de dados e SQL

SQL Pivot explicado: transforme linhas em colunas com CASE, FILTER e PIVOT

SQL pivot explicado com consultas que executamos no SQLite 3.50: agregação condicional com CASE e SUM, FILTER, NULL vs zero, totais, colunas dinâmic…

Leia o artigo →
Desenvolvimento de software

JavaScript esta palavra-chave explicada: cada regra de ligação, testada no nó

A palavra-chave JavaScript explicada com 17 casos que executamos no Nó 24: chamadas de método, perdeu isso em retornos de chamada, modo estrito, fun…

Leia o artigo →
Desenvolvimento de software

Python pathlib explicado: caminhos, arquivos e pastas da maneira moderna, testados

Python pathlib explicado com exemplos que executamos no Python 3.13: juntando caminhos com /, nome, radical e sufixo, lendo e gravando arquivos, mkd…

Leia o artigo →
Desenvolvimento de software

Itertools Python explicados: loops preguiçosos, combinações e agrupamentos, testados

Itertools do Python explicados com exemplos que executamos no Python 3.13: contagem, ciclo, acumulação, cadeia, agrupamento, produto, combinações, p…

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

Ciclo de vida de bugs em testes de software: cada status, quem é o proprietário e erros comuns

O ciclo de vida do bug explicado: cada status de defeito, de Novo a Fechado, quem é o proprietário de cada etapa, bugs rejeitados, adiados e reabert…

Leia o artigo →
Automação de testes

Teste baseado em propriedades em Python: a hipótese encontra os bugs que seus exemplos não percebem

Testes baseados em propriedades explicados com testes de hipóteses que executamos: propriedades versus exemplos, estratégias, redução, os bugs reais…

Leia o artigo →
Bancos de dados e SQL

Paginação SQL explicada: OFFSET vs Keyset, com um teste de um milhão de linhas

Paginação SQL explicada com um teste de um milhão de linhas que executamos: LIMIT e OFFSET, por que páginas profundas ficam lentas, paginação de con…

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 →