NAME

       black - uncompromising Python code formatter

SUMMARY

       black is the uncompromising Python code formatter. By using it, you  agree to cede control
       over minutiae of hand-formatting. In return,  Black  gives  you  speed,  determinism,  and
       freedom  from  pycodestyle  nagging about formatting. You will save time and mental energy
       for more important matters.

USAGE

       black [OPTIONS] [SRC]...

COMMON OPTIONS

       Options:

              -c,--code TEXT
                     Format the code passed in as a string.

              -l,--line-length INTEGER
                     How many characters per line to allow.  [default: 88]

              -t, --target-version [py27|py33|py34|py35|py36|py37|py38|py39]
                     Python versions that  should  be  supported  by  Black's  output.  [default:
                     per-file auto- detection]

              --pyi  Format  all  input  files  like  typing  stubs  regardless of file extension
                     (useful when piping source on standard input).

              -S, --skip-string-normalization
                     Don't normalize string quotes or prefixes.

              -C, --skip-magic-trailing-comma
                     Don't use trailing commas as a reason to split lines.

              --check
                     Don't write the files back, just return the status.   Return  code  0  means
                     nothing  would change.  Return code 1 means some files would be reformatted.
                     Return code 123 means there was an internal error.

              --diff Don't write the files back, just output a diff for each file on stdout.

              --color / --no-color Show colored diff. Only applies when
                     --diff is given.

              --fast / --safe If --fast given, skip temporary sanity
                     checks. [default: --safe]

              --include TEXT
                     A regular expression that matches  files  and  directories  that  should  be
                     included on recursive searches.  An empty value means all files are included
                     regardless of  the  name.   Use  forward  slashes  for  directories  on  all
                     platforms  (Windows,  too).   Exclusions  are  calculated  first, inclusions
                     later.  [default: .pyi?$]

              --exclude TEXT
                     A regular expression that matches  files  and  directories  that  should  be
                     excluded on recursive searches.  An empty value means no paths are excluded.
                     Use forward  slashes  for  directories  on  all  platforms  (Windows,  too).
                     Exclusions    are    calculated    first,   inclusions   later.    [default:
                     /(.git|.hg|.mypy_cache| .tox|.venv|_build|buck-out|build|dist)/]

              --extend-exclude TEXT
                     Like --exclude, but adds additional files and  directories  on  top  of  the
                     excluded ones.  (Useful if you simply want to add to the default)

              --force-exclude TEXT
                     Like  --exclude,  but  files  and  directories  matching  this regex will be
                     excluded even when they are passed explicitly as arguments.

              --stdin-filename TEXT
                     The name of the file when passing it through  stdin.  Useful  to  make  sure
                     Black will respect --force-exclude option on some editors that rely on using
                     stdin.

              -q, --quiet
                     Don't emit non-error messages to stderr.  Errors are still emitted,  silence
                     those with 2>/dev/null.

              -v, --verbose
                     Also  emit  messages  to  stderr  about  files that were not changed or were
                     ignored due to --exclude=.

              --version
                     Show the version and exit.

              --config FILE
                     Read configuration from PATH.

              -h, --help
                     Show this message and exit.

COPYRIGHT

       2018 Łukasz Langa