Move opening path in new browser tabs to a separate plugin (#7056)

* Add `INotebookPathOpener`

* Reorg tokens

* Use `INotebookPathOpener`

* Lint

* Rename param

* Lint

* add docstring

* Fix dependency on application package

* more tsconfig fixes

* fix typo

* dedupe

* update dev commands on Binder

* fix typo

* lint

* Add missing dependency

* tmp

* set explicit jupyterlab on Binder

* drop link share for now

* remove tmp

* edit pyproject config

* debug

* test

* test

* test

* fix typos

Author: jtpio

binder/environment.yml

@@ -3,8 +3,8 @@ channels:
   - conda-forge
 dependencies:
   - ipywidgets=8
+  - jupyterlab=4
   - jupyterlab-language-pack-fr-FR
-  - jupyterlab-link-share>=0.2
   - matplotlib
   - numpy
   - nodejs=20

binder/postBuild

@@ -1,7 +1,5 @@
 #!/bin/bash
 set -euo pipefail
 
-python -m pip install -e . --force-reinstall
-
-jlpm && jlpm run build
-jlpm run develop
+python -m pip install -e ".[dev,test]"
+jlpm develop

packages/application-extension/src/index.ts

@@ -47,6 +47,8 @@ import {
   SidePanel,
   SidePanelHandler,
   SidePanelPalette,
+  INotebookPathOpener,
+  defaultNotebookPathOpener,
 } from '@jupyter-notebook/application';
 
 import { jupyterIcon } from '@jupyter-notebook/ui-components';
@@ -309,7 +311,7 @@ const pages: JupyterFrontEndPlugin<void> = {
     app.commands.addCommand(CommandIDs.openLab, {
       label: trans.__('Open JupyterLab'),
       execute: () => {
-        window.open(`${baseUrl}lab`);
+        window.open(URLExt.join(baseUrl, 'lab'));
       },
     });
     const page = PageConfig.getOption('notebookPage');
@@ -320,7 +322,7 @@ const pages: JupyterFrontEndPlugin<void> = {
         if (page === 'tree') {
           app.commands.execute('filebrowser:activate');
         } else {
-          window.open(`${baseUrl}tree`);
+          window.open(URLExt.join(baseUrl, 'tree'));
         }
       },
     });
@@ -332,6 +334,18 @@ const pages: JupyterFrontEndPlugin<void> = {
   },
 };
 
+/**
+ * A plugin to open paths in new browser tabs.
+ */
+const pathOpener: JupyterFrontEndPlugin<INotebookPathOpener> = {
+  id: '@jupyter-notebook/application-extension:path-opener',
+  autoStart: true,
+  provides: INotebookPathOpener,
+  activate: (app: JupyterFrontEnd): INotebookPathOpener => {
+    return defaultNotebookPathOpener;
+  },
+};
+
 /**
  * The default paths for a Jupyter Notebook app.
  */
@@ -361,16 +375,19 @@ const rendermime: JupyterFrontEndPlugin<IRenderMimeRegistry> = {
     ISanitizer,
     IMarkdownParser,
     ITranslator,
+    INotebookPathOpener,
   ],
   activate: (
     app: JupyterFrontEnd,
     docManager: IDocumentManager | null,
     latexTypesetter: ILatexTypesetter | null,
     sanitizer: IRenderMime.ISanitizer | null,
     markdownParser: IMarkdownParser | null,
-    translator: ITranslator | null
+    translator: ITranslator | null,
+    notebookPathOpener: INotebookPathOpener | null
   ) => {
     const trans = (translator ?? nullTranslator).load('jupyterlab');
+    const opener = notebookPathOpener ?? defaultNotebookPathOpener;
     if (docManager) {
       app.commands.addCommand(CommandIDs.handleLink, {
         label: trans.__('Handle Local Link'),
@@ -382,10 +399,12 @@ const rendermime: JupyterFrontEndPlugin<IRenderMimeRegistry> = {
           return docManager.services.contents
             .get(path, { content: false })
             .then((model) => {
-              // Open in a new browser tab
-              const url = PageConfig.getBaseUrl();
-              const treeUrl = URLExt.join(url, 'tree', model.path);
-              window.open(treeUrl, '_blank');
+              const baseUrl = PageConfig.getBaseUrl();
+              opener.open({
+                prefix: URLExt.join(baseUrl, 'tree'),
+                path: model.path,
+                target: '_blank',
+              });
             });
         },
       });
@@ -1089,6 +1108,7 @@ const plugins: JupyterFrontEndPlugin<any>[] = [
   menuSpacer,
   opener,
   pages,
+  pathOpener,
   paths,
   rendermime,
   shell,

packages/application-extension/tsconfig.json

@@ -8,6 +8,9 @@
   "references": [
     {
       "path": "../application"
+    },
+    {
+      "path": "../ui-components"
     }
   ]
 }

packages/application/src/index.ts

@@ -4,3 +4,5 @@
 export * from './app';
 export * from './shell';
 export * from './panelhandler';
+export * from './pathopener';
+export * from './tokens';

packages/application/src/pathopener.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Jupyter Development Team.
+// Distributed under the terms of the Modified BSD License.
+
+import { URLExt } from '@jupyterlab/coreutils';
+
+import { INotebookPathOpener } from './tokens';
+
+/**
+ * A class to open paths in new browser tabs in the Notebook application.
+ */
+class DefaultNotebookPathOpener implements INotebookPathOpener {
+  /**
+   * Open a path in a new browser tab.
+   */
+  open(options: INotebookPathOpener.IOpenOptions): WindowProxy | null {
+    const { prefix, path, searchParams, target, features } = options;
+    const url = new URL(
+      URLExt.join(prefix, path ?? ''),
+      window.location.origin
+    );
+    if (searchParams) {
+      url.search = searchParams.toString();
+    }
+    return window.open(url, target, features);
+  }
+}
+
+export const defaultNotebookPathOpener = new DefaultNotebookPathOpener();

packages/application/src/tokens.ts

@@ -0,0 +1,57 @@
+import { Token } from '@lumino/coreutils';
+
+/**
+ * The INotebookPathOpener interface.
+ */
+export interface INotebookPathOpener {
+  /**
+   * Open a path in the application.
+   *
+   * @param options - The options used to open the path.
+   */
+  open: (options: INotebookPathOpener.IOpenOptions) => WindowProxy | null;
+}
+
+export namespace INotebookPathOpener {
+  /**
+   * The options used to open a path in the application.
+   */
+  export interface IOpenOptions {
+    /**
+     * The URL prefix, which should include the base URL
+     */
+    prefix: string;
+
+    /**
+     * The path to open in the application, e.g `setup.py`, or `notebooks/example.ipynb`
+     */
+    path?: string;
+
+    /**
+     * The extra search params to use in the URL.
+     */
+    searchParams?: URLSearchParams;
+
+    /**
+     * Name of the browsing context the resource is being loaded into.
+     * See https://developer.mozilla.org/en-US/docs/Web/API/Window/open for more details.
+     */
+    target?: string;
+
+    /**
+     *
+     * See https://developer.mozilla.org/en-US/docs/Web/API/Window/open for more details.
+     */
+    features?: string;
+  }
+}
+
+/**
+ * The INotebookPathOpener token.
+ * The main purpose of this token is to allow other extensions or downstream applications
+ * to override the default behavior of opening a notebook in a new tab.
+ * It also allows passing the path as a URL search parameter, or other options to the window.open call.
+ */
+export const INotebookPathOpener = new Token<INotebookPathOpener>(
+  '@jupyter-notebook/application:INotebookPathOpener'
+);

packages/console-extension/package.json

@@ -38,6 +38,7 @@
     "watch": "tsc -b --watch"
   },
   "dependencies": {
+    "@jupyter-notebook/application": "^7.0.3",
     "@jupyterlab/application": "^4.0.6",
     "@jupyterlab/console": "^4.0.6",
     "@jupyterlab/coreutils": "^6.0.6",

packages/console-extension/src/index.ts

@@ -9,7 +9,12 @@ import {
 
 import { IConsoleTracker } from '@jupyterlab/console';
 
-import { PageConfig } from '@jupyterlab/coreutils';
+import { PageConfig, URLExt } from '@jupyterlab/coreutils';
+
+import {
+  INotebookPathOpener,
+  defaultNotebookPathOpener,
+} from '@jupyter-notebook/application';
 
 import { find } from '@lumino/algorithm';
 
@@ -52,9 +57,16 @@ const opener: JupyterFrontEndPlugin<void> = {
 const redirect: JupyterFrontEndPlugin<void> = {
   id: '@jupyter-notebook/console-extension:redirect',
   requires: [IConsoleTracker],
+  optional: [INotebookPathOpener],
   autoStart: true,
-  activate: (app: JupyterFrontEnd, tracker: IConsoleTracker) => {
+  activate: (
+    app: JupyterFrontEnd,
+    tracker: IConsoleTracker,
+    notebookPathOpener: INotebookPathOpener | null
+  ) => {
     const baseUrl = PageConfig.getBaseUrl();
+    const opener = notebookPathOpener ?? defaultNotebookPathOpener;
+
     tracker.widgetAdded.connect(async (send, console) => {
       const { sessionContext } = console;
       await sessionContext.ready;
@@ -66,7 +78,11 @@ const redirect: JupyterFrontEndPlugin<void> = {
         // bail if the console is already added to the main area
         return;
       }
-      window.open(`${baseUrl}consoles/${sessionContext.path}`, '_blank');
+      opener.open({
+        prefix: URLExt.join(baseUrl, 'consoles'),
+        path: sessionContext.path,
+        target: '_blank',
+      });
 
       // the widget is not needed anymore
       console.dispose();

packages/console-extension/tsconfig.json

@@ -4,5 +4,10 @@
     "outDir": "lib",
     "rootDir": "src"
   },
-  "include": ["src/**/*"]
+  "include": ["src/**/*"],
+  "references": [
+    {
+      "path": "../application"
+    }
+  ]
 }