Mkdocs and fully async message handling

.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: CI
+
+on: [push]
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.8.6"
+          python-version: ${{ matrix.python-version }}
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Run tests
+        timeout-minutes: 5
+        run: uv run pytest -v
+
+      - name: Type checking with basedpyright
+        run: uv run basedpyright
+
+  coverage:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version:
+          - "3.12"
+          - "3.13"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.8.6"
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run tests with coverage
+        timeout-minutes: 5
+        run: uv run pytest -vv --cov --cov-fail-under=100
+
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - uses: pre-commit/action@v3.0.1
+      - uses: pre-commit-ci/lite-action@v1.1.0
+        if: always()

.github/workflows/publish-docs.yml

@@ -0,0 +1,36 @@
+name: Publish docs
+on:
+  push:
+    branches:
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.8.6"
+          python-version: ${{ matrix.python-version }}
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install the project
+        run: uv sync --no-dev --group docs
+
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: ~/.cache
+          restore-keys: |
+            mkdocs-material-
+      - run: mkdocs gh-deploy --force

.gitignore

@@ -2,21 +2,14 @@ MANIFEST
 build
 cover
 dist
+site
 _build
-docs/man/*.gz
-docs/source/api/generated
-docs/source/config/options
-docs/source/interactive/magics-generated.txt
-docs/gh-pages
-IPython/html/notebook/static/mathjax
-IPython/html/static/style/*.map
 *.py[co]
 __pycache__
 *.egg-info
 *~
 *.bak
 .ipynb_checkpoints
-.tox
 .DS_Store
 \#*#
 .#*

.pre-commit-config.yaml

@@ -14,19 +14,19 @@ repos:
       - id: check-case-conflict
       - id: check-merge-conflict
       - id: check-toml
+      - id: mixed-line-ending
       - id: check-yaml
+        args: ["--unsafe"]
       - id: debug-statements
-        exclude: async_kernel/kernel.py
       - id: end-of-file-fixer
-      - id: trailing-whitespace
 
   - repo: https://gitlab.com/bmares/check-json5
     rev: v1.0.0
     hooks:
       - id: check-json5
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.33.2
+    rev: 0.33.3
     hooks:
       - id: check-github-workflows
 
@@ -35,7 +35,10 @@ repos:
     hooks:
       - id: mdformat
         additional_dependencies:
-          [mdformat-gfm, mdformat-frontmatter, mdformat-footnote]
+          - mdformat-gfm
+          - mdformat-frontmatter
+          - mdformat-footnote
+          - mdformat-mkdocs
 
   - repo: https://github.com/pre-commit/mirrors-prettier
     rev: "v4.0.0-alpha.8"
@@ -63,7 +66,7 @@ repos:
       - id: rst-inline-touching-normal
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.8
+    rev: v0.12.9
     hooks:
       - id: ruff
         types_or: [python, jupyter]

.vscode/settings.json

@@ -4,5 +4,19 @@
   "python.testing.pytestEnabled": true,
   "python.analysis.typeCheckingMode": "off",
   "editor.defaultFormatter": "charliermarsh.ruff",
-  "basedpyright.analysis.diagnosticMode": "workspace"
+  "basedpyright.analysis.diagnosticMode": "workspace",
+  "yaml.schemas": {
+    "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
+  },
+  "yaml.customTags": [
+    "!ENV scalar",
+    "!ENV sequence",
+    "!relative scalar",
+    "tag:yaml.org,2002:python/name:material.extensions.emoji.to_svg",
+    "tag:yaml.org,2002:python/name:material.extensions.emoji.twemoji",
+    "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format",
+    "tag:yaml.org,2002:python/object/apply:pymdownx.slugs.slugify mapping"
+  ],
+  "spellright.language": ["en"],
+  "spellright.documentTypes": ["markdown", "latex", "plaintext"]
 }

.vscode/spellright.dict

@@ -0,0 +1,10 @@
+basedpyright
+uv
+Jupyter
+anyio
+asyncio
+zmq
+IPyKernel
+anyio's
+Asyc
+Jupyterlab

CHANGELOG.md

@@ -1,12 +1,12 @@
-# Changes in IPython kernel
+# Changes in Async kernel
 
 <!-- <START NEW CHANGELOG ENTRY> -->
 
 ## 0.0.0a1
 
 ([Full Changelog](<>))
 
-Kernel - Derived from an discontinued version branching from Ipython version 6.29.4.
+Kernel - Derived from an discontinued version branching from IPyKernel version 6.29.4.
 
 ### Enhancements made
 
@@ -20,14 +20,14 @@ Kernel - Derived from an discontinued version branching from Ipython version 6.2
 
 ### Contributors to this release
 
-<!-- ([GitHub contributors page for this release](https://github.com/ipython/ipykernel/graphs/contributors?from=2024-10-22&to=2025-03-07&type=c)) -->
+<!-- ([GitHub contributors page for this release](https://github.com/ipython/IPyKernel/graphs/contributors?from=2024-10-22&to=2025-03-07&type=c)) -->
 
 <!-- <END NEW CHANGELOG ENTRY> -->
 
 ## 0.1.0a0
 
 ([Full Changelog](<>))
 
-See Ipython [changelog](https://ipykernel.readthedocs.io/en/stable/changelog.html#id2) for all the hard work done to get here.
+See IPyKernel [changelog](https://ipykernel.readthedocs.io/en/stable/changelog.html#id2) for all the hard work done to get here.
 
-Forked from IPykernel commit [#8322a7684b004ee95f07b2f86f61e28146a5996d](https://github.com/ipython/ipykernel/commit/8322a7684b004ee95f07b2f86f61e28146a5996d)
+Forked from IPyKernel commit [#8322a7684b004ee95f07b2f86f61e28146a5996d](https://github.com/ipython/ipykernel/commit/8322a7684b004ee95f07b2f86f61e28146a5996d)