生成 shell 补全脚本

摘要

podman completion [选项] bash | zsh | fish | powershell

描述

podman completion 为多种 shell 生成 shell 补全脚本。支持的 shell 包括 bash, zsh, fish 和 powershell。

这些脚本被 shell 使用，以在键入命令并按 [TAB] 键时提供建议和补全命令。

通常，这些脚本通过包管理器自动安装。

选项

--file, -f=file

将生成的输出写入文件。

--no-desc

在补全中不提供描述信息。\ 默认值为 false。

安装

BASH

系统上必须安装 bash-completion。

要将补全脚本加载到当前会话中，运行：

source <(podman completion bash)

要使其对所有 bash 会话可用，运行：

podman completion -f /etc/bash_completion.d/podman bash

这条命令会将 podman 的补全脚本写入 /etc/bash_completion.d/ 目录下，名为 podman 的文件。这样，每次启动新的 bash 会话时，都会自动加载这个补全脚本，从而实现对 podman 命令的自动补全功能。这样，用户就可以更方便、更快捷地使用 podman 命令了。

ZSH

环境中需要已经启用 shell 补全功能。可以执行以下命令：

echo "autoload -U compinit; compinit" >> ~/.zshrc

要使补全功能对所有 zsh 会话可用，运行：

podman completion -f "${fpath[1]}/_podman" zsh

一旦重新加载了 shell，自动补全功能就会生效。

FISH

要将补全脚本加载到当前会话中，运行：

podman completion fish | source

要使补全功能对所有 fish 会话可用，运行：

podman completion -f ~/.config/fish/completions/podman.fish fish

POWERSHELL

要将补全脚本加载到当前会话中，运行：

podman.exe completion powershell | Out-String | Invoke-Expression

要使补全功能在用户拥有的所有 powershell 会话中都可用，请将补全输出写入文件，并在用户的 powershell 配置文件中引用该文件。关于配置文件的更多信息，请使用 Get-Help about_Profiles 命令查看。

参见

podman(1), zsh(1), fish(1), powershell(1)