Apply ruff formatting to mdtests (#22935)

- Updated the `prek` hook to replace `blacken-docs` with ruff
- Added some formatting directives to preserve obvious intentional
formatting choices
- Made some choice edits to content for better readability with new format
- Formatted md tests and updated snapshots

Author: amyreese

.pre-commit-config.yaml

@@ -115,20 +115,23 @@ repos:
           )$
         priority: 1
 
-  # Priority 2: blacken-docs runs after markdownlint-fix (both modify markdown).
-  - repo: https://github.com/adamchainz/blacken-docs
-    rev: 1.20.0
+  # Priority 2: ruffen-docs runs after markdownlint-fix (both modify markdown).
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.1
     hooks:
-      - id: blacken-docs
-        language: python # means renovate will also update `additional_dependencies`
-        args: ["--pyi", "--line-length", "130"]
-        files: '^crates/.*/resources/mdtest/.*\.md'
-        exclude: |
-          (?x)^(
-            .*?invalid(_.+)*_syntax\.md
-          )$
-        additional_dependencies:
-          - black==26.1.0
+      - id: ruff-format
+        name: mdtest format
+        args:
+          [
+            "--preview",
+            "--line-length",
+            "130",
+            "--extension",
+            "py:pyi,python:pyi",
+          ]
+        types_or: [markdown]
+        files: '^crates/.*/resources/mdtest/.*\.md$'
+        pass_filenames: true
         priority: 2
 
   # `actionlint` hook, for verifying correct syntax in GitHub Actions workflows.

crates/ty_python_semantic/resources/mdtest/annotations/deferred.md

@@ -6,6 +6,7 @@
 
 ```pyi
 def get_foo() -> Foo: ...
+
 class Foo: ...
 ```
 
@@ -256,7 +257,6 @@ Forward references in class keyword arguments are allowed in stub files.
 
 ```pyi
 class Foo(metaclass=SomeMeta): ...
-
 class SomeMeta(type): ...
 ```
 

crates/ty_python_semantic/resources/mdtest/annotations/self.md

@@ -860,7 +860,7 @@ bound at `C.f`.
 from typing import Self
 from ty_extensions import generic_context
 
-class C[T]():
+class C[T]():  # fmt:skip
     def f(self: Self):
         def b(x: Self):
             reveal_type(x)  # revealed: Self@f

crates/ty_python_semantic/resources/mdtest/annotations/string.md

@@ -87,7 +87,7 @@ def f1(
     h: """int""",
     # error: [byte-string-type-annotation] "Type expressions cannot use bytes literal"
     i: "b'int'",
-):
+):  # fmt:skip
     reveal_type(a)  # revealed: Unknown
     reveal_type(b)  # revealed: Unknown
     reveal_type(c)  # revealed: Unknown
@@ -104,7 +104,7 @@ def f1(
 ```py
 from typing import Literal
 
-def f(v: Literal["a", r"b", b"c", "d" "e", "\N{LATIN SMALL LETTER F}", "\x67", """h"""]):
+def f(v: Literal["a", r"b", b"c", "d" "e", "\N{LATIN SMALL LETTER F}", "\x67", """h"""]):  # fmt:skip
     reveal_type(v)  # revealed: Literal["a", "b", "de", "f", "g", "h", b"c"]
 ```
 

crates/ty_python_semantic/resources/mdtest/assignment/annotations.md

@@ -399,7 +399,7 @@ reveal_type(x)  # revealed: Foo
 
 ```pyi
 x: int = 1
-reveal_type(x) # revealed: Literal[1]
+reveal_type(x)  # revealed: Literal[1]
 ```
 
 ## Annotations influence generic call inference

crates/ty_python_semantic/resources/mdtest/assignment/augmented.md

@@ -60,6 +60,7 @@ def _(flag: bool):
         if flag:
             def __iadd__(self, other: int) -> str:
                 return "Hello, world!"
+
         else:
             def __iadd__(self, other: int) -> int:
                 return 42

crates/ty_python_semantic/resources/mdtest/call/abstract_method.md

@@ -225,7 +225,6 @@ class Foo(ABC):
     @classmethod
     @abstractmethod
     def classmethod(cls) -> int: ...
-
     @staticmethod
     @abstractmethod
     def staticmethod() -> int: ...

crates/ty_python_semantic/resources/mdtest/call/constructor.md

@@ -114,6 +114,7 @@ def _(flag: bool) -> None:
     class Foo:
         if flag:
             def __new__(cls, x: int): ...
+
         else:
             def __new__(cls, x: int, y: int = 1): ...
 
@@ -320,6 +321,7 @@ def _(flag: bool) -> None:
     class Foo:
         if flag:
             def __init__(self, x: int): ...
+
         else:
             def __init__(self, x: int, y: int = 1): ...
 

crates/ty_python_semantic/resources/mdtest/call/dunder.md

@@ -220,6 +220,7 @@ def _(flag: bool):
         if flag:
             def __getitem__(self, key: int) -> str:
                 return str(key)
+
         else:
             def __getitem__(self, key: int) -> bytes:
                 return bytes()

crates/ty_python_semantic/resources/mdtest/call/overloads.md

@@ -428,7 +428,6 @@ class SomeEnum(Enum):
     B = 2
     C = 3
 
-
 class A: ...
 class B: ...
 class C: ...
@@ -1494,19 +1493,16 @@ class B: ...
 def f1(x: int) -> A: ...
 @overload
 def f1(x: Any, y: Any) -> A: ...
-
 @overload
 def f2(x: int) -> A: ...
 @overload
 def f2(x: Any, y: Any) -> B: ...
-
 @overload
 def f3(x: int) -> A: ...
 @overload
 def f3(x: Any, y: Any) -> A: ...
 @overload
 def f3(x: Any, y: Any, *, z: str) -> B: ...
-
 @overload
 def f4(x: int) -> A: ...
 @overload
@@ -1550,14 +1546,12 @@ def f1(x1: T1, x2: T2, /) -> tuple[T1, T2]: ...
 def f1(x1: T1, x2: T2, x3: T3, /) -> tuple[T1, T2, T3]: ...
 @overload
 def f1(*args: Any) -> tuple[Any, ...]: ...
-
 @overload
 def f2(x1: T1) -> tuple[T1]: ...
 @overload
 def f2(x1: T1, x2: T2) -> tuple[T1, T2]: ...
 @overload
 def f2(*args: Any, **kwargs: Any) -> tuple[Any, ...]: ...
-
 @overload
 def f3(x: T1) -> tuple[T1]: ...
 @overload