Skip to content

Latest commit

 

History

History
82 lines (52 loc) · 3.16 KB

PSKoans.md

File metadata and controls

82 lines (52 loc) · 3.16 KB
Module Name Module Guid Download Help Link Help Version Locale
PSKoans
45003073-0315-4aef-862f-4d9ff1bd8f4a
0.50.0.0
en-US

PSKoans Module

Description

Inspired by Chris Marinos's 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.

PSKoans Cmdlets

An auxiliary command used primarily in the koan files itself. It is most commonly used in its alias form __, representing a blank space. This command returns a blank item that never equals anything.

Use this command to assess your own progress and check how you're progressing. This command will output a simple report on your current progress.

Use this command to list all koan files available. The report will contain location information for each file in both the module and user paths.

Retrieves the currently set PSKoans working folder path. By default, this is set to $HOME\PSKoans.

Gets all configurable PSKoans settings. Specify -Name to retrieve the value of a specific setting.

Moves the entire library folder to a new location, and updates the KoanLocation configuration value accordingly.

Registers the Show-Advice command in your profile in order to display advice on startup.

Resets a given koan file, topic, context section, or individual koan to the default state. Use this to restore files damaged beyond repair or to reset a koan to its base state so you can try again. The default is to reset everything (with confirmation prompts); use parameters to narrow the scope.

Sets the PSKoans working folder path for the current session.

Configure available PSKoans settings, such as the editor used for Show-Karma -Contemplate and the user's library location.

Displays a random piece of advice from the PSKoans advice library on the screen.

Use this command to assess your own progress and check how you're progressing. This command will display a detailed report with flavour-text to guide your progress.

Updates selected topics, context blocks, and/or individual koan It blocks. This command is provided to smooth transition to new versions of PSKoans, and to update older files. By default, all files will be updated; specify parameters to narrow the scope.