Use PEP 570 syntax in stdlib (#11250)

This commit is contained in:
Shantanu
2024-03-09 14:50:16 -08:00
committed by GitHub
parent 63737acac6
commit 470a13ab09
139 changed files with 2412 additions and 2371 deletions

View File

@@ -493,8 +493,8 @@ def get_exec_path(env: Mapping[str, str] | None = None) -> list[str]: ...
def getlogin() -> str: ...
def getpid() -> int: ...
def getppid() -> int: ...
def strerror(__code: int) -> str: ...
def umask(__mask: int) -> int: ...
def strerror(code: int, /) -> str: ...
def umask(mask: int, /) -> int: ...
@final
class uname_result(structseq[str], tuple[str, str, str, str, str]):
if sys.version_info >= (3, 10):
@@ -516,9 +516,9 @@ if sys.platform != "win32":
def getegid() -> int: ...
def geteuid() -> int: ...
def getgid() -> int: ...
def getgrouplist(__user: str, __group: int) -> list[int]: ...
def getgrouplist(user: str, group: int, /) -> list[int]: ...
def getgroups() -> list[int]: ... # Unix only, behaves differently on Mac
def initgroups(__username: str, __gid: int) -> None: ...
def initgroups(username: str, gid: int, /) -> None: ...
def getpgid(pid: int) -> int: ...
def getpgrp() -> int: ...
def getpriority(which: int, who: int) -> int: ...
@@ -528,21 +528,21 @@ if sys.platform != "win32":
def getresgid() -> tuple[int, int, int]: ...
def getuid() -> int: ...
def setegid(__egid: int) -> None: ...
def seteuid(__euid: int) -> None: ...
def setgid(__gid: int) -> None: ...
def setgroups(__groups: Sequence[int]) -> None: ...
def setegid(egid: int, /) -> None: ...
def seteuid(euid: int, /) -> None: ...
def setgid(gid: int, /) -> None: ...
def setgroups(groups: Sequence[int], /) -> None: ...
def setpgrp() -> None: ...
def setpgid(__pid: int, __pgrp: int) -> None: ...
def setregid(__rgid: int, __egid: int) -> None: ...
def setpgid(pid: int, pgrp: int, /) -> None: ...
def setregid(rgid: int, egid: int, /) -> None: ...
if sys.platform != "darwin":
def setresgid(__rgid: int, __egid: int, __sgid: int) -> None: ...
def setresuid(__ruid: int, __euid: int, __suid: int) -> None: ...
def setresgid(rgid: int, egid: int, sgid: int, /) -> None: ...
def setresuid(ruid: int, euid: int, suid: int, /) -> None: ...
def setreuid(__ruid: int, __euid: int) -> None: ...
def getsid(__pid: int) -> int: ...
def setreuid(ruid: int, euid: int, /) -> None: ...
def getsid(pid: int, /) -> int: ...
def setsid() -> None: ...
def setuid(__uid: int) -> None: ...
def setuid(uid: int, /) -> None: ...
def uname() -> uname_result: ...
@overload
@@ -555,14 +555,14 @@ if sys.platform != "win32":
def getenvb(key: bytes) -> bytes | None: ...
@overload
def getenvb(key: bytes, default: _T) -> bytes | _T: ...
def putenv(__name: StrOrBytesPath, __value: StrOrBytesPath) -> None: ...
def unsetenv(__name: StrOrBytesPath) -> None: ...
def putenv(name: StrOrBytesPath, value: StrOrBytesPath, /) -> None: ...
def unsetenv(name: StrOrBytesPath, /) -> None: ...
else:
def putenv(__name: str, __value: str) -> None: ...
def putenv(name: str, value: str, /) -> None: ...
if sys.version_info >= (3, 9):
def unsetenv(__name: str) -> None: ...
def unsetenv(name: str, /) -> None: ...
_Opener: TypeAlias = Callable[[str, int], int]
@@ -644,50 +644,50 @@ def fdopen(
opener: _Opener | None = ...,
) -> IO[Any]: ...
def close(fd: int) -> None: ...
def closerange(__fd_low: int, __fd_high: int) -> None: ...
def closerange(fd_low: int, fd_high: int, /) -> None: ...
def device_encoding(fd: int) -> str | None: ...
def dup(__fd: int) -> int: ...
def dup(fd: int, /) -> int: ...
def dup2(fd: int, fd2: int, inheritable: bool = True) -> int: ...
def fstat(fd: int) -> stat_result: ...
def ftruncate(__fd: int, __length: int) -> None: ...
def ftruncate(fd: int, length: int, /) -> None: ...
def fsync(fd: FileDescriptorLike) -> None: ...
def isatty(__fd: int) -> bool: ...
def isatty(fd: int, /) -> bool: ...
if sys.platform != "win32" and sys.version_info >= (3, 11):
def login_tty(__fd: int) -> None: ...
def login_tty(fd: int, /) -> None: ...
if sys.version_info >= (3, 11):
def lseek(__fd: int, __position: int, __whence: int) -> int: ...
def lseek(fd: int, position: int, whence: int, /) -> int: ...
else:
def lseek(__fd: int, __position: int, __how: int) -> int: ...
def lseek(fd: int, position: int, how: int, /) -> int: ...
def open(path: StrOrBytesPath, flags: int, mode: int = 0o777, *, dir_fd: int | None = None) -> int: ...
def pipe() -> tuple[int, int]: ...
def read(__fd: int, __length: int) -> bytes: ...
def read(fd: int, length: int, /) -> bytes: ...
if sys.version_info >= (3, 12) or sys.platform != "win32":
def get_blocking(__fd: int) -> bool: ...
def set_blocking(__fd: int, __blocking: bool) -> None: ...
def get_blocking(fd: int, /) -> bool: ...
def set_blocking(fd: int, blocking: bool, /) -> None: ...
if sys.platform != "win32":
def fchmod(fd: int, mode: int) -> None: ...
def fchown(fd: int, uid: int, gid: int) -> None: ...
def fpathconf(__fd: int, __name: str | int) -> int: ...
def fstatvfs(__fd: int) -> statvfs_result: ...
def lockf(__fd: int, __command: int, __length: int) -> None: ...
def fpathconf(fd: int, name: str | int, /) -> int: ...
def fstatvfs(fd: int, /) -> statvfs_result: ...
def lockf(fd: int, command: int, length: int, /) -> None: ...
def openpty() -> tuple[int, int]: ... # some flavors of Unix
if sys.platform != "darwin":
def fdatasync(fd: FileDescriptorLike) -> None: ...
def pipe2(__flags: int) -> tuple[int, int]: ... # some flavors of Unix
def posix_fallocate(__fd: int, __offset: int, __length: int) -> None: ...
def posix_fadvise(__fd: int, __offset: int, __length: int, __advice: int) -> None: ...
def pipe2(flags: int, /) -> tuple[int, int]: ... # some flavors of Unix
def posix_fallocate(fd: int, offset: int, length: int, /) -> None: ...
def posix_fadvise(fd: int, offset: int, length: int, advice: int, /) -> None: ...
def pread(__fd: int, __length: int, __offset: int) -> bytes: ...
def pwrite(__fd: int, __buffer: ReadableBuffer, __offset: int) -> int: ...
def pread(fd: int, length: int, offset: int, /) -> bytes: ...
def pwrite(fd: int, buffer: ReadableBuffer, offset: int, /) -> int: ...
# In CI, stubtest sometimes reports that these are available on MacOS, sometimes not
def preadv(__fd: int, __buffers: SupportsLenAndGetItem[WriteableBuffer], __offset: int, __flags: int = 0) -> int: ...
def pwritev(__fd: int, __buffers: SupportsLenAndGetItem[ReadableBuffer], __offset: int, __flags: int = 0) -> int: ...
def preadv(fd: int, buffers: SupportsLenAndGetItem[WriteableBuffer], offset: int, flags: int = 0, /) -> int: ...
def pwritev(fd: int, buffers: SupportsLenAndGetItem[ReadableBuffer], offset: int, flags: int = 0, /) -> int: ...
if sys.platform != "darwin":
if sys.version_info >= (3, 10):
RWF_APPEND: int # docs say available on 3.7+, stubtest says otherwise
@@ -709,8 +709,8 @@ if sys.platform != "win32":
flags: int = 0,
) -> int: ... # FreeBSD and Mac OS X only
def readv(__fd: int, __buffers: SupportsLenAndGetItem[WriteableBuffer]) -> int: ...
def writev(__fd: int, __buffers: SupportsLenAndGetItem[ReadableBuffer]) -> int: ...
def readv(fd: int, buffers: SupportsLenAndGetItem[WriteableBuffer], /) -> int: ...
def writev(fd: int, buffers: SupportsLenAndGetItem[ReadableBuffer], /) -> int: ...
@final
class terminal_size(structseq[int], tuple[int, int]):
@@ -722,21 +722,21 @@ class terminal_size(structseq[int], tuple[int, int]):
@property
def lines(self) -> int: ...
def get_terminal_size(__fd: int = ...) -> terminal_size: ...
def get_inheritable(__fd: int) -> bool: ...
def set_inheritable(__fd: int, __inheritable: bool) -> None: ...
def get_terminal_size(fd: int = ..., /) -> terminal_size: ...
def get_inheritable(fd: int, /) -> bool: ...
def set_inheritable(fd: int, inheritable: bool, /) -> None: ...
if sys.platform == "win32":
def get_handle_inheritable(__handle: int) -> bool: ...
def set_handle_inheritable(__handle: int, __inheritable: bool) -> None: ...
def get_handle_inheritable(handle: int, /) -> bool: ...
def set_handle_inheritable(handle: int, inheritable: bool, /) -> None: ...
if sys.platform != "win32":
# Unix only
def tcgetpgrp(__fd: int) -> int: ...
def tcsetpgrp(__fd: int, __pgid: int) -> None: ...
def ttyname(__fd: int) -> str: ...
def tcgetpgrp(fd: int, /) -> int: ...
def tcsetpgrp(fd: int, pgid: int, /) -> None: ...
def ttyname(fd: int, /) -> str: ...
def write(__fd: int, __data: ReadableBuffer) -> int: ...
def write(fd: int, data: ReadableBuffer, /) -> int: ...
def access(
path: FileDescriptorOrPath, mode: int, *, dir_fd: int | None = None, effective_ids: bool = False, follow_symlinks: bool = True
) -> bool: ...
@@ -779,9 +779,9 @@ def makedirs(name: StrOrBytesPath, mode: int = 0o777, exist_ok: bool = False) ->
if sys.platform != "win32":
def mknod(path: StrOrBytesPath, mode: int = 0o600, device: int = 0, *, dir_fd: int | None = None) -> None: ...
def major(__device: int) -> int: ...
def minor(__device: int) -> int: ...
def makedev(__major: int, __minor: int) -> int: ...
def major(device: int, /) -> int: ...
def minor(device: int, /) -> int: ...
def makedev(major: int, minor: int, /) -> int: ...
def pathconf(path: FileDescriptorOrPath, name: str | int) -> int: ... # Unix only
def readlink(path: GenericPath[AnyStr], *, dir_fd: int | None = None) -> AnyStr: ...
@@ -901,21 +901,21 @@ _ExecVArgs: TypeAlias = (
# we limit to str | bytes.
_ExecEnv: TypeAlias = Mapping[bytes, bytes | str] | Mapping[str, bytes | str]
def execv(__path: StrOrBytesPath, __argv: _ExecVArgs) -> NoReturn: ...
def execv(path: StrOrBytesPath, argv: _ExecVArgs, /) -> NoReturn: ...
def execve(path: FileDescriptorOrPath, argv: _ExecVArgs, env: _ExecEnv) -> NoReturn: ...
def execvp(file: StrOrBytesPath, args: _ExecVArgs) -> NoReturn: ...
def execvpe(file: StrOrBytesPath, args: _ExecVArgs, env: _ExecEnv) -> NoReturn: ...
def _exit(status: int) -> NoReturn: ...
def kill(__pid: int, __signal: int) -> None: ...
def kill(pid: int, signal: int, /) -> None: ...
if sys.platform != "win32":
# Unix only
def fork() -> int: ...
def forkpty() -> tuple[int, int]: ... # some flavors of Unix
def killpg(__pgid: int, __signal: int) -> None: ...
def nice(__increment: int) -> int: ...
def killpg(pgid: int, signal: int, /) -> None: ...
def nice(increment: int, /) -> int: ...
if sys.platform != "darwin":
def plock(__op: int) -> None: ... # ???op is int?
def plock(op: int, /) -> None: ... # ???op is int?
class _wrap_close(_TextIOWrapper):
def __init__(self, stream: _TextIOWrapper, proc: Popen[str]) -> None: ...
@@ -930,8 +930,8 @@ if sys.platform != "win32":
def spawnve(mode: int, file: StrOrBytesPath, args: _ExecVArgs, env: _ExecEnv) -> int: ...
else:
def spawnv(__mode: int, __path: StrOrBytesPath, __argv: _ExecVArgs) -> int: ...
def spawnve(__mode: int, __path: StrOrBytesPath, __argv: _ExecVArgs, __env: _ExecEnv) -> int: ...
def spawnv(mode: int, path: StrOrBytesPath, argv: _ExecVArgs, /) -> int: ...
def spawnve(mode: int, path: StrOrBytesPath, argv: _ExecVArgs, env: _ExecEnv, /) -> int: ...
def system(command: StrOrBytesPath) -> int: ...
@final
@@ -951,7 +951,7 @@ class times_result(structseq[float], tuple[float, float, float, float, float]):
def elapsed(self) -> float: ...
def times() -> times_result: ...
def waitpid(__pid: int, __options: int) -> tuple[int, int]: ...
def waitpid(pid: int, options: int, /) -> tuple[int, int]: ...
if sys.platform == "win32":
if sys.version_info >= (3, 10):
@@ -988,13 +988,13 @@ else:
@property
def si_code(self) -> int: ...
def waitid(__idtype: int, __ident: int, __options: int) -> waitid_result | None: ...
def waitid(idtype: int, ident: int, options: int, /) -> waitid_result | None: ...
from resource import struct_rusage
def wait3(options: int) -> tuple[int, int, struct_rusage]: ...
def wait4(pid: int, options: int) -> tuple[int, int, struct_rusage]: ...
def WCOREDUMP(__status: int) -> bool: ...
def WCOREDUMP(status: int, /) -> bool: ...
def WIFCONTINUED(status: int) -> bool: ...
def WIFSTOPPED(status: int) -> bool: ...
def WIFSIGNALED(status: int) -> bool: ...
@@ -1003,9 +1003,10 @@ else:
def WSTOPSIG(status: int) -> int: ...
def WTERMSIG(status: int) -> int: ...
def posix_spawn(
__path: StrOrBytesPath,
__argv: _ExecVArgs,
__env: _ExecEnv,
path: StrOrBytesPath,
argv: _ExecVArgs,
env: _ExecEnv,
/,
*,
file_actions: Sequence[tuple[Any, ...]] | None = ...,
setpgroup: int | None = ...,
@@ -1016,9 +1017,10 @@ else:
scheduler: tuple[Any, sched_param] | None = ...,
) -> int: ...
def posix_spawnp(
__path: StrOrBytesPath,
__argv: _ExecVArgs,
__env: _ExecEnv,
path: StrOrBytesPath,
argv: _ExecVArgs,
env: _ExecEnv,
/,
*,
file_actions: Sequence[tuple[Any, ...]] | None = ...,
setpgroup: int | None = ...,
@@ -1046,26 +1048,26 @@ if sys.platform != "win32":
def sched_get_priority_max(policy: int) -> int: ... # some flavors of Unix
def sched_yield() -> None: ... # some flavors of Unix
if sys.platform != "darwin":
def sched_setscheduler(__pid: int, __policy: int, __param: sched_param) -> None: ... # some flavors of Unix
def sched_getscheduler(__pid: int) -> int: ... # some flavors of Unix
def sched_rr_get_interval(__pid: int) -> float: ... # some flavors of Unix
def sched_setparam(__pid: int, __param: sched_param) -> None: ... # some flavors of Unix
def sched_getparam(__pid: int) -> sched_param: ... # some flavors of Unix
def sched_setaffinity(__pid: int, __mask: Iterable[int]) -> None: ... # some flavors of Unix
def sched_getaffinity(__pid: int) -> set[int]: ... # some flavors of Unix
def sched_setscheduler(pid: int, policy: int, param: sched_param, /) -> None: ... # some flavors of Unix
def sched_getscheduler(pid: int, /) -> int: ... # some flavors of Unix
def sched_rr_get_interval(pid: int, /) -> float: ... # some flavors of Unix
def sched_setparam(pid: int, param: sched_param, /) -> None: ... # some flavors of Unix
def sched_getparam(pid: int, /) -> sched_param: ... # some flavors of Unix
def sched_setaffinity(pid: int, mask: Iterable[int], /) -> None: ... # some flavors of Unix
def sched_getaffinity(pid: int, /) -> set[int]: ... # some flavors of Unix
def cpu_count() -> int | None: ...
if sys.platform != "win32":
# Unix only
def confstr(__name: str | int) -> str | None: ...
def confstr(name: str | int, /) -> str | None: ...
def getloadavg() -> tuple[float, float, float]: ...
def sysconf(__name: str | int) -> int: ...
def sysconf(name: str | int, /) -> int: ...
if sys.platform == "linux":
def getrandom(size: int, flags: int = 0) -> bytes: ...
def urandom(__size: int) -> bytes: ...
def urandom(size: int, /) -> bytes: ...
if sys.platform != "win32":
def register_at_fork(