jupyterlab_open_in_terminal_extension 1.0.3 → 1.0.10

package/README.md

@@ -8,14 +8,18 @@
 [![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)
 
-Open any folder from the file browser directly in a terminal. Right-click on a folder and select "Open in Terminal" to launch a new terminal session with that directory as the working directory.
+> [!TIP]
+> This extension is part of the [stellars_jupyterlab_extensions](https://github.com/stellarshenson/stellars_jupyterlab_extensions) metapackage. Install all Stellars extensions at once: `pip install stellars_jupyterlab_extensions`
+
+Open any folder or file from the file browser directly in a terminal. Right-click on a folder and select "Open Location in Terminal" to launch a new terminal session with that directory as the working directory. Right-click on a file to open a terminal in its parent folder.
 
 ![Open in Terminal](.resources/screenshot.png)
 
 ## Features
 
-- **Context menu on folders** - Right-click any folder in the file browser to reveal "Open in Terminal" option with terminal icon
-- **Opens terminal at selected path** - New terminal session starts with cwd set to the selected folder
+- **Context menu on folders** - Right-click any folder to open a terminal at that location
+- **Context menu on files** - Right-click any file to open a terminal in its parent folder
+- **Opens terminal at selected path** - New terminal session starts with cwd set to the target folder
 - **Seamless integration** - Works with JupyterLab's native terminal
 
 ## Requirements

package/lib/index.js

@@ -1,6 +1,7 @@
 import { IDefaultFileBrowser } from '@jupyterlab/filebrowser';
 import { showErrorMessage } from '@jupyterlab/apputils';
 import { terminalIcon } from '@jupyterlab/ui-components';
+import { PathExt } from '@jupyterlab/coreutils';
 /**
  * The command ID for opening a terminal at a directory.
  */
@@ -18,35 +19,35 @@ const plugin = {
         const { commands, serviceManager } = app;
         // Add the command
         commands.addCommand(COMMAND_ID, {
-            label: 'Open in Terminal',
-            caption: 'Open a terminal at this directory',
+            label: 'Open Location in Terminal',
+            caption: 'Open a terminal at this location',
             icon: terminalIcon,
             isVisible: () => {
-                // Only show for directories
-                const item = fileBrowser.selectedItems().next();
-                if (item.done || !item.value) {
-                    return false;
-                }
-                return item.value.type === 'directory';
+                // Always visible - works for files, directories, and empty area
+                return true;
             },
             execute: async () => {
                 const item = fileBrowser.selectedItems().next();
+                // Get the target path
+                let targetPath;
                 if (item.done || !item.value) {
-                    await showErrorMessage('No Selection', 'No folder selected in file browser.');
-                    return;
+                    // No selection - use current directory from file browser
+                    targetPath = fileBrowser.model.path;
                 }
-                const selectedItem = item.value;
-                // Only allow directories
-                if (selectedItem.type !== 'directory') {
-                    await showErrorMessage('Not a Directory', 'Please select a directory to open in terminal.');
-                    return;
+                else {
+                    const selectedItem = item.value;
+                    if (selectedItem.type === 'directory') {
+                        targetPath = selectedItem.path;
+                    }
+                    else {
+                        // For files, get the parent directory
+                        targetPath = PathExt.dirname(selectedItem.path);
+                    }
                 }
-                // Get the path - this is relative to the server root
-                const relativePath = selectedItem.path;
                 try {
-                    // Create a new terminal session with cwd set to the selected directory
+                    // Create a new terminal session with cwd set to the target directory
                     const session = await serviceManager.terminals.startNew({
-                        cwd: relativePath
+                        cwd: targetPath
                     });
                     // Create the terminal widget
                     const terminal = await commands.execute('terminal:create-new', {
@@ -58,18 +59,18 @@ const plugin = {
                             name: session.name
                         });
                     }
-                    console.log(`Opened terminal "${session.name}" at path: ${relativePath}`);
+                    console.log(`Opened terminal "${session.name}" at path: ${targetPath}`);
                 }
                 catch (error) {
                     console.error('Failed to open terminal:', error);
-                    await showErrorMessage('Terminal Error', `Failed to open terminal at: ${relativePath}\nError: ${error}`);
+                    await showErrorMessage('Terminal Error', `Failed to open terminal at: ${targetPath}\nError: ${error}`);
                 }
             }
         });
-        // Add context menu item for directories in file browser
+        // Add context menu item for file browser (works for files, folders, and empty area)
         app.contextMenu.addItem({
             command: COMMAND_ID,
-            selector: '.jp-DirListing-item[data-isdir="true"]',
+            selector: '.jp-DirListing-content',
             rank: 3
         });
         console.log(`Command registered: ${COMMAND_ID}`);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_open_in_terminal_extension",
-    "version": "1.0.3",
+    "version": "1.0.10",
     "description": "Jupyterlab extension that adds item to the context menu in the file browser to open folder in terminal",
     "keywords": [
         "jupyter",
@@ -58,6 +58,7 @@
     "dependencies": {
         "@jupyterlab/application": "^4.0.0",
         "@jupyterlab/apputils": "^4.0.0",
+        "@jupyterlab/coreutils": "^6.0.0",
         "@jupyterlab/filebrowser": "^4.0.0",
         "@jupyterlab/services": "^7.0.0",
         "@jupyterlab/ui-components": "^4.0.0"

package/src/__tests__/jupyterlab_open_in_terminal_extension.spec.ts

@@ -17,14 +17,13 @@ describe('jupyterlab_open_in_terminal_extension', () => {
     expect(pluginId).toContain(':plugin');
   });
 
-  it('should target directory items only', () => {
-    const selector = '.jp-DirListing-item[data-isdir="true"]';
-    expect(selector).toContain('data-isdir="true"');
-    expect(selector).toContain('.jp-DirListing-item');
+  it('should target file browser content area', () => {
+    const selector = '.jp-DirListing-content';
+    expect(selector).toBe('.jp-DirListing-content');
   });
 
   it('should have correct menu label', () => {
-    const label = 'Open in Terminal';
-    expect(label).toBe('Open in Terminal');
+    const label = 'Open Location in Terminal';
+    expect(label).toBe('Open Location in Terminal');
   });
 });

package/src/index.ts

@@ -5,6 +5,7 @@ import {
 import { IDefaultFileBrowser } from '@jupyterlab/filebrowser';
 import { showErrorMessage } from '@jupyterlab/apputils';
 import { terminalIcon } from '@jupyterlab/ui-components';
+import { PathExt } from '@jupyterlab/coreutils';
 
 /**
  * The command ID for opening a terminal at a directory.
@@ -29,45 +30,35 @@ const plugin: JupyterFrontEndPlugin<void> = {
 
     // Add the command
     commands.addCommand(COMMAND_ID, {
-      label: 'Open in Terminal',
-      caption: 'Open a terminal at this directory',
+      label: 'Open Location in Terminal',
+      caption: 'Open a terminal at this location',
       icon: terminalIcon,
       isVisible: () => {
-        // Only show for directories
-        const item = fileBrowser.selectedItems().next();
-        if (item.done || !item.value) {
-          return false;
-        }
-        return item.value.type === 'directory';
+        // Always visible - works for files, directories, and empty area
+        return true;
       },
       execute: async () => {
         const item = fileBrowser.selectedItems().next();
-        if (item.done || !item.value) {
-          await showErrorMessage(
-            'No Selection',
-            'No folder selected in file browser.'
-          );
-          return;
-        }
 
-        const selectedItem = item.value;
-
-        // Only allow directories
-        if (selectedItem.type !== 'directory') {
-          await showErrorMessage(
-            'Not a Directory',
-            'Please select a directory to open in terminal.'
-          );
-          return;
+        // Get the target path
+        let targetPath: string;
+        if (item.done || !item.value) {
+          // No selection - use current directory from file browser
+          targetPath = fileBrowser.model.path;
+        } else {
+          const selectedItem = item.value;
+          if (selectedItem.type === 'directory') {
+            targetPath = selectedItem.path;
+          } else {
+            // For files, get the parent directory
+            targetPath = PathExt.dirname(selectedItem.path);
+          }
         }
 
-        // Get the path - this is relative to the server root
-        const relativePath = selectedItem.path;
-
         try {
-          // Create a new terminal session with cwd set to the selected directory
+          // Create a new terminal session with cwd set to the target directory
           const session = await serviceManager.terminals.startNew({
-            cwd: relativePath
+            cwd: targetPath
           });
 
           // Create the terminal widget
@@ -83,22 +74,22 @@ const plugin: JupyterFrontEndPlugin<void> = {
           }
 
           console.log(
-            `Opened terminal "${session.name}" at path: ${relativePath}`
+            `Opened terminal "${session.name}" at path: ${targetPath}`
           );
         } catch (error) {
           console.error('Failed to open terminal:', error);
           await showErrorMessage(
             'Terminal Error',
-            `Failed to open terminal at: ${relativePath}\nError: ${error}`
+            `Failed to open terminal at: ${targetPath}\nError: ${error}`
           );
         }
       }
     });
 
-    // Add context menu item for directories in file browser
+    // Add context menu item for file browser (works for files, folders, and empty area)
     app.contextMenu.addItem({
       command: COMMAND_ID,
-      selector: '.jp-DirListing-item[data-isdir="true"]',
+      selector: '.jp-DirListing-content',
       rank: 3
     });