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

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

@@ -25,7 +25,7 @@ jobs:
       - name: Type checking with basedpyright
         run: |
           uv sync
-          uvx basedpyright
+          uvx basedpyright@1.39.2
 
   test:
     needs: type-checking

{async_kernel-0.16.4 → async_kernel-0.17.0}/CHANGELOG.md

@@ -5,12 +5,26 @@ 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 --> 🏗️ Breaking changes
+
+- Transfer methods from Kernel to interface [#432](https://github.com/fleming79/async-kernel/pull/432)
+
+- Improve kernelspec to simplify creating kernelspecs for virtual environments. [#431](https://github.com/fleming79/async-kernel/pull/431)
+
+- Make AsyncInteractiveShell and AsyncInteractiveSubshell easier to subclass. [#430](https://github.com/fleming79/async-kernel/pull/430)
+
 ## [0.16.4] - 2026-04-15
 
 ### <!-- 2 --> 🐛 Fixes
 
 - Fix PendingGroup mode 0 and add mode 3. [#428](https://github.com/fleming79/async-kernel/pull/428)
 
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.16.4 [#429](https://github.com/fleming79/async-kernel/pull/429)
+
 ## [0.16.3] - 2026-04-12
 
 ### <!-- 6 --> 🌀 Miscellaneous
@@ -1183,6 +1197,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.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
 [0.16.2]: https://github.com/fleming79/async-kernel/compare/v0.16.1..v0.16.2

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

@@ -78,7 +78,7 @@ using [basedpyright](https://docs.basedpyright.com/). Other type checkers might
 in the future.
 
 ```bash
-uv run basedpyright
+uvx basedpyright
 ```
 
 ### Update packages
@@ -198,7 +198,7 @@ You can run tests locally to see if there is anything that might be caught by CI
 ```bash
 uvx prek run -a
 uv run pytest -vv --cov --cov-fail-under=100
-uv run basedpyright
+uvx basedpyright
 uv run mkdocs build -s
 ```
 

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

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

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

async_kernel-0.17.0/docs/notebooks/custom_kernel.ipynb

@@ -0,0 +1,96 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "0",
+   "metadata": {},
+   "source": [
+    "# Define custom kernels (notebook)\n",
+    "\n",
+    "- [Using a uv virtual environment](#uv-managed-virtual-environment)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1",
+   "metadata": {},
+   "source": [
+    "## uv managed virtual environment\n",
+    "\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."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "2",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "%uv venv .venv_py315 --python 3.15\n",
+    "%uv pip install --directory .venv_py315 --python 3.15 async-kernel"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "3",
+   "metadata": {},
+   "source": [
+    "Now we can write a kernel spec that uses uv to start the kernel from the virtual environment."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pathlib\n",
+    "\n",
+    "from async_kernel.kernelspec import write_kernel_spec\n",
+    "\n",
+    "uv_path = pathlib.Path.cwd().joinpath(\".venv_py315\")\n",
+    "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",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5",
+   "metadata": {},
+   "source": [
+    "The kernel spec with the display name \"Python 3.15 (async kernel)\" has been added."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python (async)",
+   "language": "python",
+   "name": "async"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.13.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

{async_kernel-0.16.4 → async_kernel-0.17.0}/mkdocs.yml

@@ -169,6 +169,7 @@ nav:
       - "Command line": usage/commands.md
       - notebooks/concurrency.ipynb
       - notebooks/caller.ipynb
+      - notebooks/custom_kernel.ipynb
   - Reference:
       - reference/index.md
       - "caller": reference/caller.md