/vscode-adapter

Run PowerShell Pester Tests with Visual Studio Code

Primary LanguageTypeScriptMIT LicenseMIT

Pester Test Adapter for Visual Studio Code Latest Installs vsix Build Analysis License: MIT GitHub stars

๐Ÿšง THIS EXTENSION IS IN PREVIEW STATE, THERE ARE GOING TO BE BUGS ๐Ÿšง

This extension provides the ability to run Pester tests utilizing the native Testing functionality first introduced in Visual Studio Code 1.59

Example

Highlights

๐Ÿ” Pester Test Browser
๐Ÿž Debugging Support
๐Ÿ‘ฉโ€๐Ÿ’ป Uses PowerShell Integrated Terminal
๐Ÿ‘จโ€๐Ÿ‘งโ€๐Ÿ‘ฆ Expands Test Cases

Extension Prerequisites

  • Pester 5.2.0 or later (sorry, no Pester 4 support)
  • PowerShell 7+ or Windows PowerShell 5.1

Usage

The extension will automatically discover all .Tests.ps1 Pester files in your workspace, you can then run tests either from the Tests pane or from the green arrows that will appear adjacent to your tests.

Installing the latest preview VSIX

Preview VSIX extension packages are generated upon every commit to main and every pull request update. To install a beta build:

  1. Click the green checkmark next to the latest commit
  2. Click Details next to the ๐Ÿ‘ทโ€โ™‚๏ธ Build Visual Studio Code Extension task
  3. Click Artifacts in the upper right of the window
  4. Download the latest artifact zip and unzip it, it should be named vsix-{version}
  5. Open the resulting folder in vscode, right click the .vsix file, and choose Install Extension VSIX near the bottom.
  6. Alternatively in vscode you can hit F1 and choose Extensions: Install from VSIX and browse for the vsix file.

Configuration

This extension will use the PowerShell Extension Pester verbosity settings for the output.