b1f7b9f87d
* Bump docker/build-push-action from 5 to 6 Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 5 to 6. - [Release notes](https://github.com/docker/build-push-action/releases) - [Commits](https://github.com/docker/build-push-action/compare/v5...v6) --- updated-dependencies: - dependency-name: docker/build-push-action dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
# Black Docker image
|
||
|
||
Official _Black_ Docker images are available on
|
||
[Docker Hub](https://hub.docker.com/r/pyfound/black).
|
||
|
||
_Black_ images with the following tags are available:
|
||
|
||
- release numbers, e.g. `21.5b2`, `21.6b0`, `21.7b0` etc.\
|
||
ℹ Recommended for users who want to use a particular version of _Black_.
|
||
- `latest_release` - tag created when a new version of _Black_ is released.\
|
||
ℹ Recommended for users who want to use released versions of _Black_. It maps to
|
||
[the latest release](https://github.com/psf/black/releases/latest) of _Black_.
|
||
- `latest_prerelease` - tag created when a new alpha (prerelease) version of _Black_ is
|
||
released.\
|
||
ℹ Recommended for users who want to preview or test alpha versions of _Black_. Note
|
||
that the most recent release may be newer than any prerelease, because no prereleases
|
||
are created before most releases.
|
||
- `latest` - tag used for the newest image of _Black_.\
|
||
ℹ Recommended for users who always want to use the latest version of _Black_, even
|
||
before it is released.
|
||
|
||
There is one more tag used for _Black_ Docker images - `latest_non_release`. It is
|
||
created for all unreleased
|
||
[commits on the `main` branch](https://github.com/psf/black/commits/main). This tag is
|
||
not meant to be used by external users.
|
||
|
||
From version 23.11.0 the Docker image installs a compiled black into the image.
|
||
|
||
## Usage
|
||
|
||
A permanent container doesn't have to be created to use _Black_ as a Docker image. It's
|
||
enough to run _Black_ commands for the chosen image denoted as `:tag`. In the below
|
||
examples, the `latest_release` tag is used. If `:tag` is omitted, the `latest` tag will
|
||
be used.
|
||
|
||
More about _Black_ usage can be found in
|
||
[Usage and Configuration: The basics](./the_basics.md).
|
||
|
||
### Check Black version
|
||
|
||
```console
|
||
$ docker run --rm pyfound/black:latest_release black --version
|
||
```
|
||
|
||
### Check code
|
||
|
||
```console
|
||
$ docker run --rm --volume $(pwd):/src --workdir /src pyfound/black:latest_release black --check .
|
||
```
|
||
|
||
_Remark_: besides [regular _Black_ exit codes](./the_basics.md) returned by `--check`
|
||
option, [Docker exit codes](https://docs.docker.com/engine/reference/run/#exit-status)
|
||
should also be considered.
|