Add instructions for running Black on save in Vim (#255)

[etc/vim.git] / README.md

diff --git a/README.md b/README.md
index 5b5903b49887ff8082e490cb787be14f26f45b24..a6d7de89ce59335d548c7af96b0b5a120d76b532 100644 (file)
--- a/README.md
+++ b/README.md
@@ -80,6 +80,13 @@ Options:
   -q, --quiet                 Don't emit non-error messages to stderr. Errors
                               are still emitted, silence those with
                               2>/dev/null.
   -q, --quiet                 Don't emit non-error messages to stderr. Errors
                               are still emitted, silence those with
                               2>/dev/null.

+   --pyi                      Consider all input files typing stubs regardless
+                              of file extension (useful when piping source on
+                              standard input).
+  --py36                      Allow using Python 3.6-only syntax on all input
+                              files.  This will put trailing commas in function
+                              signatures and calls also after *args and
+                              **kwargs.  [default: per-file auto-detection]

   --version                   Show the version and exit.
   --help                      Show this message and exit.
 ```
   --version                   Show the version and exit.
   --help                      Show this message and exit.
 ```


@@ -521,6 +528,12 @@ install *Black* (for example you want to run a version from master),
 create a virtualenv manually and point `g:black_virtualenv` to it.
 The plugin will use it.
 
 create a virtualenv manually and point `g:black_virtualenv` to it.
 The plugin will use it.
 

+To run *Black* on save, add the following line to `.vimrc` or `init.vim`:
+
+```
+autocmd BufWritePost *.py execute ':Black'
+```
+

 **How to get Vim with Python 3.6?**
 On Ubuntu 17.10 Vim comes with Python 3.6 by default.
 On macOS with Homebrew run: `brew install vim --with-python3`.
 **How to get Vim with Python 3.6?**
 On Ubuntu 17.10 Vim comes with Python 3.6 by default.
 On macOS with Homebrew run: `brew install vim --with-python3`.


@@ -653,6 +666,10 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 ### 18.5b1 (unreleased)
 
 
 ### 18.5b1 (unreleased)
 

+* 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)
 
 * Python grammar pickle caches are stored with the formatting caches, making
   *Black* work in environments where site-packages is not user-writable (#192)
 


@@ -666,7 +683,8 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md).
 
 * fixed unstable formatting when inline comments were moved around in
   a trailer that was omitted from line splitting on a large expression
 
 * fixed unstable formatting when inline comments were moved around in
   a trailer that was omitted from line splitting on a large expression

-  (#238) 
+  (#238)
+

 
 ### 18.5b0
 
 
 ### 18.5b0