Updated black, but be liberal in the dependency setting

Projects implementing docstrfmt may already be relying
on the black formatter, but we should try as much as
possible to not interfere with their dependency.

docstrfmt/docstrfmt.py

@@ -196,9 +196,11 @@ def _format_children(
         self, node: docutils.nodes.Node, context
     ) -> Iterator[Iterator[str]]:
         return (
-            self.manager.perform_format(child, context)
-            if index == 0
-            else self.manager.perform_format(child, context.wrap_first_at(0))
+            (
+                self.manager.perform_format(child, context)
+                if index == 0
+                else self.manager.perform_format(child, context.wrap_first_at(0))
+            )
             for index, child in enumerate(node.children)
         )
 
@@ -893,8 +895,8 @@ def reference(
                 None, chain(self._format_children(node, context)), context, node.line
             )
         )
-        anonymous_suffix: Callable[[bool], str] = (
-            lambda anonymous: "__" if anonymous else "_"
+        anonymous_suffix: Callable[[bool], str] = lambda anonymous: (
+            "__" if anonymous else "_"
         )
         attributes = node.attributes  # type: ignore
         children = node.children  # type: ignore

docstrfmt/main.py

@@ -326,8 +326,8 @@ def _format_file(
         raw_output = True
     reporter.print(f"Checking {file}", 2)
     misformatted = False
-    with nullcontext(sys.stdin) if file.name == "-" else open(
-        file, encoding="utf-8"
+    with (
+        nullcontext(sys.stdin) if file.name == "-" else open(file, encoding="utf-8")
     ) as f:
         input_string = f.read()
         newline = getattr(f, "newlines", None)

setup.py

@@ -51,7 +51,7 @@
     },
     extras_require=extras_requires,
     install_requires=[
-        "black==23.*",
+        "black>=23.0.0,<=25.0.0",
         "click==8.*",
         "docutils==0.20.*",
         "libcst==1.*",

tests/__init__.py

@@ -1,4 +1,5 @@
 """docstrfmt Test Suite."""
+
 import black
 import docutils.nodes
 

tests/conftest.py

@@ -1,4 +1,5 @@
 """Prepare py.test."""
+
 import os
 import shutil
 

tests/test_files/error_files/py_file_error_bad_codeblock.py

@@ -1,6 +1,5 @@
 """This is an example python file"""
 
-
 test = "value"
 
 

tests/test_files/error_files/py_file_error_empty_returns.py

@@ -1,6 +1,5 @@
 """This is an example python file"""
 
-
 test = "value"
 
 

tests/test_files/error_files/py_file_error_invalid_rst.py

@@ -1,6 +1,5 @@
 """This is an example python file"""
 
-
 test = "value"
 
 

tests/test_files/py_file.py

@@ -1,6 +1,5 @@
 """This is an example python file"""
 
-
 test = "value"