History

Łukasz Langa 788268bc39 Re-implement magic trailing comma handling: - when a trailing comma is specified in any bracket pair, that signals to Black that this bracket pair needs to be always exploded, e.g. presented as "one item per line"; - this causes some changes to previously formatted code that erroneously left trailing commas embedded into single-line expressions; - internally, Black needs to be able to identify trailing commas that it put itself compared to pre-existing trailing commas. We do this by using/abusing lib2to3's `was_checked` attribute. It's True for internally generated trailing commas and False for pre-existing ones (in fact, for all pre-existing leaves and nodes). Fixes #1288		2020-08-21 16:45:30 +02:00
..
Dockerfile	Compress RUN statements into one to avoid layer proliferation	2020-03-17 11:33:57 +01:00
gallery.py	Re-implement magic trailing comma handling:	2020-08-21 16:45:30 +02:00
README.md	Don't suggest using `sudo` with Docker	2020-03-17 11:35:41 +01:00

README.md

Gallery

Gallery is a script that automates the process of applying different Black versions to a selected PyPI package and seeing the results between Black versions.

Build

$ docker build -t black_gallery .

Run

$ docker run -it -v /host/output:/output -v /host/input:/input black_gallery:latest [args]

usage: gallery.py [-h] (-p PYPI_PACKAGE | -t TOP_PACKAGES) [-b BLACK_REPO] [-v VERSION] [-w WORKERS] [-i INPUT] [-o OUTPUT]
                  [versions [versions ...]]

Black Gallery is a script that automates the process of applying different Black versions to a selected PyPI package and
seeing the results between versions.

positional arguments:
  versions

optional arguments:
  -h, --help            show this help message and exit
  -p PYPI_PACKAGE, --pypi-package PYPI_PACKAGE
                        PyPI package to download.
  -t TOP_PACKAGES, --top-packages TOP_PACKAGES
                        Top n PyPI packages to download.
  -b BLACK_REPO, --black-repo BLACK_REPO
                        Black's Git repository.
  -v VERSION, --version VERSION
                        Version for given PyPI package. Will be discarded if used with -t option.
  -w WORKERS, --workers WORKERS
                        Maximum number of threads to download with at the same time. Will be discarded if used with -p
                        option.
  -i INPUT, --input INPUT
                        Input directory to read configuration.
  -o OUTPUT, --output OUTPUT
                        Output directory to download and put result artifacts.