kisstdlib 0.0.13__tar.gz → 0.0.14__tar.gz

{kisstdlib-0.0.13/kisstdlib.egg-info → kisstdlib-0.0.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kisstdlib
-Version: 0.0.13
+Version: 0.0.14
 Summary: System programming with conceptually and algebraically simple primitives.
 Author-email: Jan Malakhovski <oxij@oxij.org>
 Project-URL: Homepage, https://oxij.org/software/kisstdlib/

kisstdlib-0.0.14/VERSION

@@ -0,0 +1 @@
+0.0.14

{kisstdlib-0.0.13 → kisstdlib-0.0.14}/kisstdlib/base.py

@@ -173,34 +173,33 @@ def is_closer[A: SupportsCounting](ideal: A, a: A, b: A) -> bool:
     return abs(ideal - a) < abs(ideal - b)
 
 
-### Simple functions
+### Exception handling hooks
 
 
-def noop() -> None:
-    """A noop."""
+def raise_one(exc: Exception, /, *_args: _t.Any, **_kwargs: _t.Any) -> _t.NoReturn:
+    """Raise the given `Exception`."""
+    raise exc
 
 
-def noop_(*_args: _t.Any, **_kwargs: _t.Any) -> None:
-    """A noop, with a bunch of ignored arguments."""
+def raise_all(excs: list[Exception], /, *_args: _t.Any, **_kwargs: _t.Any) -> _t.NoReturn:
+    """Raise give exceptions as a trivial `ExceptionGroup`."""
+    raise ExceptionGroup("multiple failures", excs)
 
 
-def identity[T](x: T, /) -> T:
-    """Identity function."""
-    return x
+### Simple functions
 
 
-def identity_[T](x: T, /, *_args: _t.Any, **_kwargs: _t.Any) -> T:
-    """Identity function, with a bunch of ignored arguments."""
-    return x
+def noop(*_args: _t.Any, **_kwargs: _t.Any) -> None:
+    """A noop, with a bunch of ignored arguments."""
 
 
-def const[A, B](x: A, /) -> _t.Callable[[B], A]:
-    """Return a function that always returns `a`."""
-    return lambda y: x
+def identity[T](x: T, /, *_args: _t.Any, **_kwargs: _t.Any) -> T:
+    """Identity function, with a bunch of ignored arguments."""
+    return x
 
 
-def const_[A, B, **PS](x: A, /) -> _t.Callable[_t.Concatenate[B, PS], A]:
-    """Return a function that always returns `a`, and has a bunch of ignored arguments."""
+def const[A, B, **PS](x: A, /) -> _t.Callable[_t.Concatenate[B, PS], A]:
+    """Return a function that always returns `a`, with a bunch of ignored arguments."""
 
     def sub(_y: B, /, *_args: PS.args, **_kwargs: PS.kwargs) -> A:
         return x
@@ -312,24 +311,44 @@ def map_right[A, B, C](f: _t.Callable[[B], C], x: Either[A, B]) -> Either[A, C]:
 ### Function composition
 
 
-def compose[A, B, C](f: _t.Callable[[B], C], g: _t.Callable[[A], B]) -> _t.Callable[[A], C]:
-    return lambda x: f(g(x))
+def compose[A, B, C, **PS](
+    f: _t.Callable[[B], C], g: _t.Callable[_t.Concatenate[A, PS], B]
+) -> _t.Callable[_t.Concatenate[A, PS], C]:
+    """Compose two functions `f` and `g` while passing all the additional `PS` arguments to `g`."""
+
+    def sub(x: A, /, *args: PS.args, **kwargs: PS.kwargs) -> C:
+        return f(g(x, *args, **kwargs))
+
+    return sub
+
+
+def compose_wide[A, B, C, **PS](
+    f: _t.Callable[_t.Concatenate[B, PS], C], g: _t.Callable[_t.Concatenate[A, PS], B]
+) -> _t.Callable[_t.Concatenate[A, PS], C]:
+    """Compose two functions `f` and `g` while passing all the additional `PS` arguments to both `f`
+    and `g`.
+    """
+
+    def sub(x: A, /, *args: PS.args, **kwargs: PS.kwargs) -> C:
+        return f(g(x, *args, **kwargs), *args, **kwargs)
+
+    return sub
 
 
 def compose_pipe[A, **PS](
     pipe: list[_t.Callable[_t.Concatenate[A, PS], A]], /
 ) -> _t.Callable[_t.Concatenate[A, PS], A]:
-    """Compose a list of functions, similarly to how a shell pipe ("|")
-    exression does it. I.e. compose them in reverse order.
+    """Compose a list of functions, similarly to how a shell pipe ("|") exression does it. I.e.
+    compose them in reverse order.
 
-    The mutating value gets passed as the first argument, all other
-    arguments get passed unchanged.
+    The mutating value gets passed as the first argument, all other arguments get passed unchanged
+    like with `compose_wide`.
 
-    `compose_pipe([])` is `identity_`.
+    `compose_pipe([])` is `identity`.
     `compose_pipe([x])` is `x`.
     """
     if len(pipe) == 0:
-        return identity_
+        return identity
     if len(pipe) == 1:
         return pipe[0]
 

{kisstdlib-0.0.13 → kisstdlib-0.0.14}/kisstdlib/collections_ext.py

@@ -43,7 +43,7 @@ from .base import (
     SupportsCounting as _SupportsCounting,
     is_infinite as _is_infinite,
     is_closer as _is_closer,
-    noop_ as _noop_,
+    noop as _noop,
 )
 from .itertools_ext import (
     chain as _chain,
@@ -66,7 +66,7 @@ class LRUCache[Key, Value](OrderedDict[Key, Value]):
     """
 
     def __init__(
-        self, maxsize: int | None = None, onevict: _t.Callable[[Key, Value], None] = _noop_
+        self, maxsize: int | None = None, onevict: _t.Callable[[Key, Value], None] = _noop
     ) -> None:
         self.maxsize = maxsize
         self.onevict = onevict