async-kernel 0.1.0__tar.gz

async_kernel-0.1.0/.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.1.0/.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.1.0/.github/workflows/ci.yml

@@ -0,0 +1,95 @@
+name: CI
+run-name: CI for ${{ github.actor }} at ${{ github.ref }}
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+jobs:
+  pre-commit:
+    name: Pre-commit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - uses: pre-commit/action@v3.0.1
+  test:
+    needs: pre-commit
+    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@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          version: "latest"
+          python-version: ${{ matrix.python-version }}
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - 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: uv run basedpyright
+
+  coverage:
+    needs: pre-commit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+
+      - 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
+
+      - 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:
+    needs: pre-commit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+
+      - name: Docs build strict
+        timeout-minutes: 5
+        run: |
+          uv sync --group docs
+          uv run async-kernel -a async-docs --shell.execute_request_timeout 0.1          
+          uv run mkdocs build -s

async_kernel-0.1.0/.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.1.0/.github/workflows/new_release.yml

@@ -0,0 +1,65 @@
+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@v5
+        with:
+          fetch-depth: 0
+          ref: main
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "latest"
+
+      - 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.1.0/.github/workflows/publish-docs.yml

@@ -0,0 +1,62 @@
+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@v5
+      - 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: "latest"
+
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Install the project
+        run: |
+          uv sync --group docs
+          uv run async-kernel -a async-docs --shell.execute_request_timeout 0.1    # The 'async-docs' kernel is specified as the kernel for mkdocs-jupyter
+
+      - name: Options
+        id: mike
+        run: |
+          version=$(git tag --points-at HEAD)
+          if [[ $version ]]; then
+              echo "version=$version" >> $GITHUB_OUTPUT
+              if [[ $version =~ .*[0-9].*[a-zA-Z] ]]; then
+                  echo "alias=$version pre-release" >> $GITHUB_OUTPUT
+              else
+                  echo "alias=release" >> $GITHUB_OUTPUT
+              fi
+          else
+            echo "version=dev" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Deploy with mike 🚀
+        run: |
+          uv run mike deploy --push --update-aliases ${{steps.mike.outputs.version}} ${{steps.mike.outputs.alias}}
+          echo "Docs has been updated for version ${{steps.mike.outputs.version}} [view here](https://fleming79.github.io/async-kernel/${{steps.mike.outputs.version}}/)." >> $GITHUB_STEP_SUMMARY

async_kernel-0.1.0/.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,117 @@
+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@v5
+        with:
+          persist-credentials: false
+          # Fetch full history for setuptools-scm
+          fetch-depth: 0
+          ref: main
+      - uses: astral-sh/setup-uv@v6
+      - name: Build a binary wheel and a source tarball
+        run: uv build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v4
+        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@v5
+        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@v5
+        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@v5
+        with:
+          persist-credentials: false
+          # Fetch full history for setuptools-scm
+          fetch-depth: 0
+          ref: main
+      - name: Download all the dists
+        uses: actions/download-artifact@v5
+        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.1.0/.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.1.0/.pre-commit-config.yaml

@@ -0,0 +1,88 @@
+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-docstring-first
+      - 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.33.3
+    hooks:
+      - id: check-github-workflows
+
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.22
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          - mdformat-gfm
+          - mdformat-frontmatter
+          - mdformat-footnote
+          - mdformat-mkdocs
+
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: "v4.0.0-alpha.8"
+    hooks:
+      - id: prettier
+        types_or: [yaml, html, json]
+
+  - repo: https://github.com/adamchainz/blacken-docs
+    rev: "1.19.1"
+    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: rst-backticks
+      - id: rst-directive-colons
+      - id: rst-inline-touching-normal
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.10
+    hooks:
+      - id: ruff
+        types_or: [python, jupyter]
+        args: ["--fix", "--show-fixes"]
+      - id: ruff-format
+        types_or: [python, jupyter]
+
+  - repo: https://github.com/scientific-python/cookie
+    rev: "2025.05.02"
+    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.1.0/.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.1.0/.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.1.0/.vscode/spellright.dict

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

async_kernel-0.1.0/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+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.1.0] - 2025-08-28
+
+### <!-- 0 --> 🏗️ Breaking changes
+
+- Caller.queue_call add argument send_nowait  and convert to sync that optionally returns an awaitable. [#71](https://github.com/fleming79/async-kernel/pull/71)
+
+### <!-- 1 --> 🚀 Features
+
+- Add anyio_backend_options and use uvloop by default [#70](https://github.com/fleming79/async-kernel/pull/70)
+
+### <!-- 5 --> 📝 Documentation
+
+- Use mike for documentation versioning. [#67](https://github.com/fleming79/async-kernel/pull/67)
+
+- Update docs, readme and project description. [#66](https://github.com/fleming79/async-kernel/pull/66)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Drop matplotlib dependency. [#69](https://github.com/fleming79/async-kernel/pull/69)
+
+## [0.1.0-rc3] - 2025-08-26
+
+### <!-- 1 --> 🚀 Features
+
+- Add more classifers and code coverage [#64](https://github.com/fleming79/async-kernel/pull/64)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.1.0-rc3 [#65](https://github.com/fleming79/async-kernel/pull/65)
+
+- Add workflow_run event because the release is not triggered if  the release is created by another workflow. [#62](https://github.com/fleming79/async-kernel/pull/62)
+
+## [0.1.0-rc2] - 2025-08-26
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.1.0-rc2 [#61](https://github.com/fleming79/async-kernel/pull/61)
+
+## [0.1.0-rc1] - 2025-08-26
+
+### <!-- 5 --> 📝 Documentation
+
+- Update licensing and contribution notes [#27](https://github.com/fleming79/async-kernel/pull/27)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Prepare for release v0.1.0-rc1 [#60](https://github.com/fleming79/async-kernel/pull/60)
+
+- Merge pull request #56 from fleming79/release/v0.1.0-rc1 [#56](https://github.com/fleming79/async-kernel/pull/56)
+
+- Revise new release [#55](https://github.com/fleming79/async-kernel/pull/55)
+
+- New release workflow in one step with publish option. [#51](https://github.com/fleming79/async-kernel/pull/51)
+
+- Improve release workflow, update documentation and license info. [#29](https://github.com/fleming79/async-kernel/pull/29)
+
+- Maintenance [#26](https://github.com/fleming79/async-kernel/pull/26)
+
+## [0.1.0-rc0] - 2025-08-24
+
+### <!-- 1 --> 🚀 Features
+
+- First release [#18](https://github.com/fleming79/async-kernel/pull/18)
+
+- Switch to vcs for versioning. [#2](https://github.com/fleming79/async-kernel/pull/2)
+
+### <!-- 2 --> 🐛 Fixes
+
+- Use no-local-version in pyproject.toml instead. [#5](https://github.com/fleming79/async-kernel/pull/5)
+
+- Use no-local-version on ci. [#4](https://github.com/fleming79/async-kernel/pull/4)
+
+### <!-- 5 --> 📝 Documentation
+
+- Revise workflow to work with tags that start with 'v'. No longer sets the tag when writing the changelog. [#16](https://github.com/fleming79/async-kernel/pull/16)
+
+- Switch to python installer to run git cliff. [#14](https://github.com/fleming79/async-kernel/pull/14)
+
+- Revise changelog template. [#12](https://github.com/fleming79/async-kernel/pull/12)
+
+- Do changelog as PR instead of push to main. [#8](https://github.com/fleming79/async-kernel/pull/8)
+
+- Git cliff [#7](https://github.com/fleming79/async-kernel/pull/7)
+
+- Fix mkdocs publishing [#6](https://github.com/fleming79/async-kernel/pull/6)
+
+### <!-- 6 --> 🌀 Miscellaneous
+
+- Bugfix [#25](https://github.com/fleming79/async-kernel/pull/25)
+
+- Update changelog [#24](https://github.com/fleming79/async-kernel/pull/24)
+
+- Update changelog [#22](https://github.com/fleming79/async-kernel/pull/22)
+
+- Release workflow changes [#21](https://github.com/fleming79/async-kernel/pull/21)
+
+- Update release workflow to use a template that appends output from git-cliff [#17](https://github.com/fleming79/async-kernel/pull/17)
+
+- Bump the actions group across 1 directory with 2 updates [#3](https://github.com/fleming79/async-kernel/pull/3)
+
+[0.1.0]: https://github.com/fleming79/async-kernel/compare/v0.1.0-rc3..v0.1.0
+[0.1.0-rc3]: https://github.com/fleming79/async-kernel/compare/v0.1.0-rc2..v0.1.0-rc3
+[0.1.0-rc2]: https://github.com/fleming79/async-kernel/compare/v0.1.0-rc1..v0.1.0-rc2
+[0.1.0-rc1]: https://github.com/fleming79/async-kernel/compare/v0.1.0-rc0..v0.1.0-rc1
+
+<!-- generated by git-cliff -->