Sure would be nice if the typeshed was good and inference was well defined

Author: mikeshardmind

.github/workflows/lint.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ '3.12', '3.13', '3.14-dev' ]
+        python-version: [ '3.12', '3.13' ]
 
     name: "Type Coverage and Linting @ ${{ matrix.python-version }}"
     steps:

src/async_utils/__init__.py

@@ -9,7 +9,7 @@
 __author__ = "Michael Hall"
 __license__ = "Apache-2.0"
 __copyright__ = "Copyright 2020-Present Michael Hall"
-__version__ = "2025.03.12b"
+__version__ = "2025.03.30b"
 
 import os
 import sys

src/async_utils/waterfall.py

@@ -168,7 +168,14 @@ async def _dispatch_loop(self) -> None:
                 # PYUPDATE: remove this block at python 3.13 minimum
             else:
                 set_name("waterfall.finalizer")
-            g = asyncio.gather(f, *tasks, return_exceptions=True)
+            # TYPESHED:
+            # Gather doesnt return a Future, it returns a GatheringFuture
+            # We only use the Future compatible api
+            # the result of that future is also not accurate in the typeshed.
+            # as we dont rely on the type of the result, the below is annotated
+            # to avoid spurious errors much as possible from inaccuracies.
+            # See: https://github.com/mikeshardmind/async-utils/actions/runs/14119338111
+            g: asyncio.Future[t.Any] = asyncio.gather(f, *tasks, return_exceptions=True)
             try:
                 await asyncio.wait_for(g, timeout=self.max_wait_finalize)
             except TimeoutError: