massive update, probably broken
[dotfiles/.git] / .config / coc / extensions / coc-python-data / languageServer.0.5.59 / Typeshed / stdlib / 2 / os / __init__.pyi
diff --git a/.config/coc/extensions/coc-python-data/languageServer.0.5.59/Typeshed/stdlib/2/os/__init__.pyi b/.config/coc/extensions/coc-python-data/languageServer.0.5.59/Typeshed/stdlib/2/os/__init__.pyi
new file mode 100644 (file)
index 0000000..e3c5a19
--- /dev/null
@@ -0,0 +1,350 @@
+# Stubs for os\r
+# Ron Murawski <ron@horizonchess.com>\r
+\r
+from builtins import OSError as error\r
+from io import TextIOWrapper as _TextIOWrapper\r
+from posix import stat_result as stat_result  # TODO: use this, see https://github.com/python/mypy/issues/3078\r
+import sys\r
+from typing import (\r
+    Mapping, MutableMapping, Dict, List, Any, Tuple, Iterator, overload, Union, AnyStr,\r
+    Optional, Generic, Set, Callable, Text, Sequence, IO, NamedTuple, NoReturn, TypeVar\r
+)\r
+from . import path as path\r
+\r
+_T = TypeVar('_T')\r
+\r
+# ----- os variables -----\r
+\r
+if sys.version_info >= (3, 2):\r
+    supports_bytes_environ: bool\r
+\r
+if sys.version_info >= (3, 3):\r
+    supports_dir_fd: Set[Callable[..., Any]]\r
+    supports_fd: Set[Callable[..., Any]]\r
+    supports_effective_ids: Set[Callable[..., Any]]\r
+    supports_follow_symlinks: Set[Callable[..., Any]]\r
+\r
+SEEK_SET: int\r
+SEEK_CUR: int\r
+SEEK_END: int\r
+\r
+O_RDONLY: int\r
+O_WRONLY: int\r
+O_RDWR: int\r
+O_APPEND: int\r
+O_CREAT: int\r
+O_EXCL: int\r
+O_TRUNC: int\r
+O_DSYNC: int    # Unix only\r
+O_RSYNC: int    # Unix only\r
+O_SYNC: int     # Unix only\r
+O_NDELAY: int   # Unix only\r
+O_NONBLOCK: int  # Unix only\r
+O_NOCTTY: int   # Unix only\r
+O_SHLOCK: int   # Unix only\r
+O_EXLOCK: int   # Unix only\r
+O_BINARY: int     # Windows only\r
+O_NOINHERIT: int  # Windows only\r
+O_SHORT_LIVED: int  # Windows only\r
+O_TEMPORARY: int  # Windows only\r
+O_RANDOM: int     # Windows only\r
+O_SEQUENTIAL: int  # Windows only\r
+O_TEXT: int       # Windows only\r
+O_ASYNC: int      # Gnu extension if in C library\r
+O_DIRECT: int     # Gnu extension if in C library\r
+O_DIRECTORY: int  # Gnu extension if in C library\r
+O_NOFOLLOW: int   # Gnu extension if in C library\r
+O_NOATIME: int    # Gnu extension if in C library\r
+O_LARGEFILE: int  # Gnu extension if in C library\r
+\r
+curdir: str\r
+pardir: str\r
+sep: str\r
+altsep: str\r
+extsep: str\r
+pathsep: str\r
+defpath: str\r
+linesep: str\r
+devnull: str\r
+name: str\r
+\r
+F_OK: int\r
+R_OK: int\r
+W_OK: int\r
+X_OK: int\r
+\r
+class _Environ(MutableMapping[AnyStr, AnyStr], Generic[AnyStr]):\r
+    def copy(self) -> Dict[AnyStr, AnyStr]: ...\r
+    def __delitem__(self, key: AnyStr) -> None: ...\r
+    def __getitem__(self, key: AnyStr) -> AnyStr: ...\r
+    def __setitem__(self, key: AnyStr, value: AnyStr) -> None: ...\r
+    def __iter__(self) -> Iterator[AnyStr]: ...\r
+    def __len__(self) -> int: ...\r
+\r
+environ: _Environ[str]\r
+if sys.version_info >= (3, 2):\r
+    environb: _Environ[bytes]\r
+\r
+confstr_names: Dict[str, int]  # Unix only\r
+pathconf_names: Dict[str, int]  # Unix only\r
+sysconf_names: Dict[str, int]  # Unix only\r
+\r
+EX_OK: int        # Unix only\r
+EX_USAGE: int     # Unix only\r
+EX_DATAERR: int   # Unix only\r
+EX_NOINPUT: int   # Unix only\r
+EX_NOUSER: int    # Unix only\r
+EX_NOHOST: int    # Unix only\r
+EX_UNAVAILABLE: int  # Unix only\r
+EX_SOFTWARE: int  # Unix only\r
+EX_OSERR: int     # Unix only\r
+EX_OSFILE: int    # Unix only\r
+EX_CANTCREAT: int  # Unix only\r
+EX_IOERR: int     # Unix only\r
+EX_TEMPFAIL: int  # Unix only\r
+EX_PROTOCOL: int  # Unix only\r
+EX_NOPERM: int    # Unix only\r
+EX_CONFIG: int    # Unix only\r
+EX_NOTFOUND: int  # Unix only\r
+\r
+P_NOWAIT: int\r
+P_NOWAITO: int\r
+P_WAIT: int\r
+if sys.platform == 'win32':\r
+    P_DETACH: int  # Windows only\r
+    P_OVERLAY: int  # Windows only\r
+\r
+# wait()/waitpid() options\r
+WNOHANG: int  # Unix only\r
+WCONTINUED: int  # some Unix systems\r
+WUNTRACED: int  # Unix only\r
+\r
+TMP_MAX: int  # Undocumented, but used by tempfile\r
+\r
+# ----- os classes (structures) -----\r
+if sys.version_info >= (3, 6):\r
+    from builtins import _PathLike as PathLike  # See comment in builtins\r
+\r
+_PathType = path._PathType\r
+\r
+_StatVFS = NamedTuple('_StatVFS', [('f_bsize', int), ('f_frsize', int), ('f_blocks', int),\r
+                                   ('f_bfree', int), ('f_bavail', int), ('f_files', int),\r
+                                   ('f_ffree', int), ('f_favail', int), ('f_flag', int),\r
+                                   ('f_namemax', int)])\r
+\r
+def ctermid() -> str: ...  # Unix only\r
+def getegid() -> int: ...  # Unix only\r
+def geteuid() -> int: ...  # Unix only\r
+def getgid() -> int: ...   # Unix only\r
+def getgroups() -> List[int]: ...  # Unix only, behaves differently on Mac\r
+def initgroups(username: str, gid: int) -> None: ...  # Unix only\r
+def getlogin() -> str: ...\r
+def getpgid(pid: int) -> int: ...  # Unix only\r
+def getpgrp() -> int: ...  # Unix only\r
+def getpid() -> int: ...\r
+def getppid() -> int: ...\r
+def getresuid() -> Tuple[int, int, int]: ...  # Unix only\r
+def getresgid() -> Tuple[int, int, int]: ...  # Unix only\r
+def getuid() -> int: ...  # Unix only\r
+def setegid(egid: int) -> None: ...  # Unix only\r
+def seteuid(euid: int) -> None: ...  # Unix only\r
+def setgid(gid: int) -> None: ...  # Unix only\r
+def setgroups(groups: Sequence[int]) -> None: ...  # Unix only\r
+def setpgrp() -> None: ...  # Unix only\r
+def setpgid(pid: int, pgrp: int) -> None: ...  # Unix only\r
+def setregid(rgid: int, egid: int) -> None: ...  # Unix only\r
+def setresgid(rgid: int, egid: int, sgid: int) -> None: ...  # Unix only\r
+def setresuid(ruid: int, euid: int, suid: int) -> None: ...  # Unix only\r
+def setreuid(ruid: int, euid: int) -> None: ...  # Unix only\r
+def getsid(pid: int) -> int: ...  # Unix only\r
+def setsid() -> None: ...  # Unix only\r
+def setuid(uid: int) -> None: ...  # Unix only\r
+def strerror(code: int) -> str: ...\r
+def umask(mask: int) -> int: ...\r
+def uname() -> Tuple[str, str, str, str, str]: ...  # Unix only\r
+\r
+@overload\r
+def getenv(key: Text) -> Optional[str]: ...\r
+@overload\r
+def getenv(key: Text, default: _T) -> Union[str, _T]: ...\r
+def putenv(key: Union[bytes, Text], value: Union[bytes, Text]) -> None: ...\r
+def unsetenv(key: Union[bytes, Text]) -> None: ...\r
+\r
+def fdopen(fd: int, *args, **kwargs) -> IO[Any]: ...\r
+def close(fd: int) -> None: ...\r
+def closerange(fd_low: int, fd_high: int) -> None: ...\r
+def dup(fd: int) -> int: ...\r
+def dup2(fd: int, fd2: int) -> None: ...\r
+def fchmod(fd: int, mode: int) -> None: ...  # Unix only\r
+def fchown(fd: int, uid: int, gid: int) -> None: ...  # Unix only\r
+def fdatasync(fd: int) -> None: ...  # Unix only, not Mac\r
+def fpathconf(fd: int, name: Union[str, int]) -> int: ...  # Unix only\r
+def fstat(fd: int) -> Any: ...\r
+def fstatvfs(fd: int) -> _StatVFS: ...  # Unix only\r
+def fsync(fd: int) -> None: ...\r
+def ftruncate(fd: int, length: int) -> None: ...  # Unix only\r
+def isatty(fd: int) -> bool: ...  # Unix only\r
+def lseek(fd: int, pos: int, how: int) -> int: ...\r
+def open(file: _PathType, flags: int, mode: int = ...) -> int: ...\r
+def openpty() -> Tuple[int, int]: ...  # some flavors of Unix\r
+def pipe() -> Tuple[int, int]: ...\r
+def read(fd: int, n: int) -> bytes: ...\r
+def tcgetpgrp(fd: int) -> int: ...  # Unix only\r
+def tcsetpgrp(fd: int, pg: int) -> None: ...  # Unix only\r
+def ttyname(fd: int) -> str: ...  # Unix only\r
+def write(fd: int, string: bytes) -> int: ...\r
+def access(path: _PathType, mode: int) -> bool: ...\r
+def chdir(path: _PathType) -> None: ...\r
+def fchdir(fd: int) -> None: ...\r
+def getcwd() -> str: ...\r
+def getcwdu() -> unicode: ...\r
+def chflags(path: _PathType, flags: int) -> None: ...  # Unix only\r
+def chroot(path: _PathType) -> None: ...  # Unix only\r
+def chmod(path: _PathType, mode: int) -> None: ...\r
+def chown(path: _PathType, uid: int, gid: int) -> None: ...  # Unix only\r
+def lchflags(path: _PathType, flags: int) -> None: ...  # Unix only\r
+def lchmod(path: _PathType, mode: int) -> None: ...  # Unix only\r
+def lchown(path: _PathType, uid: int, gid: int) -> None: ...  # Unix only\r
+def link(src: _PathType, link_name: _PathType) -> None: ...\r
+def listdir(path: AnyStr) -> List[AnyStr]: ...\r
+def lstat(path: _PathType) -> Any: ...\r
+def mkfifo(path: _PathType, mode: int = ...) -> None: ...  # Unix only\r
+def mknod(filename: _PathType, mode: int = ..., device: int = ...) -> None: ...\r
+def major(device: int) -> int: ...\r
+def minor(device: int) -> int: ...\r
+def makedev(major: int, minor: int) -> int: ...\r
+def mkdir(path: _PathType, mode: int = ...) -> None: ...\r
+def makedirs(path: _PathType, mode: int = ...) -> None: ...\r
+def pathconf(path: _PathType, name: Union[str, int]) -> int: ...  # Unix only\r
+def readlink(path: AnyStr) -> AnyStr: ...\r
+def remove(path: _PathType) -> None: ...\r
+def removedirs(path: _PathType) -> None: ...\r
+def rename(src: _PathType, dst: _PathType) -> None: ...\r
+def renames(old: _PathType, new: _PathType) -> None: ...\r
+def rmdir(path: _PathType) -> None: ...\r
+def stat(path: _PathType) -> Any: ...\r
+@overload\r
+def stat_float_times() -> bool: ...\r
+@overload\r
+def stat_float_times(newvalue: bool) -> None: ...\r
+def statvfs(path: _PathType) -> _StatVFS: ...  # Unix only\r
+def symlink(source: _PathType, link_name: _PathType) -> None: ...\r
+def unlink(path: _PathType) -> None: ...\r
+# TODO: add ns, dir_fd, follow_symlinks argument\r
+if sys.version_info >= (3, 0):\r
+    def utime(path: _PathType, times: Optional[Tuple[float, float]] = ...) -> None: ...\r
+else:\r
+    def utime(path: _PathType, times: Optional[Tuple[float, float]]) -> None: ...\r
+\r
+if sys.version_info >= (3, 6):\r
+    def walk(top: Union[AnyStr, PathLike[AnyStr]], topdown: bool = ...,\r
+             onerror: Optional[Callable[[OSError], Any]] = ...,\r
+             followlinks: bool = ...) -> Iterator[Tuple[AnyStr, List[AnyStr],\r
+                                                        List[AnyStr]]]: ...\r
+else:\r
+    def walk(top: AnyStr, topdown: bool = ..., onerror: Optional[Callable[[OSError], Any]] = ...,\r
+             followlinks: bool = ...) -> Iterator[Tuple[AnyStr, List[AnyStr],\r
+                                                        List[AnyStr]]]: ...\r
+\r
+def abort() -> NoReturn: ...\r
+# These are defined as execl(file, *args) but the first *arg is mandatory.\r
+def execl(file: _PathType, __arg0: Union[bytes, Text], *args: Union[bytes, Text]) -> NoReturn: ...\r
+def execlp(file: _PathType, __arg0: Union[bytes, Text], *args: Union[bytes, Text]) -> NoReturn: ...\r
+\r
+# These are: execle(file, *args, env) but env is pulled from the last element of the args.\r
+def execle(file: _PathType, __arg0: Union[bytes, Text], *args: Any) -> NoReturn: ...\r
+def execlpe(file: _PathType, __arg0: Union[bytes, Text], *args: Any) -> NoReturn: ...\r
+\r
+# The docs say `args: tuple or list of strings`\r
+# The implementation enforces tuple or list so we can't use Sequence.\r
+_ExecVArgs = Union[Tuple[Union[bytes, Text], ...], List[bytes], List[Text], List[Union[bytes, Text]]]\r
+def execv(path: _PathType, args: _ExecVArgs) -> NoReturn: ...\r
+def execve(path: _PathType, args: _ExecVArgs, env: Mapping[str, str]) -> NoReturn: ...\r
+def execvp(file: _PathType, args: _ExecVArgs) -> NoReturn: ...\r
+def execvpe(file: _PathType, args: _ExecVArgs, env: Mapping[str, str]) -> NoReturn: ...\r
+\r
+def _exit(n: int) -> NoReturn: ...\r
+def fork() -> int: ...  # Unix only\r
+def forkpty() -> Tuple[int, int]: ...  # some flavors of Unix\r
+def kill(pid: int, sig: int) -> None: ...\r
+def killpg(pgid: int, sig: int) -> None: ...  # Unix only\r
+def nice(increment: int) -> int: ...  # Unix only\r
+def plock(op: int) -> None: ...  # Unix only ???op is int?\r
+\r
+if sys.version_info >= (3, 0):\r
+    class popen(_TextIOWrapper):\r
+        # TODO 'b' modes or bytes command not accepted?\r
+        def __init__(self, command: str, mode: str = ...,\r
+                     bufsize: int = ...) -> None: ...\r
+        def close(self) -> Any: ...  # may return int\r
+else:\r
+    def popen(command: str, *args, **kwargs) -> IO[Any]: ...\r
+    def popen2(cmd: str, *args, **kwargs) -> Tuple[IO[Any], IO[Any]]: ...\r
+    def popen3(cmd: str, *args, **kwargs) -> Tuple[IO[Any], IO[Any], IO[Any]]: ...\r
+    def popen4(cmd: str, *args, **kwargs) -> Tuple[IO[Any], IO[Any]]: ...\r
+\r
+def spawnl(mode: int, path: _PathType, arg0: Union[bytes, Text], *args: Union[bytes, Text]) -> int: ...\r
+def spawnle(mode: int, path: _PathType, arg0: Union[bytes, Text],\r
+            *args: Any) -> int: ...  # Imprecise sig\r
+def spawnlp(mode: int, file: _PathType, arg0: Union[bytes, Text],\r
+            *args: Union[bytes, Text]) -> int: ...  # Unix only TODO\r
+def spawnlpe(mode: int, file: _PathType, arg0: Union[bytes, Text], *args: Any) -> int:\r
+    ...  # Imprecise signature; Unix only TODO\r
+def spawnv(mode: int, path: _PathType, args: List[Union[bytes, Text]]) -> int: ...\r
+def spawnve(mode: int, path: _PathType, args: List[Union[bytes, Text]],\r
+            env: Mapping[str, str]) -> int: ...\r
+def spawnvp(mode: int, file: _PathType, args: List[Union[bytes, Text]]) -> int: ...  # Unix only\r
+def spawnvpe(mode: int, file: _PathType, args: List[Union[bytes, Text]],\r
+             env: Mapping[str, str]) -> int:\r
+    ...  # Unix only\r
+def startfile(path: _PathType, operation: Optional[str] = ...) -> None: ...  # Windows only\r
+def system(command: _PathType) -> int: ...\r
+def times() -> Tuple[float, float, float, float, float]: ...\r
+def wait() -> Tuple[int, int]: ...  # Unix only\r
+def waitpid(pid: int, options: int) -> Tuple[int, int]: ...\r
+def wait3(options: int) -> Tuple[int, int, Any]: ...  # Unix only\r
+def wait4(pid: int, options: int) -> Tuple[int, int, Any]: ...  # Unix only\r
+def WCOREDUMP(status: int) -> bool: ...  # Unix only\r
+def WIFCONTINUED(status: int) -> bool: ...  # Unix only\r
+def WIFSTOPPED(status: int) -> bool: ...  # Unix only\r
+def WIFSIGNALED(status: int) -> bool: ...  # Unix only\r
+def WIFEXITED(status: int) -> bool: ...  # Unix only\r
+def WEXITSTATUS(status: int) -> int: ...  # Unix only\r
+def WSTOPSIG(status: int) -> int: ...  # Unix only\r
+def WTERMSIG(status: int) -> int: ...  # Unix only\r
+def confstr(name: Union[str, int]) -> Optional[str]: ...  # Unix only\r
+def getloadavg() -> Tuple[float, float, float]: ...  # Unix only\r
+def sysconf(name: Union[str, int]) -> int: ...  # Unix only\r
+def urandom(n: int) -> bytes: ...\r
+\r
+if sys.version_info >= (3, 0):\r
+    def sched_getaffinity(id: int) -> Set[int]: ...\r
+if sys.version_info >= (3, 3):\r
+    class waitresult:\r
+        si_pid: int\r
+    def waitid(idtype: int, id: int, options: int) -> waitresult: ...\r
+\r
+if sys.version_info < (3, 0):\r
+    def tmpfile() -> IO[Any]: ...\r
+    def tmpnam() -> str: ...\r
+    def tempnam(dir: str = ..., prefix: str = ...) -> str: ...\r
+\r
+P_ALL: int\r
+WEXITED: int\r
+WNOWAIT: int\r
+\r
+if sys.version_info >= (3, 3):\r
+    def sync() -> None: ...  # Unix only\r
+\r
+    def truncate(path: Union[_PathType, int], length: int) -> None: ...  # Unix only up to version 3.4\r
+\r
+    def fwalk(top: AnyStr = ..., topdown: bool = ...,\r
+              onerror: Callable = ..., *, follow_symlinks: bool = ...,\r
+              dir_fd: int = ...) -> Iterator[Tuple[AnyStr, List[AnyStr],\r
+                                             List[AnyStr], int]]: ...  # Unix only\r
+\r
+    terminal_size = NamedTuple('terminal_size', [('columns', int), ('lines', int)])\r
+    def get_terminal_size(fd: int = ...) -> terminal_size: ...\r
+\r
+if sys.version_info >= (3, 4):\r
+    def cpu_count() -> Optional[int]: ...\r