API gratuita para testes, fixtures e o app CycleMantle
Noções básicas de teste
O que é uma API gratuita para testes?
Uma API gratuita para testes é um serviço web público que retorna dados de exemplo, e quem a procura geralmente quer um sandbox para praticar. O CycleMantle não é uma. Ele grava respostas fixas em um arquivo JSON que você possui, então seus testes nunca dependem do servidor de outra pessoa ou se ele está online hoje. Use um serviço público apenas se o proprietário permitir.
O que é uma API dummy?
Uma API dummy é um serviço substituto que retorna dados fixos e fictícios em vez de saída real. Em um projeto de teste, muitas vezes é apenas um arquivo JSON. O CycleMantle pode escrever esse arquivo para você, com nomes, datas e valores inventados, e mostrar um diff antes de qualquer coisa ser salva na sua pasta. Mantenha-o pequeno. Adicione linhas apenas quando um teste precisar delas.
Como obter dados de teste realistas para frontend?
A maneira mais simples é pedir ao agente um arquivo JSON com linhas inventadas que correspondam aos campos que sua página mostra. Descreva as colunas, o número de linhas e alguns casos incomuns, como um nome vazio. Leia o diff. Edite qualquer valor que não goste e mantenha o arquivo no seu projeto para que o próximo teste possa reutilizá-lo.
O que um relatório de cobertura deve me dizer?
Um relatório de cobertura é uma lista das linhas ou ramificações que foram executadas enquanto seus testes rodavam, indicando código que nenhum teste tocou. Números enganam. Ele não pode dizer se as verificações foram significativas, então leia-o como uma lista de tarefas e não como uma nota, e abra as funções com linhas não testadas primeiro. Peça ao agente por um teste de cada vez.
Como testar código que depende de um backend atrasado?
A maneira mais simples é um arquivo fixture que contém respostas fixas para cada chamada. Se você precisar simular endpoints quando o backend estiver atrasado, peça ao agente para escrever esse arquivo e um teste que o leia. Mantenha a honestidade. Mais tarde, compare o fixture com as respostas reais de um serviço que você possui e atualize-o sempre que elas mudarem.
Usando o CycleMantle
O phptest.org é o site oficial do CycleMantle?
Sim. Este é o site oficial do CycleMantle, e o botão de download fornece a build original do app, cujo checksum SHA-256 você deve comparar com o manifesto publicado antes de executá-lo. Perguntas e relatórios de bugs são enviados pelo botão Send feedback dentro do app, e o app é independente do projeto PHP. Você também pode ler o número da versão na página de download, que mostra 2.9.30.
Os resultados estão sempre corretos?
Não. O agente pode interpretar mal o código, perder um caso de borda ou escrever um teste fraco, então revise todo diff e execute seu comando de teste você mesmo quando tiver dúvidas. Testes aprovados e uma alta figura de cobertura são evidência, não prova. Ask first mantém cada mudança aguardando seu OK até que você a leia. Mantenha seu histórico de controle de versão como uma rede de segurança.
O CycleMantle pode executar meu comando de teste?
Sim. Shell executa o comando que você fornece no ambiente que você escolheu, que pode ser Windows local, WSL ou SSH para um servidor que você possui. O card mostra o código de saída real, e a saída completa aparece quando você expande. Comandos perigosos são bloqueados, e você pode alternar para Plan only a qualquer momento. Nada mais é executado a menos que você peça.
Como verificar uma função cuja saída muda?
A maneira mais simples é fornecer uma entrada conhecida para a função, para que sua saída deixe de mudar. Para testar unitariamente uma função com resultados variáveis, como uma que retorna a data atual ou um número aleatório, peça ao agente para passar esse valor como parâmetro e escrever o teste em torno disso. Revise o diff. Depois, execute seu comando de teste novamente.
Qual a diferença entre Ask first e Plan only?
Ask first é o modo que faz uma pausa antes de ações que alteram algo, como escrever um arquivo, e mostra o diff para aceitar. Plan only é o modo que escreve um plano e não executa nada, então nenhum comando é executado e nenhum arquivo é alterado. Planos sobrevivem a reinicializações. Alterne o modo quando quiser que o agente execute o plano.
Modelos, privacidade e download
Meus arquivos saem do PC?
Sim, com um modelo em nuvem: seu prompt e o texto do arquivo que o agente lê vão para esse provedor. Com um modelo local, nada sai do seu PC. Chats, pastas de trabalho e chaves de API permanecem no seu PC, e o app não tem telemetria. Você escolhe o endpoint. Essa escolha decide para onde o texto do seu código vai. Segredos na saída da ferramenta são mascarados antes de chegarem ao modelo.
Quais modelos posso conectar?
Um modelo no CycleMantle é a IA por trás do chat, e você pode conectar 3 tipos: um provedor de IA em nuvem através de um endpoint de API padrão, um modelo executando localmente no seu PC ou o modelo embutido, que está pronto para uso sem seu próprio endpoint. Pressione o botão Teste após inserir um endpoint para ver o tempo de resposta e a janela de contexto.
Como baixar e verificar o instalador?
A maneira mais simples é pressionar o botão de download, que fornece o programa de instalação de cerca de 34 MB, e então comparar seu checksum SHA-256 com o manifesto publicado. A página de download mostra um comando do Windows para isso. O instalador ainda não é assinado digitalmente. O Windows SmartScreen pode avisar você, e você continua apenas após a correspondência do checksum. Mantenha a página do manifesto aberta enquanto compara.
Preciso de uma conta para usar o app?
Não. O CycleMantle funciona sem uma conta, e sua interface vem em 13 idiomas. Um provedor de IA em nuvem pode precisar de sua própria conta e pode cobrar pelo uso, mas isso é entre você e o provedor. O modelo embutido está pronto para uso sem um endpoint próprio, então um primeiro teste não precisa de cadastro.