kisstdlib 0.0.1__tar.gz

kisstdlib-0.0.1/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.1
+Name: kisstdlib
+Version: 0.0.1
+Summary: Keep It Simple STandarD LIBraries set for Python
+Author-email: Jan Malakhovski <oxij@oxij.org>
+Keywords: sys,stdlib
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Python Software Foundation License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# What?
+
+Keep It Simple STandarD LIBraries set for Python.
+
+A very alpha Work In Progress kind of thing ATM.

kisstdlib-0.0.1/README.md

@@ -0,0 +1,5 @@
+# What?
+
+Keep It Simple STandarD LIBraries set for Python.
+
+A very alpha Work In Progress kind of thing ATM.

kisstdlib-0.0.1/kisstdlib/__init__.py

@@ -0,0 +1,25 @@
+# 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.
+#
+# 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/argparse/__init__.py

@@ -0,0 +1,27 @@
+# Copyright (c) 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.
+#
+# 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/argparse/better.py

@@ -0,0 +1,208 @@
+# 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
+# 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.
+#
+# 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 *
+from gettext import gettext as _
+
+class BetterHelpFormatter(HelpFormatter):
+    """Like argparse.HelpFormatter, but with better formatting.
+       Also, it adds `add_code` function.
+    """
+
+    def _fill_text(self, text : str, width : int, indent : str) -> str:
+        import textwrap
+        res = []
+        for line in text.splitlines():
+            if line == "":
+                res.append(line)
+                continue
+
+            for sub in textwrap.wrap(line, width - len(indent)):
+                sub = indent + sub
+                res.append(sub)
+        return "\n".join(res)
+
+    def _split_lines(self, text : str, width : int) -> list[str]:
+        import textwrap
+        res = []
+        for line in text.splitlines():
+            res += textwrap.wrap(line, width)
+        return res
+
+    def add_code(self, text : str) -> None:
+        self.add_text(text.strip())
+
+class MarkdownBetterHelpFormatter(BetterHelpFormatter):
+    """BetterHelpFormatter that outputs stuff formatted in Markdown"""
+
+    def add_code(self, text : str) -> None:
+        self.add_text("```\n" + text.strip() + "\n```")
+
+    def _format_usage(self, usage : str | None, actions : _t.Any, groups : _t.Any, prefix : str | None) -> str:
+        return super()._format_usage(usage, actions, groups, "")
+
+    def _format_action(self, action : _t.Any) -> str:
+        # determine the required width and the entry label
+        action_header = self._format_action_invocation(action)
+
+        tup = self._current_indent, '', "`" + action_header + "`"
+        action_header = '%*s- %s\n' % tup
+
+        # collect the pieces of the action help
+        parts = [action_header]
+
+        # if there was help for the action, add it
+        if action.help and action.help.strip():
+            first = True
+            for line in self._expand_help(action).splitlines():
+                if first:
+                    parts.append('%*s: %s\n' % (self._current_indent, '', line))
+                else:
+                    parts.append('%*s  %s\n' % (self._current_indent, '', line))
+                first = False
+
+        # or add a newline if the description doesn't end with one
+        elif not action_header.endswith('\n'):
+            parts.append('\n')
+
+        # if there are any sub-actions, add their help as well
+        for subaction in self._iter_indented_subactions(action):
+            parts.append(self._format_action(subaction))
+
+        # return a single string
+        return self._join_parts(parts)
+
+    class _Section(HelpFormatter._Section):
+        def format_help(self) -> str:
+            if self.parent is not None:
+                self.formatter._indent()
+            join = self.formatter._join_parts
+            item_help = join([func(*args) for func, args in self.items])
+            if self.parent is not None:
+                self.formatter._dedent()
+
+            # return nothing if the section was empty
+            if not item_help:
+                return ''
+
+            # add the heading if the section was non-empty
+            if self.heading is not SUPPRESS and self.heading is not None:
+                heading = '%*s- %s:\n' % (self.formatter._current_indent, '', self.heading)
+            else:
+                heading = ''
+
+            # join the section-initial newline, the heading and the help
+            return join(['\n', heading, item_help, '\n'])
+
+class BetterArgumentParser(ArgumentParser):
+    """Like argparse.ArgumentParser but uses BetterHelpFormatter by default,
+       adds `--help` only to the root node, and
+       that `--help` prints the help for all the subcommands at once.
+       Also, provides `add_version` option.
+    """
+
+    formatter_class : type[BetterHelpFormatter]
+
+    def __init__(self,
+                 prog : str | None = None,
+                 version : str | None = None,
+                 add_version : bool = False, # we set these two to False by default
+                 add_help : bool = False,    # so that subparsers don't get them enabled by default
+                 additional_sections : list[_t.Callable[[BetterHelpFormatter], None]] = [],
+                 formatter_class : type[BetterHelpFormatter] = BetterHelpFormatter,
+                 *args : _t.Any, **kwargs : _t.Any) -> None:
+        super().__init__(prog, *args, formatter_class = formatter_class, add_help = False, **kwargs) # type: ignore
+
+        if version is None:
+            version = "dev"
+            if prog is not None:
+                try:
+                    import importlib.metadata as meta
+                    try:
+                        version = meta.version(prog)
+                    except meta.PackageNotFoundError:
+                        pass
+                except ImportError:
+                    pass
+
+        self.version = version
+        self.add_version = add_version
+        self.add_help = add_help
+        self.additional_sections = additional_sections
+
+        default_prefix = '-' if '-' in self.prefix_chars else self.prefix_chars[0]
+        if self.add_version:
+            self.add_argument(default_prefix*2 + "version", action="version", version="%(prog)s " + version)
+
+        if self.add_help:
+            self.add_argument(
+                default_prefix + "h", default_prefix*2 + "help", action='help',
+                default=SUPPRESS, help=_('show this help message and exit'))
+
+    def set_formatter_class(self, formatter_class : type[BetterHelpFormatter]) -> None:
+        self.formatter_class = formatter_class
+        if hasattr(self._subparsers, "_group_actions"):
+            for grp in self._subparsers._group_actions: # type: ignore
+                for choice, e in grp.choices.items(): # type: ignore
+                    if e.formatter_class != formatter_class:
+                        e.formatter_class = formatter_class
+
+    def format_help(self, width : int | None = None) -> str:
+        if width is None:
+            import shutil
+            width = shutil.get_terminal_size().columns - 2
+        formatter = self.formatter_class(prog=self.prog, width=width)
+
+        formatter.add_usage(self.usage, self._actions, self._mutually_exclusive_groups)
+        formatter.add_text(self.description)
+
+        if hasattr(self, "_action_groups"):
+            for action_group in self._action_groups:
+                formatter.start_section(action_group.title)
+                formatter.add_text(action_group.description)
+                formatter.add_arguments(action_group._group_actions)
+                formatter.end_section()
+
+        res : str = "# " + formatter.format_help()
+
+        if hasattr(self._subparsers, "_group_actions"):
+            seen = set()
+            for grp in self._subparsers._group_actions: # type: ignore
+                for choice, e in grp.choices.items(): # type: ignore
+                    if e in seen: continue
+                    seen.add(e)
+                    e.formatter_class = self.formatter_class
+                    res += "\n#" + e.format_help(width=width)
+
+        for gen in self.additional_sections:
+            formatter = self.formatter_class(prog=self.prog, width=width)
+            gen(formatter)
+            res += "\n" + formatter.format_help()
+
+        formatter.add_text(self.epilog)
+
+        return res

kisstdlib-0.0.1/kisstdlib/exceptions.py

@@ -0,0 +1,44 @@
+# Copyright (c) 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.
+#
+# 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.
+"""
+
+import typing as _t
+
+class CatastrophicFailure(Exception):
+    def __init__(self, what : str, *args : _t.Any) -> None:
+        super().__init__()
+        self.description = what % args
+
+    def __str__(self) -> str:
+        return self.description
+
+    def elaborate(self, what : str, *args : _t.Any) -> None:
+        self.description = what % args + ": " + self.description
+
+class Failure(CatastrophicFailure):
+    pass

kisstdlib-0.0.1/kisstdlib/io/__init__.py

@@ -0,0 +1,57 @@
+# 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.
+#
+# 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.
+
+What?
+
+  An alternative to Python's `io` module.
+
+Why?
+
+  APIs of Python's `io` module are way too complex. It only really works well
+  when you use either buffered raw or buffered textual IO and never try to mix
+  them.
+
+  The problem stems from the fact that Python's `io.RawIOBase` and
+  `io.TextIOBase` are trying to give the same APIs, but they do different
+  things. Which, after being multiplied with the differences of buffered and
+  unbuffered `read`s and `write`s, essentially gives FOUR different file
+  object semantics under the same file object API.
+
+  Here, instead we have separate calls for `bytes` and `str` versions of
+  `read` and `write` calls, buffering is completely transparent, reading and
+  writing parts are split into different interfaces, and text encoding
+  handling is split between them (because it has to be handled differently).
+
+  This also provides `TIOEncoder` and (WIP `TIODecoder`) classes that can do
+  simple serialization/de-serialization a-la Pascal.
+
+"""
+
+from .base import *
+from .wrapper import *
+from .encoder import *

kisstdlib-0.0.1/kisstdlib/io/base.py

@@ -0,0 +1,109 @@
+# 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.
+#
+# 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
+import typing as _t
+
+MEGABYTE = 1024 * 1024
+
+# anything that can be `write`n
+ByteString = _t.Union[bytes, bytearray, memoryview]
+
+ShutdownState = int # _t.NewType("ShutdownState", int), ideally, but then ~ and | operations won't work
+SHUT_NONE  = ShutdownState(0)
+SHUT_READ  = ShutdownState(1)
+SHUT_WRITE = ShutdownState(2)
+SHUT_BOTH  = ShutdownState(3)
+
+class MinimalIO(metaclass=_abc.ABCMeta):
+    def __repr__(self) -> str:
+        return "<%s %s>" % (self.__class__.__name__, hex(id(self)))
+
+    @_abc.abstractmethod
+    def close(self) -> None:
+        raise NotImplementedError()
+
+    @property
+    @_abc.abstractmethod
+    def closed(self) -> bool:
+        raise NotImplementedError()
+
+    @_abc.abstractmethod
+    def shutdown(self, what : ShutdownState) -> None:
+        raise NotImplementedError()
+
+    @property
+    @_abc.abstractmethod
+    def shutdown_state(self) -> ShutdownState:
+        raise NotImplementedError()
+
+class MinimalIOReader(MinimalIO):
+    @_abc.abstractmethod
+    def read_some_bytes(self, size : int) -> bytes:
+        raise NotImplementedError()
+
+    def read_all_bytes(self, chunk_size : int = MEGABYTE) -> bytes:
+        data : list[bytes] = []
+        while True:
+            res = self.read_some_bytes(chunk_size)
+            rlen = len(res)
+            if rlen == 0: break
+            data.append(res)
+        return b"".join(data)
+
+    def read_exactly_bytes(self, size : int) -> bytes:
+        data : list[bytes] = []
+        total = 0
+        while total < size:
+            res = self.read_some_bytes(size - total)
+            rlen = len(res)
+            if rlen == 0: break
+            data.append(res)
+            total += rlen
+        return b"".join(data)
+
+    def read_bytes(self, size : int | None = None) -> bytes:
+        if size is None:
+            return self.read_all_bytes()
+        else:
+            return self.read_exactly_bytes(size)
+
+class MinimalIOWriter(MinimalIO):
+    @_abc.abstractmethod
+    def write_some_bytes(self, data : ByteString) -> int:
+        raise NotImplementedError()
+
+    def write_bytes(self, data : ByteString) -> None:
+        done = 0
+        view = memoryview(data)
+        datalen = len(data)
+        while done < datalen:
+            done += self.write_some_bytes(view[done:])
+
+    @_abc.abstractmethod
+    def flush(self) -> None:
+        raise NotImplementedError()

kisstdlib-0.0.1/kisstdlib/io/encoder/__init__.py

@@ -0,0 +1,28 @@
+# Copyright (c) 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.
+#
+# 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/io/encoder/base.py

@@ -0,0 +1,80 @@
+# Copyright (c) 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.
+#
+# 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
+
+from ..wrapper import *
+
+class TIOEncoder(TIOWrappedWriter):
+    default : _t.Callable[[_t.Any, _t.Any], None]
+
+    def __init__(self,
+                 fobj : _t.Any,
+                 eol : bytes = b"\n",
+                 encoding : str = _sys.getdefaultencoding(),
+                 encoders : dict[type[_t.Any], _t.Callable[[_t.Any, _t.Any], None]] = {},
+                 default : _t.Callable[[_t.Any, _t.Any], None] | None = None) -> None:
+        super().__init__(fobj, eol, encoding)
+        self.encoders = encoders.copy()
+        if default is None:
+            self.default = TIOEncoder.not_implemented
+        else:
+            self.default = default
+
+    def not_implemented(self, obj : _t.Any) -> None:
+        raise NotImplementedError("don't know how to encode %s", type(obj))
+
+    def _find_encoder(self, obj_type : _t.Any) -> _t.Any:
+        for typ, enc in self.encoders.items():
+            if issubclass(obj_type, typ):
+                return enc
+        return self.default
+
+    def encode(self, obj : _t.Any) -> None:
+        typ = type(obj)
+        try:
+            enc = self.encoders[typ]
+        except KeyError:
+            enc = self._find_encoder(typ)
+            self.encoders[typ] = enc
+        enc(self, obj)
+
+tio_default_encoders : dict[type[_t.Any], _t.Callable[[TIOWrappedWriter, _t.Any], None]] = {
+    bool: TIOEncoder.write_strable,
+    int: TIOEncoder.write_strable,
+    float: TIOEncoder.write_strable,
+    str: TIOEncoder.write_str,
+    bytes: TIOEncoder.write_bytes,
+}
+
+tio_default_encoders_ln : dict[type[_t.Any], _t.Callable[[TIOWrappedWriter, _t.Any], None]] = {
+    bool: TIOEncoder.write_strable_ln,
+    int: TIOEncoder.write_strable_ln,
+    float: TIOEncoder.write_strable_ln,
+    str: TIOEncoder.write_str_ln,
+    bytes: TIOEncoder.write_bytes_ln,
+}

kisstdlib-0.0.1/kisstdlib/io/encoder/pyrepr.py

@@ -0,0 +1,152 @@
+# Copyright (c) 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.
+#
+# 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)
+"""
+
+import io as _io
+import typing as _t
+import sys as _sys
+
+from .base import TIOEncoder
+
+class PyReprEncoder(TIOEncoder):
+    def __init__(self,
+                 fobj : _io.BufferedIOBase,
+                 indent : int = 2,
+                 starting_indent : int = 0,
+                 width : int | None = None,
+                 encoding : str = _sys.getdefaultencoding(),
+                 encoders : dict[type[_t.Any], _t.Callable[[_t.Any, _t.Any], None]] | None = None,
+                 default : _t.Callable[[_t.Any, _t.Any], None] | None = None) -> None:
+        super().__init__(fobj, b"\n", encoding,
+                         pyrepr_default_encoders if encoders is None else encoders, default)
+        self.indent = indent
+        self.current = starting_indent
+        self.width = width
+        self.linelen = 0
+        self.want_space = False
+        self.want_ln = False
+
+    def flush_line(self, force : bool = False) -> None:
+        if self.linelen != 0:
+            if force or self.want_ln or (self.width is not None and self.linelen > self.width):
+                self.write_str_ln("")
+                self.linelen = 0
+                self.want_ln = False
+                self.want_space = False
+
+    def lnlexeme(self, token : str) -> None:
+        token = " " * self.current + token
+        self.write_str(token)
+        self.linelen = len(token)
+
+    def lexeme(self, token : str) -> None:
+        self.flush_line()
+
+        if self.linelen == 0:
+            self.lnlexeme(token)
+        elif self.want_space:
+            if self.width is not None and self.linelen + len(token) + 1 > self.width:
+                self.flush_line(True)
+                self.lnlexeme(token)
+            else:
+                token = " " + token
+                self.write_str(token)
+                self.linelen += len(token)
+        else:
+            self.write_str(token)
+            self.linelen += len(token)
+        self.want_space = True
+
+    def comment(self, token : str) -> None:
+        self.lexeme("# " + token)
+        self.flush_line(True)
+
+    def start(self, token : str) -> None:
+        self.lexeme(token)
+        self.current += self.indent
+
+    def delim(self, token : str) -> None:
+        self.want_space = False
+        self.lexeme(token)
+
+    def stop(self, token : str) -> None:
+        self.current -= self.indent
+        self.lexeme(token)
+
+    def encode_plain(self, obj : _t.Any) -> None:
+        self.lexeme(str(obj))
+
+    def encode_repr(self, obj : _t.Any) -> None:
+        self.lexeme(repr(obj))
+
+    def encode_list(self, obj : list[_t.Any]) -> None:
+        large = len(obj) > 2
+        self.start("[")
+        self.want_ln = large
+        first = True
+        for i in range(0, len(obj)):
+            if not first:
+                self.delim(",")
+                self.want_ln = large
+            first = False
+            self.encode(obj[i])
+        self.want_ln = large
+        self.stop("]")
+
+    def encode_dict(self, obj : dict[_t.Any, _t.Any]) -> None:
+        large = len(obj) > 1
+        self.start("{")
+        self.want_ln = large
+        first = True
+        for k in obj:
+            if not first:
+                self.delim(",")
+                self.want_ln = large
+            first = False
+
+            self.lexeme(repr(k))
+            self.delim(":")
+            self.encode(obj[k])
+        self.want_ln = large
+        self.stop("}")
+
+pyrepr_default_encoders : dict[type[_t.Any], _t.Callable[[PyReprEncoder, _t.Any], None]] = {
+    bool: PyReprEncoder.encode_plain,
+    int: PyReprEncoder.encode_plain,
+    float: PyReprEncoder.encode_plain,
+    str: PyReprEncoder.encode_repr,
+    bytes: PyReprEncoder.encode_repr,
+    type(None): PyReprEncoder.encode_repr,
+    list: PyReprEncoder.encode_list,
+    dict: PyReprEncoder.encode_dict,
+}
+
+def pyrepr_dumps(obj : _t.Any, *args : _t.Any, **kwargs : _t.Any) -> bytes:
+    encoder = PyReprEncoder(_io.BytesIO(), *args, **kwargs)
+    encoder.encode(obj)
+    return encoder.fobj.getvalue() # type: ignore

kisstdlib-0.0.1/kisstdlib/io/wrapper.py

@@ -0,0 +1,123 @@
+# 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.
+#
+# 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
+import sys as _sys
+import typing as _t
+
+from .base import *
+
+class MinimalIOWrapper(MinimalIO):
+    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()
+        except OSError:
+            self._fileno = None
+        _logging.getLogger("kisstd").debug("init %s", self)
+
+    def __del__(self) -> None:
+        _logging.getLogger("kisstd").debug("del %s", self)
+
+    def __repr__(self) -> str:
+        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)
+
+    def close(self) -> None:
+        self.fobj.close()
+
+    @property
+    def closed(self) -> bool:
+        return self.fobj.closed # type: ignore
+
+    def shutdown(self, what : ShutdownState) -> None:
+        raise NotImplementedError("MinimalIOWrapper can't be shutdown")
+
+    @property
+    def shutdown_state(self) -> ShutdownState:
+        if self.closed:
+            return SHUT_BOTH
+        else:
+            return SHUT_NONE
+
+    def __enter__(self) -> _t.Any:
+        return self
+
+    def __exit__(self, exc_type : _t.Any, exc_value : _t.Any, exc_tb : _t.Any) -> None:
+        self.close()
+
+class TIOWrapper(MinimalIOWrapper):
+    def __init__(self, fobj : _t.Any, eol : bytes = b"\n", encoding : str = _sys.getdefaultencoding()) -> None:
+        super().__init__(fobj)
+        self.encoding = encoding
+        self.eol = eol
+
+class TIOWrappedReader(TIOWrapper, MinimalIOReader):
+    def read_some_bytes(self, size : int) -> bytes:
+        return self.fobj.read(size) # type: ignore
+
+class TIOWrappedWriter(TIOWrapper, MinimalIOWriter):
+    def write_some_bytes(self, data : ByteString) -> int:
+        return self.fobj.write(data) # type: ignore
+
+    def flush(self) -> None:
+        self.fobj.flush()
+
+    def write_bytes_ln(self, data : ByteString) -> None:
+        self.write_bytes(data)
+        self.write_bytes(self.eol)
+
+    def write_str(self, data : str) -> None:
+        assert self.encoding is not None
+        self.write_bytes(data.encode(self.encoding))
+
+    def write_str_ln(self, data : str) -> None:
+        self.write_str(data)
+        self.write_bytes(self.eol)
+
+    def write_strable(self, data : _t.Any) -> None:
+        self.write_str(str(data))
+
+    def write_strable_ln(self, data : _t.Any) -> None:
+        self.write_strable(data)
+        self.write_bytes(self.eol)
+
+    def write(self, data : str | ByteString) -> None:
+        if isinstance(data, str):
+            self.write_str(data)
+        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"))

kisstdlib-0.0.1/kisstdlib/logging.py

@@ -0,0 +1,51 @@
+# Copyright (c) 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.
+#
+# 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
+
+class CounterHandler(_logging.NullHandler):
+    errors : int
+    warnings : int
+    infos : int
+    debugs : int
+
+    def __init__(self, level : int = _logging.DEBUG) -> None:
+        super().__init__(level)
+        self.errors = 0
+        self.warnings = 0
+        self.infos = 0
+        self.debugs = 0
+
+    def handle(self, record : _logging.LogRecord) -> bool:
+        if record.levelno >= _logging.ERROR:
+            self.errors += 1
+        elif record.levelno >= _logging.WARNING:
+            self.warnings += 1
+        elif record.levelno >= _logging.INFO:
+            self.infos += 1
+        elif record.levelno >= _logging.DEBUG:
+            self.debugs += 1
+        return True

kisstdlib-0.0.1/kisstdlib/path.py

@@ -0,0 +1,100 @@
+# 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.
+#
+# 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
+import stat as _stat
+import typing as _t
+
+def walk_orderly(path : _t.AnyStr,
+                 include_directories : bool = True,
+                 follow_symlinks : bool = 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.
+    """
+
+    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)
+
+    elements.sort()
+
+    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)
+        else:
+            yield path

kisstdlib-0.0.1/kisstdlib.egg-info/PKG-INFO

@@ -0,0 +1,18 @@
+Metadata-Version: 2.1
+Name: kisstdlib
+Version: 0.0.1
+Summary: Keep It Simple STandarD LIBraries set for Python
+Author-email: Jan Malakhovski <oxij@oxij.org>
+Keywords: sys,stdlib
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Python Software Foundation License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# What?
+
+Keep It Simple STandarD LIBraries set for Python.
+
+A very alpha Work In Progress kind of thing ATM.

kisstdlib-0.0.1/kisstdlib.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+README.md
+pyproject.toml
+setup.py
+kisstdlib/__init__.py
+kisstdlib/exceptions.py
+kisstdlib/logging.py
+kisstdlib/path.py
+kisstdlib/py.typed
+kisstdlib.egg-info/PKG-INFO
+kisstdlib.egg-info/SOURCES.txt
+kisstdlib.egg-info/dependency_links.txt
+kisstdlib.egg-info/top_level.txt
+kisstdlib/argparse/__init__.py
+kisstdlib/argparse/better.py
+kisstdlib/io/__init__.py
+kisstdlib/io/base.py
+kisstdlib/io/wrapper.py
+kisstdlib/io/encoder/__init__.py
+kisstdlib/io/encoder/base.py
+kisstdlib/io/encoder/pyrepr.py

kisstdlib-0.0.1/kisstdlib.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kisstdlib-0.0.1/kisstdlib.egg-info/top_level.txt

@@ -0,0 +1 @@
+kisstdlib

kisstdlib-0.0.1/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "kisstdlib"
+version = "0.0.1"
+authors = [{ name = "Jan Malakhovski", email = "oxij@oxij.org" }]
+description = "Keep It Simple STandarD LIBraries set for Python"
+readme = "README.md"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "License :: OSI Approved :: Python Software Foundation License",
+]
+keywords = [
+    "sys",
+    "stdlib",
+]
+requires-python = ">=3.10"
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["kisstdlib*"]
+namespaces = true
+[tool.setuptools.package-data]
+"kisstdlib" = ["py.typed"]

kisstdlib-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kisstdlib-0.0.1/setup.py

@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+from setuptools import setup
+setup()