kisstdlib 0.0.4__tar.gz → 0.0.5__tar.gz

kisstdlib-0.0.5/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2018-2025 Jan Malakhovski and `kisstdlib` contributors
+
+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.

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

@@ -1,15 +1,21 @@
 Metadata-Version: 2.1
 Name: kisstdlib
-Version: 0.0.4
+Version: 0.0.5
 Summary: Keep It Simple STandarD LIBraries set for Python
 Author-email: Jan Malakhovski <oxij@oxij.org>
+Project-URL: Homepage, https://oxij.org/software/kisstdlib/
+Project-URL: GitHub, https://github.com/oxij/kisstdlib
+Project-URL: Support Development, https://oxij.org/#support
 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
+Classifier: License :: OSI Approved :: BSD License
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: sortedcontainers==2.4.*
 
 # What?
 

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

@@ -1,6 +1,6 @@
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2018-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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

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

@@ -1,6 +1,6 @@
-# Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2023-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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
@@ -20,4 +20,6 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+"""Default re-exports."""
+
 from .better import *

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

@@ -1,6 +1,6 @@
-# Copyright (c) 2022-2023 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2022-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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
@@ -24,17 +24,21 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+"""Extensions for the standard `argparse` module."""
+
 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.
+    Also, it adds `add_code` function.
     """
 
-    def _fill_text(self, text : str, width : int, indent : str) -> str:
+    def _fill_text(self, text: str, width: int, indent: str) -> str:
         import textwrap
+
         res = []
         for line in text.splitlines():
             if line == "":
@@ -46,31 +50,34 @@ class BetterHelpFormatter(HelpFormatter):
                 res.append(sub)
         return "\n".join(res)
 
-    def _split_lines(self, text : str, width : int) -> list[str]:
+    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:
+    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:
+    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:
+    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:
+    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
+        action_header = f"{' ' * self._current_indent}- `{action_header}`\n"
 
         # collect the pieces of the action help
         parts = [action_header]
@@ -80,14 +87,14 @@ class MarkdownBetterHelpFormatter(BetterHelpFormatter):
             first = True
             for line in self._expand_help(action).splitlines():
                 if first:
-                    parts.append('%*s: %s\n' % (self._current_indent, '', line))
+                    parts.append(f"{' ' * self._current_indent}: {line}\n")
                 else:
-                    parts.append('%*s  %s\n' % (self._current_indent, '', line))
+                    parts.append(f"{' ' * self._current_indent}  {line}\n")
                 first = False
 
         # or add a newline if the description doesn't end with one
-        elif not action_header.endswith('\n'):
-            parts.append('\n')
+        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):
@@ -96,52 +103,57 @@ class MarkdownBetterHelpFormatter(BetterHelpFormatter):
         # return a single string
         return self._join_parts(parts)
 
-    class _Section(HelpFormatter._Section):
+    class _Section(HelpFormatter._Section):  # pylint: disable=protected-access
         def format_help(self) -> str:
             if self.parent is not None:
-                self.formatter._indent()
-            join = self.formatter._join_parts
+                self.formatter._indent()  # pylint: disable=protected-access
+            join = self.formatter._join_parts  # pylint: disable=protected-access
             item_help = join([func(*args) for func, args in self.items])
             if self.parent is not None:
-                self.formatter._dedent()
+                self.formatter._dedent()  # pylint: disable=protected-access
 
             # return nothing if the section was empty
             if not item_help:
-                return ''
+                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)
+                heading = f"{' ' * self.formatter._current_indent}- {self.heading}:\n"  # pylint: disable=protected-access
             else:
-                heading = ''
+                heading = ""
 
             # join the section-initial newline, the heading and the help
-            return join(['\n', heading, item_help, '\n'])
+            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.
+    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
+    formatter_class: type[BetterHelpFormatter]
+
+    def __init__(  # pylint: disable=dangerous-default-value
+        self,
+        *args: _t.Any,
+        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,
+        **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:
@@ -154,26 +166,33 @@ class BetterArgumentParser(ArgumentParser):
         self.add_help = add_help
         self.additional_sections = additional_sections
 
-        default_prefix = '-' if '-' in self.prefix_chars else self.prefix_chars[0]
+        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)
+            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:
+                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
+            for grp in self._subparsers._group_actions:  # type: ignore # pylint: disable=protected-access
+                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:
+    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)
 
@@ -181,19 +200,22 @@ class BetterArgumentParser(ArgumentParser):
         formatter.add_text(self.description)
 
         if hasattr(self, "_action_groups"):
-            for action_group in self._action_groups:
+            for action_group in self._action_groups:  # pylint: disable=protected-access
                 formatter.start_section(action_group.title)
                 formatter.add_text(action_group.description)
-                formatter.add_arguments(action_group._group_actions)
+                formatter.add_arguments(
+                    action_group._group_actions  # pylint: disable=protected-access
+                )
                 formatter.end_section()
 
-        res : str = "# " + formatter.format_help()
+        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
+            for grp in self._subparsers._group_actions:  # type: ignore # pylint: disable=protected-access
+                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)

kisstdlib-0.0.5/kisstdlib/failure.py

@@ -0,0 +1,60 @@
+# Copyright (c) 2023-2025 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.
+
+"""`Exceptions` with printable and i18n-able descriptions."""
+
+import typing as _t
+
+
+class CatastrophicFailure(Exception):
+    """An `Exception` with printable and i18n-able description."""
+
+    info: list[tuple[str, tuple[_t.Any, ...]]]
+
+    def __init__(self, what: _t.Any, *args: _t.Any) -> None:
+        super().__init__()
+        if isinstance(what, CatastrophicFailure):
+            self.info = what.info
+        else:
+            self.info = [(what, args)]
+
+    def get_message(self, gettext: _t.Callable[[str], str], separator: str = ": ") -> str:
+        res = []
+        for what, args in self.info:
+            try:
+                t = gettext(what) % args
+            except Exception:
+                t = f"{repr(what)} % {repr(args)}"
+            res.append(t)
+        res.reverse()
+        return separator.join(res)
+
+    def __str__(self) -> str:
+        return self.get_message(lambda x: x)
+
+    def elaborate(self, what: str, *args: _t.Any) -> _t.Any:
+        self.info.append((what, args))
+        return self
+
+
+class Failure(CatastrophicFailure):
+    """A non-catastrophic `CatastrophicFailure`."""

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

@@ -1,6 +1,6 @@
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2018-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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

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

@@ -1,6 +1,6 @@
-# Copyright (c) 2018-2023 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2018-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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
@@ -20,24 +20,31 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+"""Most basic types and definitions."""
+
 import abc as _abc
 import sys as _sys
 import typing as _t
 
-MEGABYTE = 1024 * 1024
-
-# anything that can be `write`n
+# file descriptor number
+FDNo = _t.NewType("FDNo", int)
+# anything that can be `write`ed to
 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)
+# ideally, this should be `_t.NewType("ShutdownState", int)`, but then `~` and
+# `|` operations wouldn't work
+ShutdownState = int
+SHUT_NONE = ShutdownState(0)
+SHUT_READ = ShutdownState(1)
 SHUT_WRITE = ShutdownState(2)
-SHUT_BOTH  = ShutdownState(3)
+SHUT_BOTH = ShutdownState(3)
+
+MEGABYTE = 1024 * 1024
+
 
 class MinimalIO(metaclass=_abc.ABCMeta):
     def __repr__(self) -> str:
-        return "<%s %s>" % (self.__class__.__name__, hex(id(self)))
+        return f"<{self.__class__.__name__} {hex(id(self))}>"
 
     @_abc.abstractmethod
     def close(self) -> None:
@@ -49,7 +56,7 @@ class MinimalIO(metaclass=_abc.ABCMeta):
         raise NotImplementedError()
 
     @_abc.abstractmethod
-    def shutdown(self, what : ShutdownState) -> None:
+    def shutdown(self, what: ShutdownState) -> None:
         raise NotImplementedError()
 
     @property
@@ -57,48 +64,78 @@ class MinimalIO(metaclass=_abc.ABCMeta):
     def shutdown_state(self) -> ShutdownState:
         raise NotImplementedError()
 
+
+IncompleteResultType = _t.TypeVar("IncompleteResultType")
+
+
+class IncompleteResultError(Exception, _t.Generic[IncompleteResultType]):
+    """En `Exception` signifying an opeartion did not complete, but did
+    produce a partial result.
+    """
+
+    def __init__(self, data: IncompleteResultType) -> None:
+        super().__init__()
+        self.data = data
+
+
+class IncompleteReadError(IncompleteResultError[bytes]):
+    """When a `read` operation was not complete. `.data` stores the chunk that was
+    read successfully.
+    """
+
+
+class IncompleteWriteError(IncompleteResultError[bytes]):
+    """When a `write` operation was not complete. `.data` stores the leftover
+    unwritten chunk."""
+
+
 class MinimalIOReader(MinimalIO):
     @_abc.abstractmethod
-    def read_some_bytes(self, size : int) -> bytes:
+    def read_some_bytes(self, size: int) -> bytes:
         raise NotImplementedError()
 
-    def read_all_bytes(self, chunk_size : int = MEGABYTE) -> bytes:
-        data : list[bytes] = []
+    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
+            if rlen == 0:
+                break
             data.append(res)
         return b"".join(data)
 
-    def read_exactly_bytes(self, size : int) -> bytes:
-        data : list[bytes] = []
+    def read_bytes(self, size: int | None = None) -> bytes:
+        if size is None:
+            return self.read_all_bytes()
+        return self.read_some_bytes(size)
+
+    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
+            if rlen == 0:
+                raise IncompleteReadError(b"".join(data))
             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:
+    def write_some_bytes(self, data: ByteString) -> int:
         raise NotImplementedError()
 
-    def write_bytes(self, data : ByteString) -> None:
+    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:])
+            res = self.write_some_bytes(view[done:])
+            if res == 0:
+                raise IncompleteWriteError(data[done:])
+            done += res
 
     @_abc.abstractmethod
     def flush(self) -> None:

kisstdlib-0.0.4/kisstdlib/io/encoder/base.py → kisstdlib-0.0.5/kisstdlib/io/encoder.py

@@ -1,6 +1,6 @@
-# Copyright (c) 2023 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2023-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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
@@ -20,20 +20,25 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+"""Most basic types and definitions."""
+
 import sys as _sys
 import typing as _t
 
-from ..wrapper import *
+from .wrapper import *
+
 
 class TIOEncoder(TIOWrappedWriter):
-    default : _t.Callable[[_t.Any, _t.Any], None]
+    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:
+    def __init__(  # pylint: disable=dangerous-default-value
+        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:
@@ -41,16 +46,16 @@ class TIOEncoder(TIOWrappedWriter):
         else:
             self.default = default
 
-    def not_implemented(self, obj : _t.Any) -> None:
+    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:
+    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:
+    def encode(self, obj: _t.Any) -> None:
         typ = type(obj)
         try:
             enc = self.encoders[typ]
@@ -59,7 +64,8 @@ class TIOEncoder(TIOWrappedWriter):
             self.encoders[typ] = enc
         enc(self, obj)
 
-tio_default_encoders : dict[type[_t.Any], _t.Callable[[TIOWrappedWriter, _t.Any], None]] = {
+
+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,
@@ -67,7 +73,7 @@ tio_default_encoders : dict[type[_t.Any], _t.Callable[[TIOWrappedWriter, _t.Any]
     bytes: TIOEncoder.write_bytes,
 }
 
-tio_default_encoders_ln : dict[type[_t.Any], _t.Callable[[TIOWrappedWriter, _t.Any], None]] = {
+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,

{kisstdlib-0.0.4 → kisstdlib-0.0.5}/kisstdlib/io/stdio.py

@@ -1,6 +1,6 @@
-# Copyright (c) 2018-2024 Jan Malakhovski <oxij@oxij.org>
+# Copyright (c) 2018-2025 Jan Malakhovski <oxij@oxij.org>
 #
-# This file is a part of kisstdlib project.
+# 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
@@ -20,6 +20,8 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+"""`TIOWrapped*`s for `stdin`, `stdout`, and `stderr`."""
+
 import os as _os
 import sys as _sys