kisstdlib 0.0.2__tar.gz → 0.0.4__tar.gz

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kisstdlib
-Version: 0.0.2
+Version: 0.0.4
 Summary: Keep It Simple STandarD LIBraries set for Python
 Author-email: Jan Malakhovski <oxij@oxij.org>
 Keywords: sys,stdlib

kisstdlib-0.0.4/kisstdlib/io/stdio.py

@@ -0,0 +1,30 @@
+# Copyright (c) 2018-2024 Jan Malakhovski <oxij@oxij.org>
+#
+# This file is a part of kisstdlib project.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import os as _os
+import sys as _sys
+
+from .wrapper import *
+
+stdin = TIOWrappedReader(_os.fdopen(_sys.stdin.fileno(), "rb"))
+stdout = TIOWrappedWriter(_os.fdopen(_sys.stdout.fileno(), "wb"))
+stderr = TIOWrappedWriter(_os.fdopen(_sys.stderr.fileno(), "wb"))

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/io/wrapper.py

@@ -1,6 +1,6 @@
-# This file is a part of kisstdlib project.
+# Copyright (c) 2018-2024 Jan Malakhovski <oxij@oxij.org>
 #
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
+# This file is a part of kisstdlib project.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -27,28 +27,37 @@ import typing as _t
 
 from .base import *
 
+_logger = _logging.getLogger("kisstd")
+
 class MinimalIOWrapper(MinimalIO):
+    fobj : _t.Any
+    fileno : int | None
+
     def __init__(self, fobj : _t.Any) -> None:
         self.fobj = fobj
         # _socket.socket's fileno() will return -1 after
         # .close() and poll needs an actual value to unsubscribe
         # properly so we have to keep a copy here
         try:
-            self._fileno = fobj.fileno()
+            self.fileno = fobj.fileno()
         except OSError:
-            self._fileno = None
-        _logging.getLogger("kisstd").debug("init %s", self)
+            self.fileno = None
+        _logger.debug("init %s", self)
 
     def __del__(self) -> None:
-        _logging.getLogger("kisstd").debug("del %s", self)
+        _logger.debug("del %s", self)
 
     def __repr__(self) -> str:
-        if self._fileno is not None:
-            desc = "fd=" + str(self._fileno)
+        if self.fileno is not None:
+            desc = "fd=" + str(self.fileno)
         else:
             desc = "obj=" + str(id(self.fobj))
         return "<%s %s %s closed=%s>" % (self.__class__.__name__, hex(id(self)), desc, self.closed)
 
+    @property
+    def isatty(self) -> bool:
+        return self.fobj.isatty() # type: ignore
+
     def close(self) -> None:
         self.fobj.close()
 
@@ -114,6 +123,10 @@ class TIOWrappedWriter(TIOWrapper, MinimalIOWriter):
         else:
             self.write_bytes(data)
 
-stdin = TIOWrappedReader(_os.fdopen(_sys.stdin.fileno(), "rb"))
-stdout = TIOWrappedWriter(_os.fdopen(_sys.stdout.fileno(), "wb"))
-stderr = TIOWrappedWriter(_os.fdopen(_sys.stderr.fileno(), "wb"))
+    def write_ln(self, data : str | ByteString) -> None:
+        self.write(data)
+        self.write_bytes(self.eol)
+
+    def __exit__(self, exc_type : _t.Any, exc_value : _t.Any, exc_tb : _t.Any) -> None:
+        self.flush()
+        self.close()

kisstdlib-0.0.4/kisstdlib/path.py

@@ -0,0 +1,163 @@
+# Copyright (c) 2018-2024 Jan Malakhovski <oxij@oxij.org>
+#
+# This file is a part of kisstdlib project.
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import errno as _errno
+import os as _os
+import os.path as _op
+import stat as _stat
+import typing as _t
+
+IncludeFilesFunc = _t.Callable[[_t.AnyStr], bool]
+IncludeDirectoriesFunc = _t.Callable[[_t.AnyStr, bool, list[tuple[_t.AnyStr, bool]]], bool | None]
+
+def walk_orderly(path : _t.AnyStr,
+                 *,
+                 include_files : bool | IncludeFilesFunc[_t.AnyStr] = True,
+                 include_directories : bool | IncludeDirectoriesFunc[_t.AnyStr] = True,
+                 follow_symlinks : bool = True,
+                 ordering : bool | None = True,
+                 handle_error : _t.Callable[..., None] | None = None,
+                 path_is_file_maybe : bool = True) -> _t.Iterable[tuple[_t.AnyStr, bool]]:
+    """Similar to os.walk, but produces an iterator over plain file paths, allows
+       non-directories as input (which will just output a single element), and
+       the output is guaranteed to be ordered if `ordering` is not `None`.
+    """
+
+    if path_is_file_maybe:
+        try:
+            fstat = _os.stat(path, follow_symlinks = follow_symlinks)
+        except OSError as exc:
+            if handle_error is not None:
+                eno = exc.errno
+                handle_error("failed to stat `%s`: [Errno %d, %s] %s: %s", eno, _errno.errorcode.get(eno, "?"), _os.strerror(eno), path)
+                return
+            raise
+
+        if not _stat.S_ISDIR(fstat.st_mode):
+            if isinstance(include_files, bool):
+                if not include_files:
+                    return
+            elif not include_files(path):
+                return
+            yield path, False
+            return
+
+    try:
+        scandir_it = _os.scandir(path)
+    except OSError as exc:
+        if handle_error is not None:
+            eno = exc.errno
+            handle_error("failed to `scandir`: [Errno %d, %s] %s: %s", eno, _errno.errorcode.get(eno, "?"), _os.strerror(eno), path)
+            return
+        raise
+
+    complete = True
+    elements : list[tuple[_t.AnyStr, bool]] = []
+
+    with scandir_it:
+        while True:
+            try:
+                entry : _os.DirEntry[_t.AnyStr] = next(scandir_it)
+            except StopIteration:
+                break
+            except OSError as exc:
+                if handle_error is not None:
+                    eno = exc.errno
+                    handle_error("failed in `scandir`: [Errno %d, %s] %s: %s", eno, _errno.errorcode.get(eno, "?"), _os.strerror(eno), path)
+                    return
+                raise
+            else:
+                try:
+                    entry_is_dir = entry.is_dir(follow_symlinks = follow_symlinks)
+                except OSError as exc:
+                    if handle_error is not None:
+                        eno = exc.errno
+                        handle_error("failed to `stat`: [Errno %d, %s] %s: %s", eno, _errno.errorcode.get(eno, "?"), _os.strerror(eno), path)
+                        # NB: skip errors here
+                        complete = False
+                        continue
+                    raise
+
+                elements.append((entry.path, entry_is_dir))
+
+    if ordering is not None:
+        elements.sort(reverse=not ordering)
+
+    if isinstance(include_directories, bool):
+        if include_directories:
+            yield path, True
+    else:
+        inc = include_directories(path, complete, elements)
+        if inc is None:
+            return
+        elif inc:
+            yield path, True
+
+    for epath, eis_dir in elements:
+        if eis_dir:
+            yield from walk_orderly(epath,
+                                    include_files=include_files,
+                                    include_directories=include_directories,
+                                    follow_symlinks=follow_symlinks,
+                                    ordering=ordering,
+                                    handle_error=handle_error,
+                                    path_is_file_maybe=False)
+        else:
+            yield epath, False
+
+def as_include_directories(f : IncludeFilesFunc[_t.AnyStr]) -> IncludeDirectoriesFunc[_t.AnyStr]:
+    """`convert walk_orderly(..., include_files, ...)` filter to `include_directories` filter"""
+    def func(path : _t.AnyStr, complete : bool, elements : list[tuple[_t.AnyStr, bool]]) -> bool:
+        return f(path)
+    return func
+
+def with_extension_in(exts : list[str | bytes] | set[str | bytes]) -> IncludeFilesFunc[_t.AnyStr]:
+    """`walk_orderly(..., include_files, ...)` (or `include_directories`) filter that makes it only include files that have one of the given extensions"""
+    def pred(path : _t.AnyStr) -> bool:
+        _, ext = _op.splitext(path)
+        return ext in exts
+    return pred
+
+def with_extension_not_in(exts : list[str | bytes] | set[str | bytes]) -> IncludeFilesFunc[_t.AnyStr]:
+    """`walk_orderly(..., include_files, ...)` (or `include_directories`) filter that makes it only include files that do not have any of the given extensions"""
+    def pred(path : _t.AnyStr) -> bool:
+        _, ext = _op.splitext(path)
+        return ext not in exts
+    return pred
+
+def not_empty_directories(path : _t.AnyStr, complete : bool, elements : list[tuple[_t.AnyStr, bool]]) -> bool:
+    """`walk_orderly(..., include_directories, ...)` filter that makes it print only non-empty directories"""
+    if len(elements) == 0:
+        return not complete
+    return True
+
+def leaf_directories(path : _t.AnyStr, complete : bool, elements : list[tuple[_t.AnyStr, bool]]) -> bool:
+    """`walk_orderly(..., include_directories, ...)` filter that makes it print leaf directories only, i.e. only directories without sub-directories"""
+    if complete and all(map(lambda x: not x[1], elements)):
+        return True
+    return False
+
+def not_empty_leaf_directories(path : _t.AnyStr, complete : bool, elements : list[tuple[_t.AnyStr, bool]]) -> bool:
+    """`walk_orderly(..., include_directories, ...)` filter that makes it print only non-empty leaf directories, i.e. non-empty directories without sub-directories"""
+    if not_empty_directories(path, complete, elements) and leaf_directories(path, complete, elements):
+        return True
+    return False

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kisstdlib
-Version: 0.0.2
+Version: 0.0.4
 Summary: Keep It Simple STandarD LIBraries set for Python
 Author-email: Jan Malakhovski <oxij@oxij.org>
 Keywords: sys,stdlib

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ kisstdlib/argparse/__init__.py
 kisstdlib/argparse/better.py
 kisstdlib/io/__init__.py
 kisstdlib/io/base.py
+kisstdlib/io/stdio.py
 kisstdlib/io/wrapper.py
 kisstdlib/io/encoder/__init__.py
 kisstdlib/io/encoder/base.py

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools"]
 build-backend = "setuptools.build_meta"
 [project]
 name = "kisstdlib"
-version = "0.0.2"
+version = "0.0.4"
 authors = [{ name = "Jan Malakhovski", email = "oxij@oxij.org" }]
 description = "Keep It Simple STandarD LIBraries set for Python"
 readme = "README.md"

kisstdlib-0.0.2/kisstdlib/path.py

@@ -1,98 +0,0 @@
-# This file is a part of kisstdlib project.
-#
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
-import logging as _logging
-import os as _os
-import stat as _stat
-import typing as _t
-
-def walk_orderly(path : _t.AnyStr,
-                 include_directories : bool = True,
-                 follow_symlinks : bool = True,
-                 order_by : bool | None = True,
-                 handle_error : _t.Callable[..., None] | None = _logging.error) -> _t.Iterable[_t.AnyStr]:
-    """Similar to os.walk, but produces an iterator over plain file paths, allows
-       non-directories as input (which will just output a single element), and
-       the output is guaranteed to be ordered if `order_by` is not `None`.
-    """
-
-    try:
-        fstat = _os.stat(path, follow_symlinks = follow_symlinks)
-    except OSError:
-        if handle_error is not None:
-            handle_error("failed to stat: %s", path)
-            return
-        raise
-
-    if not _stat.S_ISDIR(fstat.st_mode):
-        yield path
-        return
-
-    try:
-        scandir_it = _os.scandir(path)
-    except OSError:
-        if handle_error is not None:
-            handle_error("failed to scandir: %s", path)
-            return
-        raise
-
-    elements : list[_t.AnyStr] = []
-
-    with scandir_it:
-        while True:
-            try:
-                entry : _t.Any = next(scandir_it)
-            except StopIteration:
-                break
-            except OSError:
-                if handle_error is not None:
-                    handle_error("failed in scandir: %s", path)
-                    return
-                raise
-            else:
-                try:
-                    is_dir = entry.is_dir(follow_symlinks = follow_symlinks)
-                except OSError:
-                    if handle_error is not None:
-                        handle_error("failed to stat: %s", entry.path)
-                        return
-                    raise
-
-                if is_dir:
-                    if isinstance(entry.path, bytes):
-                        elements.append(entry.path + b"/") # type: ignore
-                    else:
-                        elements.append(entry.path + "/")
-                else:
-                    elements.append(entry.path)
-
-    if order_by is not None:
-        elements.sort(reverse=not order_by)
-
-    for path in elements:
-        lchar : _t.AnyStr = path[-1:]
-        if lchar == "/" or lchar == b"/":
-            if include_directories:
-                yield path
-            yield from walk_orderly(path, include_directories, follow_symlinks, order_by, handle_error)
-        else:
-            yield path

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/__init__.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/argparse/__init__.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/argparse/better.py

@@ -1,11 +1,11 @@
+# Copyright (c) 2022-2023 Jan Malakhovski <oxij@oxij.org>
+#
 # This file is a part of kisstdlib project.
 #
 # This file can be distributed under the terms of the MIT-style license given
 # below or Python Software Foundation License version 2 (PSF-2.0) as published
 # by Python Software Foundation.
 #
-# Copyright (c) 2022-2023 Jan Malakhovski <oxij@oxij.org>
-#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/exceptions.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/io/__init__.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/io/base.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/io/encoder/__init__.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/io/encoder/base.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/io/encoder/pyrepr.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights

{kisstdlib-0.0.2 → kisstdlib-0.0.4}/kisstdlib/logging.py

@@ -1,7 +1,7 @@
-# This file is a part of kisstdlib project.
-#
 # Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
 #
+# This file is a part of kisstdlib project.
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights