Use Final for sqlite constants (#12448)

2025-12-08 21:14:48 +08:00 · 2024-07-28 05:02:29 -05:00
parent 9a77f6006d
commit 0ffa2c5597
1 changed files with 172 additions and 172 deletions
--- a/stdlib/sqlite3/dbapi2.pyi
+++ b/stdlib/sqlite3/dbapi2.pyi
@@ -4,7 +4,7 @@ from _typeshed import ReadableBuffer, StrOrBytesPath, SupportsLenAndGetItem, Unu
 from collections.abc import Callable, Generator, Iterable, Iterator, Mapping
 from datetime import date, datetime, time
 from types import TracebackType
-from typing import Any, Literal, Protocol, SupportsIndex, TypeVar, final, overload
+from typing import Any, Final, Literal, Protocol, SupportsIndex, TypeVar, final, overload
 from typing_extensions import Self, TypeAlias

 _T = TypeVar("_T")
@@ -35,186 +35,186 @@ Binary = memoryview

 # The remaining definitions are imported from _sqlite3.

-PARSE_COLNAMES: int
-PARSE_DECLTYPES: int
-SQLITE_ALTER_TABLE: int
-SQLITE_ANALYZE: int
-SQLITE_ATTACH: int
-SQLITE_CREATE_INDEX: int
-SQLITE_CREATE_TABLE: int
-SQLITE_CREATE_TEMP_INDEX: int
-SQLITE_CREATE_TEMP_TABLE: int
-SQLITE_CREATE_TEMP_TRIGGER: int
-SQLITE_CREATE_TEMP_VIEW: int
-SQLITE_CREATE_TRIGGER: int
-SQLITE_CREATE_VIEW: int
-SQLITE_CREATE_VTABLE: int
-SQLITE_DELETE: int
-SQLITE_DENY: int
-SQLITE_DETACH: int
-SQLITE_DONE: int
-SQLITE_DROP_INDEX: int
-SQLITE_DROP_TABLE: int
-SQLITE_DROP_TEMP_INDEX: int
-SQLITE_DROP_TEMP_TABLE: int
-SQLITE_DROP_TEMP_TRIGGER: int
-SQLITE_DROP_TEMP_VIEW: int
-SQLITE_DROP_TRIGGER: int
-SQLITE_DROP_VIEW: int
-SQLITE_DROP_VTABLE: int
-SQLITE_FUNCTION: int
-SQLITE_IGNORE: int
-SQLITE_INSERT: int
-SQLITE_OK: int
+PARSE_COLNAMES: Final[int]
+PARSE_DECLTYPES: Final[int]
+SQLITE_ALTER_TABLE: Final[int]
+SQLITE_ANALYZE: Final[int]
+SQLITE_ATTACH: Final[int]
+SQLITE_CREATE_INDEX: Final[int]
+SQLITE_CREATE_TABLE: Final[int]
+SQLITE_CREATE_TEMP_INDEX: Final[int]
+SQLITE_CREATE_TEMP_TABLE: Final[int]
+SQLITE_CREATE_TEMP_TRIGGER: Final[int]
+SQLITE_CREATE_TEMP_VIEW: Final[int]
+SQLITE_CREATE_TRIGGER: Final[int]
+SQLITE_CREATE_VIEW: Final[int]
+SQLITE_CREATE_VTABLE: Final[int]
+SQLITE_DELETE: Final[int]
+SQLITE_DENY: Final[int]
+SQLITE_DETACH: Final[int]
+SQLITE_DONE: Final[int]
+SQLITE_DROP_INDEX: Final[int]
+SQLITE_DROP_TABLE: Final[int]
+SQLITE_DROP_TEMP_INDEX: Final[int]
+SQLITE_DROP_TEMP_TABLE: Final[int]
+SQLITE_DROP_TEMP_TRIGGER: Final[int]
+SQLITE_DROP_TEMP_VIEW: Final[int]
+SQLITE_DROP_TRIGGER: Final[int]
+SQLITE_DROP_VIEW: Final[int]
+SQLITE_DROP_VTABLE: Final[int]
+SQLITE_FUNCTION: Final[int]
+SQLITE_IGNORE: Final[int]
+SQLITE_INSERT: Final[int]
+SQLITE_OK: Final[int]
 if sys.version_info >= (3, 11):
-    SQLITE_LIMIT_LENGTH: int
-    SQLITE_LIMIT_SQL_LENGTH: int
-    SQLITE_LIMIT_COLUMN: int
-    SQLITE_LIMIT_EXPR_DEPTH: int
-    SQLITE_LIMIT_COMPOUND_SELECT: int
-    SQLITE_LIMIT_VDBE_OP: int
-    SQLITE_LIMIT_FUNCTION_ARG: int
-    SQLITE_LIMIT_ATTACHED: int
-    SQLITE_LIMIT_LIKE_PATTERN_LENGTH: int
-    SQLITE_LIMIT_VARIABLE_NUMBER: int
-    SQLITE_LIMIT_TRIGGER_DEPTH: int
-    SQLITE_LIMIT_WORKER_THREADS: int
-SQLITE_PRAGMA: int
-SQLITE_READ: int
-SQLITE_REINDEX: int
-SQLITE_RECURSIVE: int
-SQLITE_SAVEPOINT: int
-SQLITE_SELECT: int
-SQLITE_TRANSACTION: int
-SQLITE_UPDATE: int
+    SQLITE_LIMIT_LENGTH: Final[int]
+    SQLITE_LIMIT_SQL_LENGTH: Final[int]
+    SQLITE_LIMIT_COLUMN: Final[int]
+    SQLITE_LIMIT_EXPR_DEPTH: Final[int]
+    SQLITE_LIMIT_COMPOUND_SELECT: Final[int]
+    SQLITE_LIMIT_VDBE_OP: Final[int]
+    SQLITE_LIMIT_FUNCTION_ARG: Final[int]
+    SQLITE_LIMIT_ATTACHED: Final[int]
+    SQLITE_LIMIT_LIKE_PATTERN_LENGTH: Final[int]
+    SQLITE_LIMIT_VARIABLE_NUMBER: Final[int]
+    SQLITE_LIMIT_TRIGGER_DEPTH: Final[int]
+    SQLITE_LIMIT_WORKER_THREADS: Final[int]
+SQLITE_PRAGMA: Final[int]
+SQLITE_READ: Final[int]
+SQLITE_REINDEX: Final[int]
+SQLITE_RECURSIVE: Final[int]
+SQLITE_SAVEPOINT: Final[int]
+SQLITE_SELECT: Final[int]
+SQLITE_TRANSACTION: Final[int]
+SQLITE_UPDATE: Final[int]
 adapters: dict[tuple[type[Any], type[Any]], _Adapter[Any]]
 converters: dict[str, _Converter]
 sqlite_version: str
 version: str

 if sys.version_info >= (3, 11):
-    SQLITE_ABORT: int
-    SQLITE_ABORT_ROLLBACK: int
-    SQLITE_AUTH: int
-    SQLITE_AUTH_USER: int
-    SQLITE_BUSY: int
-    SQLITE_BUSY_RECOVERY: int
-    SQLITE_BUSY_SNAPSHOT: int
-    SQLITE_BUSY_TIMEOUT: int
-    SQLITE_CANTOPEN: int
-    SQLITE_CANTOPEN_CONVPATH: int
-    SQLITE_CANTOPEN_DIRTYWAL: int
-    SQLITE_CANTOPEN_FULLPATH: int
-    SQLITE_CANTOPEN_ISDIR: int
-    SQLITE_CANTOPEN_NOTEMPDIR: int
-    SQLITE_CANTOPEN_SYMLINK: int
-    SQLITE_CONSTRAINT: int
-    SQLITE_CONSTRAINT_CHECK: int
-    SQLITE_CONSTRAINT_COMMITHOOK: int
-    SQLITE_CONSTRAINT_FOREIGNKEY: int
-    SQLITE_CONSTRAINT_FUNCTION: int
-    SQLITE_CONSTRAINT_NOTNULL: int
-    SQLITE_CONSTRAINT_PINNED: int
-    SQLITE_CONSTRAINT_PRIMARYKEY: int
-    SQLITE_CONSTRAINT_ROWID: int
-    SQLITE_CONSTRAINT_TRIGGER: int
-    SQLITE_CONSTRAINT_UNIQUE: int
-    SQLITE_CONSTRAINT_VTAB: int
-    SQLITE_CORRUPT: int
-    SQLITE_CORRUPT_INDEX: int
-    SQLITE_CORRUPT_SEQUENCE: int
-    SQLITE_CORRUPT_VTAB: int
-    SQLITE_EMPTY: int
-    SQLITE_ERROR: int
-    SQLITE_ERROR_MISSING_COLLSEQ: int
-    SQLITE_ERROR_RETRY: int
-    SQLITE_ERROR_SNAPSHOT: int
-    SQLITE_FORMAT: int
-    SQLITE_FULL: int
-    SQLITE_INTERNAL: int
-    SQLITE_INTERRUPT: int
-    SQLITE_IOERR: int
-    SQLITE_IOERR_ACCESS: int
-    SQLITE_IOERR_AUTH: int
-    SQLITE_IOERR_BEGIN_ATOMIC: int
-    SQLITE_IOERR_BLOCKED: int
-    SQLITE_IOERR_CHECKRESERVEDLOCK: int
-    SQLITE_IOERR_CLOSE: int
-    SQLITE_IOERR_COMMIT_ATOMIC: int
-    SQLITE_IOERR_CONVPATH: int
-    SQLITE_IOERR_CORRUPTFS: int
-    SQLITE_IOERR_DATA: int
-    SQLITE_IOERR_DELETE: int
-    SQLITE_IOERR_DELETE_NOENT: int
-    SQLITE_IOERR_DIR_CLOSE: int
-    SQLITE_IOERR_DIR_FSYNC: int
-    SQLITE_IOERR_FSTAT: int
-    SQLITE_IOERR_FSYNC: int
-    SQLITE_IOERR_GETTEMPPATH: int
-    SQLITE_IOERR_LOCK: int
-    SQLITE_IOERR_MMAP: int
-    SQLITE_IOERR_NOMEM: int
-    SQLITE_IOERR_RDLOCK: int
-    SQLITE_IOERR_READ: int
-    SQLITE_IOERR_ROLLBACK_ATOMIC: int
-    SQLITE_IOERR_SEEK: int
-    SQLITE_IOERR_SHMLOCK: int
-    SQLITE_IOERR_SHMMAP: int
-    SQLITE_IOERR_SHMOPEN: int
-    SQLITE_IOERR_SHMSIZE: int
-    SQLITE_IOERR_SHORT_READ: int
-    SQLITE_IOERR_TRUNCATE: int
-    SQLITE_IOERR_UNLOCK: int
-    SQLITE_IOERR_VNODE: int
-    SQLITE_IOERR_WRITE: int
-    SQLITE_LOCKED: int
-    SQLITE_LOCKED_SHAREDCACHE: int
-    SQLITE_LOCKED_VTAB: int
-    SQLITE_MISMATCH: int
-    SQLITE_MISUSE: int
-    SQLITE_NOLFS: int
-    SQLITE_NOMEM: int
-    SQLITE_NOTADB: int
-    SQLITE_NOTFOUND: int
-    SQLITE_NOTICE: int
-    SQLITE_NOTICE_RECOVER_ROLLBACK: int
-    SQLITE_NOTICE_RECOVER_WAL: int
-    SQLITE_OK_LOAD_PERMANENTLY: int
-    SQLITE_OK_SYMLINK: int
-    SQLITE_PERM: int
-    SQLITE_PROTOCOL: int
-    SQLITE_RANGE: int
-    SQLITE_READONLY: int
-    SQLITE_READONLY_CANTINIT: int
-    SQLITE_READONLY_CANTLOCK: int
-    SQLITE_READONLY_DBMOVED: int
-    SQLITE_READONLY_DIRECTORY: int
-    SQLITE_READONLY_RECOVERY: int
-    SQLITE_READONLY_ROLLBACK: int
-    SQLITE_ROW: int
-    SQLITE_SCHEMA: int
-    SQLITE_TOOBIG: int
-    SQLITE_WARNING: int
-    SQLITE_WARNING_AUTOINDEX: int
+    SQLITE_ABORT: Final[int]
+    SQLITE_ABORT_ROLLBACK: Final[int]
+    SQLITE_AUTH: Final[int]
+    SQLITE_AUTH_USER: Final[int]
+    SQLITE_BUSY: Final[int]
+    SQLITE_BUSY_RECOVERY: Final[int]
+    SQLITE_BUSY_SNAPSHOT: Final[int]
+    SQLITE_BUSY_TIMEOUT: Final[int]
+    SQLITE_CANTOPEN: Final[int]
+    SQLITE_CANTOPEN_CONVPATH: Final[int]
+    SQLITE_CANTOPEN_DIRTYWAL: Final[int]
+    SQLITE_CANTOPEN_FULLPATH: Final[int]
+    SQLITE_CANTOPEN_ISDIR: Final[int]
+    SQLITE_CANTOPEN_NOTEMPDIR: Final[int]
+    SQLITE_CANTOPEN_SYMLINK: Final[int]
+    SQLITE_CONSTRAINT: Final[int]
+    SQLITE_CONSTRAINT_CHECK: Final[int]
+    SQLITE_CONSTRAINT_COMMITHOOK: Final[int]
+    SQLITE_CONSTRAINT_FOREIGNKEY: Final[int]
+    SQLITE_CONSTRAINT_FUNCTION: Final[int]
+    SQLITE_CONSTRAINT_NOTNULL: Final[int]
+    SQLITE_CONSTRAINT_PINNED: Final[int]
+    SQLITE_CONSTRAINT_PRIMARYKEY: Final[int]
+    SQLITE_CONSTRAINT_ROWID: Final[int]
+    SQLITE_CONSTRAINT_TRIGGER: Final[int]
+    SQLITE_CONSTRAINT_UNIQUE: Final[int]
+    SQLITE_CONSTRAINT_VTAB: Final[int]
+    SQLITE_CORRUPT: Final[int]
+    SQLITE_CORRUPT_INDEX: Final[int]
+    SQLITE_CORRUPT_SEQUENCE: Final[int]
+    SQLITE_CORRUPT_VTAB: Final[int]
+    SQLITE_EMPTY: Final[int]
+    SQLITE_ERROR: Final[int]
+    SQLITE_ERROR_MISSING_COLLSEQ: Final[int]
+    SQLITE_ERROR_RETRY: Final[int]
+    SQLITE_ERROR_SNAPSHOT: Final[int]
+    SQLITE_FORMAT: Final[int]
+    SQLITE_FULL: Final[int]
+    SQLITE_INTERNAL: Final[int]
+    SQLITE_INTERRUPT: Final[int]
+    SQLITE_IOERR: Final[int]
+    SQLITE_IOERR_ACCESS: Final[int]
+    SQLITE_IOERR_AUTH: Final[int]
+    SQLITE_IOERR_BEGIN_ATOMIC: Final[int]
+    SQLITE_IOERR_BLOCKED: Final[int]
+    SQLITE_IOERR_CHECKRESERVEDLOCK: Final[int]
+    SQLITE_IOERR_CLOSE: Final[int]
+    SQLITE_IOERR_COMMIT_ATOMIC: Final[int]
+    SQLITE_IOERR_CONVPATH: Final[int]
+    SQLITE_IOERR_CORRUPTFS: Final[int]
+    SQLITE_IOERR_DATA: Final[int]
+    SQLITE_IOERR_DELETE: Final[int]
+    SQLITE_IOERR_DELETE_NOENT: Final[int]
+    SQLITE_IOERR_DIR_CLOSE: Final[int]
+    SQLITE_IOERR_DIR_FSYNC: Final[int]
+    SQLITE_IOERR_FSTAT: Final[int]
+    SQLITE_IOERR_FSYNC: Final[int]
+    SQLITE_IOERR_GETTEMPPATH: Final[int]
+    SQLITE_IOERR_LOCK: Final[int]
+    SQLITE_IOERR_MMAP: Final[int]
+    SQLITE_IOERR_NOMEM: Final[int]
+    SQLITE_IOERR_RDLOCK: Final[int]
+    SQLITE_IOERR_READ: Final[int]
+    SQLITE_IOERR_ROLLBACK_ATOMIC: Final[int]
+    SQLITE_IOERR_SEEK: Final[int]
+    SQLITE_IOERR_SHMLOCK: Final[int]
+    SQLITE_IOERR_SHMMAP: Final[int]
+    SQLITE_IOERR_SHMOPEN: Final[int]
+    SQLITE_IOERR_SHMSIZE: Final[int]
+    SQLITE_IOERR_SHORT_READ: Final[int]
+    SQLITE_IOERR_TRUNCATE: Final[int]
+    SQLITE_IOERR_UNLOCK: Final[int]
+    SQLITE_IOERR_VNODE: Final[int]
+    SQLITE_IOERR_WRITE: Final[int]
+    SQLITE_LOCKED: Final[int]
+    SQLITE_LOCKED_SHAREDCACHE: Final[int]
+    SQLITE_LOCKED_VTAB: Final[int]
+    SQLITE_MISMATCH: Final[int]
+    SQLITE_MISUSE: Final[int]
+    SQLITE_NOLFS: Final[int]
+    SQLITE_NOMEM: Final[int]
+    SQLITE_NOTADB: Final[int]
+    SQLITE_NOTFOUND: Final[int]
+    SQLITE_NOTICE: Final[int]
+    SQLITE_NOTICE_RECOVER_ROLLBACK: Final[int]
+    SQLITE_NOTICE_RECOVER_WAL: Final[int]
+    SQLITE_OK_LOAD_PERMANENTLY: Final[int]
+    SQLITE_OK_SYMLINK: Final[int]
+    SQLITE_PERM: Final[int]
+    SQLITE_PROTOCOL: Final[int]
+    SQLITE_RANGE: Final[int]
+    SQLITE_READONLY: Final[int]
+    SQLITE_READONLY_CANTINIT: Final[int]
+    SQLITE_READONLY_CANTLOCK: Final[int]
+    SQLITE_READONLY_DBMOVED: Final[int]
+    SQLITE_READONLY_DIRECTORY: Final[int]
+    SQLITE_READONLY_RECOVERY: Final[int]
+    SQLITE_READONLY_ROLLBACK: Final[int]
+    SQLITE_ROW: Final[int]
+    SQLITE_SCHEMA: Final[int]
+    SQLITE_TOOBIG: Final[int]
+    SQLITE_WARNING: Final[int]
+    SQLITE_WARNING_AUTOINDEX: Final[int]

 if sys.version_info >= (3, 12):
-    LEGACY_TRANSACTION_CONTROL: int
-    SQLITE_DBCONFIG_DEFENSIVE: int
-    SQLITE_DBCONFIG_DQS_DDL: int
-    SQLITE_DBCONFIG_DQS_DML: int
-    SQLITE_DBCONFIG_ENABLE_FKEY: int
-    SQLITE_DBCONFIG_ENABLE_FTS3_TOKENIZER: int
-    SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION: int
-    SQLITE_DBCONFIG_ENABLE_QPSG: int
-    SQLITE_DBCONFIG_ENABLE_TRIGGER: int
-    SQLITE_DBCONFIG_ENABLE_VIEW: int
-    SQLITE_DBCONFIG_LEGACY_ALTER_TABLE: int
-    SQLITE_DBCONFIG_LEGACY_FILE_FORMAT: int
-    SQLITE_DBCONFIG_NO_CKPT_ON_CLOSE: int
-    SQLITE_DBCONFIG_RESET_DATABASE: int
-    SQLITE_DBCONFIG_TRIGGER_EQP: int
-    SQLITE_DBCONFIG_TRUSTED_SCHEMA: int
-    SQLITE_DBCONFIG_WRITABLE_SCHEMA: int
+    LEGACY_TRANSACTION_CONTROL: Final[int]
+    SQLITE_DBCONFIG_DEFENSIVE: Final[int]
+    SQLITE_DBCONFIG_DQS_DDL: Final[int]
+    SQLITE_DBCONFIG_DQS_DML: Final[int]
+    SQLITE_DBCONFIG_ENABLE_FKEY: Final[int]
+    SQLITE_DBCONFIG_ENABLE_FTS3_TOKENIZER: Final[int]
+    SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION: Final[int]
+    SQLITE_DBCONFIG_ENABLE_QPSG: Final[int]
+    SQLITE_DBCONFIG_ENABLE_TRIGGER: Final[int]
+    SQLITE_DBCONFIG_ENABLE_VIEW: Final[int]
+    SQLITE_DBCONFIG_LEGACY_ALTER_TABLE: Final[int]
+    SQLITE_DBCONFIG_LEGACY_FILE_FORMAT: Final[int]
+    SQLITE_DBCONFIG_NO_CKPT_ON_CLOSE: Final[int]
+    SQLITE_DBCONFIG_RESET_DATABASE: Final[int]
+    SQLITE_DBCONFIG_TRIGGER_EQP: Final[int]
+    SQLITE_DBCONFIG_TRUSTED_SCHEMA: Final[int]
+    SQLITE_DBCONFIG_WRITABLE_SCHEMA: Final[int]

 # Can take or return anything depending on what's in the registry.
@overload