style: apply ruff formatting and add post-generation formatting

- Run ruff format on all files to ensure consistent code style
- Run ruff check --fix to remove unused imports
- Sort imports with ruff check --select I --fix
- Update Makefile to run ruff format after code generation
- This ensures generated files are always properly formatted

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Mazyod

Makefile

@@ -50,6 +50,9 @@ generate-pyright-schema:
 generate-types: ## Generate LSP type definitions
 	echo "Generating LSP type definitions..."
 	uv run python -m assets.scripts.generate
+	echo "Formatting generated files..."
+	uvx ruff format lsp_types/types.py lsp_types/requests.py lsp_types/methods.py
+	uvx ruff check lsp_types/types.py lsp_types/requests.py lsp_types/methods.py --fix --silent || true
 	echo "Done."
 
 generate-latest-types: download-schemas generate-lsp-schema generate-pyright-schema generate-types ## Download latest LSP schemas and generate type definitions

assets/scripts/generate.py

@@ -9,8 +9,11 @@
 from .utils.generate_requests import generate_requests
 from .utils.generate_structures import generate_structures
 from .utils.generate_type_aliases import generate_type_aliases
-from .utils.helpers import (get_new_literal_structures, indentation,
-                            reset_new_literal_structures)
+from .utils.helpers import (
+    get_new_literal_structures,
+    indentation,
+    reset_new_literal_structures,
+)
 
 
 def generate_python_types(lsp_json: MetaModel, output: Path):

assets/scripts/utils/generate_methods.py

@@ -1,7 +1,7 @@
 import re
 from pathlib import Path
 
-from ..lsp_schema import MetaModel, Notification, Request
+from ..lsp_schema import MetaModel
 
 
 def method_to_enum_name(method: str) -> str:

assets/scripts/utils/generate_structures.py

@@ -1,58 +1,84 @@
 from ..lsp_schema import Structure
-from .helpers import (FormattedProperty, StructureKind,
-                      format_class_properties, format_comment,
-                      format_dict_properties, get_formatted_properties,
-                      has_invalid_property_name, indentation)
+from .helpers import (
+    FormattedProperty,
+    StructureKind,
+    format_class_properties,
+    format_comment,
+    format_dict_properties,
+    get_formatted_properties,
+    has_invalid_property_name,
+    indentation,
+)
 
 
 def generate_structures(structures: list[Structure]) -> list[str]:
-
     def toString(structure: Structure) -> str:
         kind = StructureKind.Class
-        if has_invalid_property_name(structure['properties']):
+        if has_invalid_property_name(structure["properties"]):
             kind = StructureKind.Function
         return generate_structure(structure, structures, kind)
 
-    return [toString(structure) for structure in structures if not structure['name'].startswith('_')]
+    return [
+        toString(structure)
+        for structure in structures
+        if not structure["name"].startswith("_")
+    ]
 
 
-def get_additional_properties(for_structure: Structure, structures: list[Structure], structure_kind: StructureKind) -> list[FormattedProperty]:
-    """Returns properties from extended and mixin types. """
+def get_additional_properties(
+    for_structure: Structure, structures: list[Structure], structure_kind: StructureKind
+) -> list[FormattedProperty]:
+    """Returns properties from extended and mixin types."""
     result: list[FormattedProperty] = []
-    additional_structures = for_structure.get('extends') or []
-    additional_structures.extend(for_structure.get('mixins') or [])
+    additional_structures = for_structure.get("extends") or []
+    additional_structures.extend(for_structure.get("mixins") or [])
     for additional_structure in additional_structures:
-        if additional_structure['kind'] != 'reference':
-            raise Exception("Cannot generate extends. Currently only supports kind: 'reference', but received:", additional_structure['kind'])
-        structure = next(structure for structure in structures if structure["name"] == additional_structure['name'])
+        if additional_structure["kind"] != "reference":
+            raise Exception(
+                "Cannot generate extends. Currently only supports kind: 'reference', but received:",
+                additional_structure["kind"],
+            )
+        structure = next(
+            structure
+            for structure in structures
+            if structure["name"] == additional_structure["name"]
+        )
         if structure:
-            properties = get_formatted_properties(structure['properties'], structure['name'], structure_kind)
+            properties = get_formatted_properties(
+                structure["properties"], structure["name"], structure_kind
+            )
             result.extend(properties)
     return result
 
 
-def generate_structure(structure: Structure, structures: list[Structure], structure_kind: StructureKind) -> str:
+def generate_structure(
+    structure: Structure, structures: list[Structure], structure_kind: StructureKind
+) -> str:
     result = ""
-    symbol_name = structure['name']
-    properties = get_formatted_properties(structure['properties'], structure['name'], structure_kind)
-    additional_properties = get_additional_properties(structure, structures, structure_kind)
+    symbol_name = structure["name"]
+    properties = get_formatted_properties(
+        structure["properties"], structure["name"], structure_kind
+    )
+    additional_properties = get_additional_properties(
+        structure, structures, structure_kind
+    )
 
     # add extended properties
-    taken_property_names = [property['name'] for property in properties]
+    taken_property_names = [property["name"] for property in properties]
     for additional_property in additional_properties:
-        if additional_property['name'] not in taken_property_names:
+        if additional_property["name"] not in taken_property_names:
             properties.append(additional_property)
 
     if structure_kind == StructureKind.Function:
-        documentation = format_comment(structure.get('documentation'), '')
+        documentation = format_comment(structure.get("documentation"), "")
         result += f"{symbol_name} = TypedDict('{symbol_name}', "
         result += "{\n"
         result += f"{indentation}{format_dict_properties(properties)}\n"
         result += "})"
         if documentation:
-            result += f'\n{documentation}'
+            result += f"\n{documentation}"
     else:
-        documentation = format_comment(structure.get('documentation'), indentation)
+        documentation = format_comment(structure.get("documentation"), indentation)
         result += f"class {symbol_name}(TypedDict):\n"
         if documentation:
             result += f"{documentation}\n"

examples/pyrefly_circular_imports.py

@@ -30,14 +30,16 @@
 from tempfile import TemporaryDirectory
 from textwrap import dedent
 
-import lsp_types
 from rich.console import Console
 from rich.markdown import Markdown
+
+import lsp_types
 from lsp_types.pyrefly.backend import PyreflyBackend
 from lsp_types.pyright.backend import PyrightBackend
 
 console = Console()
 
+
 # Simple structured logging helpers
 def log_step(title: str) -> None:
     console.print(f"\n=== {title} ===")
@@ -50,6 +52,7 @@ def log_result(label: str, value) -> None:
     else:
         console.print(f"{label}: {value}")
 
+
 PKGB_B = dedent(
     """\
     from __future__ import annotations
@@ -108,10 +111,19 @@ def prepare_workspace(pkgb_dir: Path, pkgc_dir: Path) -> None:
     pkgc.joinpath("c.py").write_text(PKGC_C)
 
 
-async def run_backend(backend_name: str, backend, options_key: str, root: Path, external_pkgb: Path, external_pkgc: Path) -> None:
+async def run_backend(
+    backend_name: str,
+    backend,
+    options_key: str,
+    root: Path,
+    external_pkgb: Path,
+    external_pkgc: Path,
+) -> None:
     """Run the circular imports test for a specific backend."""
-    console.rule(f"[bold cyan]{backend_name.upper()} Backend[/bold cyan]", characters="=")
-    
+    console.rule(
+        f"[bold cyan]{backend_name.upper()} Backend[/bold cyan]", characters="="
+    )
+
     session = await lsp_types.Session.create(
         backend,
         base_path=root,
@@ -147,9 +159,11 @@ async def run_backend(backend_name: str, backend, options_key: str, root: Path,
 
 
 async def main() -> None:
-    with TemporaryDirectory(prefix="circular-root-") as tmp_root, TemporaryDirectory(
-        prefix="circular-pkgb-"
-    ) as tmp_pkgb, TemporaryDirectory(prefix="circular-pkgc-") as tmp_pkgc:
+    with (
+        TemporaryDirectory(prefix="circular-root-") as tmp_root,
+        TemporaryDirectory(prefix="circular-pkgb-") as tmp_pkgb,
+        TemporaryDirectory(prefix="circular-pkgc-") as tmp_pkgc,
+    ):
         root = Path(tmp_root)
         external_pkgb = Path(tmp_pkgb)
         external_pkgc = Path(tmp_pkgc)
@@ -160,12 +174,26 @@ async def main() -> None:
         console.print()
 
         # Run Pyrefly backend
-        await run_backend("pyrefly", PyreflyBackend(), "search_path", root, external_pkgb, external_pkgc)
-        
+        await run_backend(
+            "pyrefly",
+            PyreflyBackend(),
+            "search_path",
+            root,
+            external_pkgb,
+            external_pkgc,
+        )
+
         console.print("\n")
-        
+
         # Run Pyright backend
-        await run_backend("pyright", PyrightBackend(), "extraPaths", root, external_pkgb, external_pkgc)
+        await run_backend(
+            "pyright",
+            PyrightBackend(),
+            "extraPaths",
+            root,
+            external_pkgb,
+            external_pkgc,
+        )
 
 
 if __name__ == "__main__":

examples/pyrefly_diagnostics_completion.py

@@ -236,9 +236,7 @@ def rich_format(widget):
         render_diagnostics(diagnostics)
 
         user_print("[bold]Step 1.1:[/] Hover on compile_report in initial code")
-        hover_initial = await controller.hover(
-            "compile_report", label="Initial hover"
-        )
+        hover_initial = await controller.hover("compile_report", label="Initial hover")
         user_print(f"Hover (initial) received: {hover_initial is not None}")
 
         user_print("[bold]Step 1.2:[/] Semantic tokens snapshot (initial code)")
@@ -300,9 +298,7 @@ def rich_format(widget):
             )
 
         user_print("[bold]Step 5:[/] Second completion request (same cursor)")
-        completions_second = await controller.completion(
-            label="Completion request 2"
-        )
+        completions_second = await controller.completion(label="Completion request 2")
         if completions_second is None:
             user_print("[yellow]No completion items returned[/]")
         else:
@@ -312,9 +308,7 @@ def rich_format(widget):
                 else completions_second
             )
             top_labels = [item.get("label") for item in items[:3]]
-            user_print(
-                f"Completion count: {len(items)}; sample labels: {top_labels}"
-            )
+            user_print(f"Completion count: {len(items)}; sample labels: {top_labels}")
 
         user_print("[bold]Step 6:[/] Finish completion snippet and verify diagnostics")
         await controller.write_code(
@@ -355,19 +349,13 @@ def stress_helper_{idx}(seed: str) -> str:
             hover_loop = await controller.hover(
                 f"stress_helper_{idx}", label=f"Stress hover {loop_id}"
             )
-            user_print(
-                f"Hover (stress {loop_id}) received: {hover_loop is not None}"
-            )
+            user_print(f"Hover (stress {loop_id}) received: {hover_loop is not None}")
 
             tokens_loop = await controller.semantic_tokens(
                 label=f"Stress semantic tokens {loop_id}"
             )
-            token_count_loop = (
-                len(tokens_loop.get("data", [])) if tokens_loop else 0
-            )
-            user_print(
-                f"Semantic tokens (stress {loop_id}) count: {token_count_loop}"
-            )
+            token_count_loop = len(tokens_loop.get("data", [])) if tokens_loop else 0
+            user_print(f"Semantic tokens (stress {loop_id}) count: {token_count_loop}")
 
             await controller.write_code(
                 f"\nstress_completion_{idx} = current.",
@@ -446,9 +434,9 @@ async def main() -> None:
 
         # Run Pyrefly backend
         await run_backend("pyrefly", PyreflyBackend(), workspace)
-        
+
         console.print("\n\n")
-        
+
         # Run Pyright backend
         await run_backend("pyright", PyrightBackend(node_flags=["--prof"]), workspace)
 

lsp_types/__init__.py

@@ -1,10 +1,10 @@
+import importlib.metadata
+
 from . import methods  # noqa: F401
 from .requests import *  # noqa: F401, F403
 from .session import *  # noqa: F401, F403
 from .types import *  # noqa: F401, F403
 
-import importlib.metadata
-
 try:
     __version__ = importlib.metadata.version("lsp-types")
 except Exception:

lsp_types/methods.py

@@ -3,7 +3,6 @@
 # Generated code.
 # DO NOT EDIT.
 # LSP v3.17.0
-
 from enum import StrEnum