stdlibx-compose 0.1.0__tar.gz

stdlibx_compose-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucino772
+
+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.

stdlibx_compose-0.1.0/PKG-INFO

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: stdlibx-compose
+Version: 0.1.0
+Summary: stdlibx-compose
+Author: Lucino772
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: typing-extensions>=4.10.0,<5
+Requires-Python: >=3.9
+Project-URL: Documentation, http://stdlibx.lucapalmi.com/
+Project-URL: Repository, https://github.com/Lucino772/stdlibx
+Description-Content-Type: text/markdown
+
+[![docs](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml/badge.svg?branch=main)](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml)
+
+# stdlibx
+**stdlibx** is a collection of small, focused Python utilities that simplify common programming patterns and help you write clearer, more composable code.
+
+It provides practical tools for handling optional values, explicit error management, cancellation, composition, configuration, pattern matching, and reactive flows.
+
+## Documentation
+Checkout the [documentation](http://stdlibx.lucapalmi.com/)
+
+## Licence
+This project uses a **MIT** Licence [view](https://github.com/Lucino772/stdlibx/blob/main/LICENSE)

stdlibx_compose-0.1.0/README.md

@@ -0,0 +1,12 @@
+[![docs](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml/badge.svg?branch=main)](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml)
+
+# stdlibx
+**stdlibx** is a collection of small, focused Python utilities that simplify common programming patterns and help you write clearer, more composable code.
+
+It provides practical tools for handling optional values, explicit error management, cancellation, composition, configuration, pattern matching, and reactive flows.
+
+## Documentation
+Checkout the [documentation](http://stdlibx.lucapalmi.com/)
+
+## Licence
+This project uses a **MIT** Licence [view](https://github.com/Lucino772/stdlibx/blob/main/LICENSE)

stdlibx_compose-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "stdlibx-compose"
+version = "0.1.0"
+description = "stdlibx-compose"
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+readme = "README.md"
+authors = [
+    { name = "Lucino772" }
+]
+requires-python = ">=3.9"
+dependencies = [
+    "typing_extensions>=4.10.0,<5"
+]
+
+[project.urls]
+Documentation = "http://stdlibx.lucapalmi.com/"
+Repository = "https://github.com/Lucino772/stdlibx"
+
+[tool.uv.build-backend]
+module-name = "stdlibx.compose"
+
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"

stdlibx_compose-0.1.0/src/stdlibx/compose/__init__.py

@@ -0,0 +1,4 @@
+from stdlibx.compose._flow import flow
+from stdlibx.compose._pipe import pipe
+
+__all__ = ["flow", "pipe"]

stdlibx_compose-0.1.0/src/stdlibx/compose/_flow.py

@@ -0,0 +1,100 @@
+from __future__ import annotations
+
+import functools
+from typing import TYPE_CHECKING, Any, TypeVar, overload
+
+if TYPE_CHECKING:
+    from stdlibx.compose._types import Operation
+
+T1 = TypeVar("T1")
+T2 = TypeVar("T2")
+T3 = TypeVar("T3")
+T4 = TypeVar("T4")
+T5 = TypeVar("T5")
+T6 = TypeVar("T6")
+T7 = TypeVar("T7")
+T8 = TypeVar("T8")
+T9 = TypeVar("T9")
+
+
+@overload
+def flow(source: T1, a: Operation[T1, T2], /) -> T2: ...
+
+
+@overload
+def flow(source: T1, a: Operation[T1, T2], b: Operation[T2, T3], /) -> T3: ...
+
+
+@overload
+def flow(
+    source: T1, a: Operation[T1, T2], b: Operation[T2, T3], c: Operation[T3, T4], /
+) -> T4: ...
+
+
+@overload
+def flow(
+    source: T1,
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    /,
+) -> T5: ...
+
+
+@overload
+def flow(
+    source: T1,
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    /,
+) -> T6: ...
+
+
+@overload
+def flow(
+    source: T1,
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    f: Operation[T6, T7],
+    /,
+) -> T7: ...
+
+
+@overload
+def flow(
+    source: T1,
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    f: Operation[T6, T7],
+    g: Operation[T7, T8],
+    /,
+) -> T8: ...
+
+
+@overload
+def flow(
+    source: T1,
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    f: Operation[T6, T7],
+    g: Operation[T7, T8],
+    h: Operation[T8, T9],
+    /,
+) -> T9: ...
+
+
+def flow(source: Any, *operations: Operation[Any, Any]) -> Any:
+    return functools.reduce(lambda val, operator: operator(val), operations, source)

stdlibx_compose-0.1.0/src/stdlibx/compose/_pipe.py

@@ -0,0 +1,101 @@
+from __future__ import annotations
+
+import functools
+from typing import TYPE_CHECKING, Any, TypeVar, overload
+
+if TYPE_CHECKING:
+    from stdlibx.compose._types import Operation
+
+T1 = TypeVar("T1")
+T2 = TypeVar("T2")
+T3 = TypeVar("T3")
+T4 = TypeVar("T4")
+T5 = TypeVar("T5")
+T6 = TypeVar("T6")
+T7 = TypeVar("T7")
+T8 = TypeVar("T8")
+T9 = TypeVar("T9")
+
+
+@overload
+def pipe(a: Operation[T1, T2], b: Operation[T2, T3], /) -> Operation[T1, T3]: ...
+
+
+@overload
+def pipe(
+    a: Operation[T1, T2], b: Operation[T2, T3], c: Operation[T3, T4], /
+) -> Operation[T1, T4]: ...
+
+
+@overload
+def pipe(
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    /,
+) -> Operation[T1, T5]: ...
+
+
+@overload
+def pipe(
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    /,
+) -> Operation[T1, T6]: ...
+
+
+@overload
+def pipe(
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    f: Operation[T6, T7],
+    /,
+) -> Operation[T1, T7]: ...
+
+
+@overload
+def pipe(
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    f: Operation[T6, T7],
+    g: Operation[T7, T8],
+    /,
+) -> Operation[T1, T8]: ...
+
+
+@overload
+def pipe(
+    a: Operation[T1, T2],
+    b: Operation[T2, T3],
+    c: Operation[T3, T4],
+    d: Operation[T4, T5],
+    e: Operation[T5, T6],
+    f: Operation[T6, T7],
+    g: Operation[T7, T8],
+    h: Operation[T9, T9],
+    /,
+) -> Operation[T1, T9]: ...
+
+
+def pipe(
+    first: Operation[Any, Any],
+    *others: Operation[Any, Any],
+) -> Operation[Any, Any]:
+    def _apply(value: Any) -> Any:
+        return functools.reduce(
+            lambda val, operation: operation(val),
+            (first, *others),
+            value,
+        )
+
+    return _apply

stdlibx_compose-0.1.0/src/stdlibx/compose/_types.py

@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+from typing import Callable, TypeVar
+
+from typing_extensions import TypeAlias
+
+T = TypeVar("T")
+U = TypeVar("U")
+
+Operation: TypeAlias = Callable[[T], U]