noir 19.3b0

然后运行预提交安装即可开始安装。

避免在钩子中使用args。相反，存储必要的配置 在pyproject.toml中，让编辑器和命令行使用black all 对你的项目要始终如一。请参见black自己的pyproject.toml 例如。

如果您已经在使用Python3.7，请切换语言版本 因此。最后，stable是固定到最新的 在PYPI上释放。如果您希望在master上运行，这也是一个选项。

忽略未修改的文件

黑色会记住已格式化的文件，除非使用了--diff标记或 代码通过标准输入传递。此信息按用户存储。确切的 文件的位置取决于黑色版本和黑色所在的系统 运行。文件不可移植。通用操作系统上的标准位置 是：

• 窗口：c:\\用户\<；用户名>；\appdata\local\black\black\cache\<；版本>；\cache。<；行长度>；<；文件模式>；.pickle
• macos:/users/<；username>；/库/缓存/black/<；版本>；/缓存。<；行长度>；<；文件模式>；.pickle
• Linux:/home/<；用户名>；/.cache/black/<；版本>；/缓存。<；行长度>；<；文件模式>；.pickle

文件模式是一个int标志，用于确定文件是否仅格式化为3.6+， 以及是否省略了字符串规范化。

要覆盖这些文件在MacOS或Linux上的位置，请设置环境变量 xdg_cache_home到您的首选位置。例如，如果要将缓存放入 运行black的目录，设置xdg_cache_home=.cache。黑色将 将以上文件写入.cache/black/<；version>；/

使用人

以下值得注意的开源项目信任 一致的代码风格：pytest，tox，pyramid，django channels，hypothesis， attrs、sqlalchemy、poetry、pypa应用程序（warehouse、pipenv、virtualenv） 每个数据狗代理集成。

我们是不是失踪了有人吗？告诉我们。

推荐信

尘土飞扬的菲利普斯，编写器：

黑色是固执己见的，所以你不必这样。

hynek schlawack，创建attrs，核心 twisted和cpython的开发者：

我只想要一个不烂的自动格式化程序！

carl meyer，django核心开发人员：

至少名字不错。

kenneth reitz，请求的创建者 以及pipenv：

这大大改进了代码的格式。非常感谢！

展示您的风格

使用项目自述文件中的徽章。md:

black [OPTIONS] [SRC]...

Options:
  -c, --code TEXT                 Format the code passed in as a string.
  -l, --line-length INTEGER       How many characters per line to allow.
                                  [default: 79]
  -t, --target-version [py27|py33|py34|py35|py36|py37|py38]
                                  Python versions that should be supported by
                                  Black's output. [default: per-file auto-
                                  detection]
  --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. Deprecated; use
                                  --target-version instead. [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.
  --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.
  --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: /(\.eggs|\.git|\.hg|\.mypy
                                  _cache|\.nox|\.tox|\.venv|_build|buck-
                                  out|build|dist)/]
  -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 PATH                   Read configuration from PATH.
  -h, --help                      Show this message and exit.

使用自述文件中的徽章。rst:

black [OPTIONS] [SRC]...

Options:
  -c, --code TEXT                 Format the code passed in as a string.
  -l, --line-length INTEGER       How many characters per line to allow.
                                  [default: 79]
  -t, --target-version [py27|py33|py34|py35|py36|py37|py38]
                                  Python versions that should be supported by
                                  Black's output. [default: per-file auto-
                                  detection]
  --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. Deprecated; use
                                  --target-version instead. [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.
  --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.
  --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: /(\.eggs|\.git|\.hg|\.mypy
                                  _cache|\.nox|\.tox|\.venv|_build|buck-
                                  out|build|dist)/]
  -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 PATH                   Read configuration from PATH.
  -h, --help                      Show this message and exit.

看起来是这样的：

许可证

麻省理工学院< /P>

有助于黑色

就灵感而言，黑色与gofmt一样可配置。 这是故意的。

错误报告和修复总是受欢迎的！但是，在你建议 新功能或配置旋钮，问自己为什么要。如果它 能够更好地与某些工作流集成，修复不一致性， 加快速度，等等-去吧！另一方面，如果 答案是"因为我不喜欢特定的格式"，那么你就不是 准备好拥抱黑色了。这种变化不大可能被接受。 你仍然可以尝试，但要做好失望的准备。

有关详细信息，请参见贡献

更改日志

未发布