fix: additional newline added to docstring when the previous line length is less than the line length limit minus 1

CHANGES.md

@@ -15,6 +15,8 @@
 <!-- Changes that affect Black's preview style -->
 
 - Consistently add trailing comma on typed parameters (#4164)
+- Checking for newline before adding one on docstring that is almost at the line limit
+  (#4185)
 
 ### Configuration
 

src/black/linegen.py

@@ -477,13 +477,15 @@ def visit_STRING(self, leaf: Leaf) -> Iterator[Line]:
                 last_line_length = len(lines[-1]) if docstring else 0
 
                 # If adding closing quotes would cause the last line to exceed
-                # the maximum line length then put a line break before the
-                # closing quotes
+                # the maximum line length, and the closing quote is not
+                # prefixed by a newline then put a line break before
+                # the closing quotes
                 if (
                     len(lines) > 1
                     and last_line_length + quote_len > self.mode.line_length
                     and len(indent) + quote_len <= self.mode.line_length
                     and not has_trailing_backslash
+                    and not leaf.value[-4] == "\n"
                 ):
                     leaf.value = prefix + quote + docstring + "\n" + indent + quote
                 else:

tests/data/cases/docstring_newline_preview.py

@@ -0,0 +1,4 @@
+# flags: --preview
+"""
+87 characters ............................................................................
+"""