massive update, probably broken
[dotfiles/.git] / .config / coc / extensions / coc-python-data / languageServer.0.5.59 / Typeshed / stdlib / 2 / os / path.pyi
diff --git a/.config/coc/extensions/coc-python-data/languageServer.0.5.59/Typeshed/stdlib/2/os/path.pyi b/.config/coc/extensions/coc-python-data/languageServer.0.5.59/Typeshed/stdlib/2/os/path.pyi
new file mode 100644 (file)
index 0000000..344d3ad
--- /dev/null
@@ -0,0 +1,173 @@
+# NB: path.pyi and stdlib/2 and stdlib/3 must remain consistent!\r
+# Stubs for os.path\r
+# Ron Murawski <ron@horizonchess.com>\r
+\r
+from posix import stat_result\r
+import sys\r
+from typing import (\r
+    overload, List, Any, AnyStr, Sequence, Tuple, BinaryIO, TextIO,\r
+    TypeVar, Union, Text, Callable, Optional\r
+)\r
+\r
+_T = TypeVar('_T')\r
+\r
+if sys.version_info >= (3, 6):\r
+    from builtins import _PathLike\r
+    _PathType = Union[bytes, Text, _PathLike]\r
+    _StrPath = Union[Text, _PathLike[Text]]\r
+    _BytesPath = Union[bytes, _PathLike[bytes]]\r
+else:\r
+    _PathType = Union[bytes, Text]\r
+    _StrPath = Text\r
+    _BytesPath = bytes\r
+\r
+# ----- os.path variables -----\r
+supports_unicode_filenames: bool\r
+# aliases (also in os)\r
+curdir: str\r
+pardir: str\r
+sep: str\r
+altsep: str\r
+extsep: str\r
+pathsep: str\r
+defpath: str\r
+devnull: str\r
+\r
+# ----- os.path function stubs -----\r
+if sys.version_info >= (3, 6):\r
+    # Overloads are necessary to work around python/mypy#3644.\r
+    @overload\r
+    def abspath(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def abspath(path: AnyStr) -> AnyStr: ...\r
+    @overload\r
+    def basename(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def basename(path: AnyStr) -> AnyStr: ...\r
+    @overload\r
+    def dirname(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def dirname(path: AnyStr) -> AnyStr: ...\r
+    @overload\r
+    def expanduser(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def expanduser(path: AnyStr) -> AnyStr: ...\r
+    @overload\r
+    def expandvars(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def expandvars(path: AnyStr) -> AnyStr: ...\r
+    @overload\r
+    def normcase(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def normcase(path: AnyStr) -> AnyStr: ...\r
+    @overload\r
+    def normpath(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+    @overload\r
+    def normpath(path: AnyStr) -> AnyStr: ...\r
+    if sys.platform == 'win32':\r
+        @overload\r
+        def realpath(path: _PathLike[AnyStr]) -> AnyStr: ...\r
+        @overload\r
+        def realpath(path: AnyStr) -> AnyStr: ...\r
+    else:\r
+        @overload\r
+        def realpath(filename: _PathLike[AnyStr]) -> AnyStr: ...\r
+        @overload\r
+        def realpath(filename: AnyStr) -> AnyStr: ...\r
+\r
+else:\r
+    def abspath(path: AnyStr) -> AnyStr: ...\r
+    def basename(path: AnyStr) -> AnyStr: ...\r
+    def dirname(path: AnyStr) -> AnyStr: ...\r
+    def expanduser(path: AnyStr) -> AnyStr: ...\r
+    def expandvars(path: AnyStr) -> AnyStr: ...\r
+    def normcase(path: AnyStr) -> AnyStr: ...\r
+    def normpath(path: AnyStr) -> AnyStr: ...\r
+    if sys.platform == 'win32':\r
+        def realpath(path: AnyStr) -> AnyStr: ...\r
+    else:\r
+        def realpath(filename: AnyStr) -> AnyStr: ...\r
+\r
+if sys.version_info >= (3, 6):\r
+    # In reality it returns str for sequences of _StrPath and bytes for sequences\r
+    # of _BytesPath, but mypy does not accept such a signature.\r
+    def commonpath(paths: Sequence[_PathType]) -> Any: ...\r
+elif sys.version_info >= (3, 5):\r
+    def commonpath(paths: Sequence[AnyStr]) -> AnyStr: ...\r
+\r
+# NOTE: Empty lists results in '' (str) regardless of contained type.\r
+# Also, in Python 2 mixed sequences of Text and bytes results in either Text or bytes\r
+# So, fall back to Any\r
+def commonprefix(list: Sequence[_PathType]) -> Any: ...\r
+\r
+def exists(path: _PathType) -> bool: ...\r
+def lexists(path: _PathType) -> bool: ...\r
+\r
+# These return float if os.stat_float_times() == True,\r
+# but int is a subclass of float.\r
+def getatime(path: _PathType) -> float: ...\r
+def getmtime(path: _PathType) -> float: ...\r
+def getctime(path: _PathType) -> float: ...\r
+\r
+def getsize(path: _PathType) -> int: ...\r
+def isabs(path: _PathType) -> bool: ...\r
+def isfile(path: _PathType) -> bool: ...\r
+def isdir(path: _PathType) -> bool: ...\r
+def islink(path: _PathType) -> bool: ...\r
+def ismount(path: _PathType) -> bool: ...\r
+\r
+if sys.version_info < (3, 0):\r
+    # Make sure signatures are disjunct, and allow combinations of bytes and unicode.\r
+    # (Since Python 2 allows that, too)\r
+    # Note that e.g. os.path.join("a", "b", "c", "d", u"e") will still result in\r
+    # a type error.\r
+    @overload\r
+    def join(__p1: bytes, *p: bytes) -> bytes: ...\r
+    @overload\r
+    def join(__p1: bytes, __p2: bytes, __p3: bytes, __p4: Text, *p: _PathType) -> Text: ...\r
+    @overload\r
+    def join(__p1: bytes, __p2: bytes, __p3: Text, *p: _PathType) -> Text: ...\r
+    @overload\r
+    def join(__p1: bytes, __p2: Text, *p: _PathType) -> Text: ...\r
+    @overload\r
+    def join(__p1: Text, *p: _PathType) -> Text: ...\r
+elif sys.version_info >= (3, 6):\r
+    # Mypy complains that the signatures overlap (same for relpath below), but things seem to behave correctly anyway.\r
+    @overload\r
+    def join(path: _StrPath, *paths: _StrPath) -> Text: ...  # type: ignore\r
+    @overload\r
+    def join(path: _BytesPath, *paths: _BytesPath) -> bytes: ...\r
+else:\r
+    def join(path: AnyStr, *paths: AnyStr) -> AnyStr: ...\r
+\r
+@overload\r
+def relpath(path: _BytesPath, start: Optional[_BytesPath] = ...) -> bytes: ...  # type: ignore\r
+@overload\r
+def relpath(path: _StrPath, start: Optional[_StrPath] = ...) -> Text: ...\r
+\r
+def samefile(path1: _PathType, path2: _PathType) -> bool: ...\r
+def sameopenfile(fp1: int, fp2: int) -> bool: ...\r
+def samestat(stat1: stat_result, stat2: stat_result) -> bool: ...\r
+\r
+if sys.version_info >= (3, 6):\r
+    @overload\r
+    def split(path: _PathLike[AnyStr]) -> Tuple[AnyStr, AnyStr]: ...\r
+    @overload\r
+    def split(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...\r
+    @overload\r
+    def splitdrive(path: _PathLike[AnyStr]) -> Tuple[AnyStr, AnyStr]: ...\r
+    @overload\r
+    def splitdrive(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...\r
+    @overload\r
+    def splitext(path: _PathLike[AnyStr]) -> Tuple[AnyStr, AnyStr]: ...\r
+    @overload\r
+    def splitext(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...\r
+else:\r
+    def split(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...\r
+    def splitdrive(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...\r
+    def splitext(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...\r
+\r
+def splitunc(path: AnyStr) -> Tuple[AnyStr, AnyStr]: ...  # Windows only, deprecated\r
+\r
+if sys.version_info < (3,):\r
+    def walk(path: AnyStr, visit: Callable[[_T, AnyStr, List[AnyStr]], Any], arg: _T) -> None: ...\r