debt: Migrate Python formatter from black to ruff

- Faster tooling
- Better handling with linting rule conflicts
- Enables extending to hundreds of linting rules
- Aligns with pytest-bdd (pytest-dev/pytest-bdd#758)

Author: kieran-ryan

.pre-commit-config.yaml

@@ -1,11 +1,10 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
-  # Using this mirror lets us use mypyc-compiled black, which is about 2x faster
-  - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: c53240a7f974b3707e13eac6710542cc96a2d61a  # frozen: 24.10.0
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: 89c421dff2e1026ba12cdb9ebd731f4a83aa8021  # frozen: v0.8.6
     hooks:
-      - id: black
+      - id: ruff-format
         files: "^python/"
   - repo: https://github.com/asottile/pyupgrade
     rev: 19364aa1b2ac289ce75e6bbe93994f7b4b9425f6  # frozen: v3.19.0

python/gherkin/ast_node.py

@@ -9,7 +9,6 @@
 
 
 class AstNode:
-
     def __init__(self, rule_type: str) -> None:
         self.rule_type = rule_type
         self._sub_items: defaultdict[str, list[object]] = defaultdict(list)

python/gherkin/dialect.py

@@ -33,7 +33,6 @@
 
 
 class Dialect:
-
     @classmethod
     def for_name(cls, name: str) -> Self | None:
         return cls(DIALECTS[name]) if name in DIALECTS else None

python/gherkin/token_matcher_markdown.py

@@ -12,7 +12,6 @@
 
 
 class GherkinInMarkdownTokenMatcher(TokenMatcher):
-
     def __init__(self, dialect_name: str = "en") -> None:
         super().__init__(dialect_name)
 
@@ -21,7 +20,6 @@ def reset(self) -> None:
         self.matched_feature_line = False
 
     def match_FeatureLine(self, token: Token) -> bool:
-
         if self.matched_feature_line:
             self._set_token_matched(token, None)
 
@@ -122,7 +120,6 @@ def match_Comment(self, token: Token) -> bool:
         return self._set_token_matched(token, None, False)
 
     def match_Empty(self, token: Token) -> bool:
-
         result = False
         if token.line.is_empty():
             result = True

python/pyproject.toml

@@ -44,12 +44,12 @@ gherkin = ["*.json"]
 disallow_untyped_defs = true
 packages = ["gherkin"]
 
-[tool.black]
-target-version = ["py39", "py310", "py311", "py312", "py313"]
+[tool.ruff]
+target-version = "py39"
 
 [tool.flake8]
-# E1: indentation: already covered by `black`
-# E2: whitespace: already covered by `black`
-# E3: blank line: already covered by `black`
-# E501: line length: already covered by `black`
+# E1: indentation: already covered by `ruff`
+# E2: whitespace: already covered by `ruff`
+# E3: blank line: already covered by `ruff`
+# E501: line length: already covered by `ruff`
 extend-ignore = "E1,E2,E3,E501"