async-kernel 0.16.0__tar.gz → 0.16.2__tar.gz

{async_kernel-0.16.0 → async_kernel-0.16.2}/.github/workflows/ci.yml

@@ -39,6 +39,7 @@ jobs:
           - "3.12"
           - "3.13"
           - "3.14t"
+          - "3.15"
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -53,7 +54,7 @@ jobs:
       - name: Install the project
         run: uv sync --locked --dev
 
-      - if: ${{ startsWith(matrix.os, 'windows') && !endsWith(matrix.python-version, 't')}}
+      - if: ${{ startsWith(matrix.os, 'windows') && !endsWith(matrix.python-version, 't') && !startsWith(matrix.python-version, '3.15')}}
         # Pyside does not have free-threaded binary
         run: uv sync --locked --dev --group gui
 

{async_kernel-0.16.0 → async_kernel-0.16.2}/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.2] - 2026-04-12
+
+### <!-- 1 --> 🚀 Features
+
+- Provide async line magic support [#424](https://github.com/fleming79/async-kernel/pull/424)
+
+## [0.16.1] - 2026-04-08
+
+### <!-- 1 --> 🚀 Features
+
+- Add shield option to Pending.cancel_wait. [#421](https://github.com/fleming79/async-kernel/pull/421)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.16.1 [#423](https://github.com/fleming79/async-kernel/pull/423)
+
+- Test against Python 3.15 [#422](https://github.com/fleming79/async-kernel/pull/422)
+
 ## [0.16.0] - 2026-04-06
 
 ### <!-- 0 --> 🏗️ Breaking changes
@@ -27,6 +45,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### <!-- 6 --> 🌀 Miscellaneous
 
+- Prepare for release v0.16.0 [#420](https://github.com/fleming79/async-kernel/pull/420)
+
 - Caller refactoring [#419](https://github.com/fleming79/async-kernel/pull/419)
 
 - Convert Caller._get_task_factory to a function [#416](https://github.com/fleming79/async-kernel/pull/416)
@@ -1145,6 +1165,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.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
 [0.16.0]: https://github.com/fleming79/async-kernel/compare/v0.15.0..v0.16.0
 [0.15.0]: https://github.com/fleming79/async-kernel/compare/v0.14.0..v0.15.0
 [0.14.0]: https://github.com/fleming79/async-kernel/compare/v0.13.3..v0.14.0

{async_kernel-0.16.0 → async_kernel-0.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-kernel
-Version: 0.16.0
+Version: 0.16.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
@@ -29,6 +29,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: Free Threading :: 1 - Unstable
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
@@ -73,6 +74,7 @@ The kernel provides two external interfaces:
 
 - [IPython shell](https://ipython.readthedocs.io/en/stable/overview.html#enhanced-interactive-python-shell)
     - top-level await ('asyncio' or 'trio' backend) in cells
+    - async magic function support in cells
 - [anyio](https://pypi.org/project/anyio/) compatible asynchronous backend ([`asyncio`](https://docs.python.org/3/library/asyncio.html) (default) or [`trio`](https://pypi.org/project/trio/))
 - [aiologic](https://aiologic.readthedocs.io/latest/) thread-safe synchronisation primitives
 - [Backend agnostic multi-thread / multi-event loop management](https://fleming79.github.io/async-kernel/latest/reference/caller/#async_kernel.caller.Caller)
@@ -84,6 +86,7 @@ The kernel provides two external interfaces:
     - [x] qt host and asyncio[^2] or trio[^3] backend running as a guest
 - [Experimental](https://github.com/fleming79/echo-kernel) support for
   [Jupyterlite](https://github.com/jupyterlite/jupyterlite) (try it online [here](https://fleming79.github.io/echo-kernel/) 👈)
+    - `%pip install` magic (using micropip)
 - [Debugger client](https://jupyterlab.readthedocs.io/en/latest/user/debugger.html#debugger)
 
 [^1]:

{async_kernel-0.16.0 → async_kernel-0.16.2}/README.md

@@ -23,6 +23,7 @@ The kernel provides two external interfaces:
 
 - [IPython shell](https://ipython.readthedocs.io/en/stable/overview.html#enhanced-interactive-python-shell)
     - top-level await ('asyncio' or 'trio' backend) in cells
+    - async magic function support in cells
 - [anyio](https://pypi.org/project/anyio/) compatible asynchronous backend ([`asyncio`](https://docs.python.org/3/library/asyncio.html) (default) or [`trio`](https://pypi.org/project/trio/))
 - [aiologic](https://aiologic.readthedocs.io/latest/) thread-safe synchronisation primitives
 - [Backend agnostic multi-thread / multi-event loop management](https://fleming79.github.io/async-kernel/latest/reference/caller/#async_kernel.caller.Caller)
@@ -34,6 +35,7 @@ The kernel provides two external interfaces:
     - [x] qt host and asyncio[^2] or trio[^3] backend running as a guest
 - [Experimental](https://github.com/fleming79/echo-kernel) support for
   [Jupyterlite](https://github.com/jupyterlite/jupyterlite) (try it online [here](https://fleming79.github.io/echo-kernel/) 👈)
+    - `%pip install` magic (using micropip)
 - [Debugger client](https://jupyterlab.readthedocs.io/en/latest/user/debugger.html#debugger)
 
 [^1]:

{async_kernel-0.16.0 → async_kernel-0.16.2}/_version.py

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

{async_kernel-0.16.0 → async_kernel-0.16.2}/pyproject.toml

@@ -31,6 +31,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Programming Language :: Python :: Free Threading :: 1 - Unstable",
 ]
 requires-python = ">=3.11"
@@ -92,6 +93,7 @@ uvloop = ["uvloop; python_version <= '3.13' and sys_platform != 'win32' and impl
 dev = [
   "debugpy",
   "ipykernel; implementation_name == 'cpython'",
+  "pip; implementation_name == 'cpython'",
   {include-group = "uvloop"},
   {include-group = "test"},
 ]

{async_kernel-0.16.0 → async_kernel-0.16.2}/src/async_kernel/asyncshell.py

@@ -8,7 +8,7 @@ import pathlib
 import sys
 import time
 from collections.abc import Callable
-from typing import TYPE_CHECKING, Any, Literal, Self, overload
+from typing import TYPE_CHECKING, Any, Literal, Self, TextIO, overload
 
 import anyio
 import IPython.core.release
@@ -37,6 +37,7 @@ from async_kernel.typing import Channel, Content, Message, NoValue, Tags
 if TYPE_CHECKING:
     from collections.abc import Callable, Generator
 
+    from anyio.abc import ByteReceiveStream
     from traitlets.config import Configurable
 
     from async_kernel import Kernel
@@ -45,6 +46,13 @@ if TYPE_CHECKING:
 __all__ = ["AsyncInteractiveShell"]
 
 
+async def _forward_transport_stream(transport_stream: ByteReceiveStream, out: TextIO, /) -> None:
+    from anyio.streams.text import TextReceiveStream  # noqa: PLC0415
+
+    async for text in TextReceiveStream(transport_stream):
+        out.write(text)
+
+
 class AsyncDisplayHook(DisplayHook):
     """
     A displayhook subclass that publishes data using [iopub_send][async_kernel.kernel.Kernel.iopub_send].
@@ -168,6 +176,7 @@ class AsyncInteractiveShell(InteractiveShell):
     Notable differences:
         - Supports a soft timeout specified via tags `timeout=<value in seconds>`[^1].
         - `user_ns` and `user_global_ns` are same dictionary which is a fixed [dict][].
+        - Supports async magic functions (See [KernelMagics.pip][]).
 
         [^1]: When the execution time exceeds the timeout value, the code execution will "move on".
     """
@@ -320,6 +329,14 @@ class AsyncInteractiveShell(InteractiveShell):
     def ns_table(self) -> dict[str, dict[Any, Any] | dict[str, Any]]:
         return {"user_global": self.user_global_ns, "user_local": self.user_ns, "builtin": builtins.__dict__}
 
+    async def run_line_magic_async(self, magic_name: str, line: str, _stack_depth=1) -> Any:
+        "Call and awaits [run_line_magic][IPython.core.interactiveshell.InteractiveShell.run_line_magic]."
+        result = self.run_line_magic(magic_name, line, _stack_depth)
+        try:
+            return await result  # pyright: ignore[reportGeneralTypeIssues]
+        except TypeError:
+            return result
+
     async def _execute_request(
         self,
         code: str = "",
@@ -378,7 +395,9 @@ class AsyncInteractiveShell(InteractiveShell):
                             raw_cell=code,
                             store_history=store_history,
                             silent=silent,
-                            transformed_cell=self.transform_cell(code),
+                            transformed_cell=self.transform_cell(code).replace(
+                                "get_ipython().run_line_magic(", "await get_ipython().run_line_magic_async("
+                            ),
                             shell_futures=True,
                             cell_id=cell_id,
                         )
@@ -774,5 +793,53 @@ class KernelMagics(Magics):
         )
         print(f"Current shell:\t{self.shell}\n\n{subshell_list}")
 
+    @line_magic
+    async def pip(self, line: str) -> Any | None:
+        """Run the pip package manager for the current environment.
+
+        Usage:
+          %pip install [pkgs]
+        """
+        if sys.platform == "emscripten":
+            import micropip  # noqa: PLC0415
+
+            match line.split(maxsplit=1)[0]:
+                case "install":
+                    requirements = [
+                        f"emfs:{n}" if n.startswith(".") else n for n in line.removeprefix("install").split()
+                    ]
+                    return await micropip.install(requirements, verbose=True)
+                case "uninstall":
+                    return micropip.uninstall(line.removeprefix("uninstall").split(), verbose=True)
+                case "freeze":
+                    return micropip.freeze()
+                case "list":
+                    return micropip.list()
+                case _ as name:
+                    print("Unsupported command:", name)
+        else:
+            cmd = [sys.executable, "-m", "pip", *line.split()]
+            async with await anyio.open_process(cmd) as process, anyio.create_task_group() as tg:
+                if process.stdout:
+                    tg.start_soon(_forward_transport_stream, process.stdout, sys.stdout)
+                if process.stderr:
+                    tg.start_soon(_forward_transport_stream, process.stderr, sys.stderr)
+
+        return None
+
+    @line_magic
+    async def uv(self, line) -> None:
+        """Run the uv package manager for the current environment.
+
+        Usage:
+          %uv pip install [pkgs]
+        """
+        cmd = ["uv", *line.split()]
+        async with await anyio.open_process(cmd) as process, anyio.create_task_group() as tg:
+            if process.stdout:
+                tg.start_soon(_forward_transport_stream, process.stdout, sys.stdout)
+            if process.stderr:
+                tg.start_soon(_forward_transport_stream, process.stderr, sys.stdout)
+
 
 InteractiveShellABC.register(AsyncInteractiveShell)

{async_kernel-0.16.0 → async_kernel-0.16.2}/src/async_kernel/caller.py

@@ -1042,13 +1042,11 @@ class Caller(anyio.AsyncContextManagerMixin):
             pen_.result()
         finally:
             queue.stop()
-            pen_.cancel()
             for pen in unfinished:
                 pen.remove_done_callback(queue.append)
                 if cancel_unfinished:
                     pen.cancel("Cancelled by as_completed")
-            with anyio.CancelScope():
-                await pen_.wait(result=False)
+            await pen_.cancel_wait(shield=True)
 
     async def wait(
         self,

{async_kernel-0.16.0 → async_kernel-0.16.2}/src/async_kernel/common.py

@@ -202,16 +202,17 @@ class SingleAsyncQueue(Generic[T]):
         queue = self.queue
         try:
             while self._active:
-                await checkpoint()
-                if self._active:
-                    try:
-                        yield queue.popleft()
-                    except IndexError:
-                        event = create_async_event()
-                        self._resume = event.set
-                        if not queue and self._active:
-                            await event
-                        self._resume = noop
+                if queue:
+                    yield queue.popleft()
+                    await checkpoint()
+                else:
+                    event = create_async_event()
+                    self._resume = event.set
+                    if not queue and self._active:
+                        await event
+                    self._resume = noop
+        except IndexError:
+            pass
         finally:
             self._resume = noop
             self.stop()

{async_kernel-0.16.0 → async_kernel-0.16.2}/src/async_kernel/kernel.py

@@ -505,16 +505,16 @@ class Kernel(traitlets.HasTraits, anyio.AsyncContextManagerMixin):
         #     return RunMode(run_mode)
         if msg_type is MsgType.execute_request:
             if content := job["msg"].get("content", {}):
-                if code := content.get("code"):
-                    try:
-                        if (code := code.strip().split("\n", maxsplit=1)[0]).startswith(("# ", "##")):
-                            return RunMode(code[2:])
-                    except ValueError:
-                        pass
+                if (code := content.get("code")) and (
+                    mode := RunMode.to_runmode(code.strip().split("\n", maxsplit=1)[0])
+                ):
+                    return mode
                 if content.get("silent"):
                     return RunMode.task
-            if mode_ := set(utils.get_tags(job)).intersection(RunMode):
-                return RunMode(next(iter(mode_)))
+            try:
+                return next(mode for tag in utils.get_tags(job) if (mode := RunMode.to_runmode(tag)))
+            except Exception:
+                pass
         return RunMode.queue
 
     async def kernel_info_request(self, job: Job[Content], /) -> Content:

{async_kernel-0.16.0 → async_kernel-0.16.2}/src/async_kernel/pending.py

@@ -612,12 +612,18 @@ class Pending(Awaitable[T]):
                 canceller(msg)
         return self._cancelled is not None
 
-    async def cancel_wait(self, msg: str | None, *, timeout: float | None = None) -> None:
-        "Cancel the pending and wait for it to be done."
+    async def cancel_wait(self, msg: str | None = None, *, timeout: float | None = None, shield: bool = False) -> None:
+        """
+        Cancel the pending and wait for it to be done.
+
+        Args:
+            timeout: Timeout in seconds.
+            shield: Shield from external cancellation.
+        """
         if not self._done:
             self.cancel(msg)
             if not self._done:
-                await self.wait(result=False, timeout=timeout)
+                await self.wait(result=False, timeout=timeout, shield=shield)
 
     def cancelled(self) -> bool:
         """

{async_kernel-0.16.0 → async_kernel-0.16.2}/src/async_kernel/typing.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import enum
 from collections.abc import Awaitable, Callable
-from typing import TYPE_CHECKING, Any, Generic, Literal, NotRequired, ParamSpec, TypedDict, TypeVar
+from typing import TYPE_CHECKING, Any, Generic, Literal, NotRequired, ParamSpec, Self, TypedDict, TypeVar
 
 from typing_extensions import Sentinel, override
 
@@ -113,6 +113,16 @@ class RunMode(enum.StrEnum):
     def __hash__(self) -> int:
         return hash(self.name)
 
+    @classmethod
+    def to_runmode(cls, value: Any, default: T = None, /) -> Self | T:
+        "Converts value to `Runmode` or default where it is not possible."
+        try:
+            return cls(value)
+        except ValueError:
+            if isinstance(value, str) and value.startswith(("# ", "##")):
+                return cls.to_runmode(value[2:], default)
+            return default
+
     queue = "queue"
     "Run the message handler using [async_kernel.caller.Caller.queue_call][]."
 

{async_kernel-0.16.0 → async_kernel-0.16.2}/tests/test_kernel.py

@@ -420,7 +420,16 @@ async def test_debug_static_richInspectVariables(client: AsyncKernelClient, vari
     assert reply["content"]["status"] == "ok"
 
 
-@pytest.mark.parametrize("code", argvalues=["%connect_info", "%callers", "%subshell"])
+@pytest.mark.parametrize(
+    "code",
+    argvalues=[
+        "%connect_info",
+        "%callers",
+        "%subshell",
+        "%pip install anyio",
+        "%uv pip install anyio",
+    ],
+)
 async def test_magic(client: AsyncKernelClient, code: str, kernel: Kernel, monkeypatch):
     await utils.clear_iopub(client)
     monkeypatch.setenv("JUPYTER_RUNTIME_DIR", str(pathlib.Path(kernel.connection_file).parent))
@@ -431,6 +440,12 @@ async def test_magic(client: AsyncKernelClient, code: str, kernel: Kernel, monke
     assert stdout
 
 
+@pytest.mark.parametrize("code", argvalues=["%connect_info"])
+async def test_magic_sync(client: AsyncKernelClient, code: str, kernel: Kernel, monkeypatch):
+    result = kernel.main_shell.run_cell(code)
+    assert result.success
+
+
 async def test_shell_enable_gui(kernel: Kernel):
     # used by ipython AutoMagicChecker via is_shadowed (requires 'builitin')
     assert set(kernel.shell.ns_table) == {"user_global", "user_local", "builtin"}

{async_kernel-0.16.0 → async_kernel-0.16.2}/tests/test_typing.py

@@ -17,6 +17,11 @@ class TestRunMode:
         assert list(RunMode) == ["# queue", "# task", "# thread"]
         assert list(RunMode) == ["<RunMode.queue: 'queue'>", "<RunMode.task: 'task'>", "<RunMode.thread: 'thread'>"]
 
+    def test_is_runmode(self):
+        assert RunMode.to_runmode("# thread") is RunMode.thread
+        assert not RunMode.to_runmode(1)
+        assert RunMode.to_runmode(1, RunMode.queue) is RunMode.queue
+
 
 class TestMsgType:
     def test_all_names(self):

{async_kernel-0.16.0 → async_kernel-0.16.2}/uv.lock

@@ -139,6 +139,7 @@ dependencies = [
 dev = [
     { name = "debugpy" },
     { name = "ipykernel", marker = "implementation_name == 'cpython'" },
+    { name = "pip", marker = "implementation_name == 'cpython'" },
     { name = "pytest" },
     { name = "pytest-cov" },
     { name = "pytest-mock" },
@@ -212,6 +213,7 @@ requires-dist = [
 dev = [
     { name = "debugpy" },
     { name = "ipykernel", marker = "implementation_name == 'cpython'" },
+    { name = "pip", marker = "implementation_name == 'cpython'" },
     { name = "pytest", specifier = ">=8.4,<9" },
     { name = "pytest-cov", specifier = ">=7.0.0" },
     { name = "pytest-mock" },
@@ -2126,7 +2128,7 @@ name = "pexpect"
 version = "4.9.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "ptyprocess" },
+    { name = "ptyprocess", marker = "sys_platform != 'emscripten' and sys_platform != 'win32'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/42/92/cc564bf6381ff43ce1f4d06852fc19a2f11d180f23dc32d9588bee2f149d/pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f", size = 166450, upload-time = "2023-11-25T09:07:26.339Z" }
 wheels = [
@@ -2220,6 +2222,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/bc/60/5382c03e1970de634027cee8e1b7d39776b778b81812aaf45b694dfe9e28/pillow-12.2.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:bfa9c230d2fe991bed5318a5f119bd6780cda2915cca595393649fc118ab895e", size = 7080946, upload-time = "2026-04-01T14:46:11.734Z" },
 ]
 
+[[package]]
+name = "pip"
+version = "26.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/48/83/0d7d4e9efe3344b8e2fe25d93be44f64b65364d3c8d7bc6dc90198d5422e/pip-26.0.1.tar.gz", hash = "sha256:c4037d8a277c89b320abe636d59f91e6d0922d08a05b60e85e53b296613346d8", size = 1812747, upload-time = "2026-02-05T02:20:18.702Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/de/f0/c81e05b613866b76d2d1066490adf1a3dbc4ee9d9c839961c3fc8a6997af/pip-26.0.1-py3-none-any.whl", hash = "sha256:bdb1b08f4274833d62c1aa29e20907365a2ceb950410df15fc9521bad440122b", size = 1787723, upload-time = "2026-02-05T02:20:16.416Z" },
+]
+
 [[package]]
 name = "platformdirs"
 version = "4.9.4"