Awaitables

.copier-answers.yml

@@ -11,4 +11,3 @@ project_short_description: Control JupyterLab from Python notebooks
 python_name: ipylab
 repository: https://github.com/jtpio/ipylab
 test: false
-

.github/workflows/binder-on-pr.yml

@@ -27,4 +27,4 @@ jobs:
           })
       env:
         PR_HEAD_REF: ${{ github.event.pull_request.head.ref }}
-        PR_HEAD_USERREPO: ${{ github.event.pull_request.head.repo.full_name }}
+        PR_HEAD_USERREPO: ${{ github.event.pull_request.head.repo.full_name }}

.github/workflows/build.yml

@@ -2,9 +2,11 @@ name: Build
 
 on:
   push:
-    branches: main
+    branches:
+      - main
   pull_request:
-    branches: '*'
+    branches:
+      - '*'
 
 jobs:
   build:
@@ -17,26 +19,20 @@ jobs:
     - name: Base Setup
       uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1
 
-    - name: Install dependencies
-      run: python -m pip install -U "jupyterlab>=4.2.0,<5"
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        enable-cache: true
+        version: "0.8.22"
+        python-version: 3.13
 
     - name: Build the extension
       run: |
-        set -eux
-        jlpm
-        python -m pip install .[test]
-
-        jupyter labextension list
-        jupyter labextension list 2>&1 | grep -ie "ipylab.*OK"
-        python -m jupyterlab.browser_check
-
-    - name: Package the extension
-      run: |
-        set -eux
-
-        pip install build
-        python -m build
-        pip uninstall -y "ipylab" jupyterlab
+        uv build
+        uv run jupyter labextension list
+        uv run jupyter labextension list 2>&1 | grep -ie "ipylab.*OK"
+        uv run python -m jupyterlab.browser_check
+        uv run pytest
 
     - name: Upload extension packages
       uses: actions/upload-artifact@v4
@@ -53,7 +49,7 @@ jobs:
     - name: Install Python
       uses: actions/setup-python@v5
       with:
-        python-version: '3.9'
+        python-version: '3.13'
         architecture: 'x64'
     - uses: actions/download-artifact@v4
       with:

.github/workflows/packaging.yml

@@ -2,9 +2,11 @@ name: Packaging
 
 on:
   push:
-    branches: [ main ]
+    branches:
+      - main
   pull_request:
-    branches: '*'
+    branches:
+      - '*'
 
 env:
   PIP_DISABLE_PIP_VERSION_CHECK: 1
@@ -48,11 +50,11 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu, macos, windows]
-        python: ['3.8', '3.12']
+        python: ['3.11', '3.13']
         include:
-          - python: '3.8'
+          - python: '3.11'
             dist: 'ipylab*.tar.gz'
-          - python: '3.12'
+          - python: '3.13'
             dist: 'ipylab*.whl'
           - os: windows
             py_cmd: python

.github/workflows/pre-commit.yml

@@ -0,0 +1,14 @@
+name: Pre-Commit Check
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches:
+      - '*'
+jobs:
+  pre_commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1
+      - uses: jupyterlab/maintainer-tools/.github/actions/pre-commit@v1

.gitignore

@@ -77,6 +77,9 @@ coverage.xml
 # Sphinx documentation
 docs/_build/
 
+jupyterlite/
+docs/files/
+
 # PyBuilder
 target/
 

.pre-commit-config.yaml

@@ -0,0 +1,58 @@
+ci:
+  autoupdate_schedule: monthly
+  skip:
+    - prettier
+default_language_version:
+  node: system
+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: check-yaml
+      - id: debug-statements
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: forbid-new-submodules
+      - id: end-of-file-fixer
+        exclude: galata/.*-snapshots
+      - id: requirements-txt-fixer
+      - id: check-builtin-literals
+  - 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.0
+    hooks:
+      - id: check-github-workflows
+  - repo: https://github.com/ComPWA/taplo-pre-commit
+    rev: v0.9.3
+    hooks:
+      - id: taplo-format
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.13.1
+    hooks:
+      - id: ruff
+        types_or: [python, jupyter]
+        args: ['--fix']
+      - id: ruff-format
+        types_or: [python, jupyter]
+  - repo: https://github.com/codespell-project/codespell
+    rev: 'v2.4.1'
+    hooks:
+      - id: codespell
+        additional_dependencies:
+          - tomli
+
+  - repo: https://github.com/kynan/nbstripout
+    rev: '0.8.1'
+    hooks:
+      - id: nbstripout

.prettierignore

@@ -1,3 +1,4 @@
+**/.venv
 node_modules
 **/node_modules
 **/lib

.vscode/launch.json

@@ -0,0 +1,87 @@
+{
+  // To debug jupyterlab running in a venv or conda env:
+  //   - set up Python env in your workspace as per https://code.visualstudio.com/docs/python/environments
+  //   - add an "envFile" prop to each backend config pointing to .vscode/debug.env
+  //   - configure the .vscode/debug.env file as needed
+  // https://github.com/jupyterlab/vscode-config-template/tree/main
+  // https://github.com/jupyterlab/vscode-config-template/issues/1
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Python Debugger: Current File all-code",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    },
+    {
+      "name": "Python Debugger: Current File: just my code",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "justMyCode": false
+    },
+    {
+      "name": "Ipylab",
+      "type": "debugpy",
+      "request": "launch",
+      "args": [
+        "--notebook-dir=examples",
+        "--no-browser",
+        "--IdentityProvider.token=''",
+        "--port=9990"
+      ],
+      "cwd": "${workspaceFolder}",
+      "justMyCode": false,
+      "module": "ipylab",
+      "presentation": {
+        "hidden": false
+      }
+    },
+    {
+      "name": "IPylab frontend with Firefox",
+      "type": "firefox",
+      "request": "launch",
+      "reAttach": true,
+      "url": "http://localhost:9990",
+      "webRoot": "${workspaceFolder}",
+      "pathMappings": [
+        {
+          "url": "webpack://ipylab/src",
+          "path": "${workspaceFolder}/src"
+        }
+      ],
+      "presentation": {
+        "hidden": false
+      }
+    },
+    {
+      "name": "IPylab frontend with Chrome",
+      "type": "chrome",
+      "request": "launch",
+      "timeout": 180000,
+      "url": "http://localhost:9990",
+      // set webroot to the parent dir of your project's top level package.json
+      "webRoot": "${workspaceFolder}",
+      "pathMapping": {
+        "url": "webpack://ipylab/src",
+        "path": "${workspaceFolder}/src"
+      },
+      "presentation": {
+        "hidden": true
+      }
+    }
+  ],
+  "compounds": [
+    {
+      "name": "Debug IPylab with Firefox",
+      "configurations": ["Ipylab", "IPylab frontend with Firefox"]
+    },
+    {
+      "name": "Debug Ipylab with Chrome",
+      "configurations": ["Ipylab", "IPylab frontend with Chrome"]
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,20 @@
+{
+  "spellright.language": ["en"],
+  "spellright.documentTypes": ["markdown", "latex"],
+  "[toml]": {
+    "editor.defaultFormatter": "tamasfe.even-better-toml"
+  },
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "editor.formatOnSave": true,
+  "python.terminal.activateEnvInCurrentTerminal": true,
+  "python.createEnvironment.trigger": "prompt",
+  "python.testing.pytestArgs": ["tests"],
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true,
+  "python.analysis.diagnosticMode": "workspace"
+}