Black

- hotfix: don't freeze when multiple comments directly precede ` fmt: off` (371)

- typing stub files (`.pyi`) now have blank lines added after constants (340)

- ` fmt: off` and ` fmt: on` are now much more dependable:

- they now work also within bracket pairs (329)

- they now correctly work across function/class boundaries (335)

- they now work when an indentation block starts with empty lines or misaligned
comments (334)

- made Click not fail on invalid environments; note that Click is right but the
likelihood we'll need to access non-ASCII file paths when dealing with Python source
code is low (277)

- fixed improper formatting of f-strings with quotes inside interpolated expressions
(322)

- fixed unnecessary slowdown when long list literals where found in a file

- fixed unnecessary slowdown on AST nodes with very many siblings

- fixed cannibalizing backslashes during string normalization

- fixed a crash due to symbolic links pointing outside of the project directory (338)

- added `--config` (65)

- added `-h` equivalent to `--help` (316)

- fixed improper unmodified file caching when `-S` was used

- fixed extra space in string unpacking (305)

- fixed formatting of empty triple quoted strings (313)

- fixed unnecessary slowdown in comment placement calculation on lines without comments

- hotfix: don't output human-facing information on stdout (299)

- hotfix: don't output cake emoji on non-zero return code (300)

- added `--include` and `--exclude` (270)

- added `--skip-string-normalization` (118)

- added `--verbose` (283)

- the header output in `--diff` now actually conforms to the unified diff spec

- fixed long trivial assignments being wrapped in unnecessary parentheses (273)

- fixed unnecessary parentheses when a line contained multiline strings (232)

- fixed stdin handling not working correctly if an old version of Click was used (276)

- _Black_ now preserves line endings when formatting a file in place (258)

- added `--pyi` (249)

- added `--py36` (249)

- Python grammar pickle caches are stored with the formatting caches, making _Black_
work in environments where site-packages is not user-writable (192)

- _Black_ now enforces a PEP 257 empty line after a class-level docstring (and/or
fields) and the first method

- fixed invalid code produced when standalone comments were present in a trailer that
was omitted from line splitting on a large expression (237)

- fixed optional parentheses being removed within ` fmt: off` sections (224)

- fixed invalid code produced when stars in very long imports were incorrectly wrapped
in optional parentheses (234)

- fixed unstable formatting when inline comments were moved around in a trailer that was
omitted from line splitting on a large expression (238)

- fixed extra empty line between a class declaration and the first method if no class
docstring or fields are present (219)

- fixed extra empty line between a function signature and an inner function or inner
class (196)