CycleMantle
Fluxos de trabalho

Guia do gerador de dados para seu primeiro fixture

03
Fixture em um minuto

De uma pasta vazia a um teste verde

Você tem uma função PHP que formata o total de um pedido e quer testá-la com vários inputs. O CycleMantle atua como gerador de dados: ele grava um arquivo JSON com pedidos inventados e, em seguida, grava as verificações que o leem. Nenhum dado é copiado de clientes reais. Com um modelo em nuvem, seu prompt e o texto do arquivo lido pelo agente são enviados ao provedor; com um modelo local, nada sai do seu PC. Planeje cerca de 4 mensagens curtas de chat: abra a pasta, peça os registros, peça as verificações e execute-as. Cada mensagem gera cartões que você pode ler, aceitar ou rejeitar antes da próxima mensagem. Leia os cartões de cima para baixo: cada um lista a ferramenta usada, o arquivo ou comando, e o resultado obtido. Se preferir ler antes de qualquer execução, inicie o chat no modo Plan only e mude para Ask first após ler o plano.

01

Abra a pasta do projeto

Inicie o app, escolha a pasta que contém seu código PHP e selecione Ask first como modo de aprovação, para que toda alteração aguarde sua confirmação. Você pode alterar o modo a qualquer momento, por exemplo, para Auto-run quando confiar nas etapas.

02

Peça registros fictícios

Descreva os campos necessários, como nome, data e valor, e peça um arquivo JSON com linhas inventadas. Informe quantas linhas deseja. Mantenha todos os nomes, endereços e valores claramente fictícios, para que ninguém confunda uma linha com uma pessoa real.

03

Peça as verificações

Solicite um script de teste pequeno que leia o arquivo JSON e compare inputs conhecidos com outputs esperados. Nomeie a função que deve ser testada. Peça ao agente para explicar cada verificação em uma linha, para que você saiba o que ela deve capturar.

04

Revise e execute

Leia o diff, aceite-o e deixe o Shell executar seu comando de teste. Em seguida, leia o código de saída e expanda o cartão para ver a saída. Se uma verificação falhar, peça ao agente para explicar a falha antes que ele edite qualquer coisa.

Um script de teste pequeno para começar

tests.php
<?php
function discount(int $cents, int $percent): int {
    return intdiv($cents * (100 - $percent), 100);
}
assert(discount(1000, 0) === 1000);
assert(discount(1000, 10) === 900);
assert(discount(0, 50) === 0);
assert(discount(999, 100) === 0);
echo 'All checks ran';

Uma função simples e quatro assert com inputs e resultados conhecidos. Não usa banco de dados, rede nem segredos. Mais tarde, o agente pode substituir os números fixos por linhas do seu arquivo JSON, e as verificações mantêm a mesma estrutura. Altere intencionalmente um valor esperado para ver uma falha. Salve como tests.php na pasta do seu projeto, execute-o com seu comando de teste e leia o código de saída no cartão antes de solicitar qualquer outra coisa. Em seguida, altere intencionalmente um valor esperado e observe o cartão ficar vermelho.

Quatro tarefas para ferramentas de geração de dados de teste

Escreva os registros de exemplo

Muitas pessoas se perguntam como gerar dados de teste mais rápido do que manualmente. Descreva o formato desejado e deixe o agente escrevê-lo: um arquivo JSON com 3 clientes inventados, cada um com nome, data de cadastro e valor do pedido. Entre as ferramentas de geração de dados de teste, um arquivo simples no seu projeto é o mais fácil de ler e alterar posteriormente, porque o diff mostra cada valor. glob e list_dir mostram onde as fixtures já existem, para que o novo arquivo seja criado ao lado das outras. Abra o cartão, verifique se todos os valores estão claramente inventados e edite as linhas estranhas manualmente antes de aceitar. Use domínios de exemplo reservados para e-mails. Peça algumas linhas, não centenas, para que você possa ler cada uma. Escreva datas em um formato fixo para que todas as linhas tenham a mesma aparência.

Escreva verificações que leem o arquivo

Peça um script que carregue o JSON e verifique um resultado por linha. O agente abre sua fonte com read_file, encontra a função com grep e propõe o arquivo de teste como diff. Mockar métodos estáticos em php é complicado, então peça ao agente para listar chamadas estáticas antes de escrever qualquer coisa e mantenha essas chamadas atrás de uma pequena função que um teste pode substituir. Ask first mantém a alteração até que você a aceite. Leia cada assert e pergunte se ela falharia se a função estivesse errada. Rejeite qualquer verificação que apenas repita o código que testa. Em seguida, adicione uma linha que deve falhar intencionalmente. Se o agente não conseguir identificar a função a que você se refere, nomeie-a no prompt e mencione o arquivo. Mantenha um conceito por teste.

Execute os testes e leia o código de saída

O Shell executa seu comando de teste no ambiente escolhido, como Windows local, WSL ou SSH para um servidor de sua propriedade. O cartão mostra o código de saída real, e um exit code zero significa que todas as verificações passaram, enquanto qualquer outro valor indica uma falha. Expanda o cartão para ler a saída linha por linha. Se algo falhar, o agente lê a mensagem e propõe uma correção como diff. Não aceite uma correção apenas porque ela torna a execução verde. Verifique primeiro o valor esperado no teste. Se uma segunda falha seguir, peça ao agente para explicar a primeira antes que ele edite novamente. Plan only é uma boa primeira passagem se o comando for novo para você, pois o agente então escreve um plano e não executa nada.

Decida qual código precisa de um teste

Depois que os testes passarem, execute seu comando de cobertura e deixe o agente ler o relatório. Equipes debatem se devem incluir código de infraestrutura na cobertura de código, e a resposta sensata é concordar com isso antes que o número se torne uma meta. Algumas equipes também exigem cobertura de teste obrigatória para métodos críticos, como verificações de preço ou permissão. Peça ao agente para listar esses métodos com grep e proponha testes para o primeiro. Revise o diff, execute os testes novamente e pare quando os caminhos críticos estiverem cobertos. Anote quais pastas você contou, para que o número do próximo mês signifique a mesma coisa. Peça ao agente para colocar a lista de pastas contadas em um arquivo de texto simples no seu projeto e leia o diff antes de aceitá-lo.

CycleMantle para Windows

Gere seu primeiro fixture hoje

Baixar CycleMantle ↗