admin/brew
1
0
Fork 0
Code Issues Packages Projects Releases 6 Wiki Activity

Merge pull request #19419 from heaths/pwsh-support

Browse Source 
Document pwsh shell completion
This commit is contained in:
Mike McQuaid 2025-03-04 10:49:15 +00:00 committed by GitHub
commit 9ad86c9e42
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 14 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Library/Homebrew/formula.rb
View File

@ -1994,8 +1994,8 @@ class Formula
end
private :extract_macho_slice_from
# Generate shell completions for a formula for `bash`, `zsh`, `fish`, and `pwsh`,
# using the formula's executable.
# Generate shell completions for a formula for `bash`, `zsh`, `fish`, and
# optionally `pwsh` using the formula's executable.
#
# ### Examples
#
@ -2009,6 +2009,17 @@ class Formula
# (zsh_completion/"_foo").write Utils.safe_popen_read({ "SHELL" => "zsh" }, bin/"foo", "completions", "zsh")
# (fish_completion/"foo.fish").write Utils.safe_popen_read({ "SHELL" => "fish" }, bin/"foo",
# "completions", "fish")
# ```
#
# If your executable can generate completions for PowerShell,
# you must pass ":pwsh" explicitly along with any other supported shells.
# This will pass "powershell" as the completion argument.
#
# ```ruby
# generate_completions_from_executable(bin/"foo", "completions", shells: [:bash, :pwsh])
#
# # translates to
# (bash_completion/"foo").write Utils.safe_popen_read({ "SHELL" => "bash" }, bin/"foo", "completions", "bash")
# (pwsh_completion/"foo").write Utils.safe_popen_read({ "SHELL" => "pwsh" }, bin/"foo",
# "completions", "powershell")
# ```

1
docs/Formula-Cookbook.md
View File

@ -889,6 +889,7 @@ Generally we'd rather you were specific about which files or directories need to
| **`bash_completion`** | `#{prefix}/etc/bash_completion.d` | `/opt/homebrew/Cellar/foo/0.1/etc/bash_completion.d` |
| **`zsh_completion`** | `#{prefix}/share/zsh/site-functions` | `/opt/homebrew/Cellar/foo/0.1/share/zsh/site-functions` |
| **`fish_completion`** | `#{prefix}/share/fish/vendor_completions.d` | `/opt/homebrew/Cellar/foo/0.1/share/fish/vendor_completions.d` |
| **`pwsh_completion`** | `#{prefix}/share/pwsh/completions` | `/opt/homebrew/Cellar/foo/0.1/share/pwsh/completions` |
| **`etc`** | `#{HOMEBREW_PREFIX}/etc` | `/opt/homebrew/etc` |
| **`pkgetc`** | `#{HOMEBREW_PREFIX}/etc/#{name}` | `/opt/homebrew/etc/foo` |
| **`var`** | `#{HOMEBREW_PREFIX}/var` | `/opt/homebrew/var` |