.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "" "1" "2021-10-10" "21.4b2" "uncompromising Python code formatter"
.SH NAME
black \- uncompromising Python code formatter
.SH SUMMARY
.sp
\fBblack\fP 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.
.SH USAGE
.sp
black [OPTIONS] [SRC]...
.SH COMMON OPTIONS
.INDENT 0.0
.TP
.B Options:
.INDENT 7.0
.TP
.BI \-c\fP,\fB  \-\-code \ TEXT
Format the code passed in as a string.
.TP
.BI \-l\fP,\fB  \-\-line\-length \ INTEGER
How many characters per line to allow.
[default: 88]
.UNINDENT
.INDENT 7.0
.TP
.B \-t, \-\-target\-version [py27|py33|py34|py35|py36|py37|py38|py39]
Python versions that should be supported by
Black\(aqs output. [default: per\-file auto\-
detection]
.UNINDENT
.INDENT 7.0
.TP
.B  \-\-pyi
Format all input files like typing stubs
regardless of file extension (useful when
piping source on standard input).
.TP
.B  \-S\fP,\fB  \-\-skip\-string\-normalization
Don\(aqt normalize string quotes or prefixes.
.TP
.B  \-C\fP,\fB  \-\-skip\-magic\-trailing\-comma
Don\(aqt use trailing commas as a reason to
split lines.
.TP
.B  \-\-check
Don\(aqt 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.
.TP
.B  \-\-diff
Don\(aqt write the files back, just output a
diff for each file on stdout.
.UNINDENT
.INDENT 7.0
.TP
.B \-\-color / \-\-no\-color            Show colored diff. Only applies when
\fI\-\-diff\fP is given.
.TP
.B \-\-fast / \-\-safe                 If \-\-fast given, skip temporary sanity
checks. [default: \-\-safe]
.UNINDENT
.INDENT 7.0
.TP
.BI \-\-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?$]
.TP
.BI \-\-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)/]
.TP
.BI \-\-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)
.TP
.BI \-\-force\-exclude \ TEXT
Like \-\-exclude, but files and directories
matching this regex will be excluded even
when they are passed explicitly as
arguments.
.TP
.BI \-\-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.
.TP
.B  \-q\fP,\fB  \-\-quiet
Don\(aqt emit non\-error messages to stderr.
Errors are still emitted, silence those with
2>/dev/null.
.TP
.B  \-v\fP,\fB  \-\-verbose
Also emit messages to stderr about files
that were not changed or were ignored due to
\-\-exclude=.
.TP
.B  \-\-version
Show the version and exit.
.TP
.BI \-\-config \ FILE
Read configuration from PATH.
.TP
.B  \-h\fP,\fB  \-\-help
Show this message and exit.
.UNINDENT
.UNINDENT
.SH COPYRIGHT
2018 Łukasz Langa
.\" Generated by docutils manpage writer.
.