serverish 1.2.2__tar.gz → 1.3.0__tar.gz

{serverish-1.2.2 → serverish-1.3.0}/PKG-INFO

@@ -1,13 +1,11 @@
 Metadata-Version: 2.1
 Name: serverish
-Version: 1.2.2
+Version: 1.3.0
 Summary: helpers for server alike projects
 Home-page: https://github.com/AkondLab/serverish
 Author: Mikołaj Kałuszyński
-Requires-Python: >=3.8,<4.0
+Requires-Python: >=3.10,<4.0
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12

{serverish-1.2.2 → serverish-1.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "serverish"
-version = "1.2.2"
+version = "1.3.0"
 description = "helpers for server alike projects"
 authors = ["Mikołaj Kałuszyński", "MMME team"]
 readme = "README.md"
@@ -8,7 +8,7 @@ repository = "https://github.com/AkondLab/serverish"
 include = ["serverish/schema/*"]
 
 [tool.poetry.dependencies]
-python = "^3.8"
+python = "^3.10"
 aiodns = {version="^3.2.0", optional=true}
 param = "^2.1.0"
 nats-py = { version = "^2.7.2", optional= true}

serverish-1.3.0/serverish/base/iterators.py

@@ -0,0 +1,97 @@
+import asyncio
+from typing import List, Dict, Any, Tuple, Set
+
+
+class AsyncRangeIter:
+    """This class represent async range iterator (instead of sync).
+
+    WARNING: Noticed that end is included (not like in standard iterator).
+    Example 1: start=1, end=4, will return [1, 2, 3, 4]
+    Example 2: async for n in AsyncRangeIter(start=1, end=3): ...
+    """
+
+    def __init__(self, start: int, end: int) -> None:
+        self.start = start
+        self.end = end
+
+    def __aiter__(self) -> Any:
+        self.current = self.start
+        return self
+
+    async def __anext__(self) -> int:
+        if self.current <= self.end:
+            value = self.current
+            self.current += 1
+            await asyncio.sleep(0)
+            return value
+        else:
+            raise StopAsyncIteration
+
+
+class AsyncListIter:
+    """This class represent async list iterator (instead of sync).
+
+    Example of use: async for n in AsyncListIter(some_list): ...
+    """
+    def __init__(self, iterable: List | Tuple | Set | Any):
+        self.iterable = iterable
+        self.index: int = 0
+
+    def __aiter__(self) -> Any:
+        self.index = 0
+        return self
+
+    async def __anext__(self):
+        if self.index < len(self.iterable):
+            value = self.iterable[self.index]
+            self.index += 1
+            await asyncio.sleep(0)
+            return value
+        else:
+            raise StopAsyncIteration
+
+
+class AsyncEnumerateIter:
+    """This class represent async enumerate iterator (instead of sync).
+
+    Example of use: async for current_index, value in AsyncEnumerateIter(some_iterable): ...
+    """
+
+    def __init__(self, iterable: List | Tuple | Set | Any) -> None:
+        self.iterable = iterable
+
+    def __aiter__(self):
+        self.index = 0
+        return self
+
+    async def __anext__(self):
+        if self.index < len(self.iterable):
+            value = self.iterable[self.index]
+            current_index = self.index
+            self.index += 1
+            await asyncio.sleep(0)
+            return current_index, value
+        else:
+            raise StopAsyncIteration
+
+
+class AsyncDictItemsIter:
+    """This class represent async dict items iterator (instead of sync).
+
+    Example of use: async for key, value in AsyncEnumerateIter(some_dict): ...
+    """
+
+    def __init__(self, data_dict: Dict) -> None:
+        self.data_dict = data_dict
+
+    def __aiter__(self) -> Any:
+        self.iterator = iter(self.data_dict.items())
+        return self
+
+    async def __anext__(self) -> Tuple:
+        try:
+            n, m = next(self.iterator)
+            await asyncio.sleep(0)
+            return n, m
+        except StopIteration:
+            raise StopAsyncIteration