]> git.madduck.net Git - etc/vim.git/blob - CHANGES.md

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

ed08ab3b9adb531e67d65c41ef77bb4d2fedb9b6
[etc/vim.git] / CHANGES.md
1 # Change Log
2
3 ## Unreleased
4
5 ### _Black_
6
7 - Add support for formatting Jupyter Notebook files (#2357)
8 - Move from `appdirs` dependency to `platformdirs` (#2375)
9 - Present a more user-friendly error if .gitignore is invalid (#2414)
10 - The failsafe for accidentally added backslashes in f-string expressions has been
11   hardened to handle more edge cases during quote normalization (#2437)
12
13 ### _Blackd_
14
15 - Replace sys.exit(-1) with raise ImportError (#2440)
16
17 ### Integrations
18
19 - The provided pre-commit hooks no longer specify `language_version` to avoid overriding
20   `default_language_version` (#2430)
21
22 ## 21.7b0
23
24 ### _Black_
25
26 - Configuration files using TOML features higher than spec v0.5.0 are now supported
27   (#2301)
28 - Add primer support and test for code piped into black via STDIN (#2315)
29 - Fix internal error when `FORCE_OPTIONAL_PARENTHESES` feature is enabled (#2332)
30 - Accept empty stdin (#2346)
31 - Provide a more useful error when parsing fails during AST safety checks (#2304)
32
33 ### Docker
34
35 - Add new `latest_release` tag automation to follow latest black release on docker
36   images (#2374)
37
38 ### Integrations
39
40 - The vim plugin now searches upwards from the directory containing the current buffer
41   instead of the current working directory for pyproject.toml. (#1871)
42 - The vim plugin now reads the correct string normalization option in pyproject.toml
43   (#1869)
44 - The vim plugin no longer crashes Black when there's boolean values in pyproject.toml
45   (#1869)
46
47 ## 21.6b0
48
49 ### _Black_
50
51 - Fix failure caused by `fmt: skip` and indentation (#2281)
52 - Account for += assignment when deciding whether to split string (#2312)
53 - Correct max string length calculation when there are string operators (#2292)
54 - Fixed option usage when using the `--code` flag (#2259)
55 - Do not call `uvloop.install()` when _Black_ is used as a library (#2303)
56 - Added `--required-version` option to require a specific version to be running (#2300)
57 - Fix incorrect custom breakpoint indices when string group contains fake f-strings
58   (#2311)
59 - Fix regression where `R` prefixes would be lowercased for docstrings (#2285)
60 - Fix handling of named escapes (`\N{...}`) when `--experimental-string-processing` is
61   used (#2319)
62
63 ### Integrations
64
65 - The official Black action now supports choosing what version to use, and supports the
66   major 3 OSes. (#1940)
67
68 ## 21.5b2
69
70 ### _Black_
71
72 - A space is no longer inserted into empty docstrings (#2249)
73 - Fix handling of .gitignore files containing non-ASCII characters on Windows (#2229)
74 - Respect `.gitignore` files in all levels, not only `root/.gitignore` file (apply
75   `.gitignore` rules like `git` does) (#2225)
76 - Restored compatibility with Click 8.0 on Python 3.6 when LANG=C used (#2227)
77 - Add extra uvloop install + import support if in python env (#2258)
78 - Fix --experimental-string-processing crash when matching parens are not found (#2283)
79 - Make sure to split lines that start with a string operator (#2286)
80 - Fix regular expression that black uses to identify f-expressions (#2287)
81
82 ### _Blackd_
83
84 - Add a lower bound for the `aiohttp-cors` dependency. Only 0.4.0 or higher is
85   supported. (#2231)
86
87 ### Packaging
88
89 - Release self-contained x86_64 MacOS binaries as part of the GitHub release pipeline
90   (#2198)
91 - Always build binaries with the latest available Python (#2260)
92
93 ### Documentation
94
95 - Add discussion of magic comments to FAQ page (#2272)
96 - `--experimental-string-processing` will be enabled by default in the future (#2273)
97 - Fix typos discovered by codespell (#2228)
98 - Fix Vim plugin installation instructions. (#2235)
99 - Add new Frequently Asked Questions page (#2247)
100 - Fix encoding + symlink issues preventing proper build on Windows (#2262)
101
102 ## 21.5b1
103
104 ### _Black_
105
106 - Refactor `src/black/__init__.py` into many files (#2206)
107
108 ### Documentation
109
110 - Replaced all remaining references to the
111   [`master`](https://github.com/psf/black/tree/main) branch with the
112   [`main`](https://github.com/psf/black/tree/main) branch. Some additional changes in
113   the source code were also made. (#2210)
114 - Sigificantly reorganized the documentation to make much more sense. Check them out by
115   heading over to [the stable docs on RTD](https://black.readthedocs.io/en/stable/).
116   (#2174)
117
118 ## 21.5b0
119
120 ### _Black_
121
122 - Set `--pyi` mode if `--stdin-filename` ends in `.pyi` (#2169)
123 - Stop detecting target version as Python 3.9+ with pre-PEP-614 decorators that are
124   being called but with no arguments (#2182)
125
126 ### _Black-Primer_
127
128 - Add `--no-diff` to black-primer to suppress formatting changes (#2187)
129
130 ## 21.4b2
131
132 ### _Black_
133
134 - Fix crash if the user configuration directory is inaccessible. (#2158)
135
136 - Clarify
137   [circumstances](https://github.com/psf/black/blob/master/docs/the_black_code_style.md#pragmatism)
138   in which _Black_ may change the AST (#2159)
139
140 - Allow `.gitignore` rules to be overridden by specifying `exclude` in `pyproject.toml`
141   or on the command line. (#2170)
142
143 ### _Packaging_
144
145 - Install `primer.json` (used by `black-primer` by default) with black. (#2154)
146
147 ## 21.4b1
148
149 ### _Black_
150
151 - Fix crash on docstrings ending with "\\ ". (#2142)
152
153 - Fix crash when atypical whitespace is cleaned out of dostrings (#2120)
154
155 - Reflect the `--skip-magic-trailing-comma` and `--experimental-string-processing` flags
156   in the name of the cache file. Without this fix, changes in these flags would not take
157   effect if the cache had already been populated. (#2131)
158
159 - Don't remove necessary parentheses from assignment expression containing assert /
160   return statements. (#2143)
161
162 ### _Packaging_
163
164 - Bump pathspec to >= 0.8.1 to solve invalid .gitignore exclusion handling
165
166 ## 21.4b0
167
168 ### _Black_
169
170 - Fixed a rare but annoying formatting instability created by the combination of
171   optional trailing commas inserted by `Black` and optional parentheses looking at
172   pre-existing "magic" trailing commas. This fixes issue #1629 and all of its many many
173   duplicates. (#2126)
174
175 - `Black` now processes one-line docstrings by stripping leading and trailing spaces,
176   and adding a padding space when needed to break up """". (#1740)
177
178 - `Black` now cleans up leading non-breaking spaces in comments (#2092)
179
180 - `Black` now respects `--skip-string-normalization` when normalizing multiline
181   docstring quotes (#1637)
182
183 - `Black` no longer removes all empty lines between non-function code and decorators
184   when formatting typing stubs. Now `Black` enforces a single empty line. (#1646)
185
186 - `Black` no longer adds an incorrect space after a parenthesized assignment expression
187   in if/while statements (#1655)
188
189 - Added `--skip-magic-trailing-comma` / `-C` to avoid using trailing commas as a reason
190   to split lines (#1824)
191
192 - fixed a crash when PWD=/ on POSIX (#1631)
193
194 - fixed "I/O operation on closed file" when using --diff (#1664)
195
196 - Prevent coloured diff output being interleaved with multiple files (#1673)
197
198 - Added support for PEP 614 relaxed decorator syntax on python 3.9 (#1711)
199
200 - Added parsing support for unparenthesized tuples and yield expressions in annotated
201   assignments (#1835)
202
203 - added `--extend-exclude` argument (PR #2005)
204
205 - speed up caching by avoiding pathlib (#1950)
206
207 - `--diff` correctly indicates when a file doesn't end in a newline (#1662)
208
209 - Added `--stdin-filename` argument to allow stdin to respect `--force-exclude` rules
210   (#1780)
211
212 - Lines ending with `fmt: skip` will now be not formatted (#1800)
213
214 - PR #2053: Black no longer relies on typed-ast for Python 3.8 and higher
215
216 - PR #2053: Python 2 support is now optional, install with
217   `python3 -m pip install black[python2]` to maintain support.
218
219 - Exclude `venv` directory by default (#1683)
220
221 - Fixed "Black produced code that is not equivalent to the source" when formatting
222   Python 2 docstrings (#2037)
223
224 ### _Packaging_
225
226 - Self-contained native _Black_ binaries are now provided for releases via GitHub
227   Releases (#1743)
228
229 ## 20.8b1
230
231 ### _Packaging_
232
233 - explicitly depend on Click 7.1.2 or newer as `Black` no longer works with versions
234   older than 7.0
235
236 ## 20.8b0
237
238 ### _Black_
239
240 - re-implemented support for explicit trailing commas: now it works consistently within
241   any bracket pair, including nested structures (#1288 and duplicates)
242
243 - `Black` now reindents docstrings when reindenting code around it (#1053)
244
245 - `Black` now shows colored diffs (#1266)
246
247 - `Black` is now packaged using 'py3' tagged wheels (#1388)
248
249 - `Black` now supports Python 3.8 code, e.g. star expressions in return statements
250   (#1121)
251
252 - `Black` no longer normalizes capital R-string prefixes as those have a
253   community-accepted meaning (#1244)
254
255 - `Black` now uses exit code 2 when specified configuration file doesn't exit (#1361)
256
257 - `Black` now works on AWS Lambda (#1141)
258
259 - added `--force-exclude` argument (#1032)
260
261 - removed deprecated `--py36` option (#1236)
262
263 - fixed `--diff` output when EOF is encountered (#526)
264
265 - fixed `# fmt: off` handling around decorators (#560)
266
267 - fixed unstable formatting with some `# type: ignore` comments (#1113)
268
269 - fixed invalid removal on organizing brackets followed by indexing (#1575)
270
271 - introduced `black-primer`, a CI tool that allows us to run regression tests against
272   existing open source users of Black (#1402)
273
274 - introduced property-based fuzzing to our test suite based on Hypothesis and
275   Hypothersmith (#1566)
276
277 - implemented experimental and disabled by default long string rewrapping (#1132),
278   hidden under a `--experimental-string-processing` flag while it's being worked on;
279   this is an undocumented and unsupported feature, you lose Internet points for
280   depending on it (#1609)
281
282 ### Vim plugin
283
284 - prefer virtualenv packages over global packages (#1383)
285
286 ## 19.10b0
287
288 - added support for PEP 572 assignment expressions (#711)
289
290 - added support for PEP 570 positional-only arguments (#943)
291
292 - added support for async generators (#593)
293
294 - added support for pre-splitting collections by putting an explicit trailing comma
295   inside (#826)
296
297 - added `black -c` as a way to format code passed from the command line (#761)
298
299 - --safe now works with Python 2 code (#840)
300
301 - fixed grammar selection for Python 2-specific code (#765)
302
303 - fixed feature detection for trailing commas in function definitions and call sites
304   (#763)
305
306 - `# fmt: off`/`# fmt: on` comment pairs placed multiple times within the same block of
307   code now behave correctly (#1005)
308
309 - _Black_ no longer crashes on Windows machines with more than 61 cores (#838)
310
311 - _Black_ no longer crashes on standalone comments prepended with a backslash (#767)
312
313 - _Black_ no longer crashes on `from` ... `import` blocks with comments (#829)
314
315 - _Black_ no longer crashes on Python 3.7 on some platform configurations (#494)
316
317 - _Black_ no longer fails on comments in from-imports (#671)
318
319 - _Black_ no longer fails when the file starts with a backslash (#922)
320
321 - _Black_ no longer merges regular comments with type comments (#1027)
322
323 - _Black_ no longer splits long lines that contain type comments (#997)
324
325 - removed unnecessary parentheses around `yield` expressions (#834)
326
327 - added parentheses around long tuples in unpacking assignments (#832)
328
329 - added parentheses around complex powers when they are prefixed by a unary operator
330   (#646)
331
332 - fixed bug that led _Black_ format some code with a line length target of 1 (#762)
333
334 - _Black_ no longer introduces quotes in f-string subexpressions on string boundaries
335   (#863)
336
337 - if _Black_ puts parenthesis around a single expression, it moves comments to the
338   wrapped expression instead of after the brackets (#872)
339
340 - `blackd` now returns the version of _Black_ in the response headers (#1013)
341
342 - `blackd` can now output the diff of formats on source code when the `X-Diff` header is
343   provided (#969)
344
345 ## 19.3b0
346
347 - new option `--target-version` to control which Python versions _Black_-formatted code
348   should target (#618)
349
350 - deprecated `--py36` (use `--target-version=py36` instead) (#724)
351
352 - _Black_ no longer normalizes numeric literals to include `_` separators (#696)
353
354 - long `del` statements are now split into multiple lines (#698)
355
356 - type comments are no longer mangled in function signatures
357
358 - improved performance of formatting deeply nested data structures (#509)
359
360 - _Black_ now properly formats multiple files in parallel on Windows (#632)
361
362 - _Black_ now creates cache files atomically which allows it to be used in parallel
363   pipelines (like `xargs -P8`) (#673)
364
365 - _Black_ now correctly indents comments in files that were previously formatted with
366   tabs (#262)
367
368 - `blackd` now supports CORS (#622)
369
370 ## 18.9b0
371
372 - numeric literals are now formatted by _Black_ (#452, #461, #464, #469):
373
374   - numeric literals are normalized to include `_` separators on Python 3.6+ code
375
376   - added `--skip-numeric-underscore-normalization` to disable the above behavior and
377     leave numeric underscores as they were in the input
378
379   - code with `_` in numeric literals is recognized as Python 3.6+
380
381   - most letters in numeric literals are lowercased (e.g., in `1e10`, `0x01`)
382
383   - hexadecimal digits are always uppercased (e.g. `0xBADC0DE`)
384
385 - added `blackd`, see
386   [its documentation](https://github.com/psf/black/blob/18.9b0/README.md#blackd) for
387   more info (#349)
388
389 - adjacent string literals are now correctly split into multiple lines (#463)
390
391 - trailing comma is now added to single imports that don't fit on a line (#250)
392
393 - cache is now populated when `--check` is successful for a file which speeds up
394   consecutive checks of properly formatted unmodified files (#448)
395
396 - whitespace at the beginning of the file is now removed (#399)
397
398 - fixed mangling [pweave](http://mpastell.com/pweave/) and
399   [Spyder IDE](https://www.spyder-ide.org/) special comments (#532)
400
401 - fixed unstable formatting when unpacking big tuples (#267)
402
403 - fixed parsing of `__future__` imports with renames (#389)
404
405 - fixed scope of `# fmt: off` when directly preceding `yield` and other nodes (#385)
406
407 - fixed formatting of lambda expressions with default arguments (#468)
408
409 - fixed `async for` statements: _Black_ no longer breaks them into separate lines (#372)
410
411 - note: the Vim plugin stopped registering `,=` as a default chord as it turned out to
412   be a bad idea (#415)
413
414 ## 18.6b4
415
416 - hotfix: don't freeze when multiple comments directly precede `# fmt: off` (#371)
417
418 ## 18.6b3
419
420 - typing stub files (`.pyi`) now have blank lines added after constants (#340)
421
422 - `# fmt: off` and `# fmt: on` are now much more dependable:
423
424   - they now work also within bracket pairs (#329)
425
426   - they now correctly work across function/class boundaries (#335)
427
428   - they now work when an indentation block starts with empty lines or misaligned
429     comments (#334)
430
431 - made Click not fail on invalid environments; note that Click is right but the
432   likelihood we'll need to access non-ASCII file paths when dealing with Python source
433   code is low (#277)
434
435 - fixed improper formatting of f-strings with quotes inside interpolated expressions
436   (#322)
437
438 - fixed unnecessary slowdown when long list literals where found in a file
439
440 - fixed unnecessary slowdown on AST nodes with very many siblings
441
442 - fixed cannibalizing backslashes during string normalization
443
444 - fixed a crash due to symbolic links pointing outside of the project directory (#338)
445
446 ## 18.6b2
447
448 - added `--config` (#65)
449
450 - added `-h` equivalent to `--help` (#316)
451
452 - fixed improper unmodified file caching when `-S` was used
453
454 - fixed extra space in string unpacking (#305)
455
456 - fixed formatting of empty triple quoted strings (#313)
457
458 - fixed unnecessary slowdown in comment placement calculation on lines without comments
459
460 ## 18.6b1
461
462 - hotfix: don't output human-facing information on stdout (#299)
463
464 - hotfix: don't output cake emoji on non-zero return code (#300)
465
466 ## 18.6b0
467
468 - added `--include` and `--exclude` (#270)
469
470 - added `--skip-string-normalization` (#118)
471
472 - added `--verbose` (#283)
473
474 - the header output in `--diff` now actually conforms to the unified diff spec
475
476 - fixed long trivial assignments being wrapped in unnecessary parentheses (#273)
477
478 - fixed unnecessary parentheses when a line contained multiline strings (#232)
479
480 - fixed stdin handling not working correctly if an old version of Click was used (#276)
481
482 - _Black_ now preserves line endings when formatting a file in place (#258)
483
484 ## 18.5b1
485
486 - added `--pyi` (#249)
487
488 - added `--py36` (#249)
489
490 - Python grammar pickle caches are stored with the formatting caches, making _Black_
491   work in environments where site-packages is not user-writable (#192)
492
493 - _Black_ now enforces a PEP 257 empty line after a class-level docstring (and/or
494   fields) and the first method
495
496 - fixed invalid code produced when standalone comments were present in a trailer that
497   was omitted from line splitting on a large expression (#237)
498
499 - fixed optional parentheses being removed within `# fmt: off` sections (#224)
500
501 - fixed invalid code produced when stars in very long imports were incorrectly wrapped
502   in optional parentheses (#234)
503
504 - fixed unstable formatting when inline comments were moved around in a trailer that was
505   omitted from line splitting on a large expression (#238)
506
507 - fixed extra empty line between a class declaration and the first method if no class
508   docstring or fields are present (#219)
509
510 - fixed extra empty line between a function signature and an inner function or inner
511   class (#196)
512
513 ## 18.5b0
514
515 - call chains are now formatted according to the
516   [fluent interfaces](https://en.wikipedia.org/wiki/Fluent_interface) style (#67)
517
518 - data structure literals (tuples, lists, dictionaries, and sets) are now also always
519   exploded like imports when they don't fit in a single line (#152)
520
521 - slices are now formatted according to PEP 8 (#178)
522
523 - parentheses are now also managed automatically on the right-hand side of assignments
524   and return statements (#140)
525
526 - math operators now use their respective priorities for delimiting multiline
527   expressions (#148)
528
529 - optional parentheses are now omitted on expressions that start or end with a bracket
530   and only contain a single operator (#177)
531
532 - empty parentheses in a class definition are now removed (#145, #180)
533
534 - string prefixes are now standardized to lowercase and `u` is removed on Python 3.6+
535   only code and Python 2.7+ code with the `unicode_literals` future import (#188, #198,
536   #199)
537
538 - typing stub files (`.pyi`) are now formatted in a style that is consistent with PEP
539   484 (#207, #210)
540
541 - progress when reformatting many files is now reported incrementally
542
543 - fixed trailers (content with brackets) being unnecessarily exploded into their own
544   lines after a dedented closing bracket (#119)
545
546 - fixed an invalid trailing comma sometimes left in imports (#185)
547
548 - fixed non-deterministic formatting when multiple pairs of removable parentheses were
549   used (#183)
550
551 - fixed multiline strings being unnecessarily wrapped in optional parentheses in long
552   assignments (#215)
553
554 - fixed not splitting long from-imports with only a single name
555
556 - fixed Python 3.6+ file discovery by also looking at function calls with unpacking.
557   This fixed non-deterministic formatting if trailing commas where used both in function
558   signatures with stars and function calls with stars but the former would be
559   reformatted to a single line.
560
561 - fixed crash on dealing with optional parentheses (#193)
562
563 - fixed "is", "is not", "in", and "not in" not considered operators for splitting
564   purposes
565
566 - fixed crash when dead symlinks where encountered
567
568 ## 18.4a4
569
570 - don't populate the cache on `--check` (#175)
571
572 ## 18.4a3
573
574 - added a "cache"; files already reformatted that haven't changed on disk won't be
575   reformatted again (#109)
576
577 - `--check` and `--diff` are no longer mutually exclusive (#149)
578
579 - generalized star expression handling, including double stars; this fixes
580   multiplication making expressions "unsafe" for trailing commas (#132)
581
582 - _Black_ no longer enforces putting empty lines behind control flow statements (#90)
583
584 - _Black_ now splits imports like "Mode 3 + trailing comma" of isort (#127)
585
586 - fixed comment indentation when a standalone comment closes a block (#16, #32)
587
588 - fixed standalone comments receiving extra empty lines if immediately preceding a
589   class, def, or decorator (#56, #154)
590
591 - fixed `--diff` not showing entire path (#130)
592
593 - fixed parsing of complex expressions after star and double stars in function calls
594   (#2)
595
596 - fixed invalid splitting on comma in lambda arguments (#133)
597
598 - fixed missing splits of ternary expressions (#141)
599
600 ## 18.4a2
601
602 - fixed parsing of unaligned standalone comments (#99, #112)
603
604 - fixed placement of dictionary unpacking inside dictionary literals (#111)
605
606 - Vim plugin now works on Windows, too
607
608 - fixed unstable formatting when encountering unnecessarily escaped quotes in a string
609   (#120)
610
611 ## 18.4a1
612
613 - added `--quiet` (#78)
614
615 - added automatic parentheses management (#4)
616
617 - added [pre-commit](https://pre-commit.com) integration (#103, #104)
618
619 - fixed reporting on `--check` with multiple files (#101, #102)
620
621 - fixed removing backslash escapes from raw strings (#100, #105)
622
623 ## 18.4a0
624
625 - added `--diff` (#87)
626
627 - add line breaks before all delimiters, except in cases like commas, to better comply
628   with PEP 8 (#73)
629
630 - standardize string literals to use double quotes (almost) everywhere (#75)
631
632 - fixed handling of standalone comments within nested bracketed expressions; _Black_
633   will no longer produce super long lines or put all standalone comments at the end of
634   the expression (#22)
635
636 - fixed 18.3a4 regression: don't crash and burn on empty lines with trailing whitespace
637   (#80)
638
639 - fixed 18.3a4 regression: `# yapf: disable` usage as trailing comment would cause
640   _Black_ to not emit the rest of the file (#95)
641
642 - when CTRL+C is pressed while formatting many files, _Black_ no longer freaks out with
643   a flurry of asyncio-related exceptions
644
645 - only allow up to two empty lines on module level and only single empty lines within
646   functions (#74)
647
648 ## 18.3a4
649
650 - `# fmt: off` and `# fmt: on` are implemented (#5)
651
652 - automatic detection of deprecated Python 2 forms of print statements and exec
653   statements in the formatted file (#49)
654
655 - use proper spaces for complex expressions in default values of typed function
656   arguments (#60)
657
658 - only return exit code 1 when --check is used (#50)
659
660 - don't remove single trailing commas from square bracket indexing (#59)
661
662 - don't omit whitespace if the previous factor leaf wasn't a math operator (#55)
663
664 - omit extra space in kwarg unpacking if it's the first argument (#46)
665
666 - omit extra space in
667   [Sphinx auto-attribute comments](http://www.sphinx-doc.org/en/stable/ext/autodoc.html#directive-autoattribute)
668   (#68)
669
670 ## 18.3a3
671
672 - don't remove single empty lines outside of bracketed expressions (#19)
673
674 - added ability to pipe formatting from stdin to stdin (#25)
675
676 - restored ability to format code with legacy usage of `async` as a name (#20, #42)
677
678 - even better handling of numpy-style array indexing (#33, again)
679
680 ## 18.3a2
681
682 - changed positioning of binary operators to occur at beginning of lines instead of at
683   the end, following
684   [a recent change to PEP 8](https://github.com/python/peps/commit/c59c4376ad233a62ca4b3a6060c81368bd21e85b)
685   (#21)
686
687 - ignore empty bracket pairs while splitting. This avoids very weirdly looking
688   formattings (#34, #35)
689
690 - remove a trailing comma if there is a single argument to a call
691
692 - if top level functions were separated by a comment, don't put four empty lines after
693   the upper function
694
695 - fixed unstable formatting of newlines with imports
696
697 - fixed unintentional folding of post scriptum standalone comments into last statement
698   if it was a simple statement (#18, #28)
699
700 - fixed missing space in numpy-style array indexing (#33)
701
702 - fixed spurious space after star-based unary expressions (#31)
703
704 ## 18.3a1
705
706 - added `--check`
707
708 - only put trailing commas in function signatures and calls if it's safe to do so. If
709   the file is Python 3.6+ it's always safe, otherwise only safe if there are no `*args`
710   or `**kwargs` used in the signature or call. (#8)
711
712 - fixed invalid spacing of dots in relative imports (#6, #13)
713
714 - fixed invalid splitting after comma on unpacked variables in for-loops (#23)
715
716 - fixed spurious space in parenthesized set expressions (#7)
717
718 - fixed spurious space after opening parentheses and in default arguments (#14, #17)
719
720 - fixed spurious space after unary operators when the operand was a complex expression
721   (#15)
722
723 ## 18.3a0
724
725 - first published version, Happy 🍰 Day 2018!
726
727 - alpha quality
728
729 - date-versioned (see: <https://calver.org/>)