python-iterutils 0.0.1__tar.gz

python_iterutils-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ChenyangGao <https://github.com/ChenyangGao>
+
+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.

python_iterutils-0.0.1/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.1
+Name: python-iterutils
+Version: 0.0.1
+Summary: Python another itertools.
+Home-page: https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-iterutils
+License: MIT
+Keywords: iterable,iterutils
+Author: ChenyangGao
+Author-email: wosiwujm@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Project-URL: Repository, https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-iterutils
+Description-Content-Type: text/markdown
+
+# Python another itertools.
+
+## Installation
+
+You can install from [pypi](https://pypi.org/project/python-iterutils/)
+
+```console
+pip install -U python-iterutils
+```
+
+## Usage
+
+```python
+import iterutils
+```
+

python_iterutils-0.0.1/iterutils/__init__.py

@@ -0,0 +1,109 @@
+#!/usr/bin/env python3
+# encoding: utf-8
+
+__author__ = "ChenyangGao <https://chenyanggao.github.io>"
+__version__ = (0, 0, 1)
+__all__ = ["iterable", "async_iterable", "acc_step", "cut_iter", "asyncify_iter"]
+
+from asyncio import to_thread
+from collections.abc import AsyncGenerator, AsyncIterable, Generator, Iterable, Iterator
+from typing import overload, Any, Optional, TypeVar
+
+
+TI = TypeVar("TI")
+TO = TypeVar("TO")
+
+
+def iterable(it, /) -> bool:
+    try:
+        return isinstance(iter(it), Iterable)
+    except TypeError:
+        return False
+
+
+def async_iterable(it, /) -> bool:
+    try:
+        return isinstance(iter(it), AsyncIterable)
+    except TypeError:
+        return False
+
+
+def acc_step(
+    start: int, 
+    stop: Optional[int] = None, 
+    step: int = 1, 
+) -> Iterator[tuple[int, int, int]]:
+    if stop is None:
+        start, stop = 0, start
+    for i in range(start + step, stop, step):
+        yield start, (start := i), step
+    if start != stop:
+        yield start, stop, stop - start
+
+
+def cut_iter(
+    start: int, 
+    stop: Optional[int] = None, 
+    step: int = 1, 
+) -> Iterator[tuple[int, int]]:
+    if stop is None:
+        start, stop = 0, start
+    for start in range(start + step, stop, step):
+        yield start, step
+    if start != stop:
+        yield stop, stop - start
+
+
+@overload
+async def _asyncify_iter(it: Generator[TI, TO, Any], /, wait_for_thread: bool) -> AsyncGenerator[TI, TO]: ...
+@overload
+async def _asyncify_iter(it: Iterable[TO], /, wait_for_thread: bool) -> AsyncGenerator[Any, TO]: ...
+async def _asyncify_iter(it, /, wait_for_thread: bool = False):
+    if wait_for_thread:
+        if isinstance(it, Generator):
+            send = it.send
+            def nextval(val):
+                try:
+                    return send(val), None
+                except BaseException as e:
+                    return None, e
+        else:
+            getnext = iter(it).__next__
+            def nextval(val):
+                try:
+                    return getnext(), None
+                except BaseException as e:
+                    return None, e
+        val = None
+        while True:
+            yield_val, exc = await to_thread(nextval, val)
+            if exc is None:
+                yield yield_val
+            elif isinstance(exc, StopIteration):
+                break
+            else:
+                raise exc
+    elif isinstance(it, Generator):
+        send = it.send
+        val = None
+        try:
+            while True:
+                val = yield send(val)
+        except StopIteration:
+            pass
+    else:
+        for val in it:
+            yield val
+
+
+@overload
+def asyncify_iter(it: AsyncIterable[TO], /, wait_for_thread: bool) -> AsyncIterable[TO]: ...
+@overload
+def asyncify_iter(it: Generator[TI, TO, Any], /, wait_for_thread: bool) -> AsyncGenerator[TI, TO]: ...
+@overload
+def asyncify_iter(it: Iterable[TO], /, wait_for_thread: bool) -> AsyncGenerator[Any, TO]: ...
+def asyncify_iter(it, /, wait_for_thread: bool = False):
+    if isinstance(it, AsyncIterable):
+        return it
+    return _asyncify_iter(it, wait_for_thread=wait_for_thread)
+

python_iterutils-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[tool.poetry]
+name = "python-iterutils"
+version = "0.0.1"
+description = "Python another itertools."
+authors = ["ChenyangGao <wosiwujm@gmail.com>"]
+license = "MIT"
+readme = "readme.md"
+homepage = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-iterutils"
+repository = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-iterutils"
+keywords = ["iterable", "iterutils"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Development Status :: 5 - Production/Stable",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3 :: Only",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+include = [
+    "LICENSE",
+]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[[tool.poetry.packages]]
+include = "iterutils"

python_iterutils-0.0.1/readme.md

@@ -0,0 +1,15 @@
+# Python another itertools.
+
+## Installation
+
+You can install from [pypi](https://pypi.org/project/python-iterutils/)
+
+```console
+pip install -U python-iterutils
+```
+
+## Usage
+
+```python
+import iterutils
+```