Enable sys stubs (PY-34461)

GitOrigin-RevId: d1bf0dc135aeb088412c69e47012e381456e9a6e

python/helpers/typeshed/stdlib/2/sys.pyi

@@ -0,0 +1,138 @@
+"""Stubs for the 'sys' module."""
+
+from typing import (
+    IO, NoReturn, Union, List, Sequence, Any, Dict, Tuple, BinaryIO, Optional,
+    Callable, overload, Text, Type,
+)
+from types import FrameType, ModuleType, TracebackType, ClassType
+
+# The following type alias are stub-only and do not exist during runtime
+_ExcInfo = Tuple[Type[BaseException], BaseException, TracebackType]
+_OptExcInfo = Union[_ExcInfo, Tuple[None, None, None]]
+
+class _flags:
+    bytes_warning: int
+    debug: int
+    division_new: int
+    division_warning: int
+    dont_write_bytecode: int
+    hash_randomization: int
+    ignore_environment: int
+    inspect: int
+    interactive: int
+    no_site: int
+    no_user_site: int
+    optimize: int
+    py3k_warning: int
+    tabcheck: int
+    unicode: int
+    verbose: int
+
+class _float_info:
+    max: float
+    max_exp: int
+    max_10_exp: int
+    min: float
+    min_exp: int
+    min_10_exp: int
+    dig: int
+    mant_dig: int
+    epsilon: float
+    radix: int
+    rounds: int
+
+class _version_info(Tuple[int, int, int, str, int]):
+    major = 0
+    minor = 0
+    micro = 0
+    releaselevel: str
+    serial = 0
+
+_mercurial: Tuple[str, str, str]
+api_version: int
+argv: List[str]
+builtin_module_names: Tuple[str, ...]
+byteorder: str
+copyright: str
+dont_write_bytecode: bool
+exec_prefix: str
+executable: str
+flags: _flags
+float_repr_style: str
+hexversion: int
+long_info: object
+maxint: int
+maxsize: int
+maxunicode: int
+modules: Dict[str, Any]
+path: List[str]
+platform: str
+prefix: str
+py3kwarning: bool
+__stderr__: IO[str]
+__stdin__: IO[str]
+__stdout__: IO[str]
+stderr: IO[str]
+stdin: IO[str]
+stdout: IO[str]
+subversion: Tuple[str, str, str]
+version: str
+warnoptions: object
+float_info: _float_info
+version_info: _version_info
+ps1: str
+ps2: str
+last_type: type
+last_value: BaseException
+last_traceback: TracebackType
+# TODO precise types
+meta_path: List[Any]
+path_hooks: List[Any]
+path_importer_cache: Dict[str, Any]
+displayhook: Optional[Callable[[int], None]]
+excepthook: Optional[Callable[[type, BaseException, TracebackType], None]]
+exc_type: Optional[type]
+exc_value: Union[BaseException, ClassType]
+exc_traceback: TracebackType
+
+class _WindowsVersionType:
+    major: Any
+    minor: Any
+    build: Any
+    platform: Any
+    service_pack: Any
+    service_pack_major: Any
+    service_pack_minor: Any
+    suite_mask: Any
+    product_type: Any
+
+def getwindowsversion() -> _WindowsVersionType: ...
+
+def _clear_type_cache() -> None: ...
+def _current_frames() -> Dict[int, FrameType]: ...
+def _getframe(depth: int = ...) -> FrameType: ...
+def call_tracing(fn: Any, args: Any) -> Any: ...
+def __displayhook__(value: int) -> None: ...
+def __excepthook__(type_: type, value: BaseException, traceback: TracebackType) -> None: ...
+def exc_clear() -> None:
+    raise DeprecationWarning()
+def exc_info() -> _OptExcInfo: ...
+
+# sys.exit() accepts an optional argument of anything printable
+def exit(arg: Any = ...) -> NoReturn:
+    raise SystemExit()
+def getcheckinterval() -> int: ...  # deprecated
+def getdefaultencoding() -> str: ...
+def getdlopenflags() -> int: ...
+def getfilesystemencoding() -> str: ...  # In practice, never returns None
+def getrefcount(arg: Any) -> int: ...
+def getrecursionlimit() -> int: ...
+def getsizeof(obj: object, default: int = ...) -> int: ...
+def getprofile() -> Optional[Any]: ...
+def gettrace() -> Optional[Any]: ...
+def setcheckinterval(interval: int) -> None: ...  # deprecated
+def setdlopenflags(n: int) -> None: ...
+def setdefaultencoding(encoding: Text) -> None: ...  # only exists after reload(sys)
+def setprofile(profilefunc: Any) -> None: ...  # TODO type
+def setrecursionlimit(limit: int) -> None: ...
+def settrace(tracefunc: Any) -> None: ...  # TODO type

python/helpers/typeshed/stdlib/3/sys.pyi

@@ -0,0 +1,201 @@
+# Stubs for sys
+# Ron Murawski <ron@horizonchess.com>
+
+# based on http://docs.python.org/3.2/library/sys.html
+
+from typing import (
+    List, NoReturn, Sequence, Any, Dict, Tuple, TextIO, overload, Optional,
+    Union, TypeVar, Callable, Type
+)
+import sys
+from types import FrameType, ModuleType, TracebackType
+
+from importlib.abc import MetaPathFinder
+
+_T = TypeVar('_T')
+
+# The following type alias are stub-only and do not exist during runtime
+_ExcInfo = Tuple[Type[BaseException], BaseException, TracebackType]
+_OptExcInfo = Union[_ExcInfo, Tuple[None, None, None]]
+
+# ----- sys variables -----
+abiflags: str
+argv: List[str]
+base_exec_prefix: str
+base_prefix: str
+byteorder: str
+builtin_module_names: Sequence[str]  # actually a tuple of strings
+copyright: str
+# dllhandle = 0  # Windows only
+dont_write_bytecode: bool
+__displayhook__: Any  # contains the original value of displayhook
+__excepthook__: Any  # contains the original value of excepthook
+exec_prefix: str
+executable: str
+float_repr_style: str
+hexversion: int
+last_type: Optional[Type[BaseException]]
+last_value: Optional[BaseException]
+last_traceback: Optional[TracebackType]
+maxsize: int
+maxunicode: int
+meta_path: List[MetaPathFinder]
+modules: Dict[str, ModuleType]
+path: List[str]
+path_hooks: List[Any]  # TODO precise type; function, path to finder
+path_importer_cache: Dict[str, Any]  # TODO precise type
+platform: str
+prefix: str
+ps1: str
+ps2: str
+stdin: TextIO
+stdout: TextIO
+stderr: TextIO
+__stdin__: TextIO
+__stdout__: TextIO
+__stderr__: TextIO
+# deprecated and removed in Python 3.3:
+subversion: Tuple[str, str, str]
+tracebacklimit: int
+version: str
+api_version: int
+warnoptions: Any
+#  Each entry is a tuple of the form (action, message, category, module,
+#    lineno)
+# winver = ''  # Windows only
+_xoptions: Dict[Any, Any]
+
+
+flags: _flags
+class _flags:
+    debug: int
+    division_warning: int
+    inspect: int
+    interactive: int
+    optimize: int
+    dont_write_bytecode: int
+    no_user_site: int
+    no_site: int
+    ignore_environment: int
+    verbose: int
+    bytes_warning: int
+    quiet: int
+    hash_randomization: int
+    if sys.version_info >= (3, 7):
+        dev_mode: int
+        utf8_mode: int
+
+float_info: _float_info
+class _float_info:
+    epsilon: float   # DBL_EPSILON
+    dig: int         # DBL_DIG
+    mant_dig: int    # DBL_MANT_DIG
+    max: float       # DBL_MAX
+    max_exp: int     # DBL_MAX_EXP
+    max_10_exp: int  # DBL_MAX_10_EXP
+    min: float       # DBL_MIN
+    min_exp: int     # DBL_MIN_EXP
+    min_10_exp: int  # DBL_MIN_10_EXP
+    radix: int       # FLT_RADIX
+    rounds: int      # FLT_ROUNDS
+
+hash_info: _hash_info
+class _hash_info:
+    width: int
+    modulus: int
+    inf: int
+    nan: int
+    imag: int
+
+implementation: _implementation
+class _implementation:
+    name: str
+    version: _version_info
+    hexversion: int
+    cache_tag: str
+
+int_info: _int_info
+class _int_info:
+    bits_per_digit: int
+    sizeof_digit: int
+
+class _version_info(Tuple[int, int, int, str, int]):
+    major: int
+    minor: int
+    micro: int
+    releaselevel: str
+    serial: int
+version_info: _version_info
+
+def call_tracing(fn: Callable[..., _T], args: Any) -> _T: ...
+def _clear_type_cache() -> None: ...
+def _current_frames() -> Dict[int, Any]: ...
+def displayhook(value: Optional[int]) -> None: ...
+def excepthook(type_: Type[BaseException], value: BaseException,
+               traceback: TracebackType) -> None: ...
+def exc_info() -> _OptExcInfo: ...
+# sys.exit() accepts an optional argument of anything printable
+def exit(arg: object = ...) -> NoReturn:
+    raise SystemExit()
+def getcheckinterval() -> int: ...  # deprecated
+def getdefaultencoding() -> str: ...
+if sys.platform != 'win32':
+    # Unix only
+    def getdlopenflags() -> int: ...
+def getfilesystemencoding() -> str: ...
+def getrefcount(arg: Any) -> int: ...
+def getrecursionlimit() -> int: ...
+
+@overload
+def getsizeof(obj: object) -> int: ...
+@overload
+def getsizeof(obj: object, default: int) -> int: ...
+
+def getswitchinterval() -> float: ...
+
+@overload
+def _getframe() -> FrameType: ...
+@overload
+def _getframe(depth: int) -> FrameType: ...
+
+_ProfileFunc = Callable[[FrameType, str, Any], Any]
+def getprofile() -> Optional[_ProfileFunc]: ...
+def setprofile(profilefunc: Optional[_ProfileFunc]) -> None: ...
+
+_TraceFunc = Callable[[FrameType, str, Any], Optional[Callable[[FrameType, str, Any], Any]]]
+def gettrace() -> Optional[_TraceFunc]: ...
+def settrace(tracefunc: Optional[_TraceFunc]) -> None: ...
+
+
+class _WinVersion(Tuple[int, int, int, int,
+                        str, int, int, int, int,
+                        Tuple[int, int, int]]):
+    major: int
+    minor: int
+    build: int
+    platform: int
+    service_pack: str
+    service_pack_minor: int
+    service_pack_major: int
+    suite_mast: int
+    product_type: int
+    platform_version: Tuple[int, int, int]
+
+
+def getwindowsversion() -> _WinVersion: ...  # Windows only
+
+def intern(string: str) -> str: ...
+
+def is_finalizing() -> bool: ...
+
+if sys.version_info >= (3, 7):
+    __breakpointhook__: Any  # contains the original value of breakpointhook
+    def breakpointhook(*args: Any, **kwargs: Any) -> Any: ...
+
+def setcheckinterval(interval: int) -> None: ...  # deprecated
+def setdlopenflags(n: int) -> None: ...  # Linux only
+def setrecursionlimit(limit: int) -> None: ...
+def setswitchinterval(interval: float) -> None: ...
+def settscdump(on_flag: bool) -> None: ...
+
+def gettotalrefcount() -> int: ...  # Debug builds only

python/tools/src/com/jetbrains/python/tools/PyTypeShedSync.kts

@@ -27,7 +27,7 @@ sync(repo, bundled)
 val whiteList = setOf("typing", "six", "__builtin__", "builtins", "exceptions", "types", "datetime", "functools", "shutil", "re", "time",
                       "argparse", "uuid", "threading", "signal", "collections", "subprocess", "math", "queue", "socket", "sqlite3", "attr",
                       "pathlib", "io", "_io", "itertools", "ssl", "multiprocessing", "asyncio", "mock", "unittest", "_importlib_modulespec",
-                      "typing_extensions", "ctypes", "abc", "urllib", "concurrent")
+                      "typing_extensions", "ctypes", "abc", "urllib", "concurrent", "sys")
 
 println("Cleaning")
 cleanTopLevelPackages(bundled, whiteList)