megfile 3.1.1__py3-none-any.whl → 3.1.2__py3-none-any.whl

megfile/smart_path.py

@@ -9,7 +9,6 @@ from .interfaces import BasePath, BaseURIPath, PathLike
 
 
 def _bind_function(name):
-
     def smart_method(self, *args, **kwargs):
         return getattr(self.pathlike, name)(*args, **kwargs)
 
@@ -19,7 +18,6 @@ def _bind_function(name):
 
 
 def _bind_property(name):
-
     @property
     def smart_property(self):
         return getattr(self.pathlike, name)
@@ -41,8 +39,7 @@ class SmartPath(BasePath):
         self.pathlike = pathlike
 
     @staticmethod
-    def _extract_protocol(
-            path: Union[PathLike, int]) -> Tuple[str, Union[str, int]]:
+    def _extract_protocol(path: Union[PathLike, int]) -> Tuple[str, Union[str, int]]:
         if isinstance(path, int):
             protocol = "file"
             path_without_protocol = path
@@ -52,25 +49,23 @@ class SmartPath(BasePath):
                 protocol = "file"
                 path_without_protocol = path
             else:
-                path_without_protocol = path[len(protocol) + 3:]
+                path_without_protocol = path[len(protocol) + 3 :]
         elif isinstance(path, (BaseURIPath, SmartPath)):
             protocol = path.protocol
             path_without_protocol = str(path)
         elif isinstance(path, (PurePath, BasePath)):
-            protocol, path_without_protocol = SmartPath._extract_protocol(
-                fspath(path))
+            protocol, path_without_protocol = SmartPath._extract_protocol(fspath(path))
         else:
-            raise ProtocolNotFoundError('protocol not found: %r' % path)
+            raise ProtocolNotFoundError("protocol not found: %r" % path)
         return protocol, path_without_protocol
 
     @classmethod
     def _create_pathlike(cls, path: Union[PathLike, int]) -> BaseURIPath:
         protocol, _ = cls._extract_protocol(path)
-        if protocol.startswith('s3+'):
-            protocol = 's3'
+        if protocol.startswith("s3+"):
+            protocol = "s3"
         if protocol not in cls._registered_protocols:
-            raise ProtocolNotFoundError(
-                'protocol %r not found: %r' % (protocol, path))
+            raise ProtocolNotFoundError("protocol %r not found: %r" % (protocol, path))
         path_class = cls._registered_protocols[protocol]
         return path_class(path)
 
@@ -78,47 +73,47 @@ class SmartPath(BasePath):
     def register(cls, path_class, override_ok: bool = False):
         protocol = path_class.protocol
         if protocol in cls._registered_protocols and not override_ok:
-            raise ProtocolExistsError('protocol already exists: %r' % protocol)
+            raise ProtocolExistsError("protocol already exists: %r" % protocol)
         cls._registered_protocols[protocol] = path_class
         return path_class
 
-    symlink = _bind_function('symlink')
-    symlink_to = _bind_function('symlink_to')
-    hardlink_to = _bind_function('hardlink_to')
-    readlink = _bind_function('readlink')
-    is_dir = _bind_function('is_dir')
-    is_file = _bind_function('is_file')
-    is_symlink = _bind_function('is_symlink')
-    access = _bind_function('access')
-    exists = _bind_function('exists')
-    listdir = _bind_function('listdir')
-    scandir = _bind_function('scandir')
-    getsize = _bind_function('getsize')
-    getmtime = _bind_function('getmtime')
-    stat = _bind_function('stat')
-    lstat = _bind_function('lstat')
-    remove = _bind_function('remove')
-    rename = _bind_function('rename')
-    replace = _bind_function('replace')
-    unlink = _bind_function('unlink')
-    mkdir = _bind_function('mkdir')
-    open = _bind_function('open')
-    touch = _bind_function('touch')
-    walk = _bind_function('walk')
-    scan = _bind_function('scan')
-    scan_stat = _bind_function('scan_stat')
-    glob = _bind_function('glob')
-    iglob = _bind_function('iglob')
-    glob_stat = _bind_function('glob_stat')
-    load = _bind_function('load')
-    save = _bind_function('save')
-    joinpath = _bind_function('joinpath')
-    abspath = _bind_function('abspath')
-    realpath = _bind_function('realpath')
-    relpath = _bind_function('relpath')
-    is_absolute = _bind_function('is_absolute')
-    is_mount = _bind_function('is_mount')
-    md5 = _bind_function('md5')
+    symlink = _bind_function("symlink")
+    symlink_to = _bind_function("symlink_to")
+    hardlink_to = _bind_function("hardlink_to")
+    readlink = _bind_function("readlink")
+    is_dir = _bind_function("is_dir")
+    is_file = _bind_function("is_file")
+    is_symlink = _bind_function("is_symlink")
+    access = _bind_function("access")
+    exists = _bind_function("exists")
+    listdir = _bind_function("listdir")
+    scandir = _bind_function("scandir")
+    getsize = _bind_function("getsize")
+    getmtime = _bind_function("getmtime")
+    stat = _bind_function("stat")
+    lstat = _bind_function("lstat")
+    remove = _bind_function("remove")
+    rename = _bind_function("rename")
+    replace = _bind_function("replace")
+    unlink = _bind_function("unlink")
+    mkdir = _bind_function("mkdir")
+    open = _bind_function("open")
+    touch = _bind_function("touch")
+    walk = _bind_function("walk")
+    scan = _bind_function("scan")
+    scan_stat = _bind_function("scan_stat")
+    glob = _bind_function("glob")
+    iglob = _bind_function("iglob")
+    glob_stat = _bind_function("glob_stat")
+    load = _bind_function("load")
+    save = _bind_function("save")
+    joinpath = _bind_function("joinpath")
+    abspath = _bind_function("abspath")
+    realpath = _bind_function("realpath")
+    relpath = _bind_function("relpath")
+    is_absolute = _bind_function("is_absolute")
+    is_mount = _bind_function("is_mount")
+    md5 = _bind_function("md5")
 
     @property
     def protocol(self) -> str:
@@ -128,61 +123,61 @@ class SmartPath(BasePath):
     def from_uri(cls, path: str):
         return cls(path)
 
-    as_uri = _bind_function('as_uri')
-    as_posix = _bind_function('as_posix')
-    __lt__ = _bind_function('__lt__')
-    __le__ = _bind_function('__le__')
-    __gt__ = _bind_function('__gt__')
-    __ge__ = _bind_function('__ge__')
-    __fspath__ = _bind_function('__fspath__')
-    __truediv__ = _bind_function('__truediv__')
-
-    joinpath = _bind_function('joinpath')
-    is_reserved = _bind_function('is_reserved')
-    match = _bind_function('match')
-    relative_to = _bind_function('relative_to')
-    with_name = _bind_function('with_name')
-    with_suffix = _bind_function('with_suffix')
-    with_stem = _bind_function('with_stem')
-    is_absolute = _bind_function('is_absolute')
-    is_mount = _bind_function('is_mount')
-    abspath = _bind_function('abspath')
-    realpath = _bind_function('realpath')
-    relpath = _bind_function('relpath')
-    iterdir = _bind_function('iterdir')
-    cwd = _bind_function('cwd')
-    home = _bind_function('home')
-    expanduser = _bind_function('expanduser')
-    resolve = _bind_function('resolve')
-    chmod = _bind_function('chmod')
-    lchmod = _bind_function('lchmod')
-    group = _bind_function('group')
-    is_socket = _bind_function('is_socket')
-    is_fifo = _bind_function('is_fifo')
-    is_block_device = _bind_function('is_block_device')
-    is_char_device = _bind_function('is_char_device')
-    owner = _bind_function('owner')
-    absolute = _bind_function('absolute')
-    rmdir = _bind_function('rmdir')
-    is_relative_to = _bind_function('is_relative_to')
-    read_bytes = _bind_function('read_bytes')
-    read_text = _bind_function('read_text')
-    rglob = _bind_function('rglob')
-    samefile = _bind_function('samefile')
-    write_bytes = _bind_function('write_bytes')
-    write_text = _bind_function('write_text')
-    utime = _bind_function('utime')
-
-    drive = _bind_property('drive')
-    root = _bind_property('root')
-    anchor = _bind_property('anchor')
-    parts = _bind_property('parts')
-    parents = _bind_property('parents')
-    parent = _bind_property('parent')
-    name = _bind_property('name')
-    suffix = _bind_property('suffix')
-    suffixes = _bind_property('suffixes')
-    stem = _bind_property('stem')
+    as_uri = _bind_function("as_uri")
+    as_posix = _bind_function("as_posix")
+    __lt__ = _bind_function("__lt__")
+    __le__ = _bind_function("__le__")
+    __gt__ = _bind_function("__gt__")
+    __ge__ = _bind_function("__ge__")
+    __fspath__ = _bind_function("__fspath__")
+    __truediv__ = _bind_function("__truediv__")
+
+    joinpath = _bind_function("joinpath")
+    is_reserved = _bind_function("is_reserved")
+    match = _bind_function("match")
+    relative_to = _bind_function("relative_to")
+    with_name = _bind_function("with_name")
+    with_suffix = _bind_function("with_suffix")
+    with_stem = _bind_function("with_stem")
+    is_absolute = _bind_function("is_absolute")
+    is_mount = _bind_function("is_mount")
+    abspath = _bind_function("abspath")
+    realpath = _bind_function("realpath")
+    relpath = _bind_function("relpath")
+    iterdir = _bind_function("iterdir")
+    cwd = _bind_function("cwd")
+    home = _bind_function("home")
+    expanduser = _bind_function("expanduser")
+    resolve = _bind_function("resolve")
+    chmod = _bind_function("chmod")
+    lchmod = _bind_function("lchmod")
+    group = _bind_function("group")
+    is_socket = _bind_function("is_socket")
+    is_fifo = _bind_function("is_fifo")
+    is_block_device = _bind_function("is_block_device")
+    is_char_device = _bind_function("is_char_device")
+    owner = _bind_function("owner")
+    absolute = _bind_function("absolute")
+    rmdir = _bind_function("rmdir")
+    is_relative_to = _bind_function("is_relative_to")
+    read_bytes = _bind_function("read_bytes")
+    read_text = _bind_function("read_text")
+    rglob = _bind_function("rglob")
+    samefile = _bind_function("samefile")
+    write_bytes = _bind_function("write_bytes")
+    write_text = _bind_function("write_text")
+    utime = _bind_function("utime")
+
+    drive = _bind_property("drive")
+    root = _bind_property("root")
+    anchor = _bind_property("anchor")
+    parts = _bind_property("parts")
+    parents = _bind_property("parents")
+    parent = _bind_property("parent")
+    name = _bind_property("name")
+    suffix = _bind_property("suffix")
+    suffixes = _bind_property("suffixes")
+    stem = _bind_property("stem")
 
 
 def get_traditional_path(path: PathLike) -> str:

megfile/stdio.py

@@ -4,18 +4,19 @@ from megfile.interfaces import PathLike
 from megfile.stdio_path import StdioPath, is_stdio
 
 __all__ = [
-    'is_stdio',
-    'stdio_open',
+    "is_stdio",
+    "stdio_open",
 ]
 
 
 def stdio_open(
-        path: PathLike,
-        mode: str = 'rb',
-        encoding: Optional[str] = None,
-        errors: Optional[str] = None,
-        **kwargs) -> IO:
-    '''Used to read or write stdio
+    path: PathLike,
+    mode: str = "rb",
+    encoding: Optional[str] = None,
+    errors: Optional[str] = None,
+    **kwargs,
+) -> IO:
+    """Used to read or write stdio
 
     .. note ::
 
@@ -24,5 +25,5 @@ def stdio_open(
     :param path: Given path
     :param mode: Only supports 'rb' and 'wb' now
     :return: STDReader, STDWriter
-    '''
+    """
     return StdioPath(path).open(mode, encoding, errors)  # pyre-ignore[6]

megfile/stdio_path.py

@@ -8,14 +8,11 @@ from megfile.lib.url import get_url_scheme
 from megfile.smart_path import SmartPath
 from megfile.utils import get_binary_mode
 
-__all__ = [
-    "StdioPath",
-    "is_stdio",
-]
+__all__ = ["StdioPath", "is_stdio"]
 
 
 def is_stdio(path: PathLike) -> bool:
-    '''stdio scheme definition: stdio://-
+    """stdio scheme definition: stdio://-
 
     .. note ::
 
@@ -23,23 +20,22 @@ def is_stdio(path: PathLike) -> bool:
 
     :param path: Path to be tested
     :returns: True of a path is stdio url, else False
-    '''
+    """
 
     path = fspath(path)
-    if not isinstance(path, str) or not path.startswith('stdio://'):
+    if not isinstance(path, str) or not path.startswith("stdio://"):
         return False
 
     scheme = get_url_scheme(path)
-    return scheme == 'stdio'
+    return scheme == "stdio"
 
 
 @SmartPath.register
 class StdioPath(BaseURIPath):
-
     protocol = "stdio"
 
-    def _open(self, mode: str = 'rb') -> Union[STDReader, STDWriter]:
-        '''Used to read or write stdio
+    def _open(self, mode: str = "rb") -> Union[STDReader, STDWriter]:
+        """Used to read or write stdio
 
         .. note ::
 
@@ -48,37 +44,39 @@ class StdioPath(BaseURIPath):
         :param path: stdio path, stdio://- or stdio://0 stdio://1 stdio://2
         :param mode: Only supports 'rb' and 'wb' now
         :return: STDReader, STDWriter
-        '''
+        """
 
-        if mode not in ('rb', 'wb', 'rt', 'wt', 'r', 'w'):
-            raise ValueError('unacceptable mode: %r' % mode)
+        if mode not in ("rb", "wb", "rt", "wt", "r", "w"):
+            raise ValueError("unacceptable mode: %r" % mode)
 
         mode = get_binary_mode(mode)
 
-        if self.path_with_protocol not in ('stdio://-', 'stdio://0',
-                                           'stdio://1', 'stdio://2'):
-            raise ValueError('unacceptable path: %r' % self.path_with_protocol)
+        if self.path_with_protocol not in (
+            "stdio://-",
+            "stdio://0",
+            "stdio://1",
+            "stdio://2",
+        ):
+            raise ValueError("unacceptable path: %r" % self.path_with_protocol)
 
-        if self.path_with_protocol in ('stdio://1',
-                                       'stdio://2') and 'r' in mode:
-            raise ValueError(
-                'cannot open for reading: %r' % self.path_with_protocol)
+        if self.path_with_protocol in ("stdio://1", "stdio://2") and "r" in mode:
+            raise ValueError("cannot open for reading: %r" % self.path_with_protocol)
 
-        if self.path_with_protocol == 'stdio://0' and 'w' in mode:
-            raise ValueError(
-                'cannot open for writing: %r' % self.path_with_protocol)
+        if self.path_with_protocol == "stdio://0" and "w" in mode:
+            raise ValueError("cannot open for writing: %r" % self.path_with_protocol)
 
-        if 'r' in mode:
+        if "r" in mode:
             return STDReader(mode)
         return STDWriter(self.path_with_protocol, mode)
 
     def open(
-            self,
-            mode: str = 'rb',
-            encoding: Optional[str] = None,
-            errors: Optional[str] = None,
-            **kwargs) -> IO:
-        '''Used to read or write stdio
+        self,
+        mode: str = "rb",
+        encoding: Optional[str] = None,
+        errors: Optional[str] = None,
+        **kwargs,
+    ) -> IO:
+        """Used to read or write stdio
 
         .. note ::
 
@@ -86,12 +84,11 @@ class StdioPath(BaseURIPath):
 
         :param mode: Only supports 'rb' and 'wb' now
         :return: STDReader, STDWriter
-        '''
+        """
         fileobj = self._open(mode)
 
-        if 'b' not in mode:
-            fileobj = io.TextIOWrapper(
-                fileobj, encoding=encoding, errors=errors)
+        if "b" not in mode:
+            fileobj = io.TextIOWrapper(fileobj, encoding=encoding, errors=errors)
             fileobj.mode = mode  # pyre-ignore[41]
 
         return fileobj