Initial configuration commit

typings/numpy/compat/py3k.pyi

@@ -0,0 +1,110 @@
+"""
+This type stub file was generated by pyright.
+"""
+
+import os
+
+"""
+Python 3.X compatibility tools.
+
+While this file was originally intended for Python 2 -> 3 transition,
+it is now used to create a compatibility layer between different
+minor versions of Python 3.
+
+While the active version of numpy may not support a given version of python, we
+allow downstream libraries to continue to use these shims for forward
+compatibility with numpy while they transition their code to newer versions of
+Python.
+"""
+__all__ = ['bytes', 'asbytes', 'isfileobj', 'getexception', 'strchar', 'unicode', 'asunicode', 'asbytes_nested', 'asunicode_nested', 'asstr', 'open_latin1', 'long', 'basestring', 'sixu', 'integer_types', 'is_pathlib_path', 'npy_load_module', 'Path', 'pickle', 'contextlib_nullcontext', 'os_fspath', 'os_PathLike']
+long = int
+integer_types = ...
+basestring = str
+unicode = str
+bytes = bytes
+def asunicode(s): # -> str:
+    ...
+
+def asbytes(s): # -> bytes:
+    ...
+
+def asstr(s): # -> str:
+    ...
+
+def isfileobj(f): # -> bool:
+    ...
+
+def open_latin1(filename, mode=...): # -> IO[Any]:
+    ...
+
+def sixu(s):
+    ...
+
+strchar = ...
+def getexception(): # -> BaseException | None:
+    ...
+
+def asbytes_nested(x): # -> list[Unknown] | bytes:
+    ...
+
+def asunicode_nested(x): # -> list[Unknown] | str:
+    ...
+
+def is_pathlib_path(obj): # -> bool:
+    """
+    Check whether obj is a `pathlib.Path` object.
+
+    Prefer using ``isinstance(obj, os.PathLike)`` instead of this function.
+    """
+    ...
+
+class contextlib_nullcontext:
+    """Context manager that does no additional processing.
+
+    Used as a stand-in for a normal context manager, when a particular
+    block of code is only sometimes used with a normal context manager:
+
+    cm = optional_cm if condition else nullcontext()
+    with cm:
+        # Perform operation, using optional_cm if condition is True
+
+    .. note::
+        Prefer using `contextlib.nullcontext` instead of this context manager.
+    """
+    def __init__(self, enter_result=...) -> None:
+        ...
+    
+    def __enter__(self): # -> None:
+        ...
+    
+    def __exit__(self, *excinfo): # -> None:
+        ...
+    
+
+
+def npy_load_module(name, fn, info=...): # -> ModuleType:
+    """
+    Load a module. Uses ``load_module`` which will be deprecated in python
+    3.12. An alternative that uses ``exec_module`` is in
+    numpy.distutils.misc_util.exec_mod_from_location
+
+    .. versionadded:: 1.11.2
+
+    Parameters
+    ----------
+    name : str
+        Full module name.
+    fn : str
+        Path to module file.
+    info : tuple, optional
+        Only here for backward compatibility with Python 2.*.
+
+    Returns
+    -------
+    mod : module
+
+    """
+    ...
+
+os_fspath = ...
+os_PathLike = os.PathLike