From e808e61db8c7a8f9c7fd4b2fff2281141f6b2517 Mon Sep 17 00:00:00 2001
From: Yilei Yang <yileiyang@google.com>
Date: Mon, 6 Nov 2023 14:30:04 -0800
Subject: [PATCH] Preview: Keep requiring two empty lines between module-level
 docstring and first function or class definition (#4028)

Fixes #4027.
---
 CHANGES.md                                            |  2 ++
 src/black/lines.py                                    |  1 +
 .../data/cases/module_docstring_followed_by_class.py  | 11 +++++++++++
 .../cases/module_docstring_followed_by_function.py    | 11 +++++++++++
 4 files changed, 25 insertions(+)
 create mode 100644 tests/data/cases/module_docstring_followed_by_class.py
 create mode 100644 tests/data/cases/module_docstring_followed_by_function.py

diff --git a/CHANGES.md b/CHANGES.md
index 97084a2bfc..a68f87bfc1 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -19,6 +19,8 @@
   indented less (#3964)
 - Multiline list and dict unpacking as the sole argument to a function is now also
   indented less (#3992)
+- Keep requiring two empty lines between module-level docstring and first function or
+  class definition. (#4028)
 
 ### Configuration
 
diff --git a/src/black/lines.py b/src/black/lines.py
index a73c429e3d..23c1a93d3d 100644
--- a/src/black/lines.py
+++ b/src/black/lines.py
@@ -578,6 +578,7 @@ def maybe_empty_lines(self, current_line: Line) -> LinesBlock:
             and self.previous_block.previous_block is None
             and len(self.previous_block.original_line.leaves) == 1
             and self.previous_block.original_line.is_triple_quoted_string
+            and not (current_line.is_class or current_line.is_def)
         ):
             before = 1
 
diff --git a/tests/data/cases/module_docstring_followed_by_class.py b/tests/data/cases/module_docstring_followed_by_class.py
new file mode 100644
index 0000000000..6fdbfc8c24
--- /dev/null
+++ b/tests/data/cases/module_docstring_followed_by_class.py
@@ -0,0 +1,11 @@
+# flags: --preview
+"""Two blank lines between module docstring and a class."""
+class MyClass:
+    pass
+
+# output
+"""Two blank lines between module docstring and a class."""
+
+
+class MyClass:
+    pass
diff --git a/tests/data/cases/module_docstring_followed_by_function.py b/tests/data/cases/module_docstring_followed_by_function.py
new file mode 100644
index 0000000000..5913a59e1f
--- /dev/null
+++ b/tests/data/cases/module_docstring_followed_by_function.py
@@ -0,0 +1,11 @@
+# flags: --preview
+"""Two blank lines between module docstring and a function def."""
+def function():
+    pass
+
+# output
+"""Two blank lines between module docstring and a function def."""
+
+
+def function():
+    pass