pipx 后端
pipx 是一个用于在隔离的虚拟环境中运行 Python CLI 的工具。这对于 Python CLI 是必要的， 因为它可以防止 CLI 之间，或 CLI 与 Python 项目之间的依赖冲突。简而言之， 这个后端让你可以将 Python CLI 添加到 mise 中。
需要明确的是，pipx 不是 pip，它通常也不用于管理 Python 依赖。 mise 是一个工具管理器，而不是像 pip、uv 或 poetry 那样的依赖管理器。不过，你可以使用 mise 来安装这些包管理器。 你会想使用 pipx 后端来安装像 "black" 这样的 CLI，而不是像 "NumPy" 或 "requests" 这样的库。
稍微有点令人困惑的是，如果安装了 uv，pipx 后端实际上会默认使用 uvx（uv 版的 pipx 等价工具）。 这应该只会让安装速度更快，但请参见下文以了解如何禁用或配置，因为有时工具不能与 uvx 正常工作。
pipx 后端支持以下来源：
- PyPI
- Git
- GitHub
- Http
这部分代码位于 mise 仓库中的 ./src/backend/pipx.rs。
依赖
这依赖于已安装 uv（推荐）或 pipx。
如果你已经安装了 uv，mise 会在底层使用 uv tool install，并且你不需要安装 pipx 就可以运行包含“pipx:”的命令。
mise 会在安装期间将 minimum_release_age 传递给传递性的 Python 依赖解析。uv 的安装路径使用 uv 的 --exclude-newer 标志，并且要求 uv >= 0.2.22。pipx 回退方案会传递 pip 的 --uploaded-prior-to 标志。
如果你因为其他原因需要 pipx，可以通过 mise 或不通过 mise 来安装它。以下是在 mise 中安装 pipx 的方法：
mise use -g python
pip install --user pipx用法
以下命令会安装 black 的最新版本 并将其设置为 PATH 上的当前生效版本：
$ mise use -g pipx:psf/black
$ black --version
black, 24.3.0该版本将以如下格式设置在 ~/.config/mise/config.toml 中：
[tools]
"pipx:psf/black" = "latest"Python 升级
如果 pipx 包使用的 python 版本发生变化（由 mise 或系统 python 引起），你可能需要 重新安装该包。可以使用以下命令完成：
mise install -f pipx:psf/black或者你也可以重新安装所有 pipx 包：
mise install -f "pipx:*"在使用 mise up python 时，mise 应该 会自动执行此操作。
支持的 Pipx 语法
| 描述 | 用法 |
|---|---|
| PyPI 简写，最新版本 | pipx:black |
| PyPI 简写，指定版本 | pipx:[email protected] |
| GitHub 简写，最新版本 | pipx:psf/black |
| GitHub 简写，指定版本 | pipx:psf/[email protected] |
| Git 语法，最新版本 | pipx:git+https://github.com/psf/black.git |
| Git 语法，指定分支 | pipx:git+https://github.com/psf/black.git@main |
| 带 zip 文件的 Https | pipx:https://github.com/psf/black/archive/18.9b0.zip |
对于 GitHub URL，latest 会解析为最新发布的 GitHub Release；如果没有 Release，则会回退到默认分支的 HEAD。对于其他 Git URL，latest 会跟踪默认分支的 HEAD，并在安装前将其解析为具体的提交。远程标签可用于显式版本请求。
其他语法可能也能使用，但不受支持且未经测试。
设置
使用 mise settings set [VARIABLE]=[VALUE] 设置这些，或者通过设置列出的环境变量。
pipx.registry_url
- Type:
string - Env:
MISE_PIPX_REGISTRY_URL - Default:
https://pypi.org/pypi/{}/json
URL to use for pipx registry.
This is used to fetch the latest version of a package from the pypi registry.
The default is https://pypi.org/pypi/{}/json which is the JSON endpoint for the pypi
registry.
You can also use the HTML endpoint by setting this to https://pypi.org/simple/{}/.
pipx.uvx
- Type:
boolean - Env:
MISE_PIPX_UVX - Default:
true
If true, mise will use uvx instead of pipx if
uv is installed and on PATH.
This makes installing CLIs much faster by using uv as the package manager.
You can install it with mise:
mise use -g uv
工具选项
以下 tool-options 适用于 pipx 后端——这些内容应放在 mise.toml 的 [tools] 中。
registry_url
设置 mise 用于解析此工具版本的包注册表 URL。该 URL 必须包含一个用于包名称的 {} 占位符。这会仅针对该工具覆盖 pipx.registry_url 设置；安装注册表参数仍需通过 uvx_args 或 pipx_args 单独配置。
[tools]
"pipx:my-tool" = {
version = "latest",
registry_url = "https://packages.example.com/pypi/{}/json",
uvx_args = "--extra-index-url https://packages.example.com/pypi/simple",
pipx_args = "--pip-args='--extra-index-url https://packages.example.com/pypi/simple'"
}install_env
为 uv tool install 或 pipx install 设置环境变量。mise 在应用 install_env 后，仍会设置工具目录、二进制目录以及已配置的 Python 包索引变量。
[tools]
"pipx:black" = { version = "latest", install_env = { PIP_TRUSTED_HOST = "pypi.org" } }extras
安装额外组件。
[tools]
"pipx:harlequin" = { version = "latest", extras = "postgres,s3" }
# 等效的数组形式：
# "pipx:harlequin" = { version = "latest", extras = ["postgres", "s3"] }
# extras 也适用于 Git 源：
# "pipx:psf/black" = { version = "latest", extras = ["jupyter"] }内联传递 extras 时，使用 mise 的 key=value 工具选项语法：
mise use 'pipx:psf/black[extras=jupyter]@latest'对于名称与 Python distribution 名称不同的 Git 仓库，请设置 package_name，以便 mise 构建用于选择 extras 的依赖要求：
[tools]
"pipx:owner/repository" = { version = "latest", package_name = "distribution", extras = ["feature"] }pipx_args
安装包时传递给 pipx 的附加参数。
[tools]
"pipx:black" = { version = "latest", pipx_args = "--preinstall" }uvx
设置为 false 可始终为此工具禁用 uv。
[tools]
"pipx:ansible" = { version = "latest", uvx = "false", pipx_args = "--include-deps" }uvx_args
安装包时传递给 uvx 的附加参数。
[tools]
"pipx:ansible-core" = { version = "latest", uvx_args = "--with ansible" }