async-kernel 0.17.0__tar.gz → 0.18.0__tar.gz

{async_kernel-0.17.0 → async_kernel-0.18.0}/.github/workflows/ci.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Type checking with basedpyright
         run: |
           uv sync
-          uvx basedpyright@1.39.2
+          uvx basedpyright@1.39.3
 
   test:
     needs: type-checking
@@ -110,5 +110,5 @@ jobs:
         timeout-minutes: 5
         run: |
           uv sync --group docs
-          uv run async-kernel -a async-docs --shell.timeout=0.1          
+          uv run async-kernel -a async-docs --shell.timeout=1
           uv run mkdocs build -s

{async_kernel-0.17.0 → async_kernel-0.18.0}/.github/workflows/publish-docs.yml

@@ -40,7 +40,7 @@ jobs:
       - name: Install the project
         run: |
           uv sync --group docs
-          uv run async-kernel -a async-docs --shell.timeout=0.1    # The 'async-docs' kernel is specified as the kernel for mkdocs-jupyter
+          uv run async-kernel -a async-docs --shell.timeout=1    # The 'async-docs' kernel is specified as the kernel for mkdocs-jupyter
 
       - name: Version info
         id: version

{async_kernel-0.17.0 → async_kernel-0.18.0}/.pre-commit-config.yaml

@@ -28,12 +28,12 @@ repos:
       - id: check-json5
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.37.0
+    rev: 0.37.1
     hooks:
       - id: check-github-workflows
 
   - repo: https://github.com/rbubley/mirrors-prettier
-    rev: v3.8.1
+    rev: v3.8.3
     hooks:
       - id: prettier
         types_or: [yaml, html, json]
@@ -59,7 +59,7 @@ repos:
       - id: python-use-type-annotations
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.6
+    rev: v0.15.11
     hooks:
       - id: ruff-check
         types_or: [python, jupyter]
@@ -68,7 +68,7 @@ repos:
         types_or: [python, jupyter]
 
   - repo: https://github.com/scientific-python/cookie
-    rev: 2026.03.02
+    rev: 2026.04.04
     hooks:
       - id: sp-repo-review
         additional_dependencies: ["repo-review[cli]"]

{async_kernel-0.17.0 → async_kernel-0.18.0}/.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.0 → async_kernel-0.18.0}/CHANGELOG.md

@@ -5,7 +5,57 @@ 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.17.0] - 2026-04-20
+## [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
+
+- 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
+
+- Drop the tag 'suppress_error'. [#436](https://github.com/fleming79/async-kernel/pull/436)
+
+- BaseKernelInterface refactoring [#434](https://github.com/fleming79/async-kernel/pull/434)
+
+### <!-- 1 --> 🚀 Features
+
+- Add asyncio and trio cell and line magic [#437](https://github.com/fleming79/async-kernel/pull/437)
+
+- Support specifing the thread with cell magic and passing thread options [#435](https://github.com/fleming79/async-kernel/pull/435)
+
+### <!-- 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
 
 ### <!-- 0 --> 🏗️ Breaking changes
 
@@ -15,6 +65,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Make AsyncInteractiveShell and AsyncInteractiveSubshell easier to subclass. [#430](https://github.com/fleming79/async-kernel/pull/430)
 
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.17.0 [#433](https://github.com/fleming79/async-kernel/pull/433)
+
 ## [0.16.4] - 2026-04-15
 
 ### <!-- 2 --> 🐛 Fixes
@@ -1197,6 +1251,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.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
 [0.16.3]: https://github.com/fleming79/async-kernel/compare/v0.16.2..v0.16.3

{async_kernel-0.17.0 → async_kernel-0.18.0}/CONTRIBUTING.md

@@ -25,7 +25,7 @@ Additional steps to build documentation (optional):
 
 ```bash
 uv sync --group docs
-uv run async-kernel -a async-docs --main_shell.timeout=0.1
+uv run async-kernel -a async-docs --main_shell.timeout=1
 ```
 
 ### Running tests
@@ -100,7 +100,7 @@ The 'docs' group specified extra packages are required to build documentation.
 
 ```bash
 uv sync --group docs
-uv run async-kernel -a async-docs --main_shell.timeout=0.1
+uv run async-kernel -a async-docs --main_shell.timeout=1
 ```
 
 #### Test the docs
@@ -114,7 +114,7 @@ uv run mkdocs build -s
     The command:
 
     ```bash
-    uv run async-kernel -a async-docs --main_shell.timeout=0.1
+    uv run async-kernel -a async-docs --main_shell.timeout=1
     ```
 
     Defines a new kernel spec with the name "async-docs" that sets the `shell.timeout` to 100ms.
@@ -145,13 +145,9 @@ Notebooks are included in the documentation by the plugin [mkdocs-jupyter](https
 
 !!! info
 
-    We use the kernel spec named 'async-docs' which has a cell execute timeout of 100ms. This is used
+    We use the kernel spec named 'async-docs' which has a cell execute timeout of 1s. This is used
     to advance execution through long running cells.
 
-    The [suppress-error][async_kernel.typing.Tags.suppress_error] tag is inserted in code cells to enable
-    with generating documentation. The symbol '⚠' is an indicator that the error was suppressed. Normally
-    this is due to the timeout but there is no distinction on the type of error.
-
 #### Useful links
 
 These links are not relevant for docstrings.

{async_kernel-0.17.0 → async_kernel-0.18.0}/PKG-INFO

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

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

{async_kernel-0.17.0 → async_kernel-0.18.0}/docs/notebooks/caller.ipynb

@@ -233,7 +233,7 @@
    "source": [
     "## Caller methods that return Pending\n",
     "\n",
-    "Pending is like a thread-safe [asyncio.Future](https://docs.python.org/3/library/asyncio-future.html#asyncio.Future) like object to return future results. It was called `Pending` to avoid confusion about differences in functionality to that of `asyncio.Future` and `concurrent.futures.Future`.\n",
+    "Pending is a thread-safe representation of a future result. It was designed to provide thread-safe functionality similar [asyncio.Future](https://docs.python.org/3/library/asyncio-future.html#asyncio.Future) and was named `Pending` to avoid confusion about differences in functionality to that of `asyncio.Future` and `concurrent.futures.Future`.\n",
     "\n",
     "The following functions return a `Pending` object:\n",
     "\n",

{async_kernel-0.17.0 → async_kernel-0.18.0}/docs/notebooks/concurrency.ipynb

@@ -187,10 +187,7 @@
     "editable": true,
     "slideshow": {
      "slide_type": ""
-    },
-    "tags": [
-     "suppress-error"
-    ]
+    }
    },
    "outputs": [],
    "source": [
@@ -223,13 +220,12 @@
      "slide_type": ""
     },
     "tags": [
-     "thread",
-     "suppress-error"
+     "thread"
     ]
    },
    "outputs": [],
    "source": [
-    "# This time we'll use the tag to run the cell in a Thread\n",
+    "# This time we'll use the tag to run the cell in a worker thread\n",
     "await demo()"
    ]
   },
@@ -249,6 +245,160 @@
     "# thread\n",
     "%callers # magic provided by async-kernel"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "11",
+   "metadata": {},
+   "source": [
+    "We can also specify CallerCreateOptions as part of the top line"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "12",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# thread name=\"My thread\"\n",
+    "%callers"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "13",
+   "metadata": {},
+   "source": [
+    "## Asynchronous magic\n",
+    "\n",
+    "Asynchronous line (%) and cell (%%) magic functions are supported. Any line or cell magic that returns an awaitable is awaited before proceeding.\n",
+    "\n",
+    "- **[thread magic](#thread-magic)**\n",
+    "- **[asyncio magic](#specify-the-backend)**\n",
+    "- **[trio magic](#specify-the-backend)**\n",
+    "\n",
+    "### thread magic\n",
+    "\n",
+    "This will run the code in a thread. When no settings are provided a cell worker thread is used.\n",
+    "\n",
+    "#### Comparing thread magic with thread run mode\n",
+    "\n",
+    "- thread magic (`%%thread`) is an asynchronous magic that executes the associated **code** in a separate thread. \n",
+    "- [thread run mode](#run-mode-thread) (`# thread`) instructs the kernel to run the **entire cell** in a separate thread, bypassing the shell execute request queue."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "14",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Run the magic 'callers' in a caller worker thread.\n",
+    "%thread %callers "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "15",
+   "metadata": {},
+   "source": [
+    "To specify a thread (caller) by name"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "16",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%%thread name=\"My executor\" \n",
+    "%callers"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "17",
+   "metadata": {},
+   "source": [
+    "Many of arguments accepted on `Caller.get` are also supported. Let's use a thread with a trio backend."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "18",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%%thread name=\"My trio executor\" backend=trio\n",
+    "%callers\n",
+    "\n",
+    "import trio\n",
+    "\n",
+    "await trio.sleep(0)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "19",
+   "metadata": {},
+   "source": [
+    "## Specify the backend\n",
+    "\n",
+    "Code that is written for a specific backend ('asyncio' or 'trio') can be run in the same thread with one of the following:\n",
+    "\n",
+    "- Line magic - The code following the magic on the same line is run using the specified backend.\n",
+    "    - `%trio`  \n",
+    "    - `%asyncio`  \n",
+    "\n",
+    "- Cell magic - The code block is run using the specified backend. \n",
+    "    - `%%trio`\n",
+    "    - `%asyncio`\n",
+    "\n",
+    "**Note: trio must be installed for this demo to work.**"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "20",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%asyncio await asyncio.sleep(0) # This code gets run in an asyncio task \n",
+    "%trio await trio.sleep(0) # trio run as line magic"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "21",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%%trio # trio cell magic\n",
+    "\n",
+    "def print_info():\n",
+    "    from aiologic.lowlevel import current_async_library\n",
+    "    print(f\"\"\"\n",
+    "    Kernel backend: {get_ipython().kernel.interface.backend}\n",
+    "    Current backend: { current_async_library()}\n",
+    "    \"\"\")   \n",
+    "\n",
+    "\n",
+    "print_info()\n",
+    "await trio.sleep(0)\n",
+    "\n",
+    "%callers\n",
+    "\n",
+    "%asyncio print_info()\n",
+    "%asyncio %callers\n",
+    "\n",
+    "await trio.sleep(0)"
+   ]
   }
  ],
  "metadata": {

{async_kernel-0.17.0 → async_kernel-0.18.0}/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.0 → async_kernel-0.18.0}/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 = {