Black Docker 镜像

官方 Black Docker 镜像可在 Docker Hub 上获取。

以下标签的 Black 镜像可用

  • 发行版号,例如 21.5b221.6b021.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 退出代码