Black Docker 镜像¶
官方 Black Docker 镜像可在 Docker Hub 上获取。
以下标签的 Black 镜像可用
发行版号,例如
21.5b2
,21.6b0
,21.7b0
等。
ℹ️ 推荐给想要使用特定 Black 版本的用户。latest_release
- 当发布新版本的 Black 时创建的标签。
ℹ️ 推荐给想要使用已发布的 Black 版本的用户。它映射到 最新版本的 Black。latest_prerelease
- 当发布新的 alpha(预发行版)版本的 Black 时创建的标签。
ℹ️ 推荐给想要预览或测试 Black 的 alpha 版本的用户。请注意,最新版本可能比任何预发行版更新,因为在大多数版本发布之前不会创建任何预发行版。latest
- 用于最新 Black 镜像的标签。
ℹ️ 推荐给想要始终使用最新版本的 Black 的用户,即使是在发布之前。
Black Docker 镜像还使用另一个标签 - latest_non_release
。它为所有未发布的 main 分支上的提交 创建。该标签不打算供外部用户使用。
从 23.11.0 版本开始,Docker 镜像会将已编译的 black 安装到镜像中。
使用¶
无需创建永久容器即可将 Black 用作 Docker 镜像。只需为所选镜像运行 Black 命令即可,该镜像用 :tag
表示。在以下示例中,使用 latest_release
标签。如果省略 :tag
,将使用 latest
标签。
有关 Black 用法的更多信息,请参阅 使用和配置:基础。
检查 Black 版本¶
$ docker run --rm pyfound/black:latest_release black --version
检查代码¶
$ docker run --rm --volume $(pwd):/src --workdir /src pyfound/black:latest_release black --check .
备注:除了 常规 Black 退出代码(由 --check
选项返回)外,还应考虑 Docker 退出代码。