jupyterlab_trash_mgmt_extension
A dedicated left panel for managing your JupyterLab trash. See what's taking up space, restore files you need, or empty the bin entirely.
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
HOMEcomes 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. The bands fold by the harmonica navigation: at a list end the wheel previews the next band's rows and folds to it, a short open band leaves the next band directly under its last row, and a panel too short for the bands scrolls them so none is clipped - 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 - The XDG trash under the home folder reads
HOME, the notebook root readsWORKSPACE, and other sources under the home folder keep the tilde, as~/workspace; a band's and every row's tooltip name the exact trash folder, as/home/lab/.local/share/Trash, and tooltip dates follow the browser's locale - Trash on other file systems - The trash folder of the notebook root and of every folder in
c.TrashManagement.locationsis 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 serverroot_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.38
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| jupyterlab_trash_mgmt_extension-1.1.38.tar.gz | 639.1 kB | Without provenance | Details for jupyterlab_trash_mgmt_extension-1.1.38.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| jupyterlab_trash_mgmt_extension-1.1.38-py3-none-any.whl | Python 3 | none | any | Details for jupyterlab_trash_mgmt_extension-1.1.38-py3-none-any.whl |
Total release size: 730.8 kB
Release files / jupyterlab_trash_mgmt_extension-1.1.38.tar.gz
| Download URL | jupyterlab_trash_mgmt_extension-1.1.38.tar.gz |
|---|---|
| Size | 639.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
06af5a245a3789fce27526b2d07a3bdc73e230ad33557bed37c84f8aee0bb10c
|
|
BLAKE2b-256 checksum How to use checksums |
c621c6f9fc66cbc5035d00edeb0114dd34fedccdd05c06fd8b2e2b4956d7595e
|
| 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.38-py3-none-any.whl
| Download URL | jupyterlab_trash_mgmt_extension-1.1.38-py3-none-any.whl |
|---|---|
| Size | 91.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aa67238e7919a1ea5f6da2374a3f695084758963c99eb0784ac2b6875bf70095
|
|
BLAKE2b-256 checksum How to use checksums |
d4d9f7262235ed97381aab95907072f57140a2e45971a4a97d5e4114a409941a
|
| 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.38
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.