Implement module formatting using JoinNodesBuilder (#4808)

* Implement module formatting using JoinNodesBuilder

This uses JoinNodesBuilder to implement module formatting for #4800

See the snapshots for the changed behaviour. See one PR up for a CLI that i used to verify the trailing new line behaviour

crates/ruff_python_formatter/src/module/mod_module.rs

@@ -1,18 +1,21 @@
-use crate::AsFormat;
-use crate::{FormatNodeRule, PyFormatter};
+use crate::statement::suite::SuiteLevel;
+use crate::{AsFormat, FormatNodeRule, PyFormatter};
 use ruff_formatter::prelude::hard_line_break;
 use ruff_formatter::{write, Buffer, FormatResult};
-
 use rustpython_parser::ast::ModModule;
 
 #[derive(Default)]
 pub struct FormatModModule;
 
 impl FormatNodeRule<ModModule> for FormatModModule {
  fn fmt_fields(&self, item: &ModModule, f: &mut PyFormatter) -> FormatResult<()> {
- for stmt in &item.body {
- write!(f, [stmt.format(), hard_line_break()])?;
- }
- Ok(())
+ write!(
+ f,
+ [
+ item.body.format().with_options(SuiteLevel::TopLevel),
+ // Trailing newline at the end of the file
+ hard_line_break()
+ ]
+ )
  }
 }

crates/ruff_python_formatter/src/snapshots/ruff_python_formatter__tests__black_test__attribute_access_on_number_literals_py.snap

@@ -35,7 +35,7 @@ y = 100(no)
 ```diff
 --- Black
 +++ Ruff
-@@ -1,22 +1,20 @@
+@@ -1,21 +1,21 @@
 -x = (123456789).bit_count()
 +x = 123456789 .bit_count()
  x = (123456).__abs__()
@@ -53,8 +53,6 @@ y = 100(no)
 -x = 0o777.real
 -x = (0.000000006).hex()
 -x = -100.0000j
--
--if (10).real:
 +x = .1.is_integer()
 +x = 1. .imag
 +x = 1E+1.imag
@@ -69,11 +67,12 @@ y = 100(no)
 +x = 0O777 .real
 +x = 0.000000006 .hex()
 +x = -100.0000J
+ 
+-if (10).real:
 +if 10 .real:
  ...
--
+ 
  y = 100[no]
- y = 100(no)
 ```
 
 ## Ruff Output
@@ -95,8 +94,10 @@ x = 0B1011 .conjugate()
 x = 0O777 .real
 x = 0.000000006 .hex()
 x = -100.0000J
+
 if 10 .real:
  ...
+
 y = 100[no]
 y = 100(no)
 ```

crates/ruff_python_formatter/src/snapshots/ruff_python_formatter__tests__black_test__class_blank_parentheses_py.snap

@@ -36,37 +36,35 @@ class NormalClass (
 ```diff
 --- Black
 +++ Ruff
-@@ -1,30 +1,21 @@
+@@ -1,16 +1,16 @@
 -class SimpleClassWithBlankParentheses:
 +class SimpleClassWithBlankParentheses():
  pass
--
--
+ 
+ 
 -class ClassWithSpaceParentheses:
 +class ClassWithSpaceParentheses ( ):
  first_test_data = 90
  second_test_data = 100
 -
  def test_func(self):
  return None
--
--
+ 
+ 
  class ClassWithEmptyFunc(object):
 +
  def func_with_blank_parentheses():
  return 5
--
--
- def public_func_with_blank_parentheses():
- return None
--
--
+ 
+@@ -20,11 +20,12 @@
+ 
+ 
  def class_under_the_func_with_blank_parentheses():
 - class InsideFunc:
 + class InsideFunc():
  pass
--
--
+ 
+ 
 -class NormalClass:
 +class NormalClass (
 +):
@@ -80,20 +78,30 @@ class NormalClass (
 ```py
 class SimpleClassWithBlankParentheses():
  pass
+
+
 class ClassWithSpaceParentheses ( ):
  first_test_data = 90
  second_test_data = 100
  def test_func(self):
  return None
+
+
 class ClassWithEmptyFunc(object):
 
  def func_with_blank_parentheses():
  return 5
+
+
 def public_func_with_blank_parentheses():
  return None
+
+
 def class_under_the_func_with_blank_parentheses():
  class InsideFunc():
  pass
+
+
 class NormalClass (
 ):
  def func_for_testing(self, first, second):