GitHub Actions integration¶
You can use Black within a GitHub Actions workflow without setting your own Python environment. Great for enforcing that your code matches the Black code style.
This action is known to support all GitHub-hosted runner OSes. In addition, only published versions of Black are supported (i.e. whatever is available on PyPI).
Finally, this action installs Black with both the
python2 extras so
--color flag and formatting Python 2 code are supported.
Create a file named
.github/workflows/black.yml inside your repository with:
name: Lint on: [push, pull_request] jobs: lint: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - uses: psf/black@stable
We recommend the use of the
@stable tag, but per version tags also exist if you prefer
that. Note that the action’s version you select is independent of the version of Black
the action will use.
The version of Black the action will use can be configured via
version. The action
defaults to the latest release available on PyPI. Only versions available from PyPI are
supported, so no commit SHAs or branch names.
You can also configure the arguments passed to Black via
options (defaults to
'--check --diff') and
src (default is
Here’s an example configuration:
- uses: psf/black@stable with: options: "--check --verbose" src: "./src" version: "21.5b1"