async-kernel 0.16.3__tar.gz → 0.16.4__tar.gz

{async_kernel-0.16.3 → async_kernel-0.16.4}/CHANGELOG.md

@@ -5,10 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.4] - 2026-04-15
+
+### <!-- 2 --> 🐛 Fixes
+
+- Fix PendingGroup mode 0 and add mode 3. [#428](https://github.com/fleming79/async-kernel/pull/428)
+
 ## [0.16.3] - 2026-04-12
 
 ### <!-- 6 --> 🌀 Miscellaneous
 
+- Prepare for release v0.16.3 [#427](https://github.com/fleming79/async-kernel/pull/427)
+
 - Run comm_open and com_close message handlers in the shell thread. [#426](https://github.com/fleming79/async-kernel/pull/426)
 
 ## [0.16.2] - 2026-04-12
@@ -1175,6 +1183,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Bump the actions group across 1 directory with 2 updates [#3](https://github.com/fleming79/async-kernel/pull/3)
 
+[0.16.4]: https://github.com/fleming79/async-kernel/compare/v0.16.3..v0.16.4
 [0.16.3]: https://github.com/fleming79/async-kernel/compare/v0.16.2..v0.16.3
 [0.16.2]: https://github.com/fleming79/async-kernel/compare/v0.16.1..v0.16.2
 [0.16.1]: https://github.com/fleming79/async-kernel/compare/v0.16.0..v0.16.1

{async_kernel-0.16.3 → async_kernel-0.16.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-kernel
-Version: 0.16.3
+Version: 0.16.4
 Summary: A concurrent python kernel for Jupyter supporting AnyIO, AsyncIO and Trio.
 Project-URL: Homepage, https://fleming79.github.io/async-kernel
 Project-URL: Documentation, https://fleming79.github.io/async-kernel

{async_kernel-0.16.3 → async_kernel-0.16.4}/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.16.3'
-__version_tuple__ = version_tuple = (0, 16, 3)
+__version__ = version = '0.16.4'
+__version_tuple__ = version_tuple = (0, 16, 4)
 
 __commit_id__ = commit_id = None

{async_kernel-0.16.3 → async_kernel-0.16.4}/src/async_kernel/caller.py

@@ -1098,7 +1098,7 @@ class Caller(anyio.AsyncContextManagerMixin):
                         break
         return done, pending
 
-    def create_pending_group(self, *, shield: bool = False, mode: Literal[0, 1, 2] = 0) -> PendingGroup:
+    def create_pending_group(self, *, shield: bool = False, mode: Literal[0, 1, 2, 3] = 0) -> PendingGroup:
         """
         Create a new [PendingGroup][async_kernel.pending.PendingGroup] instance.
 
@@ -1113,9 +1113,10 @@ class Caller(anyio.AsyncContextManagerMixin):
         Args:
             shield: Shield the pending group from external cancellation.
             mode: The mode.
-                - 0: Ignore cancellation of pending.
+                - 0: Ignore cancellation of pending, if any pending is cancelled - exit quietly.
                 - 1: Cancel if any pending is cancelled - raise PendingCancelled on exit.
                 - 2: Cancel if any pending is cancelled - exit quietly.
+                - 3: Ignore cancellation of pending, if any pending is cancelled - raise PendingCancelled on exit.
 
         Usage:
 

{async_kernel-0.16.3 → async_kernel-0.16.4}/src/async_kernel/pending.py

@@ -206,7 +206,7 @@ class PendingGroup(PendingTracker, anyio.AsyncContextManagerMixin):
     caller: Fixed[Self, Caller] = Fixed(lambda _: async_kernel.Caller())
     "The caller where the pending group was instantiated."
 
-    def __init__(self, *, shield: bool = False, mode: int = 0) -> None:
+    def __init__(self, *, shield: bool = False, mode: Literal[0, 1, 2, 3] = 0) -> None:
         """
         An async context to capture all pending (that opt in) created in the context.
 
@@ -217,11 +217,12 @@ class PendingGroup(PendingTracker, anyio.AsyncContextManagerMixin):
         Args:
             shield: Passed to the cancel scope.
             mode: The mode.
-                - 0: Ignore cancellation of pending.
+                - 0: Ignore cancellation of pending, if any pending is cancelled - exit quietly.
                 - 1: Cancel if any pending is cancelled - raise PendingCancelled on exit.
                 - 2: Cancel if any pending is cancelled - exit quietly.
+                - 3: Ignore cancellation of pending, if any pending is cancelled - raise PendingCancelled on exit.
         """
-        assert mode in [0, 1, 2]
+        assert mode in [0, 1, 2, 3]
         self._mode = mode
         self._shield = shield
         self.caller  # noqa: B018
@@ -259,7 +260,7 @@ class PendingGroup(PendingTracker, anyio.AsyncContextManagerMixin):
                 if exceptions := [e for pen in self._failed if isinstance(e := pen.exception(), Exception)]:
                     msg = f"One or more exceptions occurred in this context! {list(map(str, exceptions))}"
                     raise ExceptionGroup(msg, exceptions)
-                if self._mode in [0, 1]:
+                if self._mode in [1, 3]:
                     raise PendingCancelled(self._cancelled)
         finally:
             self._leaving_context = True

{async_kernel-0.16.3 → async_kernel-0.16.4}/tests/test_pending.py

@@ -432,7 +432,7 @@ class TestPendingGroup:
 
     async def test_cancellation(self, caller: Caller):
         with pytest.raises(PendingCancelled):  # noqa: PT012
-            async with PendingGroup() as pm:
+            async with PendingGroup(mode=1) as pm:
                 pen = caller.call_soon(anyio.sleep_forever)
                 pm.cancel("Stop")
         assert pen.cancelled()  # pyright: ignore[reportPossiblyUnboundVariable]
@@ -532,15 +532,29 @@ class TestPendingGroup:
 
     async def test_mode(self, caller: Caller):
 
+        # mode 0
+        async with caller.create_pending_group(mode=0) as pg:
+            pen = pg.caller.call_soon(anyio.sleep_forever)
+            pen.cancel("stop now")
+            await pg.caller.call_soon(lambda: 1 + 1)
+            assert not pg.cancelled()
         # mode 1
         with pytest.raises(PendingCancelled):  # noqa: PT012
             async with caller.create_pending_group(mode=1) as pg:
                 pen = pg.caller.call_soon(anyio.sleep_forever)
                 pen.cancel("stop now")
+                assert pg.cancelled()
         # mode 2
         async with caller.create_pending_group(mode=2) as pg:
             pen = pg.caller.call_soon(anyio.sleep_forever)
             pen.cancel("stop now")
+            assert pg.cancelled()
+        # mode 3
+        async with caller.create_pending_group(mode=3) as pg:
+            pen = pg.caller.call_soon(anyio.sleep_forever)
+            pen.cancel("stop now")
+            await pg.caller.call_soon(lambda: 1 + 1)
+            assert not pg.cancelled()
 
     async def test_repr(self, caller: Caller):