kisstdlib 0.0.1__tar.gz → 0.0.3__tar.gz

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/PKG-INFO

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

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/__init__.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,9 +19,3 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/argparse/__init__.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,11 +19,5 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 from .better import *

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/argparse/better.py

@@ -1,5 +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.
+#
 # 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
@@ -17,12 +23,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 import typing as _t
 from argparse import *

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/exceptions.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 """Exceptions with printable descriptions.
 """

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/io/__init__.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 """KISS IO File Object hierarchy.
 

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/io/base.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 import abc as _abc
 import sys as _sys

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/io/encoder/__init__.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 from .base import *
 from .pyrepr import *

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/io/encoder/base.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 import sys as _sys
 import typing as _t

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/io/encoder/pyrepr.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 """cbor2-style encoder for Pythonic Object Representation (repr)
 """

kisstdlib-0.0.3/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.1 → kisstdlib-0.0.3}/kisstdlib/io/wrapper.py

@@ -1,4 +1,6 @@
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
+# 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 import logging as _logging
 import os as _os
@@ -31,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()
 
@@ -118,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.1 → kisstdlib-0.0.3}/kisstdlib/logging.py

@@ -1,5 +1,7 @@
 # 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 import logging as _logging
 

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib/path.py

@@ -1,4 +1,6 @@
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
+# 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
@@ -17,12 +19,6 @@
 # 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.
-#
-# This file is a part of kisstdlib project.
-#
-# This file can be distributed under the terms of the above MIT license or
-# Python Software Foundation License version 2 (PSF-2.0) as published by Python
-# Software Foundation.
 
 import logging as _logging
 import os as _os
@@ -30,12 +26,14 @@ import stat as _stat
 import typing as _t
 
 def walk_orderly(path : _t.AnyStr,
+                 *,
                  include_directories : bool = True,
                  follow_symlinks : bool = True,
+                 ordering : 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.
+       the output is guaranteed to be ordered if `ordering` is not `None`.
     """
 
     try:
@@ -88,13 +86,18 @@ def walk_orderly(path : _t.AnyStr,
                 else:
                     elements.append(entry.path)
 
-    elements.sort()
+    if ordering is not None:
+        elements.sort(reverse=not ordering)
 
     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, handle_error)
+            yield from walk_orderly(path,
+                                    include_directories=include_directories,
+                                    follow_symlinks=follow_symlinks,
+                                    ordering=ordering,
+                                    handle_error=handle_error)
         else:
             yield path

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/kisstdlib.egg-info/PKG-INFO

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

{kisstdlib-0.0.1 → kisstdlib-0.0.3}/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.1 → kisstdlib-0.0.3}/pyproject.toml

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