asyncio-extensions 0.3.0__tar.gz → 0.3.2__tar.gz

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/.github/workflows/release.yml

@@ -18,7 +18,7 @@ jobs:
           persist-credentials: false
 
       - name: Set up Python
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v7
         with:
           python-version: "3.x"
 
@@ -54,4 +54,4 @@ jobs:
           path: dist/
 
       - name: Publish distribution 📦 to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.14.0
+        uses: pypa/gh-action-pypi-publish@v1.14.2

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/.github/workflows/tests.yml

@@ -22,7 +22,7 @@ jobs:
       - uses: actions/checkout@v7
 
       - name: Set up Python 3.13
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v7
         with:
           python-version: "3.13"
 
@@ -49,7 +49,7 @@ jobs:
       - uses: actions/checkout@v7
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6
+        uses: actions/setup-python@v7
         with:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/.pre-commit-config.yaml

@@ -29,7 +29,7 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/commitizen-tools/commitizen
-    rev: v4.16.4
+    rev: v4.18.1
     hooks:
       - id: commitizen
       - id: commitizen-branch

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/CHANGELOG.md

@@ -8,6 +8,20 @@ This project adheres to both [Semantic Versioning](https://semver.org/spec/v2.0.
 
 ## [UNRELEASED]
 
+## [0.3.2] - 2026-09-24
+
+### Fixed
+
+- `merge_iterables` no longer raises `ValueError` when called with no arguments.
+
+## [0.3.1] - 2026-09-23
+
+### Changed
+
+- `drain` now returns the number of items consumed as an `int` instead of `None`.
+
+## [0.3.0] - 2026-07-03
+
 ### Added
 
 - `drain` coroutine to consume and discard remaining items from an async iterator or async iterable.
@@ -18,7 +32,7 @@ This project adheres to both [Semantic Versioning](https://semver.org/spec/v2.0.
 - Type validation now includes Pyrefly checks for enhanced type safety.
 - Enabled mypy strict mode to enforce stricter type checking standards.
 - `STOP` is now a proper sentinel instance (via `typing_extensions.sentinel` on Python < 3.15) instead of a class used as a sentinel. Behaviour is unchanged; only the type changes.
-- Use built-in TaskGroup on Python 3.15+
+- Use built-in `TaskGroup` on Python 3.15+.
 
 ## [0.2.0] - 2026-05-15
 
@@ -45,23 +59,16 @@ This project adheres to both [Semantic Versioning](https://semver.org/spec/v2.0.
 
 ### Added
 
-- Expose `iscoroutinefunction` and `markcoroutinefunction` functions.
-- `iterate_queue` async generator to consume an `asyncio.Queue` as an `async for` loop, stopping automatically when the queue is shut down.
-- Expose `iscoroutinefunction` and `markcoroutinefunction` functions.
 - `iterate_queue` async generator to consume an `asyncio.Queue` as an `async for` loop, stopping automatically when the queue is shut down or when the `STOP` sentinel is dequeued.
 - `fill_queue` coroutine to fill an `asyncio.Queue` from any sync or async iterable.
 - `merge_iterables` async context manager to merge multiple sync or async iterables into a single interleaved stream.
 - `STOP` sentinel object used to signal the end of an `iterate_queue` stream.
+- Expose `iscoroutinefunction` and `markcoroutinefunction` functions.
 
 ### Changed
 
 - Rename `noop` to `identity` so the utility clearly expresses returning the passed value after yielding once to the event loop.
 
-
-### Changed
-
-- Renamed `noop` to `identity` so the utility clearly expresses returning the passed value after yielding once to the event loop.
-
 ## [0.0.4] - 2026-03-18
 
 ### Added
@@ -75,13 +82,13 @@ This project adheres to both [Semantic Versioning](https://semver.org/spec/v2.0.
 - This CHANGELOG file.
 - pre-commit config.
 - test coverage using Codecov
-- LimitedTaskGroup to execute tasks limiting concurrency
-- heartbeat function to run something at regular interval
+- `LimitedTaskGroup` to execute tasks limiting concurrency.
+- `heartbeat` function to run something at regular interval.
 
 ### Changed
 
 - Package building and publishing are run in separate jobs to avoid credential sharing.
-- Improved README
+- Improved README.
 
 ## [0.0.2] - 2025-12-23
 
@@ -97,7 +104,11 @@ This project adheres to both [Semantic Versioning](https://semver.org/spec/v2.0.
 - `checkpoint` function to yield control to the event loop.
 - `sleep_forever` function.
 
-[unreleased]: https://github.com/hartungstenio/asyncio-extensions/compare/0.1.0...HEAD
+[unreleased]: https://github.com/hartungstenio/asyncio-extensions/compare/0.3.2...HEAD
+[0.3.2]: https://github.com/hartungstenio/asyncio-extensions/compare/0.3.1...0.3.2
+[0.3.1]: https://github.com/hartungstenio/asyncio-extensions/compare/0.3.0...0.3.1
+[0.3.0]: https://github.com/hartungstenio/asyncio-extensions/compare/0.2.0...0.3.0
+[0.2.0]: https://github.com/hartungstenio/asyncio-extensions/compare/0.1.0...0.2.0
 [0.1.0]: https://github.com/hartungstenio/asyncio-extensions/compare/0.0.5...0.1.0
 [0.0.5]: https://github.com/hartungstenio/asyncio-extensions/compare/0.0.4...0.0.5
 [0.0.4]: https://github.com/hartungstenio/asyncio-extensions/compare/0.0.3...0.0.4

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: asyncio-extensions
-Version: 0.3.0
+Version: 0.3.2
 Summary: Some (maybe) useful extensions for asyncio
 Project-URL: Changelog, https://github.com/hartungstenio/asyncio-extensions/blob/main/CHANGELOG.md
 Project-URL: Documentation, https://github.com/hartungstenio/asyncio-extensions#readme
@@ -272,7 +272,7 @@ await fill_queue(source(), queue)
 
 ### drain
 
-The `drain` coroutine consumes and discards the remaining items from an async iterator or async iterable. This is useful when you want to stop processing early but must ensure the source is exhausted so producers can finish and resources can be released.
+The `drain` coroutine consumes and discards the remaining items from an async iterator or async iterable, returning the number of items consumed. This is useful when you want to stop processing early but must ensure the source is exhausted so producers can finish and resources can be released.
 
 Example — process only the first N items, then discard the rest so the producer can complete:
 
@@ -287,7 +287,8 @@ async for idx, item in enumerate(iter_items()):
         break
     print(item)
 # ensure the remaining items are consumed and the producer can finish
-await drain(stream)
+discarded = await drain(stream)
+print(f"discarded {discarded} items")
 ```
 ### merge_iterables
 

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/README.md

@@ -242,7 +242,7 @@ await fill_queue(source(), queue)
 
 ### drain
 
-The `drain` coroutine consumes and discards the remaining items from an async iterator or async iterable. This is useful when you want to stop processing early but must ensure the source is exhausted so producers can finish and resources can be released.
+The `drain` coroutine consumes and discards the remaining items from an async iterator or async iterable, returning the number of items consumed. This is useful when you want to stop processing early but must ensure the source is exhausted so producers can finish and resources can be released.
 
 Example — process only the first N items, then discard the rest so the producer can complete:
 
@@ -257,7 +257,8 @@ async for idx, item in enumerate(iter_items()):
         break
     print(item)
 # ensure the remaining items are consumed and the producer can finish
-await drain(stream)
+discarded = await drain(stream)
+print(f"discarded {discarded} items")
 ```
 ### merge_iterables
 

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/src/asyncio_extensions/_compat.py

@@ -50,7 +50,7 @@ if sys.version_info >= (3, 15):
 
     sentinel = builtins.sentinel
 else:
-    from typing_extensions import sentinel  # type: ignore[attr-defined]
+    from typing_extensions import sentinel
 
 __all__ = [
     "CreateTaskParams",

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/src/asyncio_extensions/_iterators.py

@@ -96,20 +96,26 @@ async def fill_queue(itr: AsyncIterable[T] | Iterable[T], queue: asyncio.Queue[T
         await queue.put(it)
 
 
-async def drain(itr: AsyncIterable[T] | Iterable[T]) -> None:
-    """Consume the remaining items from *itr*.
+async def drain(itr: AsyncIterable[T] | Iterable[T]) -> int:
+    """Consume the remaining items from *itr* and return the count drained.
 
     Accepts both sync and async iterables.
 
     Args:
         itr: The iterable (sync or async) to consume.
 
+    Returns:
+        The number of items consumed.
+
     Example::
 
-        await drain(range(10))
+        count = await drain(range(10))
+        assert count == 10
     """
+    count = 0
     async for _ in asyncify_iterable(itr):
-        pass
+        count += 1
+    return count
 
 
 @asynccontextmanager
@@ -144,8 +150,9 @@ async def merge_iterables(
         tasks = [tg.create_task(fill_queue(itr, queue)) for itr in itrs]
 
         async def join() -> None:
-            await asyncio.wait(tasks)
-            await queue.put(STOP)
+            if tasks:
+                await asyncio.wait(tasks)
+            await queue.put(STOP)  # type: ignore[arg-type]
 
         tg.create_task(join())
 

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/src/asyncio_extensions/_task_groups.py

@@ -78,4 +78,5 @@ class LimitedTaskGroup(TaskGroup):
         Returns:
             The created :class:`asyncio.Task`.
         """
+        # pyrefly: ignore [open-unpacking]
         return super().create_task(self._task_wrapper(coro), **kwargs)

{asyncio_extensions-0.3.0 → asyncio_extensions-0.3.2}/tests/test_iterators.py

@@ -141,10 +141,12 @@ async def test_fill_queue_full_queue_blocks_until_space_available() -> None:
 
 
 async def test_drain_sync_iterator() -> None:
-    itr = iter([1, 2, 3])
+    given = [1, 2, 3]
+    itr = iter(given)
 
-    await drain(itr)
+    count = await drain(itr)
 
+    assert count == len(given)
     with pytest.raises(StopIteration):
         next(itr)
 
@@ -156,12 +158,19 @@ async def test_drain_async_iterator() -> None:
 
     itr = aiter(gen())
 
-    await drain(itr)
+    count = await drain(itr)
 
+    assert count == 3  # noqa: PLR2004
     with pytest.raises(StopAsyncIteration):
         await anext(itr)
 
 
+async def test_drain_empty_iterator_returns_zero() -> None:
+    count = await drain(iter([]))
+
+    assert count == 0
+
+
 # merge_iterables
 
 
@@ -197,6 +206,13 @@ async def test_merge_iterables_empty_sources_yields_nothing() -> None:
     assert results == []
 
 
+async def test_merge_iterables_no_sources_yields_nothing() -> None:
+    async with merge_iterables() as stream:
+        results = [item async for item in stream]
+
+    assert results == []
+
+
 async def test_merge_iterables_early_exit_cancels_background_tasks() -> None:
     initial_tasks = len(asyncio.all_tasks())
     itrs = [count(), count(1)]