async-kernel 0.20.0__tar.gz → 0.20.2__tar.gz

{async_kernel-0.20.0 → async_kernel-0.20.2}/.github/workflows/ci.yml

@@ -15,7 +15,7 @@ jobs:
   type-checking:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -42,7 +42,7 @@ jobs:
           - "3.15"
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
         uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
@@ -82,7 +82,7 @@ jobs:
     needs: type-checking
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 
@@ -111,7 +111,7 @@ jobs:
     needs: type-checking
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           fetch-depth: 0
 

{async_kernel-0.20.0 → async_kernel-0.20.2}/.github/workflows/new_release.yml

@@ -26,7 +26,7 @@ jobs:
       pull-requests: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
           ref: main

{async_kernel-0.20.0 → async_kernel-0.20.2}/.github/workflows/pre-commit.yml

@@ -7,7 +7,7 @@ jobs:
     name: Pre-commit
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - uses: actions/setup-python@v6
         with:
           python-version: 3.x

{async_kernel-0.20.0 → async_kernel-0.20.2}/.github/workflows/publish-docs.yml

@@ -20,7 +20,7 @@ jobs:
     name: Deploy dev or latest version
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
       - name: Configure Git Credentials
         run: |
           git config user.name github-actions[bot]
@@ -32,7 +32,7 @@ jobs:
           version-file: "pyproject.toml"
 
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
 

{async_kernel-0.20.0 → async_kernel-0.20.2}/.github/workflows/publish-to-pypi.yml

@@ -25,7 +25,7 @@ jobs:
     outputs:
       TAG: ${{ steps.tag_info.outputs.tag }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           persist-credentials: false
           # Fetch full history for setuptools-scm
@@ -104,7 +104,7 @@ jobs:
     env:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           persist-credentials: false
           # Fetch full history for setuptools-scm

{async_kernel-0.20.0 → async_kernel-0.20.2}/.pre-commit-config.yaml

@@ -59,7 +59,7 @@ repos:
       - id: python-use-type-annotations
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.18
+    rev: v0.15.19
     hooks:
       - id: ruff-check
         types_or: [python, jupyter]

{async_kernel-0.20.0 → async_kernel-0.20.2}/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.20.2] - 2026-06-29
+
+### <!-- 5 --> 📝 Documentation
+
+- Update docstrings for BaseInterface. [#508](https://github.com/fleming79/async-kernel/pull/508)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Avoid attribute error in Comm.publish_msg in case the parent is gc before the object. [#511](https://github.com/fleming79/async-kernel/pull/511)
+
+- Update uv.lock and pre-commit-config.yaml [#510](https://github.com/fleming79/async-kernel/pull/510)
+
+- Add more clear_iopub to tests that use utils.check_pub_message. [#509](https://github.com/fleming79/async-kernel/pull/509)
+
+- Swap async_sleep_forever for create_async_waiter in [#507](https://github.com/fleming79/async-kernel/pull/507)
+
+- Refactor BaseInterface context and stop. [#506](https://github.com/fleming79/async-kernel/pull/506)
+
+## [0.20.1] - 2026-06-22
+
+### <!-- 2 --> 🐛 Fixes
+
+- Use a long sleep in a loop instead of anyio.sleep_forever which returns immediately on pyodide. [#504](https://github.com/fleming79/async-kernel/pull/504)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.20.1 [#505](https://github.com/fleming79/async-kernel/pull/505)
+
+- Bump actions/checkout from 6 to 7 in the actions group [#503](https://github.com/fleming79/async-kernel/pull/503)
+
 ## [0.20.0] - 2026-06-22
 
 ### <!-- 0 --> 🏗️ Breaking changes
@@ -25,6 +55,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### <!-- 6 --> 🌀 Miscellaneous
 
+- Prepare for release v0.20.0 [#502](https://github.com/fleming79/async-kernel/pull/502)
+
 - Use cancellation for interface shutdown. [#501](https://github.com/fleming79/async-kernel/pull/501)
 
 - Use a Countdown event in _start_hb_iopub_shell_control_threads. [#500](https://github.com/fleming79/async-kernel/pull/500)
@@ -1387,6 +1419,8 @@ 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.20.2]: https://github.com/fleming79/async-kernel/compare/v0.20.1..v0.20.2
+[0.20.1]: https://github.com/fleming79/async-kernel/compare/v0.20.0..v0.20.1
 [0.20.0]: https://github.com/fleming79/async-kernel/compare/v0.19.2..v0.20.0
 [0.19.2]: https://github.com/fleming79/async-kernel/compare/v0.19.1..v0.19.2
 [0.19.1]: https://github.com/fleming79/async-kernel/compare/v0.19.0..v0.19.1

{async_kernel-0.20.0 → async_kernel-0.20.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-kernel
-Version: 0.20.0
+Version: 0.20.2
 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.20.0 → async_kernel-0.20.2}/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.20.0'
-__version_tuple__ = version_tuple = (0, 20, 0)
+__version__ = version = '0.20.2'
+__version_tuple__ = version_tuple = (0, 20, 2)
 
 __commit_id__ = commit_id = None

{async_kernel-0.20.0 → async_kernel-0.20.2}/src/async_kernel/comm.py

@@ -34,14 +34,15 @@ class Comm(HasInterface, BaseComm):
     ) -> None:
         """Helper for sending a comm message on IOPub."""
         content = {"data": {} if data is None else data, "comm_id": self.comm_id} | keys
-        self.parent.iopub_send(
-            msg_or_type=msg_type,
-            content=content,
-            metadata=metadata,
-            parent=None,
-            ident=self.topic,
-            buffers=buffers,
-        )
+        if parent := self.parent:
+            parent.iopub_send(
+                msg_or_type=msg_type,
+                content=content,
+                metadata=metadata,
+                parent=None,
+                ident=self.topic,
+                buffers=buffers,
+            )
 
     @override
     def handle_msg(self, msg: comm.base_comm.MessageType) -> None:

{async_kernel-0.20.0 → async_kernel-0.20.2}/src/async_kernel/interface/base.py

@@ -14,7 +14,7 @@ from typing import TYPE_CHECKING, Any, Generic, Literal, Self, final
 from uuid import uuid4
 
 import anyio
-from aiologic.lowlevel import AsyncLibraryNotFoundError, current_async_library
+from aiologic.lowlevel import AsyncLibraryNotFoundError, async_sleep_forever, current_async_library
 from traitlets import traitlets
 from traitlets.config import Config, Configurable
 from traitlets.config.application import Application, ClassesType
@@ -32,6 +32,7 @@ from async_kernel.typing import (
     Hosts,
     Message,
     MsgHeader,
+    MsgType,
     NoValue,
     RunSettings,
     T,
@@ -82,10 +83,12 @@ class DictValueLiteralEval(traitlets.Dict):
 
 class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell_co]):
     """
-    The base class for a singleton kernel interface.
+    The base class for kernel interface (singleton).
 
-    This singleton provides configuration and convenient references to other objects.
-    This is where kerenels should be launched f
+    The interface creates the kernel and provides external communication. It is also
+    the parent object for all objects that subclass from `HasInterface`. Configurable
+    objects that subclass from `HasInterface` inherit their configuration from the
+    interface (Application).
 
     Usage:
         launch:
@@ -95,6 +98,7 @@ class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell
         async context:
             ```python
             async with Interface() as interface:
+                interface.kernel
                 ...
             ```
     """
@@ -304,7 +308,8 @@ class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell
 
         Warning:
             - Running in a thread other than the 'MainThread' is permitted, but discouraged.
-            - Blocking calls can only be interrupted in the 'MainThread' because [*'threads cannot be destroyed, stopped, suspended, resumed, or interrupted'*](https://docs.python.org/3/library/threading.html#module-threading).
+            - Blocking calls can only be interrupted in the 'MainThread' because
+                [*'threads cannot be destroyed, stopped, suspended, resumed, or interrupted'*](https://docs.python.org/3/library/threading.html#module-threading).
             - Some libraries may assume the call is occurring in the 'MainThread'.
             - If there is an `asyncio` or `trio` event loop already running in the desired thread;
                 start asynchronously instead (`async with interface: ...`).
@@ -353,7 +358,12 @@ class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell
         try:
             async with caller:
                 with anyio.CancelScope() as scope:
-                    self._scope = scope
+
+                    def stop(_):
+                        self.log.info("Stopping kernel")
+                        caller.call_later(0.5, scope.cancel, "Stopping kernel")
+
+                    self.stopping.add_done_callback(stop)
                     try:
                         async with self.kernel.running():
                             if set_started:
@@ -381,20 +391,17 @@ class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell
         """
         try:
             async with self:
-                await anyio.sleep_forever()
+                # Wait forever. This will exit when stop is called.
+                await async_sleep_forever()
         finally:
             if stopped:
                 stopped()
 
     def stop(self) -> None:
         """
-        Stop the kernel.
+        Stop the kernel and this interface.
         """
         self.stopping.set_result(None)
-        if scope := getattr(self, "_scope", None):
-            del self._scope
-            self.log.info("Stopping kernel")
-            self.callers[Channel.shell].call_later(0.5, scope.cancel, "Stopping kernel")
         if not self.started.done():
             self.started.cancel("Stopped early")
             if BaseInterface._instance is self:
@@ -412,7 +419,7 @@ class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell
 
     def msg(
         self,
-        msg_type: str,
+        msg_type: str | MsgType,
         *,
         content: T | None = None,
         parent: Message | dict[str, Any] | None = None,
@@ -422,10 +429,6 @@ class BaseInterface(Application, anyio.AsyncContextManagerMixin, Generic[T_shell
     ) -> Message[T]:
         """
         Create a new message.
-
-        This format is different from what is sent over the wire. The
-        serialize/deserialize methods converts this nested message dict to the wire
-        format, which is a list of message parts.
         """
         parent = parent or utils.get_parent_message()
         if header is None:

{async_kernel-0.20.0 → async_kernel-0.20.2}/tests/test_encryption.py

@@ -17,6 +17,7 @@ def encryption(request):
 
 async def test_curve_encryption(subprocess_kernels_client: AsyncKernelClient, encryption: str):
     client = subprocess_kernels_client
+    await utils.clear_iopub(client)
     if encryption == "curve":
         assert client.curve_publickey
         assert client.curve_secretkey

{async_kernel-0.20.0 → async_kernel-0.20.2}/tests/test_message_spec.py

@@ -23,6 +23,7 @@ async def test_execute(client: AsyncKernelClient, kernel: Kernel):
 
 
 async def test_execute_suppress(client: AsyncKernelClient, kernel: Kernel):
+    await utils.clear_iopub(client)
     for mode in ["normal", "suppress"]:
         msg_id = client.execute(code="123" if mode == "normal" else "123;")
         reply = await utils.get_reply(client, msg_id, clear_pub=False)