0861ebc8b8
Source type is now inferred from the primary key: github_repo = owner/repo (was source=github + owner + repo) git_url = https://... (was source=gittag + url) gitea_repo = owner/repo (was source=gitea + owner + repo) hashicorp_product = name (was source=hashicorp + product) One-off dist sources (nodedist, zigdist, etc.) keep the explicit source= key since they're already one-liners. Parser still accepts the old format via the default fallback branch.
title, homepage, tagline
| title | homepage | tagline |
|---|---|---|
| Microsoft PowerShell Core | https://docs.microsoft.com/powershell/ | PowerShell Core is a cross-platform (Windows, Linux, and macOS) automation and configuration tool/framework. |
To update or switch versions, run webi pwsh@stable (or @v7.4, @beta, etc).
Cheat Sheet
The core benefit of running
pwshon Mac or Linux is that you get a way to debug Windows scripts without having to boot up Windows.The core benefit of running
pwshon Windows is that it's years ahead of pre-installed version.
For example, if you want to create a curl.exe | powershell script for Windows
(as we do), it's helpful to be able to do some level of debugging on other
platforms.
Table of Contents
- Files
- ProTips
- vim
- lint
- fmt
Files
These are the files / directories that are created and/or modified with this install:
~/.config/envman/PATH.env
~/.local/opt/pwsh/
~/.local/share/powershell/Modules/
~/.local/opt/pwsh/Modules/
ProTip: pwsh-essentials
Friends don't let friends PowerShell without pwsh-essentials:
Plus, important information for anyone Getting Started with PowerShell:
- Case-Sensitivity
- Returns vs Pipeline Streams
- Strict, Trace, & Verbose Modes
- The Call Operator "&"
- curl vs curl.exe
- Script Policies & Preferences
How to Use PowerShell with Vim
Assuming you have vim-ale installed - which is included with
vim-essentials - all you need to do is install the
PSScriptAnalyzer module.
See the "Lint & Fmt" section below.
How to Use PowerShell with VSCode
VS Code should also automatically recognize and use PSScriptAnalyzer.
How to Lint, Fmt, & Fix ps1 Files
See pwsh-essentials for more info but, in short:
pwsh -Command "Install-Module -Name PSScriptAnalyzer -Scope CurrentUser -AllowClobber"
my_ps1='./my-file.ps1'
pwsh -Command "Invoke-ScriptAnalyzer -Fix -ExcludeRule PSAvoidUsingWriteHost -Path '$my_ps1'"
To fmt:
my_ps1='./my-file.ps1'
my_text="$(
pwsh -Command "Invoke-Formatter -ScriptDefinition (Get-Content -Path '$my_ps1' -Raw)"
)"
printf '%s\n' "${my_text}" > "${my_ps1}"
Note: it is several hundred times faster to lint and fmt from a native
PowerShell script than from invoking pwsh -Command each time.