From 4ffbfcf5809ad8913724dd1359089ac3d42031e1 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sat, 10 Feb 2024 07:34:46 -0600 Subject: [PATCH 1/5] chore: update pre-commit hooks (#1008) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit updates: - [github.com/python-jsonschema/check-jsonschema: 0.27.3 → 0.27.4](https://github.com/python-jsonschema/check-jsonschema/compare/0.27.3...0.27.4) - [github.com/astral-sh/ruff-pre-commit: v0.1.9 → v0.2.0](https://github.com/astral-sh/ruff-pre-commit/compare/v0.1.9...v0.2.0) - [github.com/scientific-python/cookie: 2023.12.21 → 2024.01.24](https://github.com/scientific-python/cookie/compare/2023.12.21...2024.01.24) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> --- .pre-commit-config.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 34ae3502..3720f045 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -21,7 +21,7 @@ repos: - id: trailing-whitespace - repo: https://github.com/python-jsonschema/check-jsonschema - rev: 0.27.3 + rev: 0.27.4 hooks: - id: check-github-workflows @@ -66,7 +66,7 @@ repos: - id: rst-inline-touching-normal - repo: https://github.com/astral-sh/ruff-pre-commit - rev: v0.1.9 + rev: v0.2.0 hooks: - id: ruff types_or: [python, jupyter] @@ -75,7 +75,7 @@ repos: types_or: [python, jupyter] - repo: https://github.com/scientific-python/cookie - rev: "2023.12.21" + rev: "2024.01.24" hooks: - id: sp-repo-review additional_dependencies: ["repo-review[cli]"] From a66bd117ba52b60581f853bc3996d573b8fdbd9a Mon Sep 17 00:00:00 2001 From: Steven Silvester Date: Mon, 4 Mar 2024 09:58:58 -0600 Subject: [PATCH 2/5] Add docs about packaging kernels (#1013) --- docs/kernels.rst | 17 +++++++++++++++++ docs/wrapperkernels.rst | 3 ++- 2 files changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/kernels.rst b/docs/kernels.rst index 60b1edd0..ca042c99 100644 --- a/docs/kernels.rst +++ b/docs/kernels.rst @@ -184,3 +184,20 @@ To start the terminal console or the Qt console with a specific kernel:: The notebook offers you the available kernels in a dropdown menu from the 'New' button. + + +.. _packaging-kernels: + +Packaging +========= + +To release your kernel as a Python package, we recommend following the pattern +used in the :ref:`echo_kernel`, which uses the `hatch`_ build backend and +a build file that creates the kernel directory with the ``kernel.json`` and +kernel icons, which is included as ``shared-data``, ending up in the +``share/jupyter/kernels/`` folder in the user's installed environment. +See `pyproject.toml`_ and `hatch_build.py`_ for more details. + +.. _hatch: https://hatch.pypa.io/latest/ +.. _pyproject.toml: https://github.com/jupyter/echo_kernel/blob/main/pyproject.toml +.. _hatch_build.py: https://github.com/jupyter/echo_kernel/blob/main/hatch_build.py diff --git a/docs/wrapperkernels.rst b/docs/wrapperkernels.rst index 1dd9fd41..46931099 100644 --- a/docs/wrapperkernels.rst +++ b/docs/wrapperkernels.rst @@ -19,6 +19,7 @@ also has a ``ProcessKernel`` subclass that makes it easy to write kernels that use ``pexpect``. See `Octave Kernel `_ as an example. +If releasing a wrapper kernel as a Python package, see the steps in :ref:`packaging-kernels`. Required steps -------------- @@ -86,7 +87,7 @@ Example .. seealso:: - `echo_kernel `__ + `echo_kernel `_ A packaged, installable version of the condensed example below. ``echokernel.py`` will simply echo any input it's given to stdout:: From 99556a11295a99d814e0aef5411a8556ebf89cb9 Mon Sep 17 00:00:00 2001 From: Steven Silvester Date: Tue, 12 Mar 2024 06:55:09 -0500 Subject: [PATCH 3/5] Fix docs reference (#1017) --- docs/kernels.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/kernels.rst b/docs/kernels.rst index ca042c99..5f884622 100644 --- a/docs/kernels.rst +++ b/docs/kernels.rst @@ -192,7 +192,7 @@ Packaging ========= To release your kernel as a Python package, we recommend following the pattern -used in the :ref:`echo_kernel`, which uses the `hatch`_ build backend and +used in the `echo_kernel`_, which uses the `hatch`_ build backend and a build file that creates the kernel directory with the ``kernel.json`` and kernel icons, which is included as ``shared-data``, ending up in the ``share/jupyter/kernels/`` folder in the user's installed environment. @@ -201,3 +201,4 @@ See `pyproject.toml`_ and `hatch_build.py`_ for more details. .. _hatch: https://hatch.pypa.io/latest/ .. _pyproject.toml: https://github.com/jupyter/echo_kernel/blob/main/pyproject.toml .. _hatch_build.py: https://github.com/jupyter/echo_kernel/blob/main/hatch_build.py +.. _echo_kernel: https://github.com/jupyter/echo_kernel From 8a3327ae58247be734d51f44c629354f0f600660 Mon Sep 17 00:00:00 2001 From: Steven Silvester Date: Tue, 12 Mar 2024 06:55:26 -0500 Subject: [PATCH 4/5] Update Release Scripts (#1016) --- .github/workflows/prep-release.yml | 9 ++++++- .github/workflows/publish-changelog.yml | 34 +++++++++++++++++++++++++ .github/workflows/publish-release.yml | 22 ++++++++-------- 3 files changed, 54 insertions(+), 11 deletions(-) create mode 100644 .github/workflows/publish-changelog.yml diff --git a/.github/workflows/prep-release.yml b/.github/workflows/prep-release.yml index 7a2a18de..396330bb 100644 --- a/.github/workflows/prep-release.yml +++ b/.github/workflows/prep-release.yml @@ -12,6 +12,10 @@ on: post_version_spec: description: "Post Version Specifier" required: false + silent: + description: "Set a placeholder in the changelog and don't publish the release." + required: false + type: boolean since: description: "Use PRs with activity since this date or git reference" required: false @@ -22,6 +26,8 @@ on: jobs: prep_release: runs-on: ubuntu-latest + permissions: + contents: write steps: - uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1 @@ -29,8 +35,9 @@ jobs: id: prep-release uses: jupyter-server/jupyter_releaser/.github/actions/prep-release@v2 with: - token: ${{ secrets.ADMIN_GITHUB_TOKEN }} + token: ${{ secrets.GITHUB_TOKEN }} version_spec: ${{ github.event.inputs.version_spec }} + silent: ${{ github.event.inputs.silent }} post_version_spec: ${{ github.event.inputs.post_version_spec }} target: ${{ github.event.inputs.target }} branch: ${{ github.event.inputs.branch }} diff --git a/.github/workflows/publish-changelog.yml b/.github/workflows/publish-changelog.yml new file mode 100644 index 00000000..60af4c5f --- /dev/null +++ b/.github/workflows/publish-changelog.yml @@ -0,0 +1,34 @@ +name: "Publish Changelog" +on: + release: + types: [published] + + workflow_dispatch: + inputs: + branch: + description: "The branch to target" + required: false + +jobs: + publish_changelog: + runs-on: ubuntu-latest + environment: release + steps: + - uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1 + + - uses: actions/create-github-app-token@v1 + id: app-token + with: + app-id: ${{ vars.APP_ID }} + private-key: ${{ secrets.APP_PRIVATE_KEY }} + + - name: Publish changelog + id: publish-changelog + uses: jupyter-server/jupyter_releaser/.github/actions/publish-changelog@v2 + with: + token: ${{ steps.app-token.outputs.token }} + branch: ${{ github.event.inputs.branch }} + + - name: "** Next Step **" + run: | + echo "Merge the changelog update PR: ${{ steps.publish-changelog.outputs.pr_url }}" diff --git a/.github/workflows/publish-release.yml b/.github/workflows/publish-release.yml index dbaaeaad..5295e776 100644 --- a/.github/workflows/publish-release.yml +++ b/.github/workflows/publish-release.yml @@ -15,30 +15,32 @@ on: jobs: publish_release: runs-on: ubuntu-latest + environment: release + permissions: + id-token: write steps: - uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1 + - uses: actions/create-github-app-token@v1 + id: app-token + with: + app-id: ${{ vars.APP_ID }} + private-key: ${{ secrets.APP_PRIVATE_KEY }} + - name: Populate Release id: populate-release uses: jupyter-server/jupyter_releaser/.github/actions/populate-release@v2 with: - token: ${{ secrets.ADMIN_GITHUB_TOKEN }} - target: ${{ github.event.inputs.target }} + token: ${{ steps.app-token.outputs.token }} branch: ${{ github.event.inputs.branch }} release_url: ${{ github.event.inputs.release_url }} steps_to_skip: ${{ github.event.inputs.steps_to_skip }} - name: Finalize Release id: finalize-release - env: - PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }} - PYPI_TOKEN_MAP: ${{ secrets.PYPI_TOKEN_MAP }} - TWINE_USERNAME: __token__ - NPM_TOKEN: ${{ secrets.NPM_TOKEN }} - uses: jupyter-server/jupyter-releaser/.github/actions/finalize-release@v2 + uses: jupyter-server/jupyter_releaser/.github/actions/finalize-release@v2 with: - token: ${{ secrets.ADMIN_GITHUB_TOKEN }} - target: ${{ github.event.inputs.target }} + token: ${{ steps.app-token.outputs.token }} release_url: ${{ steps.populate-release.outputs.release_url }} - name: "** Next Step **" From 0a19278ed8d4090080a44760498a38ad9d4e0d99 Mon Sep 17 00:00:00 2001 From: blink1073 Date: Tue, 12 Mar 2024 11:58:46 +0000 Subject: [PATCH 5/5] Publish 8.6.1 SHA256 hashes: jupyter_client-8.6.1-py3-none-any.whl: 3b7bd22f058434e3b9a7ea4b1500ed47de2713872288c0d511d19926f99b459f jupyter_client-8.6.1.tar.gz: e842515e2bab8e19186d89fdfea7abd15e39dd581f94e399f00e2af5a1652d3f --- CHANGELOG.md | 30 ++++++++++++++++++++++++++++-- jupyter_client/_version.py | 2 +- 2 files changed, 29 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 58920aad..b4aa02d7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,34 @@ +## 8.6.1 + +([Full Changelog](https://github.com/jupyter/jupyter_client/compare/v8.6.0...8a3327ae58247be734d51f44c629354f0f600660)) + +### Maintenance and upkeep improvements + +- Update Release Scripts [#1016](https://github.com/jupyter/jupyter_client/pull/1016) ([@blink1073](https://github.com/blink1073)) +- chore: update pre-commit hooks [#1008](https://github.com/jupyter/jupyter_client/pull/1008) ([@pre-commit-ci](https://github.com/pre-commit-ci)) +- chore: update pre-commit hooks [#1002](https://github.com/jupyter/jupyter_client/pull/1002) ([@pre-commit-ci](https://github.com/pre-commit-ci)) +- Bump actions/setup-python from 4 to 5 [#1000](https://github.com/jupyter/jupyter_client/pull/1000) ([@dependabot](https://github.com/dependabot)) +- chore: update pre-commit hooks [#999](https://github.com/jupyter/jupyter_client/pull/999) ([@pre-commit-ci](https://github.com/pre-commit-ci)) +- Bump conda-incubator/setup-miniconda from 2 to 3 [#998](https://github.com/jupyter/jupyter_client/pull/998) ([@dependabot](https://github.com/dependabot)) +- chore: update pre-commit hooks [#996](https://github.com/jupyter/jupyter_client/pull/996) ([@pre-commit-ci](https://github.com/pre-commit-ci)) + +### Documentation improvements + +- Fix docs reference [#1017](https://github.com/jupyter/jupyter_client/pull/1017) ([@blink1073](https://github.com/blink1073)) +- Add docs about packaging kernels [#1013](https://github.com/jupyter/jupyter_client/pull/1013) ([@blink1073](https://github.com/blink1073)) +- Clarify what a restart means [#966](https://github.com/jupyter/jupyter_client/pull/966) ([@mlucool](https://github.com/mlucool)) + +### Contributors to this release + +([GitHub contributors page for this release](https://github.com/jupyter/jupyter_client/graphs/contributors?from=2023-11-06&to=2024-03-12&type=c)) + +[@blink1073](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3Ablink1073+updated%3A2023-11-06..2024-03-12&type=Issues) | [@dependabot](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3Adependabot+updated%3A2023-11-06..2024-03-12&type=Issues) | [@mlucool](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3Amlucool+updated%3A2023-11-06..2024-03-12&type=Issues) | [@pre-commit-ci](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3Apre-commit-ci+updated%3A2023-11-06..2024-03-12&type=Issues) | [@Zsailer](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3AZsailer+updated%3A2023-11-06..2024-03-12&type=Issues) + + + ## 8.6.0 ([Full Changelog](https://github.com/jupyter/jupyter_client/compare/v8.5.0...2d6f52bdf5266688c51f3270cd7e47bbd17c708c)) @@ -23,8 +51,6 @@ [@blink1073](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3Ablink1073+updated%3A2023-10-25..2023-11-06&type=Issues) | [@Carreau](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3ACarreau+updated%3A2023-10-25..2023-11-06&type=Issues) | [@davidbrochart](https://github.com/search?q=repo%3Ajupyter%2Fjupyter_client+involves%3Adavidbrochart+updated%3A2023-10-25..2023-11-06&type=Issues) - - ## 8.5.0 ([Full Changelog](https://github.com/jupyter/jupyter_client/compare/v8.4.0...ff94e310c2af3546f2f9384e6b35fd11c3d09a71)) diff --git a/jupyter_client/_version.py b/jupyter_client/_version.py index a329a5c8..ed87d435 100644 --- a/jupyter_client/_version.py +++ b/jupyter_client/_version.py @@ -2,7 +2,7 @@ import re from typing import List, Union -__version__ = "8.6.0" +__version__ = "8.6.1" # Build up version_info tuple for backwards compatibility pattern = r"(?P\d+).(?P\d+).(?P\d+)(?P.*)"