]> git.madduck.net Git - etc/vim.git/blobdiff - README.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:

[blib2to3] Fixed a typo and removed an unused import. (#848)
[etc/vim.git] / README.md
index 66e863377b59382c1c20be5e21ae511ecb561e0e..76b7d7cafd770cb410071035861975fce5ed338e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -844,6 +844,14 @@ Options:
   -h, --help                      Show this message and exit.
 ```
 
   -h, --help                      Show this message and exit.
 ```
 
+There is no official blackd client tool (yet!). You can test that blackd is
+working using `curl`:
+
+```
+blackd --bind-port 9090 &  # or let blackd choose a port
+curl -s -XPOST "localhost:9090" -d "print('valid')"
+```
+
 ### Protocol
 
 `blackd` only accepts `POST` requests at the `/` path. The body of the request
 ### Protocol
 
 `blackd` only accepts `POST` requests at the `/` path. The body of the request
@@ -925,6 +933,10 @@ is:
 `file-mode` is an int flag that determines whether the file was formatted as 3.6+ only,
 as .pyi, and whether string normalization was omitted.
 
 `file-mode` is an int flag that determines whether the file was formatted as 3.6+ only,
 as .pyi, and whether string normalization was omitted.
 
+To override the location of these files on macOS or Linux, set the environment variable
+`XDG_CACHE_HOME` to your preferred location. For example, if you want to put the cache in
+the directory you're running *Black* from, set `XDG_CACHE_HOME=.cache`. *Black* will then
+write the above files to `.cache/black/<version>/`.
 
 ## Used by
 
 
 ## Used by
 
@@ -998,29 +1010,37 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 ### 19.5b0
 
 
 ### 19.5b0
 
-* don't crash when run on a Windows machine with more than 61 cores (#838)
+* added `black -c` as a way to format code passed from the command line
+  (#761)
 
 
-* remove unnecessary parentheses around `yield` expressions (#834)
+* --safe now works with Python 2 code (#840)
 
 
-* add parentheses around long tuples in unpacking assignments (#832)
+* fixed grammar selection for Python 2-specific code (#765)
 
 
-* don't produce invalid code for `from` ... `import` blocks with comments
-  (#829)
+* fixed feature detection for trailing commas in function definitions
+  and call sites (#763)
+
+* *Black* can now format async generators (#593)
+
+* *Black* no longer crashes on Windows machines with more than 61 cores
+  (#838)
 
 
-* fix grammar selection (#765)
+* *Black* no longer crashes on standalone comments prepended with
+  a backslash (#767)
 
 
-* fix feature detection for trailing commas in function definitions and
-  call sites (#763)
+* *Black* no longer crashes on `from` ... `import` blocks with comments
+  (#829)
 
 
-* add `black -c` as a way to format code passed from the command line (#761)
+* removed unnecessary parentheses around `yield` expressions (#834)
 
 
-* fix bug that led *Black* format some code with a line length target of 1
-  (#762)
+* added parentheses around long tuples in unpacking assignments (#832)
 
 
-* --safe now works with Python 2 code (#840)
+* fixed bug that led *Black* format some code with a line length target
+  of 1 (#762)
+
+* *Black* no longer introduces quotes in f-string subexpressions on string
+  boundaries (#863)
 
 
-* *Black* no longer crashes on standalone comments prepended with
-  a backslash (#767)
 
 ### 19.3b0
 
 
 ### 19.3b0
 
@@ -1048,6 +1068,7 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 * `blackd` now supports CORS (#622)
 
 
 * `blackd` now supports CORS (#622)
 
+
 ### 18.9b0
 
 * numeric literals are now formatted by *Black* (#452, #461, #464, #469):
 ### 18.9b0
 
 * numeric literals are now formatted by *Black* (#452, #461, #464, #469):
@@ -1451,6 +1472,7 @@ Maintained with [Carol Willing](mailto:carolcode@willingconsulting.com),
 Multiple contributions by:
 * [Anthony Sottile](mailto:asottile@umich.edu)
 * [Artem Malyshev](mailto:proofit404@gmail.com)
 Multiple contributions by:
 * [Anthony Sottile](mailto:asottile@umich.edu)
 * [Artem Malyshev](mailto:proofit404@gmail.com)
+* [Benjamin Woodruff](mailto:github@benjam.info)
 * [Christian Heimes](mailto:christian@python.org)
 * [Daniel M. Capella](mailto:polycitizen@gmail.com)
 * [Eli Treuherz](mailto:eli@treuherz.com)
 * [Christian Heimes](mailto:christian@python.org)
 * [Daniel M. Capella](mailto:polycitizen@gmail.com)
 * [Eli Treuherz](mailto:eli@treuherz.com)