Re-organize directory structure (#4971)

See discussion in #2491

Co-authored-by: Ivan Levkivskyi <ilevkivskyi@dropbox.com>

stdlib/pathlib.pyi

@@ -0,0 +1,174 @@
+import os
+import sys
+from _typeshed import OpenBinaryMode, OpenBinaryModeReading, OpenBinaryModeUpdating, OpenBinaryModeWriting, OpenTextMode
+from io import BufferedRandom, BufferedReader, BufferedWriter, FileIO, TextIOWrapper
+from types import TracebackType
+from typing import IO, Any, BinaryIO, Generator, List, Optional, Sequence, Tuple, Type, TypeVar, Union, overload
+from typing_extensions import Literal
+
+if sys.version_info >= (3, 9):
+    from types import GenericAlias
+
+_P = TypeVar("_P", bound=PurePath)
+
+_PurePathBase = os.PathLike[str]
+_PathLike = os.PathLike[str]
+
+class PurePath(_PurePathBase):
+    parts: Tuple[str, ...]
+    drive: str
+    root: str
+    anchor: str
+    name: str
+    suffix: str
+    suffixes: List[str]
+    stem: str
+    def __new__(cls: Type[_P], *args: Union[str, _PathLike]) -> _P: ...
+    def __hash__(self) -> int: ...
+    def __lt__(self, other: PurePath) -> bool: ...
+    def __le__(self, other: PurePath) -> bool: ...
+    def __gt__(self, other: PurePath) -> bool: ...
+    def __ge__(self, other: PurePath) -> bool: ...
+    def __truediv__(self: _P, key: Union[str, _PathLike]) -> _P: ...
+    def __rtruediv__(self: _P, key: Union[str, _PathLike]) -> _P: ...
+    def __bytes__(self) -> bytes: ...
+    def as_posix(self) -> str: ...
+    def as_uri(self) -> str: ...
+    def is_absolute(self) -> bool: ...
+    def is_reserved(self) -> bool: ...
+    if sys.version_info >= (3, 9):
+        def is_relative_to(self, *other: Union[str, os.PathLike[str]]) -> bool: ...
+    def match(self, path_pattern: str) -> bool: ...
+    def relative_to(self: _P, *other: Union[str, _PathLike]) -> _P: ...
+    def with_name(self: _P, name: str) -> _P: ...
+    if sys.version_info >= (3, 9):
+        def with_stem(self: _P, stem: str) -> _P: ...
+    def with_suffix(self: _P, suffix: str) -> _P: ...
+    def joinpath(self: _P, *other: Union[str, _PathLike]) -> _P: ...
+    @property
+    def parents(self: _P) -> Sequence[_P]: ...
+    @property
+    def parent(self: _P) -> _P: ...
+    if sys.version_info >= (3, 9):
+        def __class_getitem__(cls, type: Any) -> GenericAlias: ...
+
+class PurePosixPath(PurePath): ...
+class PureWindowsPath(PurePath): ...
+
+class Path(PurePath):
+    def __new__(cls: Type[_P], *args: Union[str, _PathLike], **kwargs: Any) -> _P: ...
+    def __enter__(self: _P) -> _P: ...
+    def __exit__(
+        self, exc_type: Optional[Type[BaseException]], exc_value: Optional[BaseException], traceback: Optional[TracebackType]
+    ) -> Optional[bool]: ...
+    @classmethod
+    def cwd(cls: Type[_P]) -> _P: ...
+    def stat(self) -> os.stat_result: ...
+    def chmod(self, mode: int) -> None: ...
+    def exists(self) -> bool: ...
+    def glob(self: _P, pattern: str) -> Generator[_P, None, None]: ...
+    def group(self) -> str: ...
+    def is_dir(self) -> bool: ...
+    def is_file(self) -> bool: ...
+    if sys.version_info >= (3, 7):
+        def is_mount(self) -> bool: ...
+    def is_symlink(self) -> bool: ...
+    def is_socket(self) -> bool: ...
+    def is_fifo(self) -> bool: ...
+    def is_block_device(self) -> bool: ...
+    def is_char_device(self) -> bool: ...
+    def iterdir(self: _P) -> Generator[_P, None, None]: ...
+    def lchmod(self, mode: int) -> None: ...
+    def lstat(self) -> os.stat_result: ...
+    def mkdir(self, mode: int = ..., parents: bool = ..., exist_ok: bool = ...) -> None: ...
+    # Adapted from builtins.open
+    # Text mode: always returns a TextIOWrapper
+    @overload
+    def open(
+        self,
+        mode: OpenTextMode = ...,
+        buffering: int = ...,
+        encoding: Optional[str] = ...,
+        errors: Optional[str] = ...,
+        newline: Optional[str] = ...,
+    ) -> TextIOWrapper: ...
+    # Unbuffered binary mode: returns a FileIO
+    @overload
+    def open(
+        self, mode: OpenBinaryMode, buffering: Literal[0], encoding: None = ..., errors: None = ..., newline: None = ...
+    ) -> FileIO: ...
+    # Buffering is on: return BufferedRandom, BufferedReader, or BufferedWriter
+    @overload
+    def open(
+        self,
+        mode: OpenBinaryModeUpdating,
+        buffering: Literal[-1, 1] = ...,
+        encoding: None = ...,
+        errors: None = ...,
+        newline: None = ...,
+    ) -> BufferedRandom: ...
+    @overload
+    def open(
+        self,
+        mode: OpenBinaryModeWriting,
+        buffering: Literal[-1, 1] = ...,
+        encoding: None = ...,
+        errors: None = ...,
+        newline: None = ...,
+    ) -> BufferedWriter: ...
+    @overload
+    def open(
+        self,
+        mode: OpenBinaryModeReading,
+        buffering: Literal[-1, 1] = ...,
+        encoding: None = ...,
+        errors: None = ...,
+        newline: None = ...,
+    ) -> BufferedReader: ...
+    # Buffering cannot be determined: fall back to BinaryIO
+    @overload
+    def open(
+        self, mode: OpenBinaryMode, buffering: int, encoding: None = ..., errors: None = ..., newline: None = ...
+    ) -> BinaryIO: ...
+    # Fallback if mode is not specified
+    @overload
+    def open(
+        self,
+        mode: str,
+        buffering: int = ...,
+        encoding: Optional[str] = ...,
+        errors: Optional[str] = ...,
+        newline: Optional[str] = ...,
+    ) -> IO[Any]: ...
+    def owner(self) -> str: ...
+    if sys.version_info >= (3, 9):
+        def readlink(self: _P) -> _P: ...
+    if sys.version_info >= (3, 8):
+        def rename(self: _P, target: Union[str, PurePath]) -> _P: ...
+        def replace(self: _P, target: Union[str, PurePath]) -> _P: ...
+    else:
+        def rename(self, target: Union[str, PurePath]) -> None: ...
+        def replace(self, target: Union[str, PurePath]) -> None: ...
+    def resolve(self: _P, strict: bool = ...) -> _P: ...
+    def rglob(self: _P, pattern: str) -> Generator[_P, None, None]: ...
+    def rmdir(self) -> None: ...
+    def symlink_to(self, target: Union[str, Path], target_is_directory: bool = ...) -> None: ...
+    def touch(self, mode: int = ..., exist_ok: bool = ...) -> None: ...
+    if sys.version_info >= (3, 8):
+        def unlink(self, missing_ok: bool = ...) -> None: ...
+    else:
+        def unlink(self) -> None: ...
+    @classmethod
+    def home(cls: Type[_P]) -> _P: ...
+    def absolute(self: _P) -> _P: ...
+    def expanduser(self: _P) -> _P: ...
+    def read_bytes(self) -> bytes: ...
+    def read_text(self, encoding: Optional[str] = ..., errors: Optional[str] = ...) -> str: ...
+    def samefile(self, other_path: Union[str, bytes, int, Path]) -> bool: ...
+    def write_bytes(self, data: bytes) -> int: ...
+    def write_text(self, data: str, encoding: Optional[str] = ..., errors: Optional[str] = ...) -> int: ...
+    if sys.version_info >= (3, 8):
+        def link_to(self, target: Union[str, bytes, os.PathLike[str]]) -> None: ...
+
+class PosixPath(Path, PurePosixPath): ...
+class WindowsPath(Path, PureWindowsPath): ...