provider-test-patterns

Visão geral da skill provider-test-patterns

provider-test-patterns é uma skill de testes de aceitação de provider do Terraform para times que usam terraform-plugin-testing com o Plugin Framework. Ela ajuda você a escrever, revisar e depurar testes de provider com bem menos tentativa e erro do que um prompt genérico, especialmente quando você precisa escolher o TestCase, TestStep, os checks de state, os checks de plan, a verificação de importação ou a configuração de sweepers corretos.

Melhor encaixe e tarefa a ser feita

Use a skill provider-test-patterns quando a sua necessidade real for: “Preciso de um padrão confiável de teste de aceitação para um recurso de provider e quero saber qual formato de teste faz sentido para este cenário.” Ela é mais útil em trabalho de backend em providers, onde a dificuldade não está só na sintaxe, mas em escolher a estratégia certa de asserção e a cobertura certa do ciclo de vida.

O que ela cobre bem

A skill provider-test-patterns é mais forte quando você precisa de orientação sobre:

• fluxo de ciclo de vida do teste entre plan, apply, refresh e destroy
• estrutura de TestCase e TestStep
• ConfigStateChecks, plancheck e CompareValue
• testes de importação com ImportStateKind
• sweepers e segurança na limpeza
• padrões de cenário como basic, update, disappears, validation e regression
• testes de recursos efêmeros com o padrão echoprovider

Quando vale a pena instalar

Instale provider-test-patterns se você quer padrões opinativos que se encaixam diretamente em testes de aceitação de provider Terraform, especialmente para equipes de backend que já trabalham com o Plugin Framework. Ela é melhor do que um prompt genérico quando o principal risco é deixar passar uma verificação obrigatória, usar o tipo errado de asserção ou estruturar testes de um jeito difícil de manter.

Como usar a skill provider-test-patterns

Instale e carregue no contexto

Use o fluxo de instalação do repositório para o seu gerenciador de skills e, em seguida, abra primeiro o SKILL.md. A skill upstream não define um comando próprio de instalação, então o passo prático de provider-test-patterns install é adicionar a skill pelo fluxo de skills do seu agente e depois ler a skill junto com as referências de apoio.

Comece pelo formato do teste, não pelo código

O melhor fluxo de provider-test-patterns usage é descrever o cenário antes de pedir código. Informe:

• o tipo de recurso e a etapa do ciclo de vida
• se a cobertura é basic, update, import, disappears, validation ou regression
• o que precisa ser verificado no state ou no plan
• se é necessário cleanup via sweepers
• se o caso envolve recursos efêmeros

Isso dá estrutura suficiente para a skill escolher entre checks de config comuns, statecheck, plancheck ou comparações entre etapas.

Leia estes arquivos primeiro

Para adotar rápido, leia nesta ordem:

1. SKILL.md para o conjunto principal de padrões e a orientação de ciclo de vida
2. references/checks.md para statecheck, plancheck, valores conhecidos e comparadores
3. references/ephemeral.md se o recurso for efêmero ou usar echoprovider
4. references/sweepers.md se houver risco de recursos órfãos

Padrão de prompt forte

Um bom prompt para provider-test-patterns deve incluir o recurso, o modo de falha e o estilo de asserção desejado. Por exemplo:

Write an acceptance test for example_widget update behavior. I need a TestStep sequence that verifies the name changes, the old value is preserved until refresh, and the final state matches the new config. Use CompareValue if that is the right fit.

Isso é mais forte do que “write a test” porque dá à skill um alvo de decisão, não só um tema.

FAQ da skill provider-test-patterns

provider-test-patterns é só para engenheiros de provider Terraform?

Na maioria dos casos, sim. Ela foi criada para testes de aceitação de provider Terraform e é mais útil para provider-test-patterns for Backend Development, quando você precisa de cobertura confiável de state, plan e comportamento de limpeza.

Preciso já conhecer terraform-plugin-testing?

Não, mas a skill assume que você está trabalhando nesse ecossistema. Se você está começando, ela ainda ajuda porque reduz a incerteza sobre a estrutura dos testes, mas você deve esperar conferir os detalhes na documentação referenciada e nas convenções de teste já existentes do seu provider.

Em que isso difere de um prompt normal?

Um prompt normal pode gerar um arquivo de teste plausível, mas provider-test-patterns é mais útil quando a escolha da asserção importa. Ela ajuda você a decidir se deve usar ConfigStateChecks, um check de plan, um check de destroy, verificação de import state ou um padrão de sweeper com base no objetivo real do teste.

Quando não devo usar?

Não use para testes unitários genéricos, testes Go sem relação com provider ou perguntas rápidas só sobre sintaxe. Também é um mau encaixe se você não estiver usando testes de aceitação de provider Terraform, porque os padrões e restrições são específicos desse fluxo.

Como melhorar a skill provider-test-patterns

Dê logo de cara os fatos que faltam no teste

A melhor forma de melhorar os resultados de provider-test-patterns é fornecer o menor conjunto de fatos que realmente muda o desenho do teste:

• nome do recurso e pacote do provider
• se o recurso é criado, atualizado, importado ou destruído
• os atributos exatos que precisam ser verificados
• se os valores são estáticos, computados, sensíveis ou dependem de outra etapa
• se o teste precisa cobrir limpeza ou recuperação de vazamento

Mencione a falha que você quer evitar

Se você disser o que pode dar errado, a skill consegue escolher melhores asserções. Por exemplo, explique se você está tentando evitar:

• drift após refresh
• state de importação incorreto
• valores mudando entre etapas
• limpeza de destroy ausente
• dados efêmeros que não podem ser verificados diretamente

Isso é mais útil do que pedir um “exemplo completo”, porque o padrão de teste depende do modo de falha.

Itere estreitando as asserções

Depois da primeira saída, refine a solicitação com a lacuna exata que ainda ficou. Bons follow-ups incluem:

• “Make the ConfigStateChecks assert the computed ID format.”
• “Rewrite this as an import test with ImportStateKind.”
• “Add a sweeper and show the required TestMain setup.”
• “Convert this to an ephemeral-resource pattern using the echoprovider approach.”

Esse tipo de iteração melhora muito mais a saída do provider-test-patterns guide do que pedir apenas uma versão mais longa.