Skip to main content

jupyterlab_basic_terminal_extension

GitHub Actions npm version PyPI version Total PyPI downloads JupyterLab 4 Brought To You By KOLOMOLO Donate PayPal

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.6 or higher, and bash on the server - the terminal initialisation step uses bash-specific syntax, so a sh-only image will not work.

pip install jupyterlab_basic_terminal_extension

Usage

The extension deliberately adds no menu item, palette entry or launcher tile. Its entire surface is one command, invoked programmatically by other extensions, notebook code, or a jupyter_app_launcher tile:

await app.commands.execute('basic-terminal:launch', {
  argv: ['/opt/utils/my-utility.sh'],
  cwd: 'projects/demo'
});
  • argv (required) - non-empty array of strings. argv[0] is executed directly; there is no shell, so no globbing, pipes or redirection
  • cwd (optional) - absolute path used as-is, or a server-relative path resolved against ServerApp.root_dir ('' is the root). Omit it and the current file browser folder is used, unless the browser is on a registered non-default drive - such a drive is not assumed to map onto the server filesystem, so the server's own working directory is used instead. A path that does not resolve to a directory is rejected with HTTP 400
  • shutdownOnClose (optional, default false) - when true, closing the tab this command opened while the program still runs shuts the terminal session down, which ends the program; a tab the lab restores after a page reload does not carry the argument. When false or omitted, the lab's terminal setting Shut down on close decides, as in 1.0.8; its default false leaves the program running on the server after the tab is closed

The command resolves to the terminal widget, and rejects if the process exits before the widget can be displayed.

Uninstall

To remove the extension, execute:

pip uninstall jupyterlab_basic_terminal_extension

Metadata

Release files for jupyterlab-basic-terminal-extension 1.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jupyterlab-basic-terminal-extension 1.0.13
File Size Uploaded Provenance Actions
jupyterlab_basic_terminal_extension-1.0.13.tar.gz 373.1 kB Without provenance Details for jupyterlab_basic_terminal_extension-1.0.13.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jupyterlab-basic-terminal-extension 1.0.13
File Interpreter ABI Platform Actions
jupyterlab_basic_terminal_extension-1.0.13-py3-none-any.whl Python 3 none any Details for jupyterlab_basic_terminal_extension-1.0.13-py3-none-any.whl

Total release size: 408.6 kB

Release files / jupyterlab_basic_terminal_extension-1.0.13.tar.gz

Download URL jupyterlab_basic_terminal_extension-1.0.13.tar.gz
Size 373.1 kB
Tags Source
SHA-256 checksum
How to use checksums
01bab8dc03d6e08ed314f7d84a0ad07dd9a324c9a14edf7b73326ce934cab34b
BLAKE2b-256 checksum
How to use checksums
554eaf8cf1f3271ae47f8f466d19a43d59ff609cdb402c008c2db840d5deaebd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Release files / jupyterlab_basic_terminal_extension-1.0.13-py3-none-any.whl

Download URL jupyterlab_basic_terminal_extension-1.0.13-py3-none-any.whl
Size 35.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
308c90458bfe63534e4286e700d095fc67e5cbcb55f60e8925f366b47f413158
BLAKE2b-256 checksum
How to use checksums
eea90fd2708dfd9b8cec7e49d1bddb6a75bfa8f9f6687ae0e20bf9c9765287c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Security for jupyterlab-basic-terminal-extension 1.0.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page