Jason Shirk (POWERSHELL)
1913244fad
PowerShell can be started with input redirected in different scenarios. `powershell -Command -` is one scenario where commands are sent to PowerShell, but this is not a interactive shell scenario, it's really a server to run commands from some other process. `powershell -File -` or just regular redirected input means PowerShell is an interactive shell, but command line editing must be done via the redirected standard input handle instead of interacting directly with a console handle. In this scenario, we want to provide a good editing experience. Today, we provide the bare minimum, supporting backspace but no cursor movement. The bug here is that backspace was treated as a backspace in the server mode but should not have been.
Pester Testing Test Guide
Also see the Pester Do and Don't document.
Running Pester Tests
Go to the top level of the PowerShell repository and run: Start-PSPester
inside a self-hosted copy of PowerShell.
You can use Start-PSPester -Tests SomeTestSuite* to limit the tests run.
Testing new powershell processes
Any launch of a new powershell process must include -noprofile so that
modified user and system profiles do not causes tests to fail. You also must
take care to call the development copy of PowerShell, which is not the first
one on the path.
Example:
$powershell = Join-Path -Path $PsHome -ChildPath "powershell"
& $powershell -noprofile -command "ExampleCommand" | Should Be "ExampleOutput"
Portability
Some tests simply must be tied to certain platforms. Use Pester's
-Skip directive on an It statement to do this. For instance to run
the test only on Windows:
It "Should do something on Windows" -Skip:($IsLinux -Or $IsOSX) { ... }
Or only on Linux and OS X:
It "Should do something on Linux" -Skip:$IsWindows { ... }
Pending
When writing a test that should pass, but does not, please do not skip or delete
the test, but use It "Should Pass" -Pending to mark the test as pending, and
file an issue on GitHub.