new script to blacken docstrings in bindings

Author: jepler

tools/black_bindings.py

@@ -0,0 +1,42 @@
+#!/usr/bin/python3
+import re
+import subprocess
+import sys
+
+
+def transform(s):
+    lines = s.rstrip().split("\n")
+    lines = [line.removeprefix("//| ").removeprefix("//|") for line in lines]
+    s = "\n".join(lines) + "\n"
+    if s[0] == " ":
+        prefix = "if 0:\n"
+    else:
+        prefix = ""
+    s = prefix + s
+    result = subprocess.run(
+        ["black", "-q", "--pyi", "-"],
+        input=s,
+        check=True,
+        stdout=subprocess.PIPE,
+        encoding="utf-8",
+    )
+    result = result.stdout[len(prefix) :]
+    result = (result.rstrip() + "\n").split("\n")
+    return "\n".join("//| " + line if line else "//|" for line in result) + "\n"
+
+
+for fn in sys.argv[1:]:
+    with open(fn, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    old_end = 0
+
+    newcontent = []
+    for m in re.finditer("(?m)((?:^//\|.*\n)+)", content):
+        newcontent.append(content[old_end : m.start()])
+        newcontent.append(transform(m.group()))
+        old_end = m.end()
+    newcontent.append(content[old_end:])
+
+    with open(fn, "w", encoding="utf-8") as f:
+        f.write("".join(newcontent))