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.
|