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

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

@@ -5,6 +5,12 @@ 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
@@ -13,6 +19,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### <!-- 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
@@ -1157,6 +1165,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.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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: async-kernel
-Version: 0.16.1
+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
@@ -74,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)
@@ -85,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.1 → 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.1 → 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.1'
-__version_tuple__ = version_tuple = (0, 16, 1)
+__version__ = version = '0.16.2'
+__version_tuple__ = version_tuple = (0, 16, 2)
 
 __commit_id__ = commit_id = None

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

@@ -93,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.1 → 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.1 → 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.1 → 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"