jupyterlab-basic-terminal-extension 1.0.4__tar.gz

jupyterlab_basic_terminal_extension-1.0.4/.claude/CLAUDE.md

@@ -0,0 +1,83 @@
+<!-- @import /home/lab/workspace/.claude/CLAUDE.md -->
+
+# Project-Specific Configuration
+
+This file imports workspace-level configuration from `/home/lab/workspace/.claude/CLAUDE.md`.
+All workspace rules apply. Project-specific rules below strengthen or extend them.
+
+The workspace `/home/lab/workspace/.claude/` directory contains additional instruction files
+(MERMAID.md, NOTEBOOK.md, DATASCIENCE.md, GIT.md, and others) referenced by CLAUDE.md.
+Consult workspace CLAUDE.md and the .claude directory to discover all applicable standards.
+
+## Mandatory Bans (Reinforced)
+
+The following workspace rules are STRICTLY ENFORCED for this project:
+
+- **No automatic git tags** - only create tags when user explicitly requests
+- **No automatic version changes** - only modify version in package.json/pyproject.toml/etc. when user explicitly requests
+- **No automatic publishing** - never run `make publish`, `npm publish`, `twine upload`, or similar without explicit user request
+- **No manual package installs if Makefile exists** - use `make install` or equivalent Makefile targets, not direct `pip install`/`uv install`/`npm install`/`jlpm install`
+- **No automatic git commits or pushes** - only when user explicitly requests
+
+## Project Context
+
+`jupyterlab_basic_terminal_extension` is a JupyterLab 4 extension that exposes a command for launching a utility terminal that runs without a shell. The terminal is intended for short-lived console utilities - when the utility process exits, the terminal window/tab closes automatically.
+
+**Technology Stack**:
+
+- JupyterLab 4 (`@jupyterlab/application`, `@jupyterlab/coreutils`, `@jupyterlab/services`)
+- TypeScript 5 frontend (`src/`) compiled to `lib/` and bundled into `jupyterlab_basic_terminal_extension/labextension/`
+- Python 3.10+ server extension (`jupyterlab_basic_terminal_extension/`) using `jupyter_server`
+- Hatch + `hatch-jupyter-builder` build backend defined in `pyproject.toml`
+- Jest for frontend unit tests, Pytest for server tests, Playwright + Galata for UI integration tests in `ui-tests/`
+- jupyter-releaser for tagged releases via GitHub Actions
+
+**Project Naming**:
+
+- npm package: `jupyterlab_basic_terminal_extension`
+- PyPI package: `jupyterlab-basic-terminal-extension` (hyphens, normalized by PyPI)
+
+## Required Workspace Skills
+
+The following workspace skills MUST be referenced when their domain is in scope. They live at
+`/home/lab/workspace/.claude/skills/` (with a fallback to `/home/lab/.claude/skills/` for the
+home-global copies). Discover via the SKILL.md frontmatter in each skill directory.
+
+- **jupyterlab-extension** - JupyterLab extension development guidelines, testing strategy, jupyter-releaser CI/CD workflows, common caveats, TypeScript compatibility, syntax highlighting, local development patterns. MUST be consulted for any work on this extension's source, build, tests, or release pipeline.
+- **playwright** - Browser automation for screenshots and UI verification. MUST be used when capturing screenshots for `README.md`, the `.resources/` folder, or when programmatically verifying the extension's behaviour inside a running JupyterLab instance.
+
+## Makefile Synchronization
+
+**MANDATORY**: At the start of every session that touches build, install, publish, or test
+targets, compare the local `Makefile` version header against the canonical Makefile at
+`/home/lab/workspace/private/jupyterlab/@utils/jupyterlab-extensions/Makefile`. The version
+is declared on the first line as `# Makefile for Jupyterlab extensions version X.YY`.
+
+- If the canonical Makefile has a higher version, update the local `Makefile` to match before doing any other build-related work
+- Preserve any project-local additions when porting forward, but treat the canonical file as the source of truth for shared targets
+- After updating, mention the version bump explicitly to the user (do not commit silently)
+
+## Build and Install
+
+**MANDATORY**: Always install via `make install`. Never run `pip install`, `jlpm install`,
+`npm install`, or `python -m build` directly - the Makefile orchestrates the correct ordering
+(clean -> increment_version -> dependency check -> npm/jlpm install -> prettier -> python build
+-> pip install of the wheel). Direct invocations skip steps and produce inconsistent state.
+
+The `build` target also runs `prettier --write` against `package.json` and `package-lock.json`,
+so both files MUST be kept under version control and committed together whenever either changes.
+Do not gitignore `package-lock.json` - reproducible installs depend on it.
+
+## Journal Rules (Project-Specific)
+
+- **APPEND ONLY**: New journal entries MUST be appended at the end of the file, never inserted between existing entries
+- Entries maintain strict chronological order by position - the last entry in the file is always the most recent work
+- Never reorder, move, or insert entries out of sequence
+- The Stellars **journal plugin** is the canonical tool for this file: create via `/journal:create`, append via `/journal:update`, archive via `/journal:archive`. The `journal:journal` skill auto-triggers on any mention of "journal" and runs `journal-tools check` after every write
+- Direct edits to `JOURNAL.md` are a last resort - prefer the plugin so modus secundis format, continuous numbering and append-only order are enforced automatically
+
+## Strengthened Rules
+
+- **GitHub project**: This repository is hosted on GitHub. Follow the `my-repository` skill for badge templates, naming conventions, and link-checker configuration. README badges already include GitHub Actions, npm, PyPI, pepy downloads, JupyterLab 4, KOLOMOLO, and PayPal donate
+- **JupyterLab extension specifics**: Always follow the `jupyterlab-extension` skill for release flow (jupyter-releaser), TypeScript pinning compatible with `@jupyterlab/builder`, syntax-highlighting peer dependencies, and local development install patterns
+- **Playwright for UI verification**: When asked to verify a feature, capture a screenshot, or reproduce a UI bug, use the `playwright` skill rather than guessing from source code

jupyterlab_basic_terminal_extension-1.0.4/.claude/JOURNAL.md

@@ -0,0 +1,14 @@
+# Claude Code Journal
+
+This journal tracks substantive work on documents, diagrams, and documentation content.
+
+---
+
+1. **Task - Project initialization** (v0.1.0): Bootstrapped `jupyterlab_basic_terminal_extension` as a new JupyterLab 4 extension with Claude configuration, README, and initial git import<br>
+   **Result**: Project was scaffolded from the JupyterLab copier template (TypeScript frontend in `src/`, Python server extension in `jupyterlab_basic_terminal_extension/`, hatch/`hatch-jupyter-builder` build backend, Jest + Pytest + Playwright/Galata stack, jupyter-releaser CI). Replaced the inlined `.claude/CLAUDE.md` with a thin import of the workspace file plus sections for Mandatory Bans, Required Workspace Skills (`jupyterlab-extension`, `playwright`), mandatory Makefile sync against `@utils/jupyterlab-extensions/Makefile` v1.31, mandatory `make install`, and keeping both `package.json` and `package-lock.json` versioned. Rewrote `README.md` after the `jupyterlab_terminal_show_in_file_browser_extension` pattern - kept up to `## Uninstall`, added the full workspace badge set (GitHub Actions, npm, PyPI, pepy, JupyterLab 4, KOLOMOLO, PayPal) and a Features section. Ran `git init -b main` and made the initial import commit.
+
+2. **Task - Hybrid shell-less terminal launch** (v0.6.4): Implemented the core capability - generic `basic-terminal:launch` JL command spawning a JupyterLab terminal whose pty's only process is a caller-supplied `argv`, with auto-focus on launch and auto-close on exit<br>
+   **Result**: Replaced the scaffold `HelloRouteHandler` in `jupyterlab_basic_terminal_extension/routes.py` with `LaunchTerminalHandler` (`POST /launch-terminal`), modelled on `jupyterlab_claude_code_extension/routes.py:198-253`. Backend validates `argv` as a non-empty list of non-empty strings and optional `cwd` as an existing directory, then calls `terminal_manager.create(shell_command=argv, cwd=cwd)` - terminado's per-call `shell_command` kwarg replaces the user's `$SHELL` so the pty has no surrounding bash. Returns `{terminal_name}` handling both dict-like and object-like model returns. Rewrote `src/index.ts` to register the JL command (programmatic-only, no menu/palette helper) accepting `{argv, cwd?}`, POSTing to the backend, attaching the standard JL widget via `terminal:open`, focusing it via `app.shell.activateById`, and disposing the widget on `session.disposed` or `connectionStatusChanged === 'disconnected'` so the tab closes the moment the underlying process exits. Added parametrized `test_routes.py` covering invalid_json/argv/cwd plus happy-path with and without cwd. Bumped `package.json` to `0.6.4` per explicit request. No new npm/python deps; `Makefile` already at canonical v1.31.
+
+3. **Task - Terminal-init wait, CI hardening, first PyPI release** (v1.0.3): Server-side init waiter so TUI tools see a real pty size at launch; fixed metadata that crashed PyPI; tightened CI<br>
+   **Result**: `LaunchTerminalHandler` in `routes.py` wraps argv via `_wrap_with_init` -> `["/bin/bash","-c",_INIT_WAITER,"basic-terminal-init",*argv]`. `_INIT_WAITER` polls `stty size` up to 5s (50 x 0.1s) until rows>=20 and cols>=80, clears, then `exec "$@"` - pty's only process becomes the target so auto-close still fires. Eliminates per-caller init loops like `/opt/utils/launch-lab-utils.sh`. Fixed v0.6.5 PyPI 400: `package.json` `homepage`, `bugs.url`, `repository.url` were copier defaults that `hatch-nodejs-version` propagated into wheel `Project-URL` lines PyPI rejected; set all to the GitHub URLs. `build.yml` `check_links` ignores npm/pepy badge URLs; `check-release.yml` adds `steps_to_skip: build-changelog` and `RH_SINCE_LAST_STABLE: 'true'` so jupyter-releaser tolerates a no-prior-tag repo. Tracking `package-lock.json` + `yarn.lock`. Added as workspace submodule.

jupyterlab_basic_terminal_extension-1.0.4/.copier-answers.yml

@@ -0,0 +1,17 @@
+# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
+_commit: v4.5.2
+_src_path: https://github.com/jupyterlab/extension-template
+author_email: konrad.jelen@gmail.com
+author_name: Stellars Henson
+has_ai_rules: false
+has_binder: false
+has_settings: false
+kind: frontend-and-server
+labextension_name: jupyterlab_basic_terminal_extension
+project_short_description: Jupyterlab extension to make a command that allows launching
+    a utility terminal that runs without shell. This can be used to start and show
+    console utilities, that when finished - close the terminal window / tab
+python_name: jupyterlab_basic_terminal_extension
+repository: ''
+test: true
+

jupyterlab_basic_terminal_extension-1.0.4/.gitignore

@@ -0,0 +1,128 @@
+*.bundle.*
+lib/
+node_modules/
+*.log
+.eslintcache
+.stylelintcache
+*.egg-info/
+.ipynb_checkpoints
+*.tsbuildinfo
+jupyterlab_basic_terminal_extension/labextension
+# Version file is handled by hatchling
+jupyterlab_basic_terminal_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 ###
+# Virtual environments
+.venv
+
+# 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_basic_terminal_extension-1.0.4/.prettierignore

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

jupyterlab_basic_terminal_extension-1.0.4/.yarnrc.yml

@@ -0,0 +1,2 @@
+nodeLinker: node-modules
+enableScripts: false

jupyterlab_basic_terminal_extension-1.0.4/CHANGELOG.md

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

jupyterlab_basic_terminal_extension-1.0.4/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, 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_basic_terminal_extension-1.0.4/Makefile

@@ -0,0 +1,130 @@
+# Makefile for Jupyterlab extensions version 1.31
+# changelog:
+#   1.31 - mrproper now removes ui-tests/node_modules (Playwright browser binaries)
+#   1.30 - check twine in check_dependencies, ensure publish doesn't fail on missing twine
+#   1.29 - replace yarn with jlpm, add prettier format, auto-commit and push after publish
+#   1.28 - initial versioned Makefile
+# author: Stellars Henson <konrad.jelen@gmail.com>
+# License: MIT Open Source License
+
+.PHONY: build install clean uninstall publish dependencies mrproper increment_version install_dependencies check_dependencies upgrade help test
+.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 check_dependencies
+	npm install
+	jlpm install
+	npx prettier --write package-lock.json package.json
+	python -m build
+
+## install package
+install: build
+	pip install dist/*.whl --force-reinstall
+
+## run tests
+test: check_dependencies
+	jlpm test
+
+## clean builds and installables
+clean: uninstall  check_dependencies
+	@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:  check_dependencies
+	pip uninstall -y dist/*.whl 2>/dev/null || true
+
+## check if required dependencies are installed
+check_dependencies:
+	@echo "Checking dependencies..."
+	@MISSING=""; \
+	command -v node >/dev/null 2>&1 || MISSING="$$MISSING node"; \
+	command -v npm >/dev/null 2>&1 || MISSING="$$MISSING npm"; \
+	python -m twine --version >/dev/null 2>&1 || MISSING="$$MISSING twine"; \
+	if [ -n "$$MISSING" ]; then \
+		echo "Missing dependencies:$$MISSING"; \
+		echo "Installing missing dependencies..."; \
+		$(MAKE) install_dependencies; \
+	else \
+		echo "All dependencies are installed."; \
+	fi
+
+## publish package to public repository
+publish: check_dependencies install
+	npm publish --access public
+	python -m twine upload dist/*
+	git add package.json package-lock.json
+	git commit -m "chore: post-publish $$(node -p "require('./package.json').version") package metadata"
+	git push
+
+## install all required build dependencies
+install_dependencies:
+	pip install nodeenv twine
+	nodeenv --node=lts --prebuilt -p
+	npm install -g yarn rimraf
+
+## upgrade all npm and yarn dependencies
+upgrade: check_dependencies
+	jlpm up
+
+## cleanup all build and metabuild artefacts
+mrproper: clean uninstall
+	rm -rf node_modules .yarn ui-tests/node_modules || 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_basic_terminal_extension-1.0.4/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: jupyterlab_basic_terminal_extension
+Version: 1.0.4
+Summary: Jupyterlab extension to make a command that allows launching a utility terminal that runs without shell. This can be used to start and show console utilities, that when finished - close the terminal window / tab
+Project-URL: Homepage, https://github.com/stellarshenson/jupyterlab_basic_terminal_extension
+Project-URL: Bug Tracker, https://github.com/stellarshenson/jupyterlab_basic_terminal_extension/issues
+Project-URL: Repository, https://github.com/stellarshenson/jupyterlab_basic_terminal_extension.git
+Author-email: Stellars Henson <konrad.jelen@gmail.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2026, 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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Requires-Dist: jupyter-server<3,>=2.4.0
+Provides-Extra: dev
+Requires-Dist: jupyterlab>=4; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: coverage; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-asyncio; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest-jupyter[server]>=0.6.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# jupyterlab_basic_terminal_extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_basic_terminal_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_basic_terminal_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_basic_terminal_extension.svg)](https://www.npmjs.com/package/jupyterlab_basic_terminal_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-basic-terminal-extension.svg)](https://pypi.org/project/jupyterlab-basic-terminal-extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-basic-terminal-extension)](https://pepy.tech/project/jupyterlab-basic-terminal-extension)
+[![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
+[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
+[![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)
+
+Launch a utility terminal in JupyterLab that runs without a shell. Perfect for spawning short-lived console utilities that close their tab automatically when the underlying process exits, instead of leaving behind an idle shell prompt.
+
+## Features
+
+- **Shell-less terminal command** - Adds a JupyterLab command that opens a terminal bound directly to a utility process, with no surrounding shell
+- **Auto-close on exit** - Terminal tab closes as soon as the utility process finishes, keeping the workspace tidy
+- **Server extension companion** - Python `jupyter_server` extension exposes the route used by the frontend to spawn the process
+- **JupyterLab 4 native** - Built against `@jupyterlab/application` 4.x and ships as a prebuilt federated extension
+
+## Installation
+
+Requires JupyterLab 4.0.0 or higher.
+
+```bash
+pip install jupyterlab_basic_terminal_extension
+```
+
+## Uninstall
+
+To remove the extension, execute:
+
+```bash
+pip uninstall jupyterlab_basic_terminal_extension
+```

jupyterlab_basic_terminal_extension-1.0.4/README.md

@@ -0,0 +1,34 @@
+# jupyterlab_basic_terminal_extension
+
+[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_basic_terminal_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_basic_terminal_extension/actions/workflows/build.yml)
+[![npm version](https://img.shields.io/npm/v/jupyterlab_basic_terminal_extension.svg)](https://www.npmjs.com/package/jupyterlab_basic_terminal_extension)
+[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-basic-terminal-extension.svg)](https://pypi.org/project/jupyterlab-basic-terminal-extension/)
+[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-basic-terminal-extension)](https://pepy.tech/project/jupyterlab-basic-terminal-extension)
+[![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
+[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
+[![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)
+
+Launch a utility terminal in JupyterLab that runs without a shell. Perfect for spawning short-lived console utilities that close their tab automatically when the underlying process exits, instead of leaving behind an idle shell prompt.
+
+## Features
+
+- **Shell-less terminal command** - Adds a JupyterLab command that opens a terminal bound directly to a utility process, with no surrounding shell
+- **Auto-close on exit** - Terminal tab closes as soon as the utility process finishes, keeping the workspace tidy
+- **Server extension companion** - Python `jupyter_server` extension exposes the route used by the frontend to spawn the process
+- **JupyterLab 4 native** - Built against `@jupyterlab/application` 4.x and ships as a prebuilt federated extension
+
+## Installation
+
+Requires JupyterLab 4.0.0 or higher.
+
+```bash
+pip install jupyterlab_basic_terminal_extension
+```
+
+## Uninstall
+
+To remove the extension, execute:
+
+```bash
+pip uninstall jupyterlab_basic_terminal_extension
+```

jupyterlab_basic_terminal_extension-1.0.4/RELEASE.md

@@ -0,0 +1,80 @@
+# Making a new release of jupyterlab_basic_terminal_extension
+
+The extension can be published to `PyPI` and `npm` manually or using the [Jupyter Releaser](https://github.com/jupyter-server/jupyter_releaser).
+
+## Manual release
+
+### Python package
+
+This extension can be distributed as Python packages. All of the Python
+packaging instructions are in the `pyproject.toml` file to wrap your extension in a
+Python package. Before generating a package, you first need to install some tools:
+
+```bash
+pip install build twine hatch
+```
+
+Bump the version using `hatch`. By default this will create a tag.
+See the docs on [hatch-nodejs-version](https://github.com/agoose77/hatch-nodejs-version#semver) for details.
+
+```bash
+hatch version <new-version>
+```
+
+Make sure to clean up all the development files before building the package:
+
+```bash
+jlpm clean:all
+```
+
+You could also clean up the local git repository:
+
+```bash
+git clean -dfX
+```
+
+To create a Python source package (`.tar.gz`) and the binary package (`.whl`) in the `dist/` directory, do:
+
+```bash
+python -m build
+```
+
+> `python setup.py sdist bdist_wheel` is deprecated and will not work for this package.
+
+Then to upload the package to PyPI, do:
+
+```bash
+twine upload dist/*
+```
+
+### NPM package
+
+To publish the frontend part of the extension as a NPM package, do:
+
+```bash
+npm login
+npm publish --access public
+```
+
+## Automated releases with the Jupyter Releaser
+
+The extension repository should already be compatible with the Jupyter Releaser. But
+the GitHub repository and the package managers need to be properly set up. Please
+follow the instructions of the Jupyter Releaser [checklist](https://jupyter-releaser.readthedocs.io/en/latest/how_to_guides/convert_repo_from_repo.html).
+
+Here is a summary of the steps to cut a new release:
+
+- Go to the Actions panel
+- Run the "Step 1: Prep Release" workflow
+- Check the draft changelog
+- Run the "Step 2: Publish Release" workflow
+
+> [!NOTE]
+> Check out the [workflow documentation](https://jupyter-releaser.readthedocs.io/en/latest/get_started/making_release_from_repo.html)
+> for more information.
+
+## Publishing to `conda-forge`
+
+If the package is not on conda forge yet, check the documentation to learn how to add it: https://conda-forge.org/docs/maintainer/adding_pkgs.html
+
+Otherwise a bot should pick up the new version publish to PyPI, and open a new PR on the feedstock repository automatically.

jupyterlab_basic_terminal_extension-1.0.4/babel.config.js

@@ -0,0 +1 @@
+module.exports = require('@jupyterlab/testutils/lib/babel.config');

jupyterlab_basic_terminal_extension-1.0.4/conftest.py

@@ -0,0 +1,8 @@
+import pytest
+
+pytest_plugins = ("pytest_jupyter.jupyter_server", )
+
+
+@pytest.fixture
+def jp_server_config(jp_server_config):
+    return {"ServerApp": {"jpserver_extensions": {"jupyterlab_basic_terminal_extension": True}}}

jupyterlab_basic_terminal_extension-1.0.4/install.json

@@ -0,0 +1,5 @@
+{
+  "packageManager": "python",
+  "packageName": "jupyterlab_basic_terminal_extension",
+  "uninstallInstructions": "Use your Python package manager (pip, conda, etc.) to uninstall the package jupyterlab_basic_terminal_extension"
+}