Skip to main content

jupyterlab_trash_mgmt_extension

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

A dedicated left panel for managing your JupyterLab trash. See what's taking up space, restore files you need, or empty the bin entirely.

Trash Management Panel

Features

  • Trash panel in sidebar - Accessible alongside file browser, kernels, git, and extensions panels
  • Storage usage display - See how much space deleted files occupy
  • Every trash in one list - The main list shows the items of the XDG trash, /home/cache, every user's home trash and every location trash together; each row restores and deletes in its own trash
  • Show Volumes - Right-click anywhere in the panel, or use the command palette, to show each trash as a collapsible band: the summary bar on top counts and sizes every trash together, then the home trash ~ comes first, its band folding the main list, followed by one band per other trash; each band shows its own item count and size and a trash button that empties only that trash; an empty band reads Trash is empty and its trash button is disabled; while the bands show, the entry reads Hide Volumes and hides them again; off by default and remembered in the browser
  • Filter the trash - A filter button in the panel header opens a search box: typing narrows the main list and every band to the files and folders whose name or original path contains the text, ignoring case; the clear button restores every row
  • Short labels - A trash under the home folder is labelled with ~, as ~/workspace
  • Trash on other file systems - The trash folder of the notebook root and of every folder in c.TrashManagement.locations is one of the trashes (see Configuration)
  • Mount-safe delete - Deleting or emptying a trashed folder stops at a file system mounted inside it; that entry stays in the trash with an error naming the mount
  • Range of the clean - two commands in the command palette: Empty All Bins empties every source; Clean Workspace removes only entries whose original path lies under the workspace
  • Individual item management - Remove or restore specific files from trash
  • Folder navigation - Open a trashed folder and restore or remove single items inside it
  • Keyboard control - Tab to the list, move with the arrow keys, select with Space, open a folder with Enter and reach Restore and Delete with Shift+F10
  • Motion that carries meaning - the loading ring keeps turning under every system preference, while the refresh button stays static
  • Large trash - Emptying tens of thousands of items no longer blocks the rest of the lab
  • Empty bin - The header trash button empties every trash at once and the outcome is reported in a notification with the totals; a trash that cannot be read or that vanishes is reported as an error
  • Server-side integration - Python backend for reliable trash operations

Installation

Requires JupyterLab 4.6 or higher.

pip install jupyterlab_trash_mgmt_extension

Uninstall

pip uninstall jupyterlab_trash_mgmt_extension

Configuration

send2trash can put a deleted item into a trash folder at the top of another file system: <folder>/.Trash-<uid>, or <folder>/.Trash/<uid> when .Trash is a sticky directory that is not a symbolic link. The XDG trash (the main list) and the trash folder of the notebook root are always monitored. The server option c.TrashManagement.locations adds folders; the main list includes the items of each one's trash folder, and with Show Volumes on the panel shows it as a section after the notebook root, in option order, labelled with that folder.

  • Default []: the XDG trash and the notebook root only
  • ~ is expanded; a relative path resolves against the server root_dir
  • A folder with no trash folder gets no section
  • A folder that repeats the notebook root or the XDG trash gets no second section
  • No mount table is read and no mount below a folder is visited
  • A change needs a server restart

Add folders in jupyter_server_config.py:

c.TrashManagement.locations = ['~/.cache', '/mnt/nas-shared']

Built because I kept running out of disk space and blaming everything except my own hoarding of failed notebooks.

Metadata

Release files for jupyterlab-trash-mgmt-extension 1.1.33

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-trash-mgmt-extension 1.1.33
File Size Uploaded Provenance Actions
jupyterlab_trash_mgmt_extension-1.1.33.tar.gz 618.6 kB Without provenance Details for jupyterlab_trash_mgmt_extension-1.1.33.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jupyterlab-trash-mgmt-extension 1.1.33
File Interpreter ABI Platform Actions
jupyterlab_trash_mgmt_extension-1.1.33-py3-none-any.whl Python 3 none any Details for jupyterlab_trash_mgmt_extension-1.1.33-py3-none-any.whl

Total release size: 704.5 kB

Release files / jupyterlab_trash_mgmt_extension-1.1.33.tar.gz

Download URL jupyterlab_trash_mgmt_extension-1.1.33.tar.gz
Size 618.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a1bd1a3e46c0b6899c6b8fddd584629bc825c16b9e47e8703dc70b631e84a926
BLAKE2b-256 checksum
How to use checksums
6eaf834b8da8b1cb6cce93f916a3cb4a272b578778305f2dc701c974e9703e27
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Release files / jupyterlab_trash_mgmt_extension-1.1.33-py3-none-any.whl

Download URL jupyterlab_trash_mgmt_extension-1.1.33-py3-none-any.whl
Size 85.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f28ac2761474b5aba566ee048e37d37fbf8b5e06777e1edf5ffab51cf89bad74
BLAKE2b-256 checksum
How to use checksums
151afd1126e0f743131eec11374f39bcad9a654afc302ebeb6ef2e49ace09ed9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Security for jupyterlab-trash-mgmt-extension 1.1.33

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