jupyterlab-refresh-view-extension 0.6.3__tar.gz

jupyterlab_refresh_view_extension-0.6.3/.claude/JOURNAL.md

@@ -0,0 +1,11 @@
+# JupyterLab Refresh View Extension - Journal
+
+This journal tracks substantive work on the JupyterLab Refresh View Extension.
+
+---
+
+1. **Task - JupyterLab Refresh View Extension**: Implemented context menu refresh functionality for JupyterLab markdown and notebook files<br>
+    **Result**: Created jupyterlab_refresh_view_extension from scratch using JupyterLab extension template (Copier v4.4.0). Implemented "Refresh View" command executing context.revert() to reload file content from disk with intelligent scroll position preservation (captures scroll state from .jp-RenderedMarkdown, .jp-Notebook, .jp-OutputArea-output elements, restores positions after 150ms rendering delay). Registered command with IDocumentManager (required), ICommandPalette and IFileBrowserFactory (optional dependencies). Added context menu integration using .jp-Document selector to cover all document types without duplication. Resolved TypeScript compilation errors (removed unused MarkdownDocument and NotebookPanel imports). Fixed duplicate menu item issue by consolidating 4 overlapping selectors (.jp-MarkdownViewer, .jp-RenderedMarkdown, .jp-NotebookPanel, .jp-FileEditor) into single parent selector (.jp-Document). Added dependencies to package.json: @jupyterlab/apputils, @jupyterlab/docmanager, @jupyterlab/docregistry, @jupyterlab/filebrowser, @jupyterlab/markdownviewer, @jupyterlab/notebook (all ^4.0.0). Used Makefile build system throughout: make install target handles version increment (0.1.0 -> 0.1.4), dependency installation (npm/yarn), TypeScript compilation, Python package build (hatch), and pip installation. Extension successfully installed and verified via jupyter labextension list showing jupyterlab_refresh_view_extension v0.1.4 enabled OK. Context menu "Refresh View" item appears once when right-clicking markdown/notebook content, enables only when document context exists, preserves scroll position during refresh, and integrates with command palette under "File Operations" category. Build infrastructure: TypeScript (strict mode), Jest unit tests, Playwright integration tests, ESLint/Prettier/Stylelint, GitHub Actions CI/CD workflows (build, test, release). Extension provides in-place file refresh without scrolling to top - critical for iterative document editing workflows.
+
+2. **Task - Package Metadata and Documentation**: Updated package metadata and comprehensive documentation for publishing<br>
+    **Result**: Updated version from 0.1.4 to 0.6.2 in package.json. Added GitHub repository URLs: homepage (https://github.com/the-cog-conf/jupyterlab_refresh_view_extension), bugs tracker (/issues), and repository git URL. Improved package description from generic text to feature-focused: "JupyterLab extension adding context menu 'Refresh View' command to reload file content from disk while preserving scroll position". Enhanced README.md with professional structure: added GitHub Actions, npm, and PyPI badges with working links; created Features section highlighting context menu integration, scroll preservation, command palette access, and smart enable/disable; added Use Cases section covering iterative editing, live documentation, collaborative work, and build system integration; expanded Installation section with both PyPI and npm methods; added detailed Usage section with step-by-step instructions and command palette alternative. Created local project journal at .claude/JOURNAL.md documenting complete implementation history. Committed changes with conventional commit message and pushed to GitHub (commit 14fe948). Package now ready for publishing to npm and PyPI with complete metadata and user-facing documentation.

jupyterlab_refresh_view_extension-0.6.3/.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(make install:*)",
+      "Bash(tee:*)",
+      "Bash(jupyter labextension list:*)",
+      "Read(//tmp/**)",
+      "Read(//home/lab/workspace/.claude/**)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(make publish:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

jupyterlab_refresh_view_extension-0.6.3/.copier-answers.yml

@@ -0,0 +1,15 @@
+# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
+_commit: v4.4.0
+_src_path: https://github.com/jupyterlab/extension-template
+author_email: konrad.jelen@gmail.com
+author_name: Stellars Henson
+has_binder: false
+has_settings: false
+kind: frontend
+labextension_name: jupyterlab_refresh_view_extension
+project_short_description: A JupyterLab to allow context menu option to refresh markdown
+    or notebook
+python_name: jupyterlab_refresh_view_extension
+repository: ''
+test: true
+

jupyterlab_refresh_view_extension-0.6.3/.gitignore

@@ -0,0 +1,125 @@
+*.bundle.*
+lib/
+node_modules/
+*.log
+.eslintcache
+.stylelintcache
+*.egg-info/
+.ipynb_checkpoints
+*.tsbuildinfo
+jupyterlab_refresh_view_extension/labextension
+# Version file is handled by hatchling
+jupyterlab_refresh_view_extension/_version.py
+
+# Integration tests
+ui-tests/test-results/
+ui-tests/playwright-report/
+
+# Created by https://www.gitignore.io/api/python
+# Edit at https://www.gitignore.io/?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage/
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# End of https://www.gitignore.io/api/python
+
+# OSX files
+.DS_Store
+
+# Yarn cache
+.yarn/

jupyterlab_refresh_view_extension-0.6.3/.prettierignore

@@ -0,0 +1,6 @@
+node_modules
+**/node_modules
+**/lib
+**/package.json
+!/package.json
+jupyterlab_refresh_view_extension

jupyterlab_refresh_view_extension-0.6.3/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

jupyterlab_refresh_view_extension-0.6.3/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+<!-- <START NEW CHANGELOG ENTRY> -->
+
+<!-- <END NEW CHANGELOG ENTRY> -->

jupyterlab_refresh_view_extension-0.6.3/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Stellars Henson
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

jupyterlab_refresh_view_extension-0.6.3/Makefile

@@ -0,0 +1,92 @@
+.PHONY: build install clean uninstall publish dependencies mrproper increment_version install_dependencies help
+.DEFAULT_GOAL := help
+
+# Read current version from package.json (only if node is available)
+VERSION := $(shell command -v node >/dev/null 2>&1 && node -p "require('./package.json').version" || echo "0.0.0")
+
+## increment project version
+increment_version:
+	@echo "Current version: $(VERSION)"
+	@bash -c 'CURRENT_VERSION=$(VERSION); \
+	IFS="." read -r major minor patch <<< "$$CURRENT_VERSION"; \
+	NEW_PATCH=$$((patch + 1)); \
+	NEW_VERSION="$$major.$$minor.$$NEW_PATCH"; \
+	echo "New version: $$NEW_VERSION"; \
+	sed -i "s/\"version\": \"$$CURRENT_VERSION\"/\"version\": \"$$NEW_VERSION\"/" package.json; '
+
+## build packages
+build: clean increment_version
+	npm install
+	yarn install
+	python -m build 
+
+## install package
+install: build
+	pip install dist/*.whl --force-reinstall
+
+## clean builds and installables
+clean: uninstall
+	@command -v npm >/dev/null 2>&1 && npm run clean || true
+	@command -v npm >/dev/null 2>&1 && npm run clean:labextension || true
+	rm -rf dist lib || true
+
+## uninstall package
+uninstall:
+	pip uninstall -y dist/*.whl 2>/dev/null || true
+
+## publish package to public repository
+publish: install
+	twine upload dist/*
+
+## install all required build dependencies
+install_dependencies:
+	conda install -y nodejs yarn --update-all
+	pip install twine
+
+## cleanup all build and metabuild artefacts
+mrproper: clean uninstall
+	rm -rf node_modules .yarn || true
+
+## prints the list of available commands
+help:
+	@echo ""
+	@echo "$$(tput bold)Available rules:$$(tput sgr0)"
+	@sed -n -e "/^## / { \
+		h; \
+		s/.*//; \
+		:doc" \
+		-e "H; \
+		n; \
+		s/^## //; \
+		t doc" \
+		-e "s/:.*//; \
+		G; \
+		s/\\n## /---/; \
+		s/\\n/ /g; \
+		p; \
+	}" ${MAKEFILE_LIST} \
+	| LC_ALL='C' sort --ignore-case \
+	| awk -F '---' \
+		-v ncol=$$(tput cols) \
+		-v indent=19 \
+		-v col_on="$$(tput setaf 6)" \
+		-v col_off="$$(tput sgr0)" \
+	'{ \
+		printf "%s%*s%s ", col_on, -indent, $$1, col_off; \
+		n = split($$2, words, " "); \
+		line_length = ncol - indent; \
+		for (i = 1; i <= n; i++) { \
+			line_length -= length(words[i]) + 1; \
+			if (line_length <= 0) { \
+				line_length = ncol - indent - length(words[i]) - 1; \
+				printf "\n%*s ", -indent, " "; \
+			} \
+			printf "%s ", words[i]; \
+		} \
+		printf "\n"; \
+	}' 
+	@echo ""
+
+
+# EOF
+

jupyterlab_refresh_view_extension-0.6.3/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: jupyterlab_refresh_view_extension
+Version: 0.6.3
+Summary: JupyterLab extension adding context menu 'Refresh View' command to reload file content from disk while preserving scroll position
+Project-URL: Homepage, https://github.com/the-cog-conf/jupyterlab_refresh_view_extension
+Project-URL: Bug Tracker, https://github.com/the-cog-conf/jupyterlab_refresh_view_extension/issues
+Project-URL: Repository, https://github.com/the-cog-conf/jupyterlab_refresh_view_extension.git
+Author-email: Stellars Henson <konrad.jelen@gmail.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, Stellars Henson
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+License-File: LICENSE
+Keywords: jupyter,jupyterlab,jupyterlab-extension
+Classifier: Framework :: Jupyter
+Classifier: Framework :: Jupyter :: JupyterLab
+Classifier: Framework :: Jupyter :: JupyterLab :: 4
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# JupyterLab Refresh View Extension
+
+[![Github Actions Status](https://github.com/the-cog-conf/jupyterlab_refresh_view_extension/workflows/Build/badge.svg)](https://github.com/the-cog-conf/jupyterlab_refresh_view_extension/actions/workflows/build.yml)
+[![npm version](https://badge.fury.io/js/jupyterlab_refresh_view_extension.svg)](https://www.npmjs.com/package/jupyterlab_refresh_view_extension)
+[![PyPI version](https://badge.fury.io/py/jupyterlab-refresh-view-extension.svg)](https://pypi.org/project/jupyterlab-refresh-view-extension/)
+
+JupyterLab extension that adds a **"Refresh View"** context menu command to reload file content from disk while preserving scroll position.
+
+## Features
+
+- **Context Menu Integration** - Right-click on markdown files, notebooks, or text editors to access the refresh command
+- **Scroll Position Preservation** - Automatically maintains your current scroll position after refreshing content
+- **Command Palette Access** - Available via command palette under "File Operations" category
+- **Smart Enable/Disable** - Only enabled when a document with context is active
+
+## Use Cases
+
+- **Iterative Editing** - Refresh files edited externally without losing your place
+- **Live Documentation** - Keep markdown files in sync with external updates
+- **Collaborative Work** - View changes from teammates without manual reload
+- **Build System Integration** - Refresh generated files after build processes
+
+## Requirements
+
+- JupyterLab >= 4.0.0
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install jupyterlab-refresh-view-extension
+```
+
+### From npm
+
+```bash
+jupyter labextension install jupyterlab_refresh_view_extension
+```
+
+## Usage
+
+1. Open a markdown file, notebook, or text file in JupyterLab
+2. Right-click anywhere in the document content
+3. Select **"Refresh View"** from the context menu
+4. The file reloads from disk while maintaining your scroll position
+
+Alternatively, open the command palette (`Ctrl+Shift+C` or `Cmd+Shift+C`) and search for "Refresh View".
+
+## Uninstall
+
+```bash
+pip uninstall jupyterlab-refresh-view-extension
+```
+
+## Contributing
+
+### Development install
+
+Note: You will need NodeJS to build the extension package.
+
+The `jlpm` command is JupyterLab's pinned version of
+[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use
+`yarn` or `npm` in lieu of `jlpm` below.
+
+```bash
+# Clone the repo to your local environment
+# Change directory to the jupyterlab_refresh_view_extension directory
+# Install package in development mode
+pip install -e "."
+# Link your development version of the extension with JupyterLab
+jupyter labextension develop . --overwrite
+# Rebuild extension Typescript source after making changes
+jlpm build
+```
+
+You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.
+
+```bash
+# Watch the source directory in one terminal, automatically rebuilding when needed
+jlpm watch
+# Run JupyterLab in another terminal
+jupyter lab
+```
+
+With the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).
+
+By default, the `jlpm build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:
+
+```bash
+jupyter lab build --minimize=False
+```
+
+### Development uninstall
+
+```bash
+pip uninstall jupyterlab_refresh_view_extension
+```
+
+In development mode, you will also need to remove the symlink created by `jupyter labextension develop`
+command. To find its location, you can run `jupyter labextension list` to figure out where the `labextensions`
+folder is located. Then you can remove the symlink named `jupyterlab_refresh_view_extension` within that folder.
+
+### Testing the extension
+
+#### Frontend tests
+
+This extension is using [Jest](https://jestjs.io/) for JavaScript code testing.
+
+To execute them, execute:
+
+```sh
+jlpm
+jlpm test
+```
+
+#### Integration tests
+
+This extension uses [Playwright](https://playwright.dev/docs/intro) for the integration tests (aka user level tests).
+More precisely, the JupyterLab helper [Galata](https://github.com/jupyterlab/jupyterlab/tree/master/galata) is used to handle testing the extension in JupyterLab.
+
+More information are provided within the [ui-tests](./ui-tests/README.md) README.
+
+### Packaging the extension
+
+See [RELEASE](RELEASE.md)

jupyterlab_refresh_view_extension-0.6.3/README.md

@@ -0,0 +1,126 @@
+# JupyterLab Refresh View Extension
+
+[![Github Actions Status](https://github.com/the-cog-conf/jupyterlab_refresh_view_extension/workflows/Build/badge.svg)](https://github.com/the-cog-conf/jupyterlab_refresh_view_extension/actions/workflows/build.yml)
+[![npm version](https://badge.fury.io/js/jupyterlab_refresh_view_extension.svg)](https://www.npmjs.com/package/jupyterlab_refresh_view_extension)
+[![PyPI version](https://badge.fury.io/py/jupyterlab-refresh-view-extension.svg)](https://pypi.org/project/jupyterlab-refresh-view-extension/)
+
+JupyterLab extension that adds a **"Refresh View"** context menu command to reload file content from disk while preserving scroll position.
+
+## Features
+
+- **Context Menu Integration** - Right-click on markdown files, notebooks, or text editors to access the refresh command
+- **Scroll Position Preservation** - Automatically maintains your current scroll position after refreshing content
+- **Command Palette Access** - Available via command palette under "File Operations" category
+- **Smart Enable/Disable** - Only enabled when a document with context is active
+
+## Use Cases
+
+- **Iterative Editing** - Refresh files edited externally without losing your place
+- **Live Documentation** - Keep markdown files in sync with external updates
+- **Collaborative Work** - View changes from teammates without manual reload
+- **Build System Integration** - Refresh generated files after build processes
+
+## Requirements
+
+- JupyterLab >= 4.0.0
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install jupyterlab-refresh-view-extension
+```
+
+### From npm
+
+```bash
+jupyter labextension install jupyterlab_refresh_view_extension
+```
+
+## Usage
+
+1. Open a markdown file, notebook, or text file in JupyterLab
+2. Right-click anywhere in the document content
+3. Select **"Refresh View"** from the context menu
+4. The file reloads from disk while maintaining your scroll position
+
+Alternatively, open the command palette (`Ctrl+Shift+C` or `Cmd+Shift+C`) and search for "Refresh View".
+
+## Uninstall
+
+```bash
+pip uninstall jupyterlab-refresh-view-extension
+```
+
+## Contributing
+
+### Development install
+
+Note: You will need NodeJS to build the extension package.
+
+The `jlpm` command is JupyterLab's pinned version of
+[yarn](https://yarnpkg.com/) that is installed with JupyterLab. You may use
+`yarn` or `npm` in lieu of `jlpm` below.
+
+```bash
+# Clone the repo to your local environment
+# Change directory to the jupyterlab_refresh_view_extension directory
+# Install package in development mode
+pip install -e "."
+# Link your development version of the extension with JupyterLab
+jupyter labextension develop . --overwrite
+# Rebuild extension Typescript source after making changes
+jlpm build
+```
+
+You can watch the source directory and run JupyterLab at the same time in different terminals to watch for changes in the extension's source and automatically rebuild the extension.
+
+```bash
+# Watch the source directory in one terminal, automatically rebuilding when needed
+jlpm watch
+# Run JupyterLab in another terminal
+jupyter lab
+```
+
+With the watch command running, every saved change will immediately be built locally and available in your running JupyterLab. Refresh JupyterLab to load the change in your browser (you may need to wait several seconds for the extension to be rebuilt).
+
+By default, the `jlpm build` command generates the source maps for this extension to make it easier to debug using the browser dev tools. To also generate source maps for the JupyterLab core extensions, you can run the following command:
+
+```bash
+jupyter lab build --minimize=False
+```
+
+### Development uninstall
+
+```bash
+pip uninstall jupyterlab_refresh_view_extension
+```
+
+In development mode, you will also need to remove the symlink created by `jupyter labextension develop`
+command. To find its location, you can run `jupyter labextension list` to figure out where the `labextensions`
+folder is located. Then you can remove the symlink named `jupyterlab_refresh_view_extension` within that folder.
+
+### Testing the extension
+
+#### Frontend tests
+
+This extension is using [Jest](https://jestjs.io/) for JavaScript code testing.
+
+To execute them, execute:
+
+```sh
+jlpm
+jlpm test
+```
+
+#### Integration tests
+
+This extension uses [Playwright](https://playwright.dev/docs/intro) for the integration tests (aka user level tests).
+More precisely, the JupyterLab helper [Galata](https://github.com/jupyterlab/jupyterlab/tree/master/galata) is used to handle testing the extension in JupyterLab.
+
+More information are provided within the [ui-tests](./ui-tests/README.md) README.
+
+### Packaging the extension
+
+See [RELEASE](RELEASE.md)