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

2026-01-03 18:13:36 +08:00 · 2024-03-10 06:11:43 -07:00
parent f94bbfbcc4
commit 88fa182253
97 changed files with 625 additions and 632 deletions
--- a/stubs/ibm-db/ibm_db.pyi
+++ b/stubs/ibm-db/ibm_db.pyi
@@ -216,131 +216,128 @@ class IBM_DBServerInfo:
 class IBM_DBStatement:
    def __new__(cls, *args: object, **kwargs: object) -> Self: ...

-def active(__connection: IBM_DBConnection | None) -> bool: ...
-def autocommit(__connection: IBM_DBConnection, __value: int = ...) -> int | bool: ...
+def active(connection: IBM_DBConnection | None, /) -> bool: ...
+def autocommit(connection: IBM_DBConnection, value: int = ..., /) -> int | bool: ...
 def bind_param(
-    __stmt: IBM_DBStatement,
-    __parameter_number: int,
-    __variable: str,
-    __parameter_type: int | None = ...,
-    __data_type: int | None = ...,
-    __precision: int | None = ...,
-    __scale: int | None = ...,
-    __size: int | None = ...,
+    stmt: IBM_DBStatement,
+    parameter_number: int,
+    variable: str,
+    parameter_type: int | None = ...,
+    data_type: int | None = ...,
+    precision: int | None = ...,
+    scale: int | None = ...,
+    size: int | None = ...,
+    /,
 ) -> bool: ...
@overload
-def callproc(__connection: IBM_DBConnection, __procname: str) -> IBM_DBStatement | None: ...
+def callproc(connection: IBM_DBConnection, procname: str, /) -> IBM_DBStatement | None: ...
@overload
-def callproc(__connection: IBM_DBConnection, __procname: str, __parameters: tuple[object, ...]) -> tuple[object, ...] | None: ...
-def check_function_support(__connection: IBM_DBConnection, __function_id: int) -> bool: ...
-def client_info(__connection: IBM_DBConnection) -> IBM_DBClientInfo | bool: ...
-def close(__connection: IBM_DBConnection) -> bool: ...
+def callproc(connection: IBM_DBConnection, procname: str, parameters: tuple[object, ...], /) -> tuple[object, ...] | None: ...
+def check_function_support(connection: IBM_DBConnection, function_id: int, /) -> bool: ...
+def client_info(connection: IBM_DBConnection, /) -> IBM_DBClientInfo | bool: ...
+def close(connection: IBM_DBConnection, /) -> bool: ...
 def column_privileges(
-    __connection: IBM_DBConnection,
-    __qualifier: str | None = ...,
-    __schema: str | None = ...,
-    __table_name: str | None = ...,
-    __column_name: str | None = ...,
+    connection: IBM_DBConnection,
+    qualifier: str | None = ...,
+    schema: str | None = ...,
+    table_name: str | None = ...,
+    column_name: str | None = ...,
+    /,
 ) -> IBM_DBStatement: ...
 def columns(
-    __connection: IBM_DBConnection,
-    __qualifier: str | None = ...,
-    __schema: str | None = ...,
-    __table_name: str | None = ...,
-    __column_name: str | None = ...,
+    connection: IBM_DBConnection,
+    qualifier: str | None = ...,
+    schema: str | None = ...,
+    table_name: str | None = ...,
+    column_name: str | None = ...,
+    /,
 ) -> IBM_DBStatement: ...
-def commit(__connection: IBM_DBConnection) -> bool: ...
-def conn_error(__connection: IBM_DBConnection | None = ...) -> str: ...
-def conn_errormsg(__connection: IBM_DBConnection | None = ...) -> str: ...
-def conn_warn(__connection: IBM_DBConnection | None = ...) -> str: ...
+def commit(connection: IBM_DBConnection, /) -> bool: ...
+def conn_error(connection: IBM_DBConnection | None = ..., /) -> str: ...
+def conn_errormsg(connection: IBM_DBConnection | None = ..., /) -> str: ...
+def conn_warn(connection: IBM_DBConnection | None = ..., /) -> str: ...
 def connect(
-    __database: str,
-    __user: str,
-    __password: str,
-    __options: dict[int, int | str] | None = ...,
-    __replace_quoted_literal: int = ...,
+    database: str, user: str, password: str, options: dict[int, int | str] | None = ..., replace_quoted_literal: int = ..., /
 ) -> IBM_DBConnection | None: ...
-def createdb(__connection: IBM_DBConnection, __dbName: str, __codeSet: str = ..., __mode: str = ...) -> bool: ...
-def createdbNX(__connection: IBM_DBConnection, __dbName: str, __codeSet: str = ..., __mode: str = ...) -> bool: ...
-def cursor_type(__stmt: IBM_DBStatement) -> int: ...
-def dropdb(__connection: IBM_DBConnection, __dbName: str) -> bool: ...
+def createdb(connection: IBM_DBConnection, dbName: str, codeSet: str = ..., mode: str = ..., /) -> bool: ...
+def createdbNX(connection: IBM_DBConnection, dbName: str, codeSet: str = ..., mode: str = ..., /) -> bool: ...
+def cursor_type(stmt: IBM_DBStatement, /) -> int: ...
+def dropdb(connection: IBM_DBConnection, dbName: str, /) -> bool: ...
 def exec_immediate(
-    __connection: IBM_DBConnection, __statement: str | None, __options: dict[int, int] = ...
+    connection: IBM_DBConnection, statement: str | None, options: dict[int, int] = ..., /
 ) -> IBM_DBStatement | bool: ...
-def execute(__stmt: IBM_DBStatement, __parameters: tuple[object, ...] | None = ...) -> bool: ...
+def execute(stmt: IBM_DBStatement, parameters: tuple[object, ...] | None = ..., /) -> bool: ...
 def execute_many(
-    __stmt: IBM_DBStatement, __seq_of_parameters: tuple[object, ...], __options: dict[int, int] = ...
+    stmt: IBM_DBStatement, seq_of_parameters: tuple[object, ...], options: dict[int, int] = ..., /
 ) -> int | None: ...
-def fetch_assoc(__stmt: IBM_DBStatement, __row_number: int = ...) -> dict[str, object] | bool: ...
-def fetch_both(__stmt: IBM_DBStatement, __row_number: int = ...) -> dict[int | str, object] | bool: ...
-def fetch_row(__stmt: IBM_DBStatement, __row_number: int = ...) -> bool: ...
-def fetch_tuple(__stmt: IBM_DBStatement, __row_number: int = ...) -> tuple[object, ...]: ...
-def field_display_size(__stmt: IBM_DBStatement, __column: int | str) -> int | bool: ...
-def field_name(__stmt: IBM_DBStatement, __column: int | str) -> str | bool: ...
-def field_nullable(__stmt: IBM_DBStatement, __column: int | str) -> bool: ...
-def field_num(__stmt: IBM_DBStatement, __column: int | str) -> int | bool: ...
-def field_precision(__stmt: IBM_DBStatement, __column: int | str) -> int | bool: ...
-def field_scale(__stmt: IBM_DBStatement, __column: int | str) -> int | bool: ...
-def field_type(__stmt: IBM_DBStatement, __column: int | str) -> str | bool: ...
-def field_width(__stmt: IBM_DBStatement, __column: int | str) -> int | bool: ...
+def fetch_assoc(stmt: IBM_DBStatement, row_number: int = ..., /) -> dict[str, object] | bool: ...
+def fetch_both(stmt: IBM_DBStatement, row_number: int = ..., /) -> dict[int | str, object] | bool: ...
+def fetch_row(stmt: IBM_DBStatement, row_number: int = ..., /) -> bool: ...
+def fetch_tuple(stmt: IBM_DBStatement, row_number: int = ..., /) -> tuple[object, ...]: ...
+def field_display_size(stmt: IBM_DBStatement, column: int | str, /) -> int | bool: ...
+def field_name(stmt: IBM_DBStatement, column: int | str, /) -> str | bool: ...
+def field_nullable(stmt: IBM_DBStatement, column: int | str, /) -> bool: ...
+def field_num(stmt: IBM_DBStatement, column: int | str, /) -> int | bool: ...
+def field_precision(stmt: IBM_DBStatement, column: int | str, /) -> int | bool: ...
+def field_scale(stmt: IBM_DBStatement, column: int | str, /) -> int | bool: ...
+def field_type(stmt: IBM_DBStatement, column: int | str, /) -> str | bool: ...
+def field_width(stmt: IBM_DBStatement, column: int | str, /) -> int | bool: ...
 def foreign_keys(
-    __connection: IBM_DBConnection,
-    __pk_qualifier: str | None,
-    __pk_schema: str | None,
-    __pk_table_name: str | None,
-    __fk_qualifier: str | None = ...,
-    __fk_schema: str | None = ...,
-    __fk_table_name: str | None = ...,
+    connection: IBM_DBConnection,
+    pk_qualifier: str | None,
+    pk_schema: str | None,
+    pk_table_name: str | None,
+    fk_qualifier: str | None = ...,
+    fk_schema: str | None = ...,
+    fk_table_name: str | None = ...,
+    /,
 ) -> IBM_DBStatement: ...
-def free_result(__stmt: IBM_DBStatement) -> bool: ...
-def free_stmt(__stmt: IBM_DBStatement) -> bool: ...
-def get_db_info(__connection: IBM_DBConnection, __option: int) -> str | bool: ...
-def get_last_serial_value(__stmt: IBM_DBStatement) -> str | bool: ...
-def get_num_result(__stmt: IBM_DBStatement) -> int | bool: ...
-def get_option(__resc: IBM_DBConnection | IBM_DBStatement, __options: int, __type: int) -> Any: ...
-def next_result(__stmt: IBM_DBStatement) -> IBM_DBStatement | bool: ...
-def num_fields(__stmt: IBM_DBStatement) -> int | bool: ...
-def num_rows(__stmt: IBM_DBStatement) -> int: ...
+def free_result(stmt: IBM_DBStatement, /) -> bool: ...
+def free_stmt(stmt: IBM_DBStatement, /) -> bool: ...
+def get_db_info(connection: IBM_DBConnection, option: int, /) -> str | bool: ...
+def get_last_serial_value(stmt: IBM_DBStatement, /) -> str | bool: ...
+def get_num_result(stmt: IBM_DBStatement, /) -> int | bool: ...
+def get_option(resc: IBM_DBConnection | IBM_DBStatement, options: int, type: int, /) -> Any: ...
+def next_result(stmt: IBM_DBStatement, /) -> IBM_DBStatement | bool: ...
+def num_fields(stmt: IBM_DBStatement, /) -> int | bool: ...
+def num_rows(stmt: IBM_DBStatement, /) -> int: ...
 def pconnect(
-    __database: str, __username: str, __password: str, __options: dict[int, int | str] | None = ...
+    database: str, username: str, password: str, options: dict[int, int | str] | None = ..., /
 ) -> IBM_DBConnection | None: ...
 def prepare(
-    __connection: IBM_DBConnection, __statement: str, __options: dict[int, int | str] | None = ...
+    connection: IBM_DBConnection, statement: str, options: dict[int, int | str] | None = ..., /
 ) -> IBM_DBStatement | bool: ...
 def primary_keys(
-    __connection: IBM_DBConnection, __qualifier: str | None, __schema: str | None, __table_name: str | None
+    connection: IBM_DBConnection, qualifier: str | None, schema: str | None, table_name: str | None, /
 ) -> IBM_DBStatement: ...
 def procedure_columns(
-    __connection: IBM_DBConnection,
-    __qualifier: str | None,
-    __schema: str | None,
-    __procedure: str | None,
-    __parameter: str | None,
+    connection: IBM_DBConnection, qualifier: str | None, schema: str | None, procedure: str | None, parameter: str | None, /
 ) -> IBM_DBStatement | bool: ...
 def procedures(
-    __connection: IBM_DBConnection, __qualifier: str | None, __schema: str | None, __procedure: str | None
+    connection: IBM_DBConnection, qualifier: str | None, schema: str | None, procedure: str | None, /
 ) -> IBM_DBStatement | bool: ...
-def recreatedb(__connection: IBM_DBConnection, __dbName: str, __codeSet: str | None = ..., __mode: str | None = ...) -> bool: ...
-def result(__stmt: IBM_DBStatement, __column: int | str) -> Any: ...
-def rollback(__connection: IBM_DBConnection) -> bool: ...
-def server_info(__connection: IBM_DBConnection) -> IBM_DBServerInfo | bool: ...
-def set_option(__resc: IBM_DBConnection | IBM_DBStatement, __options: dict[int, int | str], __type: int) -> bool: ...
+def recreatedb(connection: IBM_DBConnection, dbName: str, codeSet: str | None = ..., mode: str | None = ..., /) -> bool: ...
+def result(stmt: IBM_DBStatement, column: int | str, /) -> Any: ...
+def rollback(connection: IBM_DBConnection, /) -> bool: ...
+def server_info(connection: IBM_DBConnection, /) -> IBM_DBServerInfo | bool: ...
+def set_option(resc: IBM_DBConnection | IBM_DBStatement, options: dict[int, int | str], type: int, /) -> bool: ...
 def special_columns(
-    __connection: IBM_DBConnection, __qualifier: str | None, __schema: str | None, __table_name: str | None, __scope: int
+    connection: IBM_DBConnection, qualifier: str | None, schema: str | None, table_name: str | None, scope: int, /
 ) -> IBM_DBStatement: ...
 def statistics(
-    __connection: IBM_DBConnection, __qualifier: str | None, __schema: str | None, __table_name: str | None, __unique: bool | None
+    connection: IBM_DBConnection, qualifier: str | None, schema: str | None, table_name: str | None, unique: bool | None, /
 ) -> IBM_DBStatement: ...
-def stmt_error(__stmt: IBM_DBStatement = ...) -> str: ...
-def stmt_errormsg(__stmt: IBM_DBStatement = ...) -> str: ...
-def stmt_warn(__connection: IBM_DBConnection = ...) -> IBM_DBStatement: ...
+def stmt_error(stmt: IBM_DBStatement = ..., /) -> str: ...
+def stmt_errormsg(stmt: IBM_DBStatement = ..., /) -> str: ...
+def stmt_warn(connection: IBM_DBConnection = ..., /) -> IBM_DBStatement: ...
 def table_privileges(
-    __connection: IBM_DBConnection, __qualifier: str | None = ..., __schema: str | None = ..., __table_name: str | None = ...
+    connection: IBM_DBConnection, qualifier: str | None = ..., schema: str | None = ..., table_name: str | None = ..., /
 ) -> IBM_DBStatement | bool: ...
 def tables(
-    __connection: IBM_DBConnection,
-    __qualifier: str | None = ...,
-    __schema: str | None = ...,
-    __table_name: str | None = ...,
-    __table_type: str | None = ...,
+    connection: IBM_DBConnection,
+    qualifier: str | None = ...,
+    schema: str | None = ...,
+    table_name: str | None = ...,
+    table_type: str | None = ...,
+    /,
 ) -> IBM_DBStatement | bool: ...