Use PEP 570 syntax in third party stubs (#11554)

stubs/gdb/gdb/__init__.pyi

@@ -26,24 +26,24 @@ STDLOG: int
 def execute(command: str, from_tty: bool = ..., to_string: bool = ...) -> str | None: ...
 def breakpoints() -> Sequence[Breakpoint]: ...
 def rbreak(regex: str, minsyms: bool = ..., throttle: int = ..., symtabs: Iterator[Symtab] = ...) -> list[Breakpoint]: ...
-def parameter(__parameter: str) -> bool | int | str | None: ...
+def parameter(parameter: str, /) -> bool | int | str | None: ...
 def set_parameter(name: str, value: bool | int | str | None) -> None: ...
 def with_parameter(name: str, value: bool | int | str | None) -> AbstractContextManager[None]: ...
-def history(__number: int) -> Value: ...
-def add_history(__value: Value) -> int: ...
+def history(number: int, /) -> Value: ...
+def add_history(value: Value, /) -> int: ...
 def history_count() -> int: ...
-def convenience_variable(__name: str) -> Value | None: ...
-def set_convenience_variable(__name: str, __value: _ValueOrNative | None) -> None: ...
-def parse_and_eval(__expression: str) -> Value: ...
+def convenience_variable(name: str, /) -> Value | None: ...
+def set_convenience_variable(name: str, value: _ValueOrNative | None, /) -> None: ...
+def parse_and_eval(expression: str, /) -> Value: ...
 def find_pc_line(pc: int | Value) -> Symtab_and_line: ...
-def post_event(__event: Callable[[], object]) -> None: ...
+def post_event(event: Callable[[], object], /) -> None: ...
 def write(string: str, stream: int = ...) -> None: ...
 def flush(stream: int = ...) -> None: ...
 def target_charset() -> str: ...
 def target_wide_charset() -> str: ...
 def host_charset() -> str: ...
 def solib_name(addr: int) -> str | None: ...
-def decode_line(__expression: str = ...) -> tuple[str | None, tuple[Symtab_and_line, ...] | None]: ...
+def decode_line(expression: str = ..., /) -> tuple[str | None, tuple[Symtab_and_line, ...] | None]: ...
 def prompt_hook(current_prompt: str) -> str: ...
 def architecture_names() -> list[str]: ...
 def connections() -> list[TargetConnection]: ...
@@ -195,7 +195,7 @@ class _PrettyPrinter(Protocol):
 
 _PrettyPrinterLookupFunction: TypeAlias = Callable[[Value], _PrettyPrinter | None]
 
-def default_visualizer(__value: Value) -> _PrettyPrinter | None: ...
+def default_visualizer(value: Value, /) -> _PrettyPrinter | None: ...
 
 # Selecting Pretty-Printers
 
@@ -230,13 +230,13 @@ class _FrameDecorator(Protocol):
 
 @final
 class PendingFrame:
-    def read_register(self, __reg: str | RegisterDescriptor | int) -> Value: ...
-    def create_unwind_info(self, __frame_id: object) -> UnwindInfo: ...
+    def read_register(self, reg: str | RegisterDescriptor | int, /) -> Value: ...
+    def create_unwind_info(self, frame_id: object, /) -> UnwindInfo: ...
     def architecture(self) -> Architecture: ...
     def level(self) -> int: ...
 
 class UnwindInfo:
-    def add_saved_register(self, __reg: str | RegisterDescriptor | int, __value: Value) -> None: ...
+    def add_saved_register(self, reg: str | RegisterDescriptor | int, value: Value, /) -> None: ...
 
 class Unwinder:
     name: str
@@ -289,7 +289,7 @@ class InferiorThread:
 
 # Recordings
 
-def start_recording(__method: str = ..., __format: str = ...) -> Record: ...
+def start_recording(method: str = ..., format: str = ..., /) -> Record: ...
 def current_recording() -> Record | None: ...
 def stop_recording() -> None: ...
 
@@ -302,7 +302,7 @@ class Record:
     instruction_history: list[Instruction]
     function_call_history: list[RecordFunctionSegment]
 
-    def goto(self, __instruction: Instruction) -> None: ...
+    def goto(self, instruction: Instruction, /) -> None: ...
 
 class Instruction:
     pc: int
@@ -337,7 +337,7 @@ class Command:
     def invoke(self, argument: str, from_tty: bool) -> None: ...
     def complete(self, text: str, word: str) -> object: ...
 
-def string_to_argv(__argv: str) -> list[str]: ...
+def string_to_argv(argv: str, /) -> list[str]: ...
 
 COMMAND_NONE: int
 COMMAND_RUNNING: int
@@ -410,11 +410,11 @@ class Progspace:
     type_printers: list[gdb.types._TypePrinter]
     frame_filters: list[_FrameFilter]
 
-    def block_for_pc(self, __pc: int) -> Block | None: ...
-    def find_pc_line(self, __pc: int) -> Symtab_and_line: ...
+    def block_for_pc(self, pc: int, /) -> Block | None: ...
+    def find_pc_line(self, pc: int, /) -> Symtab_and_line: ...
     def is_valid(self) -> bool: ...
     def objfiles(self) -> Sequence[Objfile]: ...
-    def solib_name(self, __address: int) -> str | None: ...
+    def solib_name(self, address: int, /) -> str | None: ...
 
 # Objfiles
 
@@ -441,7 +441,7 @@ class Objfile:
 
 def selected_frame() -> Frame: ...
 def newest_frame() -> Frame: ...
-def frame_stop_reason_string(__code: int) -> str: ...
+def frame_stop_reason_string(code: int, /) -> str: ...
 def invalidate_cached_frames() -> None: ...
 
 NORMAL_FRAME: int
@@ -474,8 +474,8 @@ class Frame:
     def older(self) -> Frame | None: ...
     def newer(self) -> Frame | None: ...
     def find_sal(self) -> Symtab_and_line: ...
-    def read_register(self, __register: str | RegisterDescriptor | int) -> Value: ...
-    def read_var(self, __variable: str | Symbol, block: Block | None = ...) -> Value: ...
+    def read_register(self, register: str | RegisterDescriptor | int, /) -> Value: ...
+    def read_var(self, variable: str | Symbol, /, block: Block | None = ...) -> Value: ...
     def select(self) -> None: ...
     def level(self) -> int: ...
 
@@ -524,7 +524,7 @@ class Symbol:
     is_variable: bool
 
     def is_valid(self) -> bool: ...
-    def value(self, __frame: Frame = ...) -> Value: ...
+    def value(self, frame: Frame = ..., /) -> Value: ...
 
 SYMBOL_UNDEF_DOMAIN: int
 SYMBOL_VAR_DOMAIN: int
@@ -584,8 +584,8 @@ class LineTableEntry:
 class LineTable(Iterator[LineTableEntry]):
     def __iter__(self: _typeshed.Self) -> _typeshed.Self: ...
     def __next__(self) -> LineTableEntry: ...
-    def line(self, __line: int) -> tuple[LineTableEntry, ...]: ...
-    def has_line(self, __line: int) -> bool: ...
+    def line(self, line: int, /) -> tuple[LineTableEntry, ...]: ...
+    def has_line(self, line: int, /) -> bool: ...
     def source_lnes(self) -> list[int]: ...
 
 # Breakpoints
@@ -705,7 +705,7 @@ class TuiWindow:
 
     def is_valid(self) -> bool: ...
     def erase(self) -> None: ...
-    def write(self, __string: str, __full_window: bool = ...) -> None: ...
+    def write(self, string: str, full_window: bool = ..., /) -> None: ...
 
 class _Window(Protocol):
     def close(self) -> None: ...

stubs/gdb/gdb/events.pyi

@@ -8,8 +8,8 @@ class ThreadEvent:
 class ContinueEvent(ThreadEvent): ...
 
 class ContinueEventRegistry:
-    def connect(self, __object: Callable[[ContinueEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[ContinueEvent], object]) -> None: ...
+    def connect(self, object: Callable[[ContinueEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[ContinueEvent], object], /) -> None: ...
 
 cont: ContinueEventRegistry
 
@@ -18,8 +18,8 @@ class ExitedEvent:
     inferior: gdb.Inferior
 
 class ExitedEventRegistry:
-    def connect(self, __object: Callable[[ExitedEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[ExitedEvent], object]) -> None: ...
+    def connect(self, object: Callable[[ExitedEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[ExitedEvent], object], /) -> None: ...
 
 exited: ExitedEventRegistry
 
@@ -31,8 +31,8 @@ class BreakpointEvent(StopEvent):
     breakpoint: gdb.Breakpoint
 
 class StopEventRegistry:
-    def connect(self, __object: Callable[[StopEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[StopEvent], object]) -> None: ...
+    def connect(self, object: Callable[[StopEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[StopEvent], object], /) -> None: ...
 
 stop: StopEventRegistry
 
@@ -40,8 +40,8 @@ class NewObjFileEvent:
     new_objfile: gdb.Objfile
 
 class NewObjFileEventRegistry:
-    def connect(self, __object: Callable[[NewObjFileEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[NewObjFileEvent], object]) -> None: ...
+    def connect(self, object: Callable[[NewObjFileEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[NewObjFileEvent], object], /) -> None: ...
 
 new_objfile: NewObjFileEventRegistry
 
@@ -49,8 +49,8 @@ class ClearObjFilesEvent:
     progspace: gdb.Progspace
 
 class ClearObjFilesEventRegistry:
-    def connect(self, __object: Callable[[ClearObjFilesEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[ClearObjFilesEvent], object]) -> None: ...
+    def connect(self, object: Callable[[ClearObjFilesEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[ClearObjFilesEvent], object], /) -> None: ...
 
 clear_objfiles: ClearObjFilesEventRegistry
 
@@ -65,8 +65,8 @@ class InferiorCallPostEvent(InferiorCallEvent):
     address: gdb.Value
 
 class InferiorCallEventRegistry:
-    def connect(self, __object: Callable[[InferiorCallEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[InferiorCallEvent], object]) -> None: ...
+    def connect(self, object: Callable[[InferiorCallEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[InferiorCallEvent], object], /) -> None: ...
 
 inferior_call: InferiorCallEventRegistry
 
@@ -75,8 +75,8 @@ class MemoryChangedEvent:
     length: int
 
 class MemoryChangedEventRegistry:
-    def connect(self, __object: Callable[[MemoryChangedEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[MemoryChangedEvent], object]) -> None: ...
+    def connect(self, object: Callable[[MemoryChangedEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[MemoryChangedEvent], object], /) -> None: ...
 
 memory_changed: MemoryChangedEventRegistry
 
@@ -85,22 +85,22 @@ class RegisterChangedEvent:
     regnum: str
 
 class RegisterChangedEventRegistry:
-    def connect(self, __object: Callable[[RegisterChangedEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[RegisterChangedEvent], object]) -> None: ...
+    def connect(self, object: Callable[[RegisterChangedEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[RegisterChangedEvent], object], /) -> None: ...
 
 register_changed: RegisterChangedEventRegistry
 
 class BreakpointEventRegistry:
-    def connect(self, __object: Callable[[gdb.Breakpoint], object]) -> None: ...
-    def disconnect(self, __object: Callable[[gdb.Breakpoint], object]) -> None: ...
+    def connect(self, object: Callable[[gdb.Breakpoint], object], /) -> None: ...
+    def disconnect(self, object: Callable[[gdb.Breakpoint], object], /) -> None: ...
 
 breakpoint_created: BreakpointEventRegistry
 breakpoint_modified: BreakpointEventRegistry
 breakpoint_deleted: BreakpointEventRegistry
 
 class BeforePromptEventRegistry:
-    def connect(self, __object: Callable[[], object]) -> None: ...
-    def disconnect(self, __object: Callable[[], object]) -> None: ...
+    def connect(self, object: Callable[[], object], /) -> None: ...
+    def disconnect(self, object: Callable[[], object], /) -> None: ...
 
 before_prompt: BeforePromptEventRegistry
 
@@ -108,8 +108,8 @@ class NewInferiorEvent:
     inferior: gdb.Inferior
 
 class NewInferiorEventRegistry:
-    def connect(self, __object: Callable[[NewInferiorEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[NewInferiorEvent], object]) -> None: ...
+    def connect(self, object: Callable[[NewInferiorEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[NewInferiorEvent], object], /) -> None: ...
 
 new_inferior: NewInferiorEventRegistry
 
@@ -117,15 +117,15 @@ class InferiorDeletedEvent:
     inferior: gdb.Inferior
 
 class InferiorDeletedEventRegistry:
-    def connect(self, __object: Callable[[InferiorDeletedEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[InferiorDeletedEvent], object]) -> None: ...
+    def connect(self, object: Callable[[InferiorDeletedEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[InferiorDeletedEvent], object], /) -> None: ...
 
 inferior_deleted: InferiorDeletedEventRegistry
 
 class NewThreadEvent(ThreadEvent): ...
 
 class NewThreadEventRegistry:
-    def connect(self, __object: Callable[[NewThreadEvent], object]) -> None: ...
-    def disconnect(self, __object: Callable[[NewThreadEvent], object]) -> None: ...
+    def connect(self, object: Callable[[NewThreadEvent], object], /) -> None: ...
+    def disconnect(self, object: Callable[[NewThreadEvent], object], /) -> None: ...
 
 new_thread: NewThreadEventRegistry

stubs/gdb/gdb/types.pyi

@@ -18,7 +18,7 @@ class _TypePrinter(Protocol):
     def instantiate(self) -> _TypeRecognizer | None: ...
 
 class _TypeRecognizer(Protocol):
-    def recognize(self, __type: gdb.Type) -> str | None: ...
+    def recognize(self, type: gdb.Type, /) -> str | None: ...
 
 class TypePrinter:
     def __init__(self, name: str) -> None: ...