X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/0bf683a65929cb2153ed5e6d881ab6ed21e49e8c..6f5e1277e9f0270de30f732e6cba5077bb6cad26:/README.md diff --git a/README.md b/README.md index 3fcba56..6aad8bc 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,8 @@ Documentation Status Coverage Status License: MIT -PyPI -Downloads +PyPI +Downloads Code style: black

@@ -371,6 +371,13 @@ human-readable strings"](https://stackoverflow.com/a/56190)), you can pass `--skip-string-normalization` on the command line. This is meant as an adoption helper, avoid using this for new projects. +### Numeric literals + +*Black* standardizes most numeric literals to use lowercase letters: `0xab` +instead of `0XAB` and `1e10` instead of `1E10`. Python 2 long literals are +styled as `2L` instead of `2l` to avoid confusion between `l` and `1`. In +Python 3.6+, *Black* adds underscores to long numeric literals to aid +readability: `100000000` becomes `100_000_000`. ### Line breaks & binary operators @@ -721,7 +728,7 @@ the [Python Language Server](https://github.com/palantir/python-language-server) ### Atom/Nuclide -Use [atom-black](https://github.com/hauntsaninja/atom-black). +Use [python-black](https://atom.io/packages/python-black). ### Other editors @@ -786,7 +793,7 @@ as .pyi, and whether string normalization was omitted. > *Black* is opinionated so you don't have to be. -**Hynek Schlawack**, [creator of `attrs`](http://www.attrs.org/), core +**Hynek Schlawack**, [creator of `attrs`](https://www.attrs.org/), core developer of Twisted and CPython: > An auto-formatter that doesn't suck is all I want for Xmas! @@ -843,8 +850,15 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). ### 18.8b0 -* numeric literals are now normalized to include `_` separators on Python 3.6+ code - (#452) +* adjacent string literals are now correctly split into multiple lines (#463) + +* numeric literals are now formatted by *Black* (#452, #461, #464, #469): + + * numeric literals are normalized to include `_` separators on Python 3.6+ code + + * code with `_` in numeric literals is recognized as Python 3.6+ + + * most letters in numeric literals are lowercased (e.g., in `1e10` or `0xab`) * cache is now populated when `--check` is successful for a file which speeds up consecutive checks of properly formatted unmodified files (#448) @@ -856,6 +870,10 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). * note: the Vim plugin stopped registering ``,=`` as a default chord as it turned out to be a bad idea (#415) +* fixed formatting of lambda expressions with default arguments (#468) + +* *Black* no longer breaks ``async for`` statements up to separate lines (#372) + ### 18.6b4 @@ -1209,6 +1227,7 @@ Glued together by [Łukasz Langa](mailto:lukasz@langa.pl). Maintained with [Carol Willing](mailto:carolcode@willingconsulting.com), [Carl Meyer](mailto:carl@oddbird.net), +[Jelle Zijlstra](mailto:jelle.zijlstra@gmail.com), [Mika Naylor](mailto:mail@autophagy.io), and [Zsolt Dollenstein](mailto:zsol.zsol@gmail.com). @@ -1217,10 +1236,9 @@ Multiple contributions by: * [Artem Malyshev](mailto:proofit404@gmail.com) * [Christian Heimes](mailto:christian@python.org) * [Daniel M. Capella](mailto:polycitizen@gmail.com) -* [Eli Treuherz](mailto:eli.treuherz@cgi.com) +* [Eli Treuherz](mailto:eli@treuherz.com) * Hugo van Kemenade * [Ivan Katanić](mailto:ivan.katanic@gmail.com) -* [Jelle Zijlstra](mailto:jelle.zijlstra@gmail.com) * [Jonas Obrist](mailto:ojiidotch@gmail.com) * [Luka Sterbic](mailto:luka.sterbic@gmail.com) * [Miguel Gaiowski](mailto:miggaiowski@gmail.com)