JupyterLab v0.33.0 Release Notes
-
July 26, 2018
๐ See the JupyterLab 0.33.0 milestone on GitHub for the full list of pull requests and issues closed.
Key Features:
- No longer in beta
- Workspaces
- Menu items
- Keyboard shortcuts
- Command palette items
- Settings
- Larger file uploads
- Extension management and installation
- Interface changes
- Renderers
- Changes for developers
- ๐ Other fixes
No longer in beta
๐ฆ In JupyterLab 0.33, we removed the "Beta" label to better signal that JupyterLab is ready for users to use on a daily basis. The extension ๐ developer API is still being stabilized. See the release blog post for details. (#4898, #4920)
Workspaces
๐ We added new workspace support, which enables you to have multiple saved ๐ layouts, including in different browser windows. See the ๐
workspace documentation
for more details. (#4502, #4708, #4088, #4041 #3673, #4780)Menu items
- "Activate Previously Used Tab" added to the Tab menu
(
Ctrl/Cmd Shift '
) to toggle between the previously active tabs in the main area. (#4296) - "Reload From Disk" added to the File menu to reload an open file from the state saved on disk. (#4615)
- "Save Notebook with View State" added to the File menu to persist
the notebook collapsed and scrolled cell state. We now read the
collapsed
,scrolled
,jupyter.source_hidden
andjupyter.outputs_hidden
notebook cell metadata when opening.collapsed
andjupyter.outputs_hidden
are redundant and the initial collapsed state is the union of both of them. When the state is persisted, if an output is collapsed, both will be written with the valuetrue
, and if it is not, both will not be written. (#3981) - "Increase/Decrease Font Size" added to the text editor settings menu. (#4811)
- ๐ป "Show in File Browser" added to a document tab's context menu. (#4500)
- ๐ป "Open in New Browser Tab" added to the file browser context menu. (#4315)
- ๐ป "Copy Path" added to file browser context menu to copy the document's path to the clipboard. (#4582)
- "Show Left Area" has been renamed to "Show Left Sidebar" for consistency (same for right sidebar). (#3818)
Keyboard shortcuts
- "Save As..." given the keyboard shortcut
Ctrl/Cmd Shift S
. (#4560) - "Run All Cells" given the keyboard shortcut
Ctrl/Cmd Shift Enter
. (#4558) - "notebook:change-to-cell-heading-X" keyboard shortcuts (and commands) renamed to "notebook:change-cell-to-heading-X" for X=1...6. This fixes the notebook command-mode keyboard shortcuts for changing headings. (#4430)
- The console execute shortcut can now be set to either
Enter
orShift Enter
as a Console setting. (#4054)
Command palette items
"Notebook" added to the command palette to open a new notebook. (#4812)
"Run Selected Text or Current Line in Console" added to the command palette to run the selected text or current line from a notebook in a console. A default keyboard shortcut for this command is not yet provided, but can be added by users with the
notebook:run-in-console
command. To add a keyboard shortcutCtrl G
for this command, use the "Settings" | "Advanced Settings Editor" menu item to open the "Keyboard Shortcuts" advanced settings, and add the following JSON in the shortcut JSON object in the User Overrides pane (adjust the actual keyboard shortcut if you wish). (#3453, #4206, #4330)
{ "command": "notebook:run-in-console", "keys": ["Ctrl G"], "selector": ".jp-Notebook.jp-mod-editMode" }
- The command palette now renders labels, toggled state, and keyboard shortcuts in a more consistent and correct way. (#4533, #4510)
Settings
- "fontFamily", "fontSize", and "lineHeight" settings added to the text editor advanced settings. (#4673)
- Solarized dark and light text editor themes from CodeMirror. (#4445)
Larger file uploads
- ๐ Support for larger file uploads (>15MB) when using Jupyter notebook server version >= 5.1. (#4224)
Extension management and installation
- ๐ New extension manager for installing JupyterLab extensions from npm within the JupyterLab UI. You can enable this from the Advanced Settings interface. (#4682, #4925)
- Please note that to install extensions in JupyterLab, you must use NodeJS version 9 or earlier (i.e., not NodeJS version 10). We will upgrade yarn, with NodeJS version 10 support, when a bug in yarn is fixed. (#4804)
Interface changes
- Wider tabs in the main working area to show longer filenames. (#4801)
- ๐ Initial kernel selection for a notebook or console can no longer be canceled: the user must select a kernel. (#4596)
- 0๏ธโฃ Consoles now do not display output from other clients by default. A new "Show All Kernel Activity" console context menu item has been added to show all activity from a kernel in the console. (#4503)
- The favicon now shows the busy status of the kernels in JupyterLab. (#4361, #3957, #4966)
Renderers
- โฌ๏ธ JupyterLab now ships with a Vega4 renderer by default (upgraded from Vega3). (#4806)
- The HTML sanitizer now allows some extra tags in rendered HTML,
including
kbd
,sup
, andsub
. (#4618) - JupyterLab now recognizes the
.tsv
file extension as tab-separated files. (#4684) - Javascript execution in notebook cells has been re-enabled. (#4515)
๐ Changes for developers
- ๐ฆ A new signal for observing application dirty status state changes. (#4840)
- ๐ฆ A new signal for observing notebook cell execution. (#4740, #4744)
- ๐ฆ A new
anyMessage
signal for observing any message a kernel sends or receives. (#4437) - A generic way for different widgets to register a "Save with extras" command that appears in the File menu under save. (#3981)
- A new API for removing groups from a JupyterLab menu.
addGroup
now returns anIDisposable
which can be used to remove the group.removeGroup
has been removed. (#4890) - The
Launcher
now uses commands from the applicationCommandRegistry
to launch new activities. Extension authors that add items to the launcher will need to update them to use commands. (#4757) - There is now a top-level
addToBottomArea
function in the application, allowing extension authors to add bottom panel items like status bars. (#4752) - 0๏ธโฃ Rendermime extensions can now indicate that they are the default rendered widget factory for a file-type. For instance, the default widget for a markdown file is a text editor, but the default rendered widget is the markdown viewer. (#4692)
- โ Add new workspace REST endpoints to
jupyterlab_server
and make them available in@jupyterlab/services
. (#4841) - Documents created with a mimerenderer extension can now be accessed
using an
IInstanceTracker
which tracks them. Include the tokenIMimeDocumentTracker
in your plugin to access this. TheIInstanceTracker
interface has also gained convenience functionsfind
andfilter
to simplify iterating over instances. (#4762) - RenderMime render errors are now displayed to the user. (#4465)
getNotebookVersion
is added to thePageConfig
object. (#4224)- ๐ฆ The session
kernelChanged
signal now contains both the old kernel and the new kernel to make it easy to unregister things from the old kernel. (#4834) - The
connectTo
functions for connecting to kernels and sessions are now synchronous (returning a connection immediately rather than a promise). The DefaultSessionclone
andupdate
methods are also synchronous now. (#4725) - Kernel message processing is now asynchronous, which guarantees the
order of processing even if a handler is asynchronous. If a kernel
message handler returns a promise, kernel message processing is
paused until the promise resolves. The kernel's
anyMessage
signal is emitted synchronously when a message is received before asynchronous message handling, and theiopubMessage
andunhandledMessage
signals are emitted during asynchronous message handling. These changes mean that the commonMsg
andonClose
handlers and the kernel futureonReply
,onIOPub
, andonStdin
handlers, as well as the comm target and message hook handlers, may be asynchronous and return promises. (#4697) - Kernel comm targets and message hooks now are unregistered with
removeCommTarget
andremoveMessageHook
, instead of using disposables. The correspondingregisterCommTarget
andregisterMessageHook
functions now return nothing. (#4697) - ๐ The kernel
connectToComm
function is synchronous, and now returns the comm rather than a promise to the comm. (#4697) - The
KernelFutureHandler
classexpectShell
constructor argument is renamed toexpectReply
. (#4697) - The kernel future
done
returned promise now resolves to undefined if there is no reply message. (#4697) - โก๏ธ The
IDisplayDataMsg
is updated to have the optionaltransient
key, and a newIUpdateDisplayDataMsg
type was added for update display messages. (#4697) - ๐ The
uuid
function from@jupyterlab/coreutils
is removed. Instead importUUID
from@phosphor/coreutils
and useUUID.uuid4()
. (#4604) - Main area widgets like the launcher and console inherit from a
common
MainAreaWidget
class which provides a content area (.content
) and a toolbar (.toolbar
), consistent focus handling and activation behavior, and a spinner displayed until the givenreveal
promise is resolved. Document widgets, like the notebook and text editor and other documents opened from the document manager, implement theIDocumentWidget
interface (instead ofDocumentRegistry.IReadyWidget
), which builds onMainAreaWidget
and adds a.context
attribute for the document context and makes dirty handling consistent. Extension authors may consider inheriting from theMainAreaWidget
orDocumentWidget
class for consistency. Several effects from these changes are noted below. (#3499, #4453)- The notebook panel
.notebook
attribute is renamed to.content
. - The text editor is now the
.content
of aDocumentWidget
, so the top-level editor widget has a toolbar and the editor itself iswidget.content.editor
rather than justwidget.editor
. - Mime documents use a
MimeContent
widget embedded inside of aDocumentWidget
now. - Main area widgets and document widgets now have a
revealed
promise which resolves when the widget has been revealed (i.e., the spinner has been removed). This should be used instead of theready
promise.
- The notebook panel
๐ Changes in the JupyterLab code infrastructure include:
- The JupyterLab TypeScript codebase is now compiled to ES2015 (ES6)
using TypeScript 2.9. We also turned on the TypeScript
esModuleInterop
flag to enable more natural imports from non-es2015 JavaScript modules. With the update to ES2015 output, code generated from async/await syntax became much more manageable, so we have started to use async/await liberally throughout the codebase, especially in tests. Because we use Typedoc for API documentation, we still use syntax compatible with TypeScript 2.7 where Typedoc is used. Extension authors may have some minor compatibility updates to make. If you are writing an extension in TypeScript, we recommend updating to TypeScript 2.9 and targeting ES2015 output as well. (#4462, #4675, #4714, #4797) - The JupyterLab codebase is now formatted using Prettier. By default the development environment installs a pre-commit hook that formats your staged changes. (#4090)
- โก๏ธ Updated build infrastructure using webpack 4 and better typing. (#4702, #4698)
- โฌ๏ธ Upgraded yarn to version 1.6. Please note that you must use NodeJS version 9 or earlier with JupyterLab (i.e., not NodeJS version 10). We will upgrade yarn, with NodeJS version 10 support, when a bug in yarn is fixed. (#4804)
- ๐ Various process utilities were moved to
jupyterlab_server
. (#4696)
๐ Other fixes
- ๐ Fixed a rendering bug with the Launcher in single-document mode. (#4805)
- ๐ Fixed a bug where the native context menu could not be triggered in a notebook cell in Chrome. (#4720)
- ๐ Fixed a bug where the cursor would not show up in the dark theme. (#4699)
- ๐ Fixed a bug preventing relative links from working correctly in
alternate
IDrive
s. (#4613) - ๐ Fixed a bug breaking the image viewer upon saving the image. (#4602)
- ๐ Fixed the font size for code blocks in notebook Markdown headers. (#4617)
- Prevented a memory leak when repeatedly rendering a Vega chart. (#4904)
- ๐ Support dropped terminal connection re-connecting. (#4763, #4802)
- ๐ Use
require.ensure
invega4-extension
to lazily loadvega-embed
and its dependencies on first render. (#4706) - Relative links to documents that include anchor tags will now correctly scroll the document to the right place. (#4692)
- ๐ Fix default settings JSON in setting editor. (#4591, #4595)
- ๐ Fix setting editor pane layout's stretch factor. (#2971, #4772)
- Programmatically set settings are now output with nicer formatting. (#4870)
- ๐ Fixed a bug in displaying one-line CSV files. (#4795, #4796)
- ๐ Fixed a bug where JSON arrays in rich outputs were collapsed into strings. (#4480)