Skill pester-cli-testing
✓ VérifiéConfigure des tests unitaires, d'intégration et d'acceptation pour les scripts PowerShell, les fonctions et les outils CLI en utilisant le framework Pester v5.
- Étoiles GitHub
- 13
- Fichiers
- 3
- Dernier commit
- 12 nov. 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill pester-cli-testing ?
pester-cli-testing est une agent skill. Configure des tests unitaires, d'intégration et d'acceptation pour les scripts PowerShell, les fonctions et les outils CLI en utilisant le framework Pester v5.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill pester-cli-testing
Cette SKILL permet aux développeurs travaillant dans des environnements pwsh d'automatiser la vérification des scripts PowerShell, des fonctions et des outils CLI. Elle offre une méthode structurée pour implémenter des tests unitaires, d'intégration et d'acceptation via le framework Pester v5 sur Windows, Linux et macOS. En utilisant les blocs Describe, Context et It, les utilisateurs peuvent organiser des scénarios de test complexes et appliquer des assertions Should pour valider les résultats.
Un agent doit charger cette SKILL lorsque le code à tester est basé sur PowerShell. Elle génère des suites de tests complètes, incluant des hooks de cycle de vie tels que BeforeAll et BeforeEach pour gérer l'état et les fixtures. La SKILL prend également en charge des fonctionnalités avancées comme le Mocking pour remplacer le comportement de commandes, le Tagging pour filtrer des sous-ensembles de tests spécifiques, et la Code Coverage pour garantir une profondeur de test suffisante. Pour l'intégration continue, elle génère des sorties XML NUnit ou JUnit et peut être configurée pour renvoyer des codes de sortie non nuls en cas d'échec afin de garantir la fiabilité des pipelines.
Ce qu'un agent peut faire avec
- 1Vérifier la logique d'une fonction PowerShellCréer un fichier de test pour s'assurer qu'une fonction spécifique renvoie la chaîne de caractères attendue.
- 2Simuler des appels API externesRemplacer une commande dépendant du réseau par une implémentation contrôlée pour tester la gestion des erreurs ou des réponses spécifiques.
- 3Surveiller la couverture de code en CIConfigurer un paramétrage qui échoue au build si la couverture de code descend en dessous d'un certain pourcentage.
- 4Filtrer les tests par catégorieExécuter uniquement un sous-ensemble spécifique de tests, comme les tests d'intégration, tout en ignorant les tests lents.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill pester-cli-testing
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill pester-cli-testing dans Plugin
/plugin marketplace add testland/qa /plugin install qa-cli-tools@testland-qa
Installer la skill pester-cli-testing dans Claude Code
~/.claude/skills/pester-cli-testing/SKILL.md
$ npx degit testland/qa/plugins/qa-cli-tools/skills/pester-cli-testing ~/.claude/skills/pester-cli-testingInstaller la skill pester-cli-testing dans Claude Code (project)
.claude/skills/pester-cli-testing/SKILL.md
$ npx degit testland/qa/plugins/qa-cli-tools/skills/pester-cli-testing .claude/skills/pester-cli-testingInstaller la skill pester-cli-testing dans Codex
~/.agents/skills/pester-cli-testing/SKILL.md
$ npx degit testland/qa/plugins/qa-cli-tools/skills/pester-cli-testing ~/.agents/skills/pester-cli-testingInstaller la skill pester-cli-testing dans Gemini CLI
~/.gemini/skills/pester-cli-testing/SKILL.md
$ npx degit testland/qa/plugins/qa-cli-tools/skills/pester-cli-testing ~/.gemini/skills/pester-cli-testingInstaller la skill pester-cli-testing dans Claude.ai
npx degit testland/qa/plugins/qa-cli-tools/skills/pester-cli-testing pester-cli-testing && zip -r pester-cli-testing.zip pester-cli-testing # claude.ai → Customize → Skills → + → Create skill → Upload a skill → pester-cli-testing.zip
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessibletestland/qa/plugins/qa-cli-tools/skills/pester-cli-testing is public and reachablegithub.com/testland/qa/tree/HEAD/plugins/qa-cli-tools/skills ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-11-12github.com/testland/qa/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/testland/qa/blob/HEAD/plugins/qa-cli-tools/skills ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/testland/qa/blob/HEAD/plugins/qa-cli-tools/skills ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 332 linesgithub.com/testland/qa/blob/HEAD/plugins/qa-cli-tools/skills ↗Réussi
SKILL.md
Voir sur GitHubpester-cli-testing
Overview
Per pester-install, Pester is the standard PowerShell test framework for
unit, integration, and acceptance testing of scripts, functions, modules, and
CLI tools invoked from pwsh. It supports Windows PowerShell 3.0 - 5.1 and
PowerShell 6.0.4+ across Windows, Linux, and macOS. When the unit-under-test
is a shell script or binary on Linux/macOS, use bats-testing instead; Pester
is the correct choice whenever the subject or test is PowerShell.
Step 1 - Install
Per pester-install, Windows 10 / Server 2016+ ship with Pester 3.4.0
built-in. The bundled version cannot be updated via Update-Module alone
because its publisher certificate differs from the community-signed Gallery
version. Install Pester v5 side-by-side:
# Windows (5.1 or pwsh 7+): -Force enables side-by-side; -SkipPublisherCheck
# accepts the newer certificate
Install-Module -Name Pester -Force -SkipPublisherCheck
# Linux / macOS (pwsh 7+): no bundled version to conflict with
Install-Module -Name Pester
# Verify
Import-Module Pester -PassThru
Step 2 - First test file
Per pester-quick-start:
Test files must follow the *.Tests.ps1 naming convention. The outer
BeforeAll block dot-sources the script under test so its functions are
available to every nested block:
# Get-Greeting.Tests.ps1
BeforeAll {
. $PSScriptRoot/Get-Greeting.ps1
}
Describe 'Get-Greeting' {
It 'returns a greeting for the given name' {
Get-Greeting -Name 'Alice' | Should -Be 'Hello, Alice!'
}
}
Run with:
Invoke-Pester -Output Detailed .\Get-Greeting.Tests.ps1
Step 3 - Describe / Context / It
Per pqs, Context and Describe are nearly interchangeable. Use
Describe at the top level (function or CLI command name) and Context to
group scenarios:
Describe 'Invoke-Deploy' {
Context 'when the target environment is valid' {
It 'exits 0 and logs a success message' {
# ...
}
}
Context 'when credentials are missing' {
It 'throws a terminating error' {
# ...
}
}
}
Step 4 - Should assertions
Per pqs, Should is the assertion command. Common matchers:
$result | Should -Be 'expected' # strict equality
$result | Should -BeExactly 'Expected' # case-sensitive equality
$result | Should -BeLike '*partial*' # wildcard match
$result | Should -Match 'regex\d+' # regex match
$result | Should -BeNullOrEmpty # null or empty string/array
$result | Should -BeGreaterThan 0
{ risky-call } | Should -Throw # expects a terminating error
{ risky-call } | Should -Throw '*message*' # error message wildcard
$result | Should -Not -Be $null # negated form
Step 5 - BeforeAll / BeforeEach
Per pqs, lifecycle hooks load fixtures and reset state.
BeforeAll runs once per block; BeforeEach runs before every It:
Describe 'Get-Report' {
BeforeAll {
. $PSScriptRoot/Get-Report.ps1
$script:TempDir = Join-Path ([System.IO.Path]::GetTempPath()) ([System.IO.Path]::GetRandomFileName())
New-Item -ItemType Directory -Path $script:TempDir | Out-Null
}
AfterAll {
Remove-Item -Recurse -Force $script:TempDir
}
BeforeEach {
# reset any per-test state here
}
It 'writes a report file to the output directory' {
Get-Report -OutputPath $script:TempDir
Test-Path (Join-Path $script:TempDir 'report.csv') | Should -BeTrue
}
}
Use $script: scope when a variable set in BeforeAll must be read inside
It blocks. Variables declared with plain $var in BeforeAll are not
visible inside It due to PowerShell scoping rules.
Step 6 - Mock
Per pester-mock:
"Mock mocks the behavior of an existing command with an alternate implementation."
Describe 'Send-Notification' {
BeforeAll {
. $PSScriptRoot/Send-Notification.ps1
Mock Invoke-RestMethod {
return @{ status = 'ok' }
}
Mock Write-Error {} # suppress error output in test runs
}
It 'calls Invoke-RestMethod once with the correct URI' {
Send-Notification -Message 'deploy done'
Should -Invoke Invoke-RestMethod -Times 1 -Exactly
}
It 'passes a ParameterFilter to scope the mock to specific arguments' {
Mock Get-Date { return [datetime]'2024-01-01' } -ParameterFilter {
$Format -eq 'yyyy-MM-dd'
}
$result = Get-FormattedDate
$result | Should -Be '2024-01-01'
}
}
Per pm, mocks placed in BeforeAll apply to all It blocks in the
enclosing Describe/Context; a mock inside an It block scopes only to
that test. Use -Scope to override. Should -Invoke verifies call count:
Should -Invoke -CommandName Invoke-RestMethod -Times 1 `
-ParameterFilter { $Uri -like '*api.example.com*' }
Per pm, $PesterBoundParameters (available since Pester 5.2.0)
replaces $PSBoundParameters inside mock script blocks.
Step 7 - Tags
Per pester-tags:
Tags can be applied to Describe, Context, and It blocks. Run a subset
by filtering on tags:
Describe 'Invoke-Deploy' -Tag 'Integration' {
Context 'slow path' -Tag 'Slow' {
It 'completes a full deployment cycle' -Tag 'E2E' {
# ...
}
}
}
# Run only Integration tests, excluding slow ones
Invoke-Pester $path -TagFilter 'Integration' -ExcludeTagFilter 'Slow', 'WindowsOnly'
Per pt, tag matching uses -like comparison, so wildcards work:
Invoke-Pester $path -ExcludeTagFilter 'Slow*', '*Only'
Step 8 - Invoke-Pester with PesterConfiguration
Per pester-config:
New-PesterConfiguration returns a typed configuration object. Cast from a
hashtable for concise setup:
$config = [PesterConfiguration]@{
Run = @{
Path = '.\tests'
Exit = $true # non-zero exit code on failure (required for CI)
}
Filter = @{
Tag = 'Unit'
ExcludeTag = 'Slow', 'WindowsOnly'
}
Output = @{
Verbosity = 'Detailed'
}
}
Invoke-Pester -Configuration $config
Key Run properties and their defaults (Run.Path, Run.ExcludePath,
Run.Exit, Run.TestExtension) are tabulated in
references/ci-and-config.md.
Step 9 - Code coverage
Per pester-coverage:
$config = New-PesterConfiguration
$config.Run.Path = '.\tests'
$config.CodeCoverage.Enabled = $true
$config.CodeCoverage.Path = '.\src'
$config.CodeCoverage.CoveragePercentTarget = 75 # fail if below 75%
$config.CodeCoverage.OutputFormat = 'JaCoCo' # or 'CoverageGutters'
$config.CodeCoverage.OutputPath = 'coverage.xml'
Invoke-Pester -Configuration $config
Per pcov, Pester does not traverse directories automatically for
coverage; set CodeCoverage.Path explicitly when source files are not
co-located with tests.
Step 10 - Test result XML and CI
Per pester-results:
$config = New-PesterConfiguration
$config.Run.Path = '.\tests'
$config.Run.Exit = $true
$config.TestResult.Enabled = $true
$config.TestResult.OutputFormat = 'NUnitXml' # or 'JUnitXml'
$config.TestResult.OutputPath = 'testResults.xml'
Invoke-Pester -Configuration $config
Full CI pipeline definitions - a single cross-platform GitHub Actions matrix (with code coverage and artifact upload) and the Azure DevOps Publish Test Results task - are in references/ci-and-config.md.
Anti-patterns
| Anti-pattern | Why it fails | Fix |
|---|---|---|
Dot-sourcing the script under test inside It |
Re-executes on every test; slow and leaks state | Dot-source once in BeforeAll |
Using plain $var in BeforeAll, reading in It |
PowerShell scope: It does not inherit BeforeAll locals |
Use $script:var |
Mocking in It when needed across multiple tests |
Mock scopes to that single test only | Move mock to BeforeAll or BeforeEach |
Omitting Run.Exit = $true in CI config |
Pester exits 0 even on failures; CI pipeline passes on broken tests | Set Run.Exit = $true |
Setting CodeCoverage.Path = '.' without explicit paths |
Pester may miss source files not co-located with tests | Set CodeCoverage.Path to the source directory explicitly |
Using legacy Invoke-Pester -Script syntax |
Removed in Pester v5; breaks silently on older runners | Use PesterConfiguration with Run.Path |
Limitations
- Mocking scope is version-sensitive. Pester v5 scopes mocks to their
placement block (not the entire
Describe). Code written for v4 may need mock placement adjusted. - No built-in parallel execution. Pester v5 runs tests serially within
a session. Parallelism requires splitting test files across separate
pwshprocesses or using a CI matrix. - Non-PowerShell binaries. Pester can invoke any executable, but
assertion helpers are PowerShell-centric. For deep exit-code / stdout
testing of Unix binaries,
bats-testingis more idiomatic. - Windows PowerShell 5.1 vs pwsh 7+. Some Pester 5 features (e.g.
$PesterBoundParameters) require a minimum Pester patch level; pin the version in CI withInstall-Module -Name Pester -RequiredVersion 5.x.y.
References
- pester-install - compatibility, Windows side-by-side install,
cross-platform
pwshinstall. - pqs - quick-start,
BeforeAll,Describe/Context/It,Should. - pm -
Mock,ParameterFilter,Should -Invoke, scope rules,$PesterBoundParameters. - pc -
New-PesterConfiguration,Run,Filter,Output,Invoke-Pester -Configuration. - pcov -
CodeCoverage.Enabled,CoveragePercentTarget, formats, path scoping. - pr -
TestResult.Enabled,OutputFormat,OutputPath, Azure DevOps / AppVeyor CI notes. - references/ci-and-config.md - cross-platform
GitHub Actions matrix, Azure DevOps publish task,
Runproperty table. bats-testing- use for shell script / Unix binary testing; Pester is the correct choice when the subject or test is PowerShell.cli-output-conventions- what to assert on (stable formats, exit codes, stderr vs stdout contracts).
Fichiers de cette skill
3Questions sur la skill pester-cli-testing
Comment installer la skill pester-cli-testing dans Claude Code ?
Exécutez npx degit testland/qa/plugins/qa-cli-tools/skills/pester-cli-testing ~/.claude/skills/pester-cli-testing. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill pester-cli-testing ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Comment rendre les variables définies dans BeforeAll disponibles dans les blocs It ?
Vous devez utiliser le préfixe de portée $script: pour les variables définies dans BeforeAll qui doivent être lues à l'intérieur des blocs It, en raison des règles de portée de PowerShell.
Que dois-je utiliser si je dois tester un script shell ou un binaire sur Linux/macOS au lieu de PowerShell ?
Pour les scripts shell ou les binaires sur Linux/macOS, vous devriez utiliser bats-testing à la place de Pester.