async-kernel 0.17.1__tar.gz → 0.18.1__tar.gz

{async_kernel-0.17.1 → async_kernel-0.18.1}/.vscode/launch.json

@@ -34,7 +34,7 @@
       "args": [
         "--notebook-dir=docs/notebooks",
         "--no-browser",
-        "--ServerApp.token=''",
+        "--IdentityProvider.token=''",
         "--port=9991"
       ],
       "cwd": "${workspaceFolder}",

{async_kernel-0.17.1 → async_kernel-0.18.1}/CHANGELOG.md

@@ -5,6 +5,50 @@ 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.18.1] - 2026-04-26
+
+### <!-- 2 --> 🐛 Fixes
+
+- Refactor OutStream and fix utils.redirect_stderr. [#450](https://github.com/fleming79/async-kernel/pull/450)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Check trio is available early when creating a Caller for a trio backend. [#452](https://github.com/fleming79/async-kernel/pull/452)
+
+- Remove unnecessary line. [#451](https://github.com/fleming79/async-kernel/pull/451)
+
+## [0.18.0] - 2026-04-25
+
+### <!-- 0 --> 🏗️ Breaking changes
+
+- Move kernel_info, help_links and debugger from the shell to the kernel or interface. [#444](https://github.com/fleming79/async-kernel/pull/444)
+
+### <!-- 1 --> 🚀 Features
+
+- Add utils.redirect_stdout and utils.redirect_stderr. [#442](https://github.com/fleming79/async-kernel/pull/442)
+
+- Make system calls asynchronous and convert uv and pip magics to use it. [#441](https://github.com/fleming79/async-kernel/pull/441)
+
+### <!-- 2 --> 🐛 Fixes
+
+- Improve uv support and fix example kernel spec [#440](https://github.com/fleming79/async-kernel/pull/440)
+
+### <!-- 5 --> 📝 Documentation
+
+- Update Caller docstrings [#446](https://github.com/fleming79/async-kernel/pull/446)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.18.0 [#449](https://github.com/fleming79/async-kernel/pull/449)
+
+- Refactor AsyncInteractiveShell.shell method [#448](https://github.com/fleming79/async-kernel/pull/448)
+
+- Refactor Caller.as_completed. [#447](https://github.com/fleming79/async-kernel/pull/447)
+
+- Change kernel_info back to a property. [#445](https://github.com/fleming79/async-kernel/pull/445)
+
+- Change magics thread, asynio and trio back to coroutines that don't return results. [#443](https://github.com/fleming79/async-kernel/pull/443)
+
 ## [0.17.1] - 2026-04-23
 
 ### <!-- 0 --> 🏗️ Breaking changes
@@ -21,6 +65,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### <!-- 6 --> 🌀 Miscellaneous
 
+- Prepare for release v0.17.1 [#439](https://github.com/fleming79/async-kernel/pull/439)
+
 - Update pre-commit, uv.lock and basedpyright [#438](https://github.com/fleming79/async-kernel/pull/438)
 
 ## [0.17.0] - 2026-04-22
@@ -1219,6 +1265,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.18.1]: https://github.com/fleming79/async-kernel/compare/v0.18.0..v0.18.1
+[0.18.0]: https://github.com/fleming79/async-kernel/compare/v0.17.1..v0.18.0
 [0.17.1]: https://github.com/fleming79/async-kernel/compare/v0.17.0..v0.17.1
 [0.17.0]: https://github.com/fleming79/async-kernel/compare/v0.16.4..v0.17.0
 [0.16.4]: https://github.com/fleming79/async-kernel/compare/v0.16.3..v0.16.4

{async_kernel-0.17.1 → async_kernel-0.18.1}/PKG-INFO

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

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.17.1'
-__version_tuple__ = version_tuple = (0, 17, 1)
+__version__ = version = '0.18.1'
+__version_tuple__ = version_tuple = (0, 18, 1)
 
 __commit_id__ = commit_id = None

{async_kernel-0.17.1 → async_kernel-0.18.1}/docs/notebooks/custom_kernel.ipynb

@@ -19,7 +19,9 @@
     "\n",
     "We can use uv to create a virtual environment for different versions of Python.\n",
     "\n",
-    "Let's create a new virtual environment in the folder named \".venv_py315\" using uv."
+    "Let's create a new virtual environment in the folder named \".venv_py315\" using uv.\n",
+    "\n",
+    "**Requires a recent version of uv to be installed.**"
    ]
   },
   {
@@ -29,7 +31,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%uv venv .venv_py315 --python 3.15\n",
+    "%uv venv .venv_py315 --python 3.15 --clear\n",
     "%uv pip install --directory .venv_py315 --python 3.15 async-kernel"
    ]
   },
@@ -56,10 +58,10 @@
     "assert uv_path.exists()\n",
     "\n",
     "write_kernel_spec(\n",
-    "    kernel_name=\"async-kernel-315\",\n",
-    "    display_name=\"Python 3.15 (async kernel)\",\n",
-    "    env={\"UV_PROJECT_ENVIRONMENT\": uv_path.as_posix()},\n",
-    "    executable=(\"uv\", \"run\", \"python\", \"-m\"),\n",
+    "    kernel_name=\"async_3.15\",\n",
+    "    display_name=\"Python 3.15 (async)\",\n",
+    "    env={\"UV_PROJECT_ENVIRONMENT\": str(uv_path)},\n",
+    "    executable=(\"uv\", \"run\", \"--no-sync\", \"python\", \"-m\", \"async_kernel\"),\n",
     ")"
    ]
   },
@@ -68,7 +70,7 @@
    "id": "5",
    "metadata": {},
    "source": [
-    "The kernel spec with the display name \"Python 3.15 (async kernel)\" has been added."
+    "The kernel spec with the display name \"Python 3.15 (async kernel)\" has been added. You will need to refresh the list of kernels for it to be available."
    ]
   }
  ],

{async_kernel-0.17.1 → async_kernel-0.18.1}/src/async_kernel/__init__.py

@@ -7,7 +7,8 @@ from async_kernel.kernel import Kernel
 from async_kernel.kernelspec import PROTOCOL_VERSION
 from async_kernel.pending import Pending
 
-__version__ = version(distribution_name="async-kernel")
+distribution_name = "async-kernel"
+__version__ = version(distribution_name=distribution_name)
 
 kernel_protocol_version = PROTOCOL_VERSION
 kernel_protocol_version_info = {

{async_kernel-0.17.1 → async_kernel-0.18.1}/src/async_kernel/asyncshell.py

@@ -5,6 +5,7 @@ import contextlib
 import json
 import os
 import pathlib
+import shlex
 import sys
 import time
 from collections.abc import Callable
@@ -13,6 +14,7 @@ from typing import TYPE_CHECKING, Any, Literal, Never, Self, TextIO, final
 import anyio
 import IPython.core.release
 from aiologic.lowlevel import async_checkpoint
+from anyio.streams.text import TextReceiveStream
 from IPython.core.completer import provisionalcompleter, rectify_completions
 from IPython.core.displayhook import DisplayHook
 from IPython.core.displaypub import DisplayPublisher
@@ -28,10 +30,10 @@ from typing_extensions import override
 import async_kernel
 from async_kernel import utils
 from async_kernel.caller import Caller
-from async_kernel.common import Fixed, KernelInterrupt, import_item
+from async_kernel.common import Fixed, KernelInterrupt
 from async_kernel.compiler import XCachingCompiler
 from async_kernel.event_loop.run import get_runtime_matplotlib_guis
-from async_kernel.pending import PendingManager
+from async_kernel.pending import Pending, PendingManager
 from async_kernel.typing import Channel, Content, Message, NoValue, RunMode, Tags
 
 if TYPE_CHECKING:
@@ -40,19 +42,11 @@ if TYPE_CHECKING:
     from anyio.abc import ByteReceiveStream
 
     from async_kernel import Kernel
-    from async_kernel.debugger import Debugger
 
 
 __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.interface.base.BaseKernelInterface.iopub_send].
@@ -207,9 +201,6 @@ class AsyncInteractiveShell(InteractiveShell):
     pending_manager = Fixed(ShellPendingManager)
     subshell_id = Fixed(lambda _: None)
 
-    debugger: Fixed[Self, Debugger | None] | None = None  # pyright: ignore[reportIncompatibleMethodOverride]
-    "Handles [debug requests](https://jupyter-client.readthedocs.io/en/stable/messaging.html#debug-request)."
-
     user_ns_hidden: Fixed[Self, dict] = Fixed(lambda c: c["owner"]._get_default_ns())
     user_global_ns: Fixed[Self, dict] = Fixed(lambda c: c["owner"]._user_ns)  # pyright: ignore[reportIncompatibleMethodOverride]
 
@@ -228,9 +219,6 @@ class AsyncInteractiveShell(InteractiveShell):
     loop_runner = None
     autoindent = False
 
-    help_links = traitlets.Tuple()
-    ""
-
     @override
     def __repr__(self) -> str:
         return f"<{self.__class__.__name__}  kernel_name: {self.kernel.kernel_name!r} subshell_id: {self.subshell_id}>"
@@ -363,51 +351,59 @@ 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__}
 
-    @property
-    def kernel_info(self) -> dict[str, Any]:
-        "A dict of detail sent in reply to for a 'kernel_info_request'."
-        return {
-            "protocol_version": async_kernel.kernel_protocol_version,
-            "implementation": "async_kernel",
-            "implementation_version": async_kernel.__version__,
-            "language_info": async_kernel.kernel_protocol_version_info,
-            "banner": self.banner,
-            "help_links": self.help_links,
-            "debugger": bool(self.debugger),
-            "kernel_name": self.kernel.kernel_name,
-            "supported_features": self.supported_features,
-        }
-
-    @property
-    def supported_features(self) -> list[str]:
-        "Supported features included in the reply to a [async_kernel.kernel.Kernel.kernel_info_request][]."
-        features = ["kernel subshells"]
-        if self.debugger:
-            features.append("debugger")
-        return features
-
     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 with Caller().create_pending_group(mode=1):
+            result = self.run_line_magic(magic_name, line, _stack_depth)
+            try:
+                return await result  # pyright: ignore[reportGeneralTypeIssues]
+            except TypeError:
+                return result
 
     async def run_cell_magic_async(self, magic_name: str, line: str, cell: str) -> Any:
         "Call and awaits [run_cell_magic][IPython.core.interactiveshell.InteractiveShell.run_cell_magic]."
-        result = self.run_cell_magic(magic_name, line, cell)
-        try:
-            return await result  # pyright: ignore[reportGeneralTypeIssues]
-        except TypeError:
-            return result
+        async with Caller().create_pending_group(mode=1):
+            result = self.run_cell_magic(magic_name, line, cell)
+            try:
+                return await result  # pyright: ignore[reportGeneralTypeIssues]
+            except TypeError:
+                return result
+
+    @override
+    def system(self, cmd: list[str] | str, *, stderr_to_stdout: bool = False, **kwargs: Any) -> Pending[None]:
+        """
+        Make a system call in a separate thread.
+
+        Args:
+            cmd: Passed as the first argument 'command' when calling [anyio.open_process][].
+            stderr_to_stdout: Send stderr output to stdout.
+            **kwargs: Keyword arguments are passed to [anyio.open_process][].
+
+        Tip:
+            - The output can be redicted by making the call in the context of
+                [async_kernel.utils.redirect_stdout][] and/or [async_kernel.utils.redirect_stderr][].
+        """
+
+        async def forward_output(transport_stream: ByteReceiveStream | None, out: TextIO, /) -> None:
+            if transport_stream:
+                async for text in TextReceiveStream(transport_stream):
+                    out.write(text)
+
+        async def open_process() -> None:
+            async with await anyio.open_process(cmd, **kwargs) as process, anyio.create_task_group() as tg:
+                tg.start_soon(forward_output, process.stdout, sys.stdout)
+                tg.start_soon(forward_output, process.stderr, sys.stdout if stderr_to_stdout else sys.stderr)
+
+        return Caller().to_thread(open_process)
 
     def transform_cell_async(self, raw_cell: str) -> str:
         "Transform the cell and substitute magic calls with an awaitable wrapper."
+
         return (
             self.transform_cell(raw_cell)
             .replace("get_ipython().run_line_magic(", "await get_ipython().run_line_magic_async(")
             .replace("get_ipython().run_cell_magic(", "await get_ipython().run_cell_magic_async(")
+            .replace("get_ipython().system(", "await get_ipython().system(")
         )
 
     async def execute_request(
@@ -611,6 +607,9 @@ class AsyncInteractiveShell(InteractiveShell):
         """Initialize magics."""
         super().init_magics()
         self.register_magics(KernelMagics)
+        self.magics_manager.register_alias("python", "thread")
+        self.magics_manager.register_alias("python3", "thread")
+        self.magics_manager.register_alias("!", "system")
 
     @override
     def enable_gui(self, gui=None) -> None:
@@ -760,39 +759,6 @@ class AsyncInteractiveSubshell(AsyncInteractiveShell):
 class IPythonAsyncInteractiveShell(AsyncInteractiveShell):
     "The default AsyncInteractiveShell"
 
-    debugger = Fixed(
-        lambda _: (
-            import_item("async_kernel.debugger.Debugger")()
-            if (not utils.LAUNCHED_BY_DEBUGPY) & (sys.platform != "emscripten")
-            else None
-        )
-    )
-
-    @traitlets.default("help_links")
-    def _default_help_links(self) -> tuple[dict[str, str], ...]:
-        return (
-            {
-                "text": "Async Kernel Reference ",
-                "url": "https://fleming79.github.io/async-kernel/",
-            },
-            {
-                "text": "IPython Reference",
-                "url": "https://ipython.readthedocs.io/en/stable/",
-            },
-            {
-                "text": "IPython magic Reference",
-                "url": "https://ipython.readthedocs.io/en/stable/interactive/magics.html",
-            },
-            {
-                "text": "Matplotlib ipympl Reference",
-                "url": "https://matplotlib.org/ipympl/",
-            },
-            {
-                "text": "Matplotlib Reference",
-                "url": "https://matplotlib.org/contents.html",
-            },
-        )
-
 
 class IPythonInteractiveSubshell(AsyncInteractiveSubshell):
     "The default AsyncInteractiveSubshell"
@@ -955,29 +921,18 @@ class KernelMagics(Magics):
                 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)
-
+            await SubshellManager.get_shell().system([sys.executable, "-m", "pip", *line.split()])
         return None
 
     @no_var_expand
     @line_magic
-    async def uv(self, line) -> None:
+    def uv(self, line) -> Pending[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)
+        return SubshellManager.get_shell().system(["uv", *shlex.split(line)], stderr_to_stdout=True)
 
     @no_var_expand
     @line_cell_magic
@@ -1008,7 +963,7 @@ class KernelMagics(Magics):
             transformed_cell=shell.transform_cell_async(cell),
         )
 
-    async def _call_using_backend(self, backend: Literal["asyncio", "trio"], code: str):
+    async def _call_using_backend(self, backend: Literal["asyncio", "trio"], code: str) -> None:
         shell: AsyncInteractiveShell | AsyncInteractiveSubshell = SubshellManager.get_shell()
         await Caller().call_using_backend(
             backend,