jupyterlab 4.4.0a1__tar.gz → 4.4.0a2__tar.gz

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/.gitignore

@@ -154,3 +154,6 @@ Untitled*.ipynb
 untitled*.md
 untitled*.py
 untitled*.txt
+
+# pixi environments
+.pixi

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/CHANGELOG.md

@@ -393,6 +393,50 @@ To ease code migration to JupyterLab 4, developers should review the [migration
 
 <!-- <START NEW CHANGELOG ENTRY> -->
 
+## 4.4.0a2
+
+([Full Changelog](https://github.com/jupyterlab/jupyterlab/compare/v4.4.0a1...1477b7c60f04f7260bf71afaaec27b6565f7bd61))
+
+### New features added
+
+- Support kernel subshells [#16963](https://github.com/jupyterlab/jupyterlab/pull/16963) ([@ianthomas23](https://github.com/ianthomas23))
+
+### Enhancements made
+
+- Add Content Provider API [#17092](https://github.com/jupyterlab/jupyterlab/pull/17092) ([@krassowski](https://github.com/krassowski))
+- Add option to render markdown cells upon exit [#17076](https://github.com/jupyterlab/jupyterlab/pull/17076) ([@peytondmurray](https://github.com/peytondmurray))
+
+### Bugs fixed
+
+- Fix title for overscan count option [#17130](https://github.com/jupyterlab/jupyterlab/pull/17130) ([@krassowski](https://github.com/krassowski))
+- Respect query argument in `settingeditor:open` when settings editor is already open [#17121](https://github.com/jupyterlab/jupyterlab/pull/17121) ([@andrewfulton9](https://github.com/andrewfulton9))
+- Fix sanitizer call in ToC if html data is array of strings [#17114](https://github.com/jupyterlab/jupyterlab/pull/17114) ([@martenrichter](https://github.com/martenrichter))
+- Use bare string `proxies` parameter for `httpx`\<0.28 [#17113](https://github.com/jupyterlab/jupyterlab/pull/17113) ([@AmberArr](https://github.com/AmberArr))
+- Add missing `bind(this)` to `NotebookAdapter`'s `isReady` function [#17109](https://github.com/jupyterlab/jupyterlab/pull/17109) ([@martenrichter](https://github.com/martenrichter))
+
+### Maintenance and upkeep improvements
+
+- Bump tj-actions/changed-files from 45.0.4 to 45.0.5 in the actions group [#17134](https://github.com/jupyterlab/jupyterlab/pull/17134) ([@dependabot](https://github.com/dependabot))
+- Bump the pip group with 3 updates [#17133](https://github.com/jupyterlab/jupyterlab/pull/17133) ([@dependabot](https://github.com/dependabot))
+- Fix exposing `ISignal` instead of `Signal` [#17122](https://github.com/jupyterlab/jupyterlab/pull/17122) ([@jtpio](https://github.com/jtpio))
+- Add pixi files to various ignore files [#17120](https://github.com/jupyterlab/jupyterlab/pull/17120) ([@jtpio](https://github.com/jtpio))
+- Bump systeminformation from 5.21.8 to 5.23.8 [#17116](https://github.com/jupyterlab/jupyterlab/pull/17116) ([@dependabot](https://github.com/dependabot))
+
+### Documentation improvements
+
+- Fix jupyverse installation instructions [#17137](https://github.com/jupyterlab/jupyterlab/pull/17137) ([@SamuelMarks](https://github.com/SamuelMarks))
+- Update docs to include export and import functionality for overrides.json [#17104](https://github.com/jupyterlab/jupyterlab/pull/17104) ([@Darshan808](https://github.com/Darshan808))
+- Add Content Provider API [#17092](https://github.com/jupyterlab/jupyterlab/pull/17092) ([@krassowski](https://github.com/krassowski))
+- Use Zulip for instant messaging [#17031](https://github.com/jupyterlab/jupyterlab/pull/17031) ([@jtpio](https://github.com/jtpio))
+
+### Contributors to this release
+
+([GitHub contributors page for this release](https://github.com/jupyterlab/jupyterlab/graphs/contributors?from=2024-12-18&to=2025-01-06&type=c))
+
+[@AmberArr](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3AAmberArr+updated%3A2024-12-18..2025-01-06&type=Issues) | [@andrewfulton9](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Aandrewfulton9+updated%3A2024-12-18..2025-01-06&type=Issues) | [@andreytaboola](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Aandreytaboola+updated%3A2024-12-18..2025-01-06&type=Issues) | [@bollwyvl](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Abollwyvl+updated%3A2024-12-18..2025-01-06&type=Issues) | [@Darshan808](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3ADarshan808+updated%3A2024-12-18..2025-01-06&type=Issues) | [@davidbrochart](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Adavidbrochart+updated%3A2024-12-18..2025-01-06&type=Issues) | [@dependabot](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Adependabot+updated%3A2024-12-18..2025-01-06&type=Issues) | [@echarles](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Aecharles+updated%3A2024-12-18..2025-01-06&type=Issues) | [@fcollonval](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Afcollonval+updated%3A2024-12-18..2025-01-06&type=Issues) | [@ianthomas23](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Aianthomas23+updated%3A2024-12-18..2025-01-06&type=Issues) | [@jtpio](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Ajtpio+updated%3A2024-12-18..2025-01-06&type=Issues) | [@jupyterlab-probot](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Ajupyterlab-probot+updated%3A2024-12-18..2025-01-06&type=Issues) | [@krassowski](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Akrassowski+updated%3A2024-12-18..2025-01-06&type=Issues) | [@martenrichter](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Amartenrichter+updated%3A2024-12-18..2025-01-06&type=Issues) | [@peytondmurray](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Apeytondmurray+updated%3A2024-12-18..2025-01-06&type=Issues) | [@SamuelMarks](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3ASamuelMarks+updated%3A2024-12-18..2025-01-06&type=Issues)
+
+<!-- <END NEW CHANGELOG ENTRY> -->
+
 ## 4.4.0a1
 
 ([Full Changelog](https://github.com/jupyterlab/jupyterlab/compare/v4.4.0a0...3ff5dd9abeb22030623990322b8352e923b9673a))
@@ -461,8 +505,6 @@ To ease code migration to JupyterLab 4, developers should review the [migration
 
 [@bollwyvl](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Abollwyvl+updated%3A2024-11-17..2024-12-18&type=Issues) | [@brichet](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Abrichet+updated%3A2024-11-17..2024-12-18&type=Issues) | [@claytonparnell](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Aclaytonparnell+updated%3A2024-11-17..2024-12-18&type=Issues) | [@cmarmo](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Acmarmo+updated%3A2024-11-17..2024-12-18&type=Issues) | [@Darshan808](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3ADarshan808+updated%3A2024-11-17..2024-12-18&type=Issues) | [@davidbrochart](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Adavidbrochart+updated%3A2024-11-17..2024-12-18&type=Issues) | [@dependabot](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Adependabot+updated%3A2024-11-17..2024-12-18&type=Issues) | [@fcollonval](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Afcollonval+updated%3A2024-11-17..2024-12-18&type=Issues) | [@itsmevichu](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Aitsmevichu+updated%3A2024-11-17..2024-12-18&type=Issues) | [@JasonWeill](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3AJasonWeill+updated%3A2024-11-17..2024-12-18&type=Issues) | [@joaopalmeiro](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Ajoaopalmeiro+updated%3A2024-11-17..2024-12-18&type=Issues) | [@jtpio](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Ajtpio+updated%3A2024-11-17..2024-12-18&type=Issues) | [@jupyterlab-probot](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Ajupyterlab-probot+updated%3A2024-11-17..2024-12-18&type=Issues) | [@krassowski](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Akrassowski+updated%3A2024-11-17..2024-12-18&type=Issues) | [@lumberbot-app](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Alumberbot-app+updated%3A2024-11-17..2024-12-18&type=Issues) | [@mgeier](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Amgeier+updated%3A2024-11-17..2024-12-18&type=Issues) | [@Nriver](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3ANriver+updated%3A2024-11-17..2024-12-18&type=Issues) | [@pre-commit-ci](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3Apre-commit-ci+updated%3A2024-11-17..2024-12-18&type=Issues) | [@RRosio](https://github.com/search?q=repo%3Ajupyterlab%2Fjupyterlab+involves%3ARRosio+updated%3A2024-11-17..2024-12-18&type=Issues)
 
-<!-- <END NEW CHANGELOG ENTRY> -->
-
 ## 4.4.0a0
 
 ([Full Changelog](https://github.com/jupyterlab/jupyterlab/compare/v4.3.0...ef7925c4d1b175a2e51bbeab376cafd57a1d0fe0))

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/CORPORATE.md

@@ -67,8 +67,8 @@ accelerates the work of everyone.
 **Use public communications channels whenever possible.** JupyterLab is
 developed openly on GitHub. We have weekly video meetings on Wednesday at 9:00
 am PT on Zoom (https://calpoly.zoom.us/my/jupyter). Finally, we have a public
-chat room on gitter (https://gitter.im/jupyterlab/jupyterlab). As much as
-possible, all work and communications should take place on these public
+chat room on Zulip (https://jupyter.zulipchat.com/#narrow/channel/469762-jupyterlab).
+As much as possible, all work and communications should take place on these public
 channels. We welcome you to join these channels and introduce yourself.
 We are willing to have private conversations once in a while, but we
 try to minimize their frequency and always summarize them in our

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: jupyterlab
-Version: 4.4.0a1
+Version: 4.4.0a2
 Summary: JupyterLab computational environment
 Project-URL: Homepage, https://jupyter.org
 Project-URL: Changelog, https://jupyterlab.readthedocs.io/en/stable/getting_started/changelog.html
 Project-URL: Documentation, https://jupyterlab.readthedocs.io
 Project-URL: Source, https://github.com/jupyterlab/jupyterlab
 Project-URL: Issues, https://github.com/jupyterlab/jupyterlab/issues/new/choose
-Project-URL: Gitter, https://gitter.im/jupyterlab/jupyterlab
+Project-URL: Zulip, https://jupyter.zulipchat.com/#narrow/channel/469762-jupyterlab
 Project-URL: Pypi, https://pypi.org/project/jupyterlab
 Author-email: Jupyter Development Team <jupyter@googlegroups.com>
 License: Copyright (c) 2015-2024 Project Jupyter Contributors
@@ -83,7 +83,7 @@ Requires-Dist: coverage; extra == 'dev'
 Requires-Dist: hatch; extra == 'dev'
 Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: ruff==0.8.3; extra == 'dev'
+Requires-Dist: ruff==0.8.4; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: jsx-lexer; extra == 'docs'
 Requires-Dist: myst-parser; extra == 'docs'
@@ -98,8 +98,8 @@ Requires-Dist: altair==5.5.0; extra == 'docs-screenshots'
 Requires-Dist: ipython==8.16.1; extra == 'docs-screenshots'
 Requires-Dist: ipywidgets==8.1.5; extra == 'docs-screenshots'
 Requires-Dist: jupyterlab-geojson==3.4.0; extra == 'docs-screenshots'
-Requires-Dist: jupyterlab-language-pack-zh-cn==4.3.post0; extra == 'docs-screenshots'
-Requires-Dist: matplotlib==3.9.3; extra == 'docs-screenshots'
+Requires-Dist: jupyterlab-language-pack-zh-cn==4.3.post1; extra == 'docs-screenshots'
+Requires-Dist: matplotlib==3.10.0; extra == 'docs-screenshots'
 Requires-Dist: nbconvert>=7.0.0; extra == 'docs-screenshots'
 Requires-Dist: pandas==2.2.3; extra == 'docs-screenshots'
 Requires-Dist: scipy==1.14.1; extra == 'docs-screenshots'
@@ -143,7 +143,7 @@ Description-Content-Type: text/markdown
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/jupyterlab/jupyterlab/badge)](https://scorecard.dev/viewer/?uri=github.com/jupyterlab/jupyterlab)
 [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue.svg)](https://github.com/jupyterlab/jupyterlab/issues)
 [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue.svg)](https://discourse.jupyter.org/c/jupyterlab)
-[![Gitter](https://img.shields.io/badge/social_chat-gitter-blue.svg)](https://gitter.im/jupyterlab/jupyterlab)
+[![Zulip](https://img.shields.io/badge/social_chat-zulip-blue.svg)](https://jupyter.zulipchat.com/#narrow/channel/469762-jupyterlab)
 [![Gitpod](https://img.shields.io/badge/gitpod_editor-open-blue.svg)](https://gitpod.io/#https://github.com/jupyterlab/jupyterlab)
 
 [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyterlab/jupyterlab-demo/HEAD?urlpath=lab/tree/demo)

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/README.md

@@ -17,7 +17,7 @@
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/jupyterlab/jupyterlab/badge)](https://scorecard.dev/viewer/?uri=github.com/jupyterlab/jupyterlab)
 [![GitHub](https://img.shields.io/badge/issue_tracking-github-blue.svg)](https://github.com/jupyterlab/jupyterlab/issues)
 [![Discourse](https://img.shields.io/badge/help_forum-discourse-blue.svg)](https://discourse.jupyter.org/c/jupyterlab)
-[![Gitter](https://img.shields.io/badge/social_chat-gitter-blue.svg)](https://gitter.im/jupyterlab/jupyterlab)
+[![Zulip](https://img.shields.io/badge/social_chat-zulip-blue.svg)](https://jupyter.zulipchat.com/#narrow/channel/469762-jupyterlab)
 [![Gitpod](https://img.shields.io/badge/gitpod_editor-open-blue.svg)](https://gitpod.io/#https://github.com/jupyterlab/jupyterlab)
 
 [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyterlab/jupyterlab-demo/HEAD?urlpath=lab/tree/demo)

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/RELEASE.md

@@ -62,11 +62,11 @@ The full process is documented in https://jupyter-releaser.readthedocs.io/en/lat
 
 Here is a quick summary of the different steps.
 
-#### Communicate on Gitter
+#### Communicate on Zulip
 
 It is good practice to let other maintainers and users know when starting a new release.
 
-For this we usually leave a small message in the `jupyterlab` room on Gitter: https://gitter.im/jupyterlab/jupyterlab.
+For this we usually leave a small message in the "Release Coordination" topic of the `jupyterlab` channel on Zulip: https://jupyter.zulipchat.com/#narrow/channel/469762-jupyterlab/topic/Release.20coordination.
 Once the release is done, we also post a message with a link to the release notes, which include the changelog.
 
 #### 1. Prep Release

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/docs/source/conf.py

@@ -266,9 +266,9 @@ html_theme_options = {
             "icon": "fab fa-discourse",
         },
         {
-            "name": "Gitter",
-            "url": "https://gitter.im/jupyterlab/jupyterlab",
-            "icon": "fab fa-gitter",
+            "name": "Zulip",
+            "url": "https://jupyter.zulipchat.com/channel/469762-jupyterlab",
+            "icon": "fab fa-zulip",
         },
     ],
     "logo": {

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/docs/source/developer/contributing.rst

@@ -10,7 +10,7 @@ contributing!
 
 Please take a look at the Contributor documentation, familiarize
 yourself with using JupyterLab, and introduce yourself to the community
-(on the `chat <https://gitter.im/jupyterlab/jupyterlab>`__ and/or the `forum <https://discourse.jupyter.org/c/jupyterlab/17>`__)
+(on the `chat <https://jupyter.zulipchat.com/#narrow/channel/469762-jupyterlab>`__ and/or the `forum <https://discourse.jupyter.org/c/jupyterlab/17>`__)
 and share what area of the project you are interested in working on. Please also see the Jupyter `Community
 Guides <https://jupyter.readthedocs.io/en/latest/community/content-community.html>`__.
 

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/docs/source/extension/documents.rst

@@ -78,6 +78,16 @@ Document Registry
 
 Create a widget for a given file.
 
+If multiple widget factories are associated with the same file type,
+the user will be able to choose one of them using "Open with" list
+in the context menu of the file browser.
+
+.. versionadded:: 4.4
+   Widget factories now can accept a ``contentProviderId`` parameter allowing
+   the widgets to modify the way the content is provisioned. For example,
+   using a custom provider enables fetching the document content in chunks
+   rather than all at once.
+
 *Example*
 
 -  The notebook widget factory that creates NotebookPanel widgets.

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/docs/source/extension/extension_points.rst

@@ -1135,3 +1135,181 @@ Occasionally, LSP extensions include a CodeMirror extension to modify the code e
       });
     }
   };
+
+
+Content Provisioning
+--------------------
+
+The file system interactions can be customized by adding:
+
+* a content provider, selectively replacing the way in which content is fetched and synchronized
+* a drive, adding a new source of content, analogous to a physical hard drive
+
+While both the content provider and drive are meant to provide custom implementations of
+the Contents API methods such as ``get()`` and ``save()``, and optionally a custom ``sharedModelFactory``,
+the intended use cases, and the way these are exposed in the user interface are different:
+
+* Drive:
+
+  * Use case: provision of additional content, not available on the default drive.
+
+  * UI: paths of files and directories from the drive are prefixed with the drive name and colon.
+
+* Content Provider:
+
+  * Use case: modification of the protocol used for data retrieval
+    (e.g., streaming of the content, real-time collaboration),
+    by extending the Contents API methods for files which already
+    exist on one of the drives.
+
+  * UI: users will choose a widget factory with an associated content provider
+    when selecting how to open a file using the "Open with" dropdown.
+
+To register a custom drive, use the contents manager's ``addDrive`` method.
+The drive needs to follow the ``IDrive`` interface. For drives that use
+a jupyter-server compliant REST API you may wish to extend or re-use
+the built-in ``Drive`` class, as demonstrated below:
+
+.. code:: typescript
+
+  import { Drive, ServerConnection } from '@jupyterlab/services';
+
+  const customDrivePlugin: JupyterFrontEndPlugin<void> = {
+    id: 'my-extension:custom-drive',
+    autoStart: true,
+    activate: (app: JupyterFrontEnd) => {
+      const myDrive = new Drive({
+        apiEndpoint: 'api/contents',
+        name: 'MyNetworkDrive',
+        serverSettings: {
+          baseUrl: 'https://your-jupyter-server.com',
+          // ...
+        } as ServerConnection.ISettings,
+      });
+      app.serviceManager.contents.addDrive(myDrive);
+    }
+  };
+
+To use a content provider, first register it on a drive (or multiple drives):
+
+.. code:: typescript
+
+  import { Contents, ContentsManager, RestContentProvider } from '@jupyterlab/services';
+
+  interface IMyContentChunk {
+    /** URL allowing to fetch the content chunk */
+    url: string;
+  }
+
+  interface CustomContentsModel extends Contents.IModel {
+    /**
+     * Specializes the content (which in `Contents.IModel` is just `any`).
+     */
+    content: IMyContentChunk[];
+  }
+
+  class CustomContentProvider extends RestContentProvider {
+    async get(
+      localPath: string,
+      options?: Contents.IFetchOptions,
+    ): Promise<CustomContentsModel> {
+      // Customize the behaviour of the `get` action to fetch a list of
+      // content chunks from a custom API endpoint instead of the `get`
+
+      try {
+        return getChunks();    // this method needs to be implemented
+      }
+      catch {
+        // fall back to the REST API on errors:
+        const model = await super.get(localPath, options);
+        return {
+          ...model,
+          content: []
+        };
+      }
+    }
+
+    // ...
+  }
+
+  const customContentProviderPlugin: JupyterFrontEndPlugin<void> = {
+    id: 'my-extension:custom-content-provider',
+    autoStart: true,
+    activate: (app: JupyterFrontEnd) => {
+      const drive = (app.serviceManager.contents as ContentsManager).defaultDrive;
+      const registry = drive?.contentProviderRegistry;
+      if (!registry) {
+        // If content provider is a non-essential feature and support for JupyterLab <4.4 is desired:
+        console.error('Cannot initialize content provider: no content provider registry.');
+        return;
+      }
+      const customContentProvider = new CustomContentProvider({
+        // These options are only required if extending the `RestContentProvider`.
+        apiEndpoint: '/api/contents',
+        serverSettings: app.serviceManager.serverSettings,
+      });
+      registry.register('my-custom-provider', customContentProvider);
+    }
+  };
+
+and then create and register a widget factory which will understand how to make use of your custom content provider:
+
+.. code:: typescript
+
+  class ExampleWidgetFactory extends ABCWidgetFactory<ExampleDocWidget, ExampleDocModel> {
+    protected createNewWidget(
+      context: DocumentRegistry.IContext<ExampleDocModel>
+    ): ExampleDocWidget {
+
+      return new ExampleDocWidget({
+        context,
+        content: new ExamplePanel(context)
+      });
+    }
+  }
+
+  const widgetFactoryPlugin: JupyterFrontEndPlugin<void> = {
+    id: 'my-extension:custom-widget-factory',
+    autoStart: true,
+    activate: (app: JupyterFrontEnd) => {
+
+      const widgetFactory = new ExampleWidgetFactory({
+        name: FACTORY,
+        modelName: 'example-model',
+        fileTypes: ['example'],
+        defaultFor: ['example'],
+        // Instructs the document registry to use the custom provider
+        // for context of widgets created with `ExampleWidgetFactory`.
+        contentProviderId: 'my-custom-provider'
+      });
+      app.docRegistry.addWidgetFactory(widgetFactory);
+    }
+  };
+
+
+Where ``ExampleDocModel`` can now expect the ``CustomContentsModel`` rather than ``Contents.IModel``:
+
+.. code:: typescript
+
+  class ExampleDocModel implements DocumentRegistry.IModel {
+    // ...
+
+    fromJSON(chunks: IMyContentChunk[]): void {
+      this.sharedModel.transact(() => {
+        let i = 0;
+        for (const chunk of chunks) {
+          const chunk = fetch(chunk.url);
+          this.sharedModel.set(`chunk-${i}`, chunk);
+          i += 1;
+        }
+      });
+    }
+
+    fromString(data: string): void {
+      const chunks = JSON.parse(data) as IMyContentChunk[];
+      return this.fromJSON(chunks);
+    }
+  }
+
+
+For a complete example of a widget factory (although not using a content provider), see the `documents extension example <https://github.com/jupyterlab/extension-examples/tree/main/documents>`__.

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/docs/source/getting_started/installation.rst

@@ -108,7 +108,7 @@ You can install ``jupyverse`` with ``pip``:
 
 .. code:: bash
 
-    pip install jupyverse[auth, jupyterlab]
+    pip install "jupyverse[auth,jupyterlab]"
 
 or with ``conda``:
 

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/docs/source/user/directories.rst

@@ -234,6 +234,12 @@ example, if the :ref:`application_directory` is
     }
   }
 
+JupyterLab also allows you to **export** and **import** an ``overrides.json`` file
+directly through the interface. You can generate an ``overrides.json`` file based
+on your current customized settings by clicking the **Export** button in the **Settings Editor**
+Similarly, you can use the **Import** button to apply an existing ``overrides.json`` file.
+This makes it easier to back up, share, or reuse your configuration.
+
 .. _build_configjson:
 
 build_config.json

{jupyterlab-4.4.0a1/jupyterlab/galata/@jupyterlab/galata-extension → jupyterlab-4.4.0a2/galata/extension}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlab/galata-extension",
-  "version": "5.4.0-alpha.0",
+  "version": "5.4.0-alpha.2",
   "private": true,
   "description": "JupyterLab UI Testing Framework Extension.",
   "keywords": [
@@ -32,29 +32,25 @@
     "clean:lib": "rimraf ../lib/extension tsconfig.tsbuildinfo"
   },
   "dependencies": {
-    "@jupyterlab/application": "^4.4.0-alpha.0",
-    "@jupyterlab/apputils": "^4.5.0-alpha.0",
-    "@jupyterlab/cells": "^4.4.0-alpha.0",
-    "@jupyterlab/debugger": "^4.4.0-alpha.0",
-    "@jupyterlab/docmanager": "^4.4.0-alpha.0",
-    "@jupyterlab/nbformat": "^4.4.0-alpha.0",
-    "@jupyterlab/notebook": "^4.4.0-alpha.0",
-    "@jupyterlab/settingregistry": "^4.4.0-alpha.0",
+    "@jupyterlab/application": "^4.4.0-alpha.2",
+    "@jupyterlab/apputils": "^4.5.0-alpha.2",
+    "@jupyterlab/cells": "^4.4.0-alpha.2",
+    "@jupyterlab/debugger": "^4.4.0-alpha.2",
+    "@jupyterlab/docmanager": "^4.4.0-alpha.2",
+    "@jupyterlab/nbformat": "^4.4.0-alpha.2",
+    "@jupyterlab/notebook": "^4.4.0-alpha.2",
+    "@jupyterlab/settingregistry": "^4.4.0-alpha.2",
     "@lumino/algorithm": "^2.0.2",
     "@lumino/coreutils": "^2.2.0",
     "@lumino/signaling": "^2.1.3"
   },
   "devDependencies": {
-    "@jupyterlab/builder": "^4.4.0-alpha.0",
+    "@jupyterlab/builder": "^4.4.0-alpha.2",
     "rimraf": "~5.0.5",
     "typescript": "~5.1.6"
   },
   "jupyterlab": {
     "extension": true,
-    "outputDir": "../../jupyterlab/galata/@jupyterlab/galata-extension",
-    "_build": {
-      "load": "static/remoteEntry.2e2ad260d6cb70dfce84.js",
-      "extension": "./extension"
-    }
+    "outputDir": "../../jupyterlab/galata/@jupyterlab/galata-extension"
   }
 }

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/galata/jupyter_server_test_config.py

@@ -5,6 +5,7 @@ from jupyterlab.galata import configure_jupyter_server
 
 configure_jupyter_server(c)
 c.LabApp.dev_mode = True
+c.LabApp.subshell_console = True
 
 # Uncomment to set server log level to debug level
 # c.ServerApp.log_level = "DEBUG"

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/galata/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlab/galata",
-  "version": "5.4.0-alpha.1",
+  "version": "5.4.0-alpha.2",
   "description": "JupyterLab UI Testing Framework",
   "homepage": "https://github.com/jupyterlab/jupyterlab",
   "bugs": {
@@ -44,15 +44,15 @@
     "test:update": "jlpm test:base:update && jlpm test:benchmark:update"
   },
   "dependencies": {
-    "@jupyterlab/application": "^4.4.0-alpha.1",
-    "@jupyterlab/apputils": "^4.5.0-alpha.1",
-    "@jupyterlab/coreutils": "^6.4.0-alpha.1",
-    "@jupyterlab/debugger": "^4.4.0-alpha.1",
-    "@jupyterlab/docmanager": "^4.4.0-alpha.1",
-    "@jupyterlab/nbformat": "^4.4.0-alpha.1",
-    "@jupyterlab/notebook": "^4.4.0-alpha.1",
-    "@jupyterlab/services": "^7.4.0-alpha.1",
-    "@jupyterlab/settingregistry": "^4.4.0-alpha.1",
+    "@jupyterlab/application": "^4.4.0-alpha.2",
+    "@jupyterlab/apputils": "^4.5.0-alpha.2",
+    "@jupyterlab/coreutils": "^6.4.0-alpha.2",
+    "@jupyterlab/debugger": "^4.4.0-alpha.2",
+    "@jupyterlab/docmanager": "^4.4.0-alpha.2",
+    "@jupyterlab/nbformat": "^4.4.0-alpha.2",
+    "@jupyterlab/notebook": "^4.4.0-alpha.2",
+    "@jupyterlab/services": "^7.4.0-alpha.2",
+    "@jupyterlab/settingregistry": "^4.4.0-alpha.2",
     "@lumino/coreutils": "^2.2.0",
     "@playwright/test": "^1.48.0",
     "@stdlib/stats": "~0.0.13",

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/galata/test/jupyterlab/kernel.test.ts

@@ -104,6 +104,79 @@ test.describe('Kernel', () => {
         'Python 3 (ipykernel)'
       );
     });
+
+    test('Should support opening subshell in separate code console', async ({
+      page
+    }) => {
+      // Open new notebook
+      await page.menu.clickMenuItem('File>New>Notebook');
+      await page
+        .getByRole('tab', { name: 'Untitled.ipynb' })
+        .waitFor({ state: 'detached' });
+      await page.getByRole('button', { name: 'Select Kernel' }).click();
+
+      // Run %subshell in notebook
+      const notebook = page.locator('.jp-Notebook');
+      await notebook.waitFor();
+      await page.notebook.setCell(0, 'code', '%subshell');
+      await page.notebook.runCell(0);
+
+      const output1 = notebook.locator('.jp-OutputArea-output').locator('pre');
+      const text1 = (await output1.innerText()).split('\n');
+
+      // Confirm that subshells are supported by %subshell printing something useful.
+      // Subshell ID for this main shell is None, and no subshells have been created
+      // yet so the subshell list is empty.
+      expect(text1[0]).toEqual('subshell id: None');
+      expect(text1[5]).toEqual('subshell list: []');
+
+      // Open subshell console
+      await output1.click({ button: 'right' });
+      await page
+        .getByRole('menuitem', { name: 'New Subshell Console for Notebook' })
+        .click();
+
+      // Run %subshell in console
+      const subshellConsole = page.locator('.jp-CodeConsole');
+      await subshellConsole.waitFor();
+      await subshellConsole
+        .getByLabel('Code Cell Content')
+        .getByRole('textbox')
+        .click();
+      await subshellConsole
+        .getByLabel('Code Cell Content')
+        .getByRole('textbox')
+        .fill('%subshell');
+      await page.menu.clickMenuItem('Run>Run Cell (forced)');
+
+      // Confirm that this is a subshell using "subshell id" printed by %subshell magic
+      // which will be something other than None (None means main shell not subshell).
+      // The subshell ID should also be the one and only entry in the "subshell list",
+      // and wrapped in quotes as it is a string.
+      const output2 = subshellConsole
+        .locator('.jp-OutputArea-output')
+        .locator('pre');
+      const text2 = (await output2.innerText()).split('\n');
+      expect(text2[0]).toMatch(/^subshell id:/);
+      const subshellId = text2[0].split(':')[1].trim();
+      expect(subshellId).not.toEqual('None');
+      expect(text2[5]).toEqual(`subshell list: ['${subshellId}']`);
+
+      // Rerun %subshell in notebook now that subshell exists.
+      await notebook
+        .getByLabel('Code Cell Content')
+        .getByRole('textbox')
+        .nth(0)
+        .click();
+      await page.menu.clickMenuItem('Run>Run Selected Cell');
+
+      // Confirm that the parent shell is still a parent shell (subshell ID is None),
+      // and that the new subshell appears in the "subshell list".
+      const output3 = notebook.locator('.jp-OutputArea-output').locator('pre');
+      const text3 = (await output3.innerText()).split('\n');
+      expect(text3[0]).toEqual('subshell id: None');
+      expect(text3[5]).toEqual(`subshell list: ['${subshellId}']`);
+    });
   });
 
   test.describe('Console', () => {

{jupyterlab-4.4.0a1 → jupyterlab-4.4.0a2}/galata/test/jupyterlab/settings.test.ts

@@ -25,15 +25,27 @@ test('Open the settings editor with a specific search query', async ({
 
   const pluginList = page.locator('.jp-PluginList');
 
-  expect(await pluginList.screenshot()).toMatchSnapshot(
-    'settings-plugin-list.png'
-  );
+  expect
+    .soft(await pluginList.screenshot())
+    .toMatchSnapshot('settings-plugin-list.png');
 
   const settingsPanel = page.locator('.jp-SettingsPanel');
 
-  expect(await settingsPanel.screenshot()).toMatchSnapshot(
-    'settings-panel.png'
-  );
+  expect
+    .soft(await settingsPanel.screenshot())
+    .toMatchSnapshot('settings-panel.png');
+  // Test that new query takes effect
+  await expect(page.locator('.jp-PluginList-entry')).toHaveCount(1);
+
+  await page.evaluate(async () => {
+    await window.jupyterapp.commands.execute('settingeditor:open', {
+      query: 'CodeMirror'
+    });
+  });
+  // wait for command to be executed
+  const fistListEntry = page.locator('.jp-PluginList-entry-label-text').first();
+
+  await expect(fistListEntry).toHaveText('CodeMirror');
 });
 
 test.describe('change font-size', () => {