Build Status | |
---|---|
![]() |
- PowerShell Koans
Inspired by Chris Marinos' fantastic F# koans, the goal of the PowerShell koans is to teach you PowerShell by presenting you with a set of questions. Each kōan (each question) is represented by a failing Pester test. Your goal is to make those tests pass by filling out the correct answer, or writing the correct code. The koans start very simple to get you familiar with the basic concepts and progress towards more difficult. Teaching you multiple beginner, intermediate and advanced aspects of PowerShell in the process.
To get started please navigate to prerequisites and getting started.
View the PSKoans Command Reference Documentation.
- Windows PowerShell version 5.1 / PowerShell 6+
- NuGet
- Pester
If you've never installed PowerShell modules before, you need to first install the NuGet PackageProvider to enable modules to be installed:
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
To install the latest version of Pester, use the appropriate command for your version of PowerShell:
# PS 5.1 (upgrade to latest Pester)
Install-Module Pester -Force -SkipPublisherCheck -Scope CurrentUser
# PS 6.0+ (Install Pester under current user)
Install-Module Pester -Scope CurrentUser
Install-Module PSKoans -Scope CurrentUser
git clone
the repository into your desired directory, or download the module zip file from the build artifacts available on this page.- From a normal powershell session run
Get-ChildItem -Recurse | Unblock-File
in that directory to remove the "downloaded from internet" flag that blocks them from running. - Check
Get-ExecutionPolicy
: if it says 'Restricted' or 'Undefined', you need to also runSet-ExecutionPolicy RemoteSigned
in order to allow the scripts to run. - Add the repository folder to
$env:PSModulePath
so that PowerShell can see it.- From the repository main folder, run:
$env:PSModulePath = "$(Get-Location)$([IO.Path]::PathSeparator)${env:PSModulePath}"
- From the repository main folder, run:
You will be presented with a page describing your goal:
Welcome, seeker of enlightenment.
Please wait a moment while we examine your karma...
Describing 'Equality' has damaged your karma.
You have not yet reached enlightenment.
The answers you seek...
Expected $true, but got $null.
Please meditate on the following code:
× It is a simple comparison
at <ScriptBlock>, C:\Users\Joel\PSKoans\Introduction\AboutAssertions.Koans.ps1: line 27
27: $____ | Should -Be $true
▌ When you smash the citadel of doubt,
▌ Then the Buddha is simply yourself.
You examine the path beneath your feet...
[AboutAssertions]: [――――――――――――――――――――――――――] 0/4
[Total]: [――――――――――――――――――――――――――――――――――――――――――――――――――――] 0/635
Run 'Show-Karma -Meditate' to begin your meditations.
Inspect the red messages carefully, most importantly the last one.
The error message contains path to the file that you need to edit in order to progress forward.
In this case, you'll need to examine Introduction\AboutAssertions.Koans.ps1
.
Navigate to Introduction\AboutAssertions.Koans.ps1
. Near the top you'll see:
It 'is a simple comparison' {
# Some truths are absolute.
$____ | Should -Be $true
}
The $___
represents a blank for you to fill, and | Should -Be $true
shows the expected result.
To pass this koan you need to replace $____
with $true
to fulfil the assertion: $true | Should -Be $true
You passed your first koan!
You'll notice that your overall progress updated to 1/635
and you are presented with the next challenge.
Welcome, seeker of enlightenment.
Please wait a moment while we examine your karma...
Describing 'Equality' has damaged your karma.
You have not yet reached enlightenment.
The answers you seek...
Expected 3, but got .
Please meditate on the following code:
× It expects you to fill in values
at <ScriptBlock>, C:\Users\Joel\PSKoans\Introduction\AboutAssertions.Koans.ps1: line 32
32: __ | Should -Be (1 + 2)
▌ Grasping nothing, discarding nothing.
▌ In every place there's no hindrance, no conflict.
▌ My supernatural power and marvelous activity:
▌ Drawing water and chopping wood.
You examine the path beneath your feet...
[AboutAssertions]: [■■■■■■――――――――――――――――――――] 1/4
[Total]: [――――――――――――――――――――――――――――――――――――――――――――――――――――] 1/635
Run 'Show-Karma -Meditate' to begin your meditations.
You are on your own from here, but the progression should be fairly smooth. If you need help, you can always ask around in the PowerShell communities:
Good luck!
You can see the current folder your copy of the koans is stored in by calling Get-PSKoanLocation
.
If you want to save a backup of your current progress, simply make a copy of this folder and store it in a safe location.
For example:
Get-PSKoanLocation | Copy-Item -Recurse -Destination "D:\Backups\PSKoans"
Just as you can Get-PSKoanLocation
, you can also use Set-PSKoanLocation
to change the directory that PSKoans will look for.
This allows you to have any number of in-progress libraries of koans on a single machine without moving any folders.
However, be aware that the module does not retain any information about previous locations specified, only the current location.
To change the set location, call Set-PSKoanLocation
with the path you would like to set.
If the specified folder does not exist, it will be created the next time you call Show-Karma
.
$oldLocation = Get-PSKoanLocation
Set-PSKoanLocation "~/New/PSKoans"
# Call Show-Karma to create the directory and populate it with a fresh koan library
Show-Karma
# Restore the old location
$newLocation = Get-PSKoanLocation
Set-PSKoanLocation $oldLocation
# Call Show-Karma again to check the progress on the old library once again
Show-Karma
You can uninstall the PSKoans module the usual way you uninstall PowerShell modules, with Uninstall-Module -Name PSKoans
This will not remove your copy of the koans themselves, which are stored in your user folder, and it will also not remove the configuration file.
To completely remove all of these files, call these commands before you uninstall PSKoans:
# To remove configuration settings
Remove-Item -Path "~/.config/PSKoans" -Recurse
# To remove your koan files (THIS WILL COMPLETELY DELETE YOUR PROGRESS)
Get-PSKoanLocation | Remove-Item -Recurse
If you would like to contribute to PSKoans, please check out the Contributing document.
If you would like to support the project, you can: