Migração do Pester

Pester é o framework de testes para PowerShell. Arquivos de teste terminam em *.Tests.ps1 e usam blocos Describe / Context / It com asserções Should. Esta habilidade atualiza um conjunto existente de uma versão principal do Pester para a próxima e o faz passar novamente.

Modelo mental: cada salto principal tem um caráter diferente. v3→v4 é principalmente uma renomeação de sintaxe. v4→v5 é uma mudança fundamental de tempo de execução (a divisão Descoberta/Execução) e é a difícil. v5→v6 é em grande parte retrocompatível — um punhado de coisas previamente depreciadas agora lançam erros. Migre uma versão principal por vez; nunca pule uma versão.

Guias detalhados e orientados por sintomas vivem em references/ — carregue aquele(s) para o salto que você está fazendo.

Referências

Fonte canônica: os guias de migração oficiais em https://pester.dev/docs/migrations/ — esta habilidade os espelha. Em caso de dúvida, prefira o site.

Passo 0 — Detecte onde você está e para onde está indo

Encontre a(s) versão(ões) instalada(s) e a versão para a qual os testes foram escritos. Estes podem diferir.

# Installed Pester version(s) on this machine
Get-Module Pester -ListAvailable | Select-Object Name, Version, Path

# Version currently imported in the session
(Get-Module Pester).Version

Determine a versão de origem do código de teste com estas heurísticas:

Instale a versão de destino quando estiver pronto:

# Latest stable v5 — pin the major to avoid installing Pester 6
Install-Module Pester -MaximumVersion 5.99.99 -Force

# Pester 6
Install-Module Pester -Force

No Windows PowerShell 5.1 o sistema operacional vem com um Pester 3 assinado pela Microsoft que o PowerShellGet não sobrescreverá com o Pester mais novo assinado de forma diferente — adicione -SkipPublisherCheck lá para instalar lado a lado. Não é necessário no PowerShell 7+. Veja https://pester.dev/docs/introduction/installation.

Fluxo de trabalho de migração

Execute este loop para cada salto principal. Não pule dois principais de uma vez — vá v4→v5, depois v5→v6.

1. Linha de base. Execute o conjunto na versão atual primeiro e registre aprovações/falhas. Você precisa de um ponto de partida conhecido como bom (ou conhecido) para que possa distinguir regressões de migração de falhas pré-existentes.

   # Bare Invoke-Pester works on every major; exact parameters differ
   # (v3/v4: -Script/-OutputFile; v5+/v6: -Path/-Output).
   Invoke-Pester
   

2. Leia a referência para este salto (tabela acima) para que você saiba o escopo completo antes de editar.
3. Edite arquivo por arquivo. Aplique as mudanças mecânicas (veja as folhas de cola por salto abaixo e na referência). Mantenha as mudanças pequenas e revisáveis — um arquivo ou uma preocupação por vez.
4. Troque as versões com Install-Module (Passo 0), então reimporte: Remove-Module Pester; Import-Module Pester (ou inicie uma sessão nova).
5. Execute e corrija. Reexecute com -Output Detailed; use -Output Diagnostic (v4→v5) ou leia as mensagens de erro explícitas do v6 para localizar problemas. Combine cada falha com as tabelas de sintoma → correção na referência.

…