async-kernel 0.10.0rc2__tar.gz

async_kernel-0.10.0rc2/.github/dependabot.yaml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      actions:
+        patterns:
+          - "*"
+  # https://docs.astral.sh/uv/guides/integration/dependency-bots/#dependabot
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"

async_kernel-0.10.0rc2/.github/release.yml

@@ -0,0 +1,27 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot
+      - pre-commit-ci
+  categories:
+    - title: 🏗️ Breaking Changes
+      labels:
+        - Semver-Major
+        - breaking-change
+    - title: 🚀 Features
+      labels:
+        - feature
+        - enhancement
+    - title: 🧪 Dependencies
+      labels:
+        - update
+    - title: 🐛 Fixes
+      labels:
+        - bug
+    - title: 🏭 Refactor
+      labels:
+        - refactor
+        - maintenance
+    - title: 📝 Documentation
+      labels:
+        - documentation

async_kernel-0.10.0rc2/.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+name: CI
+run-name: CI for ${{ github.actor }} at ${{ github.ref }}
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+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"
+          - "3.14"
+          # - "3.14t" #  re-enabled when free-threading becomes more widely supported.
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          version: "0.8.22"
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install the project
+        run: uv sync --locked --dev
+
+      - name: Run tests
+        timeout-minutes: 5
+        run: uv run pytest -vvl
+
+      - name: Type checking with basedpyright
+        run: uvx basedpyright
+
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          version: "0.8.22"
+
+      - name: Run tests with coverage
+        timeout-minutes: 5
+        run: uv run pytest --cov --cov-report=xml --junitxml=junit.xml -o junit_family=legacy  --cov-fail-under=100 --cov-report markdown-append:$GITHUB_STEP_SUMMARY
+
+      - name: Upload coverage reports to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: fleming79/async-kernel
+
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/test-results-action@v1
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          version: "0.8.22"
+
+      - name: Docs build strict
+        timeout-minutes: 5
+        run: |
+          uv sync --group docs
+          uv run async-kernel -a async-docs --shell.timeout=0.1          
+          uv run mkdocs build -s

async_kernel-0.10.0rc2/.github/workflows/enforce-label.yml

@@ -0,0 +1,17 @@
+name: Enforce PR label
+
+concurrency:
+  group: label-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  pull_request:
+    types: [labeled, unlabeled, opened, edited, synchronize]
+jobs:
+  enforce-label:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+    steps:
+      - name: enforce-triage-label
+        uses: jupyterlab/maintainer-tools/.github/actions/enforce-label@v1

async_kernel-0.10.0rc2/.github/workflows/new_release.yml

@@ -0,0 +1,66 @@
+name: New release
+# This workflow starts a new release. Trigger it manually from github ('workflow_dispatch').
+# publish_to_pypi.yml is configured to after this workflow is completed (using 'workflow_run').
+run-name: ${{ github.actor }} initiated a new release ${{ github.event.inputs.release_version }}  🚀
+on:
+  workflow_dispatch:
+    inputs:
+      release_version:
+        description: "Version"
+        default: "0.1.0rc0"
+      pre_release:
+        description: "Pre-release"
+        type: boolean
+        default: true
+env:
+  VERSION: ${{ github.event.inputs.release_version}}
+  BRANCH: releases/${{ github.event.inputs.release_version}}
+  TAG: v${{ github.event.inputs.release_version}}
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+jobs:
+  changelog:
+    name: Write changelog and merge into main
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: main
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          version: "0.8.22"
+
+      - name: Create a new branch, generate the changelog and release notes.
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+          git checkout -b $BRANCH main
+          git tag $TAG
+          uvx git-cliff -o CHANGELOG.md --github-repo ${{ github.repository }} --github-token ${{ secrets.GITHUB_TOKEN }}
+          uvx git-cliff -o release_notes.md --github-repo ${{ github.repository }} --github-token ${{ secrets.GITHUB_TOKEN }} --current
+          git commit -am "Prepare for release $TAG"
+          git push  https://${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git $BRANCH
+          git tag -d $TAG
+
+      - name: Create & merge pull request + Create release
+        # ref: https://cli.github.com/manual/gh_pr_create
+        run: |
+          gh pr create --head $BRANCH --title $VERSION --body 'Changelog for new release'  --label release
+          gh pr merge --squash --delete-branch
+
+      - name: Create a new pre-release
+        # ref: https://cli.github.com/manual/gh_release
+        if: ${{github.event.inputs.pre_release}}
+        run: |
+          gh release create $TAG -F release_notes.md  --prerelease
+
+      - name: Create a new release
+        if: ${{!github.event.inputs.pre_release}}
+        run: |
+          gh release create $TAG -F release_notes.md

async_kernel-0.10.0rc2/.github/workflows/pre-commit.yml

@@ -0,0 +1,16 @@
+name: Pre-commit
+run-name: Pre commit for ${{ github.actor }} at ${{ github.ref }}
+on:
+  pull_request:
+jobs:
+  pre-commit:
+    name: Pre-commit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - uses: pre-commit/action@v3.0.1
+      - uses: pre-commit-ci/lite-action@v1.1.0
+        if: always()

async_kernel-0.10.0rc2/.github/workflows/publish-docs.yml

@@ -0,0 +1,80 @@
+name: Publish docs
+on:
+  push:
+    branches:
+      - main
+  workflow_run:
+    workflows:
+      - New release
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    name: Deploy dev or latest version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - 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@v7
+        with:
+          enable-cache: true
+          version: "0.8.22"
+
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - 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
+
+      - name: Version info
+        id: version
+        run: |
+          version=$(git tag --points-at HEAD)
+          if [[ $version ]]; then
+            if [[ $version =~ .*[0-9].*[a-zA-Z] ]]; then
+              alias=pre-release
+            else
+              alias=latest
+              fi
+            version=$(cut -d '.' -f 1,2 <<< $version)
+          else
+            version=dev
+          fi
+
+          echo "Version: $version"
+          echo Alias: $alias
+
+          echo "version=$version" >> $GITHUB_OUTPUT
+          echo "alias=$alias" >> $GITHUB_OUTPUT
+
+          echo "Version: $version" >> $GITHUB_STEP_SUMMARY
+          echo "Alias: $alias" >> $GITHUB_STEP_SUMMARY
+
+      - name: Deploy dev docs with mike 🚀
+        if: ${{steps.version.outputs.version == 'dev'}}
+        run: |
+          uvx git-cliff -o CHANGELOG.md
+          uv run mike deploy --push ${{steps.version.outputs.version}}
+          echo "Dev docs have been updated [view here](https://fleming79.github.io/async-kernel/dev/)." >> $GITHUB_STEP_SUMMARY
+
+      - name: Deploy docs with mike 🚀
+        if: ${{steps.version.outputs.version != 'dev'}}
+        run: |
+          uv run mike deploy --push --update-aliases ${{steps.version.outputs.version}} ${{steps.version.outputs.alias}}
+          echo "Docs has been updated [view here](https://fleming79.github.io/async-kernel/${{steps.version.outputs.version}}/)." >> $GITHUB_STEP_SUMMARY

async_kernel-0.10.0rc2/.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,121 @@
+name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
+# ref: https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
+# This workflow builds the distribution and uploads it to PyPI and TestPyPI
+# It will only publish to PyPI when the head has a tag starting with 'v'.concurrency:
+# This workflow is configured to start after a 'New release' workflow has been run ('workflow_run').
+on:
+  push:
+    branches:
+      - main
+  release:
+    types: [published]
+  workflow_run:
+    workflows:
+      - New release
+    branches:
+      - main
+    types:
+      - completed
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build distribution 📦
+    runs-on: ubuntu-latest
+    outputs:
+      TAG: ${{ steps.tag_info.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+          # Fetch full history for setuptools-scm
+          fetch-depth: 0
+          ref: main
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          version: "0.8.22"
+
+      - name: Build a binary wheel and a source tarball
+        run: uv build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+      - id: tag_info
+        name: Tag info
+        run: echo "tag=$(git tag --points-at HEAD)" >> $GITHUB_OUTPUT
+
+  publish-to-pypi:
+    name: Publish Python 🐍 distribution 📦 to PyPI
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    if: startsWith(needs.build.outputs.TAG, 'v') # only publish to PyPI when the head has a version tag
+    environment:
+      name: pypi
+      url: https://pypi.org/p/async-kernel
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution 📦 to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-to-testpypi:
+    name: Publish Python 🐍 distribution 📦 to TestPyPI
+    if: github.event_name == 'push'
+    needs:
+      - build
+    runs-on: ubuntu-latest
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/async-kernel
+
+    permissions:
+      id-token: write # IMPORTANT: mandatory for trusted publishing
+
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution 📦 to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  replace-release-files:
+    name: Replace github release files
+    needs:
+      - build
+      - publish-to-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    if: startsWith(needs.build.outputs.TAG, 'v') # only upload if there is a release
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+          # Fetch full history for setuptools-scm
+          fetch-depth: 0
+          ref: main
+      - name: Download all the dists
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Upload assets to release
+        # ref: https://cli.github.com/manual/gh_release_upload
+        run: gh release upload ${{needs.build.outputs.TAG}} ./dist/* --clobber

async_kernel-0.10.0rc2/.gitignore

@@ -0,0 +1,15 @@
+build
+cover
+dist
+site
+*.py[co]
+__pycache__
+*.egg-info
+*.bak
+.ipynb_checkpoints
+.coverage
+.cache
+data_kernelspec
+.pytest_cache
+_version.py
+release_notes.md

async_kernel-0.10.0rc2/.pre-commit-config.yaml

@@ -0,0 +1,78 @@
+ci:
+  autoupdate_commit_msg: "chore: update pre-commit hooks"
+  autoupdate_schedule: weekly
+
+exclude: CHANGELOG.md
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-case-conflict
+      - id: check-ast
+      - id: check-executables-have-shebangs
+      - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: mixed-line-ending
+      - id: check-yaml
+        args: ["--unsafe"]
+      - id: debug-statements
+      - id: end-of-file-fixer
+
+  - 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.34.1
+    hooks:
+      - id: check-github-workflows
+
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.6.2
+    hooks:
+      - id: prettier
+        types_or: [yaml, html, json]
+      - id: prettier
+        types_or: [markdown]
+        args: ["--tab-width", "4"]
+
+  - repo: https://github.com/adamchainz/blacken-docs
+    rev: 1.20.0
+    hooks:
+      - id: blacken-docs
+        additional_dependencies: [black==23.7.0]
+
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
+        args: ["-L", "sur,nd"]
+
+  - repo: https://github.com/pre-commit/pygrep-hooks
+    rev: v1.10.0
+    hooks:
+      - id: python-use-type-annotations
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.4
+    hooks:
+      - id: ruff-check
+        types_or: [python, jupyter]
+        args: ["--fix", "--show-fixes"]
+      - id: ruff-format
+        types_or: [python, jupyter]
+
+  - repo: https://github.com/scientific-python/cookie
+    rev: 2025.11.07
+    hooks:
+      - id: sp-repo-review
+        additional_dependencies: ["repo-review[cli]"]
+
+  - repo: https://github.com/kynan/nbstripout
+    rev: 0.8.1
+    hooks:
+      - id: nbstripout

async_kernel-0.10.0rc2/.vscode/launch.json

@@ -0,0 +1,31 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Python: Debug Tests",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "purpose": ["debug-test"],
+      "console": "integratedTerminal",
+      "justMyCode": false, // Change as required. Note only one test config will work Ref: https://code.visualstudio.com/docs/python/testing#_debug-tests
+      "subProcess": true // Set this to false when debugging inside test_debugger.py
+    },
+    {
+      "name": "Python: Current File",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "cwd": "${workspaceFolder}",
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}"
+      },
+      "justMyCode": true,
+      "args": ["-X dev", "Wd"]
+    }
+  ]
+}

async_kernel-0.10.0rc2/.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+  "python.testing.pytestArgs": ["tests"],
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true,
+  "python.analysis.typeCheckingMode": "off",
+  "editor.defaultFormatter": "charliermarsh.ruff",
+  "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", "plaintext"]
+}

async_kernel-0.10.0rc2/.vscode/spellright.dict

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