From: Łukasz Langa <lukasz@langa.pl>
Date: Wed, 4 Mar 2020 22:08:57 +0000 (+0100)
Subject: Document how to use format_str()
X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/0626c89a5a0be5cca7d90bc01428ccf0ffe0f402?ds=inline

Document how to use format_str()

Closes #1064
---

diff --git a/black.py b/black.py
index b7cacf7..5209681 100644
--- a/black.py
+++ b/black.py
@@ -746,7 +746,30 @@ def format_str(src_contents: str, *, mode: FileMode) -> FileContent:
     """Reformat a string and return new contents.
 
     `mode` determines formatting options, such as how many characters per line are
-    allowed.
+    allowed.  Example:
+
+    >>> import black
+    >>> print(black.format_str("def f(arg:str='')->None:...", mode=FileMode()))
+    def f(arg: str = "") -> None:
+        ...
+
+    A more complex example:
+    >>> print(
+    ...   black.format_str(
+    ...     "def f(arg:str='')->None: hey",
+    ...     mode=black.FileMode(
+    ...       target_versions={black.TargetVersion.PY36},
+    ...       line_length=10,
+    ...       string_normalization=False,
+    ...       is_pyi=False,
+    ...     ),
+    ...   ),
+    ... )
+    def f(
+        arg: str = '',
+    ) -> None:
+        hey
+
     """
     src_node = lib2to3_parse(src_contents.lstrip(), mode.target_versions)
     dst_contents = []