From eb8015a1922c8edd6f51cc56b10f97f60f83e2ec Mon Sep 17 00:00:00 2001
From: stets <stetsblake@gmail.com>
Date: Wed, 30 Oct 2019 21:29:02 -0400
Subject: [PATCH] black: add page (#3506)

---
 pages/common/black.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 pages/common/black.md

diff --git a/pages/common/black.md b/pages/common/black.md
new file mode 100644
index 000000000..17469017e
--- /dev/null
+++ b/pages/common/black.md
@@ -0,0 +1,24 @@
+# black
+
+> A Python auto code formatter.
+> More information: <https://github.com/psf/black>.
+
+- Auto-format a file or entire directory:
+
+`black {{path/to/file_or_directory}}`
+
+- Format the code passed in as a string:
+
+`black -c {{path/to/file_or_directory}}`
+
+- Output a diff for each file on stdout:
+
+`black --diff {{path/to/file_or_directory}}`
+
+- Return the status without writing the files back:
+
+`black --check {{path/to/file_or_directory}}`
+
+- Auto-format a file or directory emitting exclusively error messages to stderr:
+
+`black --quiet {{path/to/file_or_directory}}`