X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/10bb45c35e8e08215ad9a060aca33be91a98b864..a42aef780630bce97c01dbf33a1947ea108e6e29:/README.md?ds=sidebyside diff --git a/README.md b/README.md index ac4caa1..205163f 100644 --- a/README.md +++ b/README.md @@ -159,7 +159,7 @@ def very_important_function( debug: bool = False, ): """Applies `variables` to the `template` and writes to `file`.""" - with open(file, 'w') as f: + with open(file, "w") as f: ... ``` @@ -260,6 +260,15 @@ if you'd like a trailing comma in this situation and *Black* didn't recognize it was safe to do so, put it there manually and *Black* will keep it. +### Strings + +*Black* prefers double quotes (`"` and `"""`), but only if this does not +result in more escaping. It will remove escape sequences as necessary as +part of moving to the other type of quote. This applies to all kinds of +prefixed strings, including *raw-strings* (`r""`), *byte literals* (`b""`), +and *formatted strings* (`f""`). The approach above strikes a good balance +between consistency and legibility. + ## Editor integration @@ -385,9 +394,19 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). ### 18.3a5 (unreleased) +* add line breaks before all delimiters, except in cases like commas, to better + comply with PEP8 (#73) + +* fixed handling of standalone comments within nested bracketed + expressions; Black will no longer produce super long lines or put all + standalone comments at the end of the expression (#22) + * fixed 18.3a4 regression: don't crash and burn on empty lines with trailing whitespace (#80) +* when CTRL+C is pressed while formatting many files, Black no longer + freaks out with a flurry of asyncio-related exceptions + * only allow up to two empty lines on module level and only single empty lines within functions (#74) @@ -497,5 +516,5 @@ Multiple contributions by: * [Daniel M. Capella](mailto:polycitizen@gmail.com) * [Eli Treuherz](mailto:eli.treuherz@cgi.com) * Hugo van Kemenade -* [Mika⠙](mailto:mail@autophagy.io) +* [Mika Naylor](mailto:mail@autophagy.io) * [Osaetin Daniel](mailto:osaetindaniel@gmail.com)