Jupyterlab

October 3, 2018

See the [JupyterLab
0.35.0](https://github.com/jupyterlab/jupyterlab/milestone/18?closed=1)
milestone on GitHub for the full list of pull requests and issues
closed.

Features

- A notebook cell can now be readonly, reflecting its `enabled`
metadata.
([5401](https://github.com/jupyterlab/jupyterlab/pull/5401),
[1312](https://github.com/jupyterlab/jupyterlab/issues/1312))
- Add "Go To Line" in the Edit menu for text editors.
([5377](https://github.com/jupyterlab/jupyterlab/pull/5377))
- Sidebar panels can now be switched between left and right sidebars.
Right-click on a sidebar tab to move it to the other sidebar.
([5347](https://github.com/jupyterlab/jupyterlab/pull/5347),
[5054](https://github.com/jupyterlab/jupyterlab/issues/5054),
[3707](https://github.com/jupyterlab/jupyterlab/issues/3707))
- Make the sidebar a bit narrower, and make the minimum width
adjustable from a theme.
([5245](https://github.com/jupyterlab/jupyterlab/pull/5245))
- Populate the File, Export Notebook As... submenu from the server
nbconvert capabilities.
([5217](https://github.com/jupyterlab/jupyterlab/pull/5217))
- Server contents managers can now tell JupyterLab to open files as
notebooks. For example, several custom contents managers save and
open notebooks as Markdown files.
([5247](https://github.com/jupyterlab/jupyterlab/pull/5247),
[4924](https://github.com/jupyterlab/jupyterlab/issues/4924))
- Add a command-line interface for managing workspaces.
([5166](https://github.com/jupyterlab/jupyterlab/pull/5166))
- Allow safe inline CSS styles in Markdown.
([5012](https://github.com/jupyterlab/jupyterlab/pull/5012),
[1812](https://github.com/jupyterlab/jupyterlab/issues/1812))
- Add Quit to File menu when appropriate.
([5226](https://github.com/jupyterlab/jupyterlab/pull/5226),
[5252](https://github.com/jupyterlab/jupyterlab/pull/5252),
[5246](https://github.com/jupyterlab/jupyterlab/issues/5246),
[5280](https://github.com/jupyterlab/jupyterlab/pull/5280))
- Rework extension manager user experience.
([5147](https://github.com/jupyterlab/jupyterlab/pull/5147),
[5042](https://github.com/jupyterlab/jupyterlab/issues/5042))

Dark theme

- Show a dark splash screen when using a dark theme.
([5339](https://github.com/jupyterlab/jupyterlab/pull/5339),
[5338](https://github.com/jupyterlab/jupyterlab/issues/5338),
[5403](https://github.com/jupyterlab/jupyterlab/pull/5403))
- Fix code completion menu for a dark theme.
([5364](https://github.com/jupyterlab/jupyterlab/pull/5364),
[5349](https://github.com/jupyterlab/jupyterlab/issues/5349))
- Style CSV viewer for a dark theme.
([5304](https://github.com/jupyterlab/jupyterlab/pull/5304),
[3456](https://github.com/jupyterlab/jupyterlab/issues/3456))
- Make Matplotlib figures legible in a dark theme.
([5232](https://github.com/jupyterlab/jupyterlab/pull/5232))
- Fix notebook cell dropdown legibility in a dark theme.
([5168](https://github.com/jupyterlab/jupyterlab/issues/5168))

Bug fixes

- Various save options in the file menu and toolbar are now disabled
when a file is not writable.
([5376](https://github.com/jupyterlab/jupyterlab/pull/5376),
[5391](https://github.com/jupyterlab/jupyterlab/pull/5391))
- Kernel selector dialog no longer cuts off kernel names.
([5260](https://github.com/jupyterlab/jupyterlab/pull/5260),
[5181](https://github.com/jupyterlab/jupyterlab/issues/5181))
- Fix focus issues with the toolbar.
([5344](https://github.com/jupyterlab/jupyterlab/pull/5344),
[5324](https://github.com/jupyterlab/jupyterlab/pull/5324),
[2995](https://github.com/jupyterlab/jupyterlab/issues/2995),
[5328](https://github.com/jupyterlab/jupyterlab/pull/5328))
- Fix toolbar button enabled/disabled status.
([5278](https://github.com/jupyterlab/jupyterlab/pull/5278))
- Table alignment is now respected in Markdown.
([5301](https://github.com/jupyterlab/jupyterlab/pull/5301),
[3180](https://github.com/jupyterlab/jupyterlab/issues/3180))
- Fix syntax highlighting for Markdown lists.
([5297](https://github.com/jupyterlab/jupyterlab/pull/5297),
[2741](https://github.com/jupyterlab/jupyterlab/issues/2741))
- Use the current filebrowser instead of the default one for various
commands.
([5390](https://github.com/jupyterlab/jupyterlab/pull/5390))
- Fix escaping in link handling to conform to Markdown syntax. This
means that spaces in link references now need to be encoded as
`%20`.
([5383](https://github.com/jupyterlab/jupyterlab/pull/5383),
[5340](https://github.com/jupyterlab/jupyterlab/pull/5340),
[5153](https://github.com/jupyterlab/jupyterlab/issues/5153))

Build system

- Use Typescript 3.1.
([5360](https://github.com/jupyterlab/jupyterlab/pull/5360))
- Use Lerna 3.2.1.
([5262](https://github.com/jupyterlab/jupyterlab/pull/5262))
- Node >=6.11.5 is now required.
([5227](https://github.com/jupyterlab/jupyterlab/pull/5227))
- Pin vega-embed version to 3.18.2.
([5342](https://github.com/jupyterlab/jupyterlab/pull/5342))
- Use Jest for services tests.
([5251](https://github.com/jupyterlab/jupyterlab/pull/5251),
[5282](https://github.com/jupyterlab/jupyterlab/pull/5282))
- Make it easier for third party extensions to use the JupyterLab test
app and testing utilities.
([5415](https://github.com/jupyterlab/jupyterlab/pull/5415))
- Fix `jupyter lab clean` on Windows.
([5400](https://github.com/jupyterlab/jupyterlab/pull/5400),
[5397](https://github.com/jupyterlab/jupyterlab/issues/5397))
- Fix `jupyter lab build` on NFS.
([5237](https://github.com/jupyterlab/jupyterlab/pull/5237),
[5233](https://github.com/jupyterlab/jupyterlab/issues/5233))
- Build wheels for Python 3 only.
([5287](https://github.com/jupyterlab/jupyterlab/pull/5287))
- Migrate to using `jupyterlab_server` instead of
`jupyterlab_launcher` and fix the app example.
([5316](https://github.com/jupyterlab/jupyterlab/pull/5316))
- Move Mathjax 2 typesetter to a library package.
([5259](https://github.com/jupyterlab/jupyterlab/pull/5259),
[5257](https://github.com/jupyterlab/jupyterlab/issues/5257))

For Developers

- Default toolbar buttons can be overridden, and mime renderers can
now specify toolbar buttons.
([5398](https://github.com/jupyterlab/jupyterlab/pull/5398),
[5370](https://github.com/jupyterlab/jupyterlab/pull/5370),
[5363](https://github.com/jupyterlab/jupyterlab/issues/5363))
- A JupyterLab application instance can now be given a document
registry, service manager, and command linker.
([5291](https://github.com/jupyterlab/jupyterlab/pull/5291))

August 18, 2018

See the [JupyterLab
0.34.0](https://github.com/jupyterlab/jupyterlab/milestone/16?closed=1)
milestone on GitHub for the full list of pull requests and issues
closed.

Key Features

- Notebooks, consoles, and text files now have access to completions
for local tokens.
- Python 3.5+ is now required to use JupyterLab. Python 2 kernels can
still be run within JupyterLab.
- Added the pipe (`|`) character as a CSV delimiter option.
- Added "Open From Path..."" to top level `File` menu.
- Added "Copy Download Link" to context menu for files.

Changes for Developers

- Notebooks, consoles, and text files now have access to completions
for local tokens. If a text file has a running kernel associated
with its path (as happens with an attached console), it also gets
completions and tooltips from that kernel.
([5049](https://github.com/jupyterlab/jupyterlab/pull/5049))

- The `FileBrowser` widget has a new constructor option
`refreshInterval`, allowing the creator to customize how often the
widget polls the storage backend. This can be useful to prevent
rate-limiting in certain contexts.
([5048](https://github.com/jupyterlab/jupyterlab/pull/5048))

- The application shell now gets a pair of CSS data attributes
indicating the current theme, and whether it is light or dark.
Extension authors can write CSS rules targeting these to have their
extension UI elements respond to the application theme. For
instance, to write a rule targeting whether the theme is overall
light or dark, you can use

css
[data-theme-light='true'] your-ui-class {
background-color: white;
}
[data-theme-light='false'] your-ui-class {
background-color: black;
}


The theme name can also be targeted by writing CSS rules for
`data-theme-name`.
([5078](https://github.com/jupyterlab/jupyterlab/pull/5078))

- The `IThemeManager` interface now exposes a signal for
`themeChanged`, allowing extension authors to react to changes in
the theme. Theme extensions must also provide a new boolean property
`isLight`, declaring whether they are broadly light colored. This
data allows third-party extensions to react better to the active
application theme.
([5078](https://github.com/jupyterlab/jupyterlab/pull/5078))

- Added a patch to update the `uploads` for each `FileBrowserModel`
instantly whenever a file upload errors. Previously, the upload that
erred was only being removed from uploads upon an update. This would
allow the status bar component and other extensions that use the
`FileBrowserModel` to be more precise.
([5077](https://github.com/jupyterlab/jupyterlab/pull/5077))

- Cell IDs are now passed in the shell message as part of the cell
metadata when a cell is executed. This helps in developing reactive
kernels.
([5033](https://github.com/jupyterlab/jupyterlab/pull/5033))

- The IDs of all deleted cells since the last run cell are now passed
as part of the cell metadata on execution. The IDs of deleted cells
since the last run cell are stored as `deletedCells` in
`NotebookModel`. This helps in developing reactive kernels.
([5037](https://github.com/jupyterlab/jupyterlab/pull/5037))

- The `ToolbarButton` in `apputils` has been refactored with an API
change and now uses a React component `ToolbarButtonComponent` to
render its children. It is now a `div` with a single `button` child,
which in turn as two `span` elements for an icon and text label.
Extensions that were using the `className` options should rename it
as `iconClassName`. The `className` options still exists, but it
used as the CSS class on the `button` element itself. The API
changes were done to accommodate styling changes to the button.
([5117](https://github.com/jupyterlab/jupyterlab/pull/5117))

- The `Toolbar.createFromCommand` function has been replaced by a
dedicated `ToolbarButton` subclass called `CommandToolbarButton`,
that wraps a similarly named React component.
([5117](https://github.com/jupyterlab/jupyterlab/pull/5117))

- The design and styling of the right and left sidebars tabs has been
improved to address
[5054](https://github.com/jupyterlab/jupyterlab/issues/50). We are
now using icons to render tabs for the extensions we ship with
JupyterLab and extension authors are encouraged to do the same (text
labels still work). Icon based tabs can be used by removing
`widget.caption` and adding
`widget.iconClass = '<youriconclass> jp-SideBar-tabIcon';`.
([5117](https://github.com/jupyterlab/jupyterlab/pull/5117))

- The style of buttons in JupyterLab has been updated to a borderless
design.
([5117](https://github.com/jupyterlab/jupyterlab/pull/5117))

- A new series of helper CSS classes for styling SVG-based icons at
different sizes has been added: `jp-Icon`, `jp-Icon-16`,
`jp-Icon-18`, `jp-Icon-20`.

- The rank of the default sidebar widget has been updated. The main
change is giving the extension manager a rank of `1000` so that it
appears at the end of the default items.

- Python 3.5+ is now required to use JupyterLab. Python 2 kernels can
still be run within JupyterLab.
([5119](https://github.com/jupyterlab/jupyterlab/pull/5119))

- JupyterLab now uses `yarn 1.9.4` (aliased as `jlpm`), which now
allows uses to use Node 10+.
([5121](https://github.com/jupyterlab/jupyterlab/pull/5121))

- Clean up handling of `baseUrl` and `wsURL` for `PageConfig` and
`ServerConnection`.
([5111](https://github.com/jupyterlab/jupyterlab/pull/5111))

Other Changes

- Added the pipe (`|`) character as a CSV delimiter option.
([5112](https://github.com/jupyterlab/jupyterlab/pull/5112))
- Added `Open From Path...` to top level `File` menu.
([5108](https://github.com/jupyterlab/jupyterlab/pull/5108))
- Added a `saveState` signal to the document context object.
([5096](https://github.com/jupyterlab/jupyterlab/pull/5096))
- Added "Copy Download Link" to context menu for files.
([5089](https://github.com/jupyterlab/jupyterlab/pull/5089))
- Extensions marked as `deprecated` are no longer shown in the
extension manager.
([5058](https://github.com/jupyterlab/jupyterlab/pull/5058))
- Remove `In` and `Out` text from cell prompts. Shrunk the prompt
width from 90px to 64px. In the light theme, set the prompt colors
of executed console cells to active prompt colors and reduced their
opacity to 0.5. In the dark theme, set the prompt colors of executed
console cells to active prompt colors and set their opacity to 1.
([5097](https://github.com/jupyterlab/jupyterlab/pull/5097) and
[5130](https://github.com/jupyterlab/jupyterlab/pull/5130))

Bug Fixes

- Fixed a bug in the rendering of the "New Notebook" item of the
command palette.
([5079](https://github.com/jupyterlab/jupyterlab/pull/5079))
- We only create the extension manager widget if it is enabled. This
prevents unnecessary network requests to `npmjs.com`.
([5075](https://github.com/jupyterlab/jupyterlab/pull/5075))
- The `running` panel now shows the running sessions at startup.
([5118](https://github.com/jupyterlab/jupyterlab/pull/5118))
- Double clicking a file in the file browser always opens it rather
than sometimes selecting it for a rename.
([5101](https://github.com/jupyterlab/jupyterlab/pull/5101))

July 26, 2018

See the [JupyterLab
0.33.0](https://github.com/jupyterlab/jupyterlab/milestone/12?closed=1)
milestone on GitHub for the full list of pull requests and issues
closed.

Key Features:

- [No longer in beta](no-longer-in-beta)
- [Workspaces](workspaces)
- [Menu items](menu-items)
- [Keyboard shortcuts](keyboard-shortcuts)
- [Command palette items](command-palette-items)
- [Settings](settings)
- [Larger file uploads](larger-file-uploads)
- [Extension management and installation](extension-management-and-installation)
- [Interface changes](interface-changes)
- [Renderers](renderers)
- [Changes for developers](changes-for-developers)
- [Other fixes](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](https://github.com/jupyterlab/jupyterlab/issues/4898),
[4920](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/jupyterlab/jupyterlab/issues/4502),
[4708](https://github.com/jupyterlab/jupyterlab/pull/4708),
[4088](https://github.com/jupyterlab/jupyterlab/issues/4088),
[4041](https://github.com/jupyterlab/jupyterlab/pull/4041)
[3673](https://github.com/jupyterlab/jupyterlab/issues/3673),
[4780](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/jupyterlab/jupyterlab/pull/4296))
- "Reload From Disk" added to the File menu to reload an open file
from the state saved on disk.
([4615](https://github.com/jupyterlab/jupyterlab/pull/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` and
`jupyter.outputs_hidden` notebook cell metadata when opening.
`collapsed` and `jupyter.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 value `true`, and if it is not, both will not be written.
([3981](https://github.com/jupyterlab/jupyterlab/pull/3981))
- "Increase/Decrease Font Size" added to the text editor settings
menu. ([4811](https://github.com/jupyterlab/jupyterlab/pull/4811))
- "Show in File Browser" added to a document tab's context menu.
([4500](https://github.com/jupyterlab/jupyterlab/pull/4500))
- "Open in New Browser Tab" added to the file browser context menu.
([4315](https://github.com/jupyterlab/jupyterlab/pull/4315))
- "Copy Path" added to file browser context menu to copy the
document's path to the clipboard.
([4582](https://github.com/jupyterlab/jupyterlab/pull/4582))
- "Show Left Area" has been renamed to "Show Left Sidebar" for
consistency (same for right sidebar).
([3818](https://github.com/jupyterlab/jupyterlab/pull/3818))

Keyboard shortcuts

- "Save As..." given the keyboard shortcut `Ctrl/Cmd Shift S`.
([4560](https://github.com/jupyterlab/jupyterlab/pull/4560))
- "Run All Cells" given the keyboard shortcut `Ctrl/Cmd Shift Enter`.
([4558](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/jupyterlab/jupyterlab/pull/4430))
- The console execute shortcut can now be set to either `Enter` or
`Shift Enter` as a Console setting.
([4054](https://github.com/jupyterlab/jupyterlab/pull/4054))

Command palette items

- "Notebook" added to the command palette to open a new notebook.
([4812](https://github.com/jupyterlab/jupyterlab/pull/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 shortcut
`Ctrl 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](https://github.com/jupyterlab/jupyterlab/issues/3453),
[4206](https://github.com/jupyterlab/jupyterlab/issues/4206),
[4330](https://github.com/jupyterlab/jupyterlab/pull/4330))

json
{
"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](https://github.com/jupyterlab/jupyterlab/pull/4533),
[4510](https://github.com/jupyterlab/jupyterlab/pull/4510))

Settings

- "fontFamily", "fontSize", and "lineHeight" settings added to the
text editor advanced settings.
([4673](https://github.com/jupyterlab/jupyterlab/pull/4673))
- Solarized dark and light text editor themes from CodeMirror.
([4445](https://github.com/jupyterlab/jupyterlab/pull/4445))

Larger file uploads

- Support for larger file uploads (>15MB) when using Jupyter notebook
server version >= 5.1.
([4224](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/jupyterlab/jupyterlab/pull/4682),
[4925](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/yarnpkg/yarn/issues/5935) is fixed.
([4804](https://github.com/jupyterlab/jupyterlab/pull/4804))

Interface changes

- Wider tabs in the main working area to show longer filenames.
([4801](https://github.com/jupyterlab/jupyterlab/pull/4801))
- Initial kernel selection for a notebook or console can no longer be
canceled: the user must select a kernel.
([4596](https://github.com/jupyterlab/jupyterlab/pull/4596))
- 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](https://github.com/jupyterlab/jupyterlab/pull/4503))
- The favicon now shows the busy status of the kernels in JupyterLab.
([4361](https://github.com/jupyterlab/jupyterlab/pull/4361),
[3957](https://github.com/jupyterlab/jupyterlab/issues/3957),
[4966](https://github.com/jupyterlab/jupyterlab/pull/4966))

Renderers

- JupyterLab now ships with a Vega4 renderer by default (upgraded from
Vega3).
([4806](https://github.com/jupyterlab/jupyterlab/pull/4806))
- The HTML sanitizer now allows some extra tags in rendered HTML,
including `kbd`, `sup`, and `sub`.
([4618](https://github.com/jupyterlab/jupyterlab/pull/4618))
- JupyterLab now recognizes the `.tsv` file extension as tab-separated
files.
([4684](https://github.com/jupyterlab/jupyterlab/pull/4684))
- Javascript execution in notebook cells has been re-enabled.
([4515](https://github.com/jupyterlab/jupyterlab/pull/4682))

Changes for developers

- A new signal for observing application dirty status state changes.
([4840](https://github.com/jupyterlab/jupyterlab/issues/4840))
- A new signal for observing notebook cell execution.
([4740](https://github.com/jupyterlab/jupyterlab/issues/4740),
[4744](https://github.com/jupyterlab/jupyterlab/pull/4744))
- A new `anyMessage` signal for observing any message a kernel sends
or receives.
([4437](https://github.com/jupyterlab/jupyterlab/pull/4437))
- A generic way for different widgets to register a "Save with extras"
command that appears in the File menu under save.
([3981](https://github.com/jupyterlab/jupyterlab/pull/3981))
- A new API for removing groups from a JupyterLab menu. `addGroup` now
returns an `IDisposable` which can be used to remove the group.
`removeGroup` has been removed.
([4890](https://github.com/jupyterlab/jupyterlab/pull/4890))
- The `Launcher` now uses commands from the application
`CommandRegistry` to launch new activities. Extension authors that
add items to the launcher will need to update them to use commands.
([4757](https://github.com/jupyterlab/jupyterlab/pull/4757))
- There is now a top-level `addToBottomArea` function in the
application, allowing extension authors to add bottom panel items
like status bars.
([4752](https://github.com/jupyterlab/jupyterlab/pull/4752))
- 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](https://github.com/jupyterlab/jupyterlab/pull/4692))
- Add new workspace REST endpoints to `jupyterlab_server` and make
them available in `jupyterlab/services`.
([4841](https://github.com/jupyterlab/jupyterlab/pull/4841))
- Documents created with a mimerenderer extension can now be accessed
using an `IInstanceTracker` which tracks them. Include the token
`IMimeDocumentTracker` in your plugin to access this. The
`IInstanceTracker` interface has also gained convenience functions
`find` and `filter` to simplify iterating over instances.
([4762](https://github.com/jupyterlab/jupyterlab/pull/4762))
- RenderMime render errors are now displayed to the user.
([4465](https://github.com/jupyterlab/jupyterlab/pull/4465))
- `getNotebookVersion` is added to the `PageConfig` object.
([4224](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/jupyterlab/jupyterlab/pull/4834))
- The `connectTo` functions for connecting to kernels and sessions are
now synchronous (returning a connection immediately rather than a
promise). The DefaultSession `clone` and `update` methods are also
synchronous now.
([4725](https://github.com/jupyterlab/jupyterlab/pull/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 the `iopubMessage` and
`unhandledMessage` signals are emitted during asynchronous message
handling. These changes mean that the comm `onMsg` and `onClose`
handlers and the kernel future `onReply`, `onIOPub`, and `onStdin`
handlers, as well as the comm target and message hook handlers, may
be asynchronous and return promises.
([4697](https://github.com/jupyterlab/jupyterlab/pull/4697))
- Kernel comm targets and message hooks now are unregistered with
`removeCommTarget` and `removeMessageHook`, instead of using
disposables. The corresponding `registerCommTarget` and
`registerMessageHook` functions now return nothing.
([4697](https://github.com/jupyterlab/jupyterlab/pull/4697))
- The kernel `connectToComm` function is synchronous, and now returns
the comm rather than a promise to the comm.
([4697](https://github.com/jupyterlab/jupyterlab/pull/4697))
- The `KernelFutureHandler` class `expectShell` constructor argument
is renamed to `expectReply`.
([4697](https://github.com/jupyterlab/jupyterlab/pull/4697))
- The kernel future `done` returned promise now resolves to undefined
if there is no reply message.
([4697](https://github.com/jupyterlab/jupyterlab/pull/4697))
- The `IDisplayDataMsg` is updated to have the optional `transient`
key, and a new `IUpdateDisplayDataMsg` type was added for update
display messages.
([4697](https://github.com/jupyterlab/jupyterlab/pull/4697))
- The `uuid` function from `jupyterlab/coreutils` is removed. Instead
import `UUID` from `phosphor/coreutils` and use `UUID.uuid4()` .
([4604](https://github.com/jupyterlab/jupyterlab/pull/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 given
`reveal` promise is resolved. Document widgets, like the notebook
and text editor and other documents opened from the document
manager, implement the `IDocumentWidget` interface (instead of
`DocumentRegistry.IReadyWidget`), which builds on `MainAreaWidget`
and adds a `.context` attribute for the document context and makes
dirty handling consistent. Extension authors may consider inheriting
from the `MainAreaWidget` or `DocumentWidget` class for consistency.
Several effects from these changes are noted below.
([3499](https://github.com/jupyterlab/jupyterlab/pull/3499),
[4453](https://github.com/jupyterlab/jupyterlab/pull/4453))
- The notebook panel `.notebook` attribute is renamed to
`.content`.
- The text editor is now the `.content` of a `DocumentWidget`, so
the top-level editor widget has a toolbar and the editor itself
is `widget.content.editor` rather than just `widget.editor`.
- Mime documents use a `MimeContent` widget embedded inside of a
`DocumentWidget` 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
the `ready` promise.

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](https://github.com/jupyterlab/jupyterlab/pull/4462),
[4675](https://github.com/jupyterlab/jupyterlab/pull/4675),
[4714](https://github.com/jupyterlab/jupyterlab/pull/4714),
[4797](https://github.com/jupyterlab/jupyterlab/pull/4797))
- The JupyterLab codebase is now formatted using
[Prettier](https://github.com/prettier/prettier). By default the
development environment installs a pre-commit hook that formats your
staged changes.
([4090](https://github.com/jupyterlab/jupyterlab/pull/4090))
- Updated build infrastructure using webpack 4 and better typing.
([4702](https://github.com/jupyterlab/jupyterlab/pull/4702),
[4698](https://github.com/jupyterlab/jupyterlab/pull/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](https://github.com/yarnpkg/yarn/issues/5935) is fixed.
([4804](https://github.com/jupyterlab/jupyterlab/pull/4804))
- Various process utilities were moved to `jupyterlab_server`.
([4696](https://github.com/jupyterlab/jupyterlab/pull/4696))

Other fixes

- Fixed a rendering bug with the Launcher in single-document mode.
([4805](https://github.com/jupyterlab/jupyterlab/pull/4805))
- Fixed a bug where the native context menu could not be triggered in
a notebook cell in Chrome.
([4720](https://github.com/jupyterlab/jupyterlab/pull/4720))
- Fixed a bug where the cursor would not show up in the dark theme.
([4699](https://github.com/jupyterlab/jupyterlab/pull/4699))
- Fixed a bug preventing relative links from working correctly in
alternate `IDrive`s.
([4613](https://github.com/jupyterlab/jupyterlab/pull/4613))
- Fixed a bug breaking the image viewer upon saving the image.
([4602](https://github.com/jupyterlab/jupyterlab/pull/4602))
- Fixed the font size for code blocks in notebook Markdown headers.
([4617](https://github.com/jupyterlab/jupyterlab/pull/4617))
- Prevented a memory leak when repeatedly rendering a Vega chart.
([4904](https://github.com/jupyterlab/jupyterlab/pull/4904))
- Support dropped terminal connection re-connecting.
([4763](https://github.com/jupyterlab/jupyterlab/issues/4763),
[4802](https://github.com/jupyterlab/jupyterlab/pull/4802))
- Use `require.ensure` in `vega4-extension` to lazily load
`vega-embed` and its dependencies on first render.
([4706](https://github.com/jupyterlab/jupyterlab/pull/4706))
- Relative links to documents that include anchor tags will now
correctly scroll the document to the right place.
([4692](https://github.com/jupyterlab/jupyterlab/pull/4692))
- Fix default settings JSON in setting editor.
([4591](https://github.com/jupyterlab/jupyterlab/issues/4591),
[4595](https://github.com/jupyterlab/jupyterlab/pull/4595))
- Fix setting editor pane layout's stretch factor.
([2971](https://github.com/jupyterlab/jupyterlab/issues/2971),
[4772](https://github.com/jupyterlab/jupyterlab/pull/4772))
- Programmatically set settings are now output with nicer formatting.
([4870](https://github.com/jupyterlab/jupyterlab/pull/4870))
- Fixed a bug in displaying one-line CSV files.
([4795](https://github.com/jupyterlab/jupyterlab/issues/4795),
[4796](https://github.com/jupyterlab/jupyterlab/pull/4796))
- Fixed a bug where JSON arrays in rich outputs were collapsed into
strings.
([4480](https://github.com/jupyterlab/jupyterlab/pull/4480))

Apr 16, 2018

This is the second in the JupyterLab Beta series of releases. It
contains many enhancements, bugfixes, and refinements, including:

- Better handling of a corrupted or invalid state database.
([3619](https://github.com/jupyterlab/jupyterlab/issues/3619),
[3622](https://github.com/jupyterlab/jupyterlab/issues/3622),
[3687](https://github.com/jupyterlab/jupyterlab/issues/3687),
[4114](https://github.com/jupyterlab/jupyterlab/issues/4114)).
- Fixing file dirty status indicator.
([3652](https://github.com/jupyterlab/jupyterlab/issues/3652)).
- New option for whether to autosave documents.
([3734](https://github.com/jupyterlab/jupyterlab/issues/3734)).
- More commands in the notebook context menu.
([3770](https://github.com/jupyterlab/jupyterlab/issues/3770),
[3909](https://github.com/jupyterlab/jupyterlab/issues/3909))
- Defensively checking for completion metadata from kernels.
([3888](https://github.com/jupyterlab/jupyterlab/issues/3888))
- New "Shutdown all" button in the Running panel.
([3764](https://github.com/jupyterlab/jupyterlab/issues/3764))
- Performance improvements wherein non-focused documents poll the
server less.
([3931](https://github.com/jupyterlab/jupyterlab/issues/3931))
- Changing the keyboard shortcut for singled-document-mode to
something less easy to trigger.
([3889](https://github.com/jupyterlab/jupyterlab/issues/3889))
- Performance improvements for rendering text streams, especially
around progress bars.
([4045](https://github.com/jupyterlab/jupyterlab/issues/4045)).
- Canceling a "Restart Kernel" now functions correctly.
([3703](https://github.com/jupyterlab/jupyterlab/issues/3703)).
- Defer loading file contents until after the application has been
restored.
([4087](https://github.com/jupyterlab/jupyterlab/issues/4087)).
- Ability to rotate, flip, and invert images in the image viewer.
([4000](https://github.com/jupyterlab/jupyterlab/issues/4000))
- Major performance improvements for large CSV viewing.
([3997](https://github.com/jupyterlab/jupyterlab/issues/3997)).
- Always show the context menu in the file browser, even for an empty
directory.
([4264](https://github.com/jupyterlab/jupyterlab/issues/4264)).
- Handle asynchronous comm messages in the services library more
correctly (Note: this means `jupyterlab/services` is now at version
2.0!)
(\[[4115](https://github.com/jupyterlab/jupyterlab/issues/4115)\](https://github.com/jupyterlab/jupyterlab/pull/4115)).
- Display the kernel banner in the console when a kernel is restarted
to mark the restart
(\[[3663](https://github.com/jupyterlab/jupyterlab/issues/3663)\](https://github.com/jupyterlab/jupyterlab/pull/3663)).
- Many tweaks to the UI, as well as better error handling.

Jan 11, 2018

- Add a `/tree` handler and `Copy Shareable Link` to file listing
right click menu:
<https://github.com/jupyterlab/jupyterlab/pull/3396>
- Experimental support for saved workspaces:
[3490](https://github.com/jupyterlab/jupyterlab/issues/3490),
[3586](https://github.com/jupyterlab/jupyterlab/issues/3586)
- Added types information to the completer:
[3508](https://github.com/jupyterlab/jupyterlab/issues/3508)
- More improvements to the top level menus:
<https://github.com/jupyterlab/jupyterlab/pull/3344>
- Editor settings for notebook cells:
<https://github.com/jupyterlab/jupyterlab/pull/3441>
- Simplification of theme extensions:
<https://github.com/jupyterlab/jupyterlab/pull/3423>
- New CSS variable naming scheme:
<https://github.com/jupyterlab/jupyterlab/pull/3403>
- Improvements to cell selection and dragging:
<https://github.com/jupyterlab/jupyterlab/pull/3414>
- Style and typography improvements:
<https://github.com/jupyterlab/jupyterlab/pull/3468>
<https://github.com/jupyterlab/jupyterlab/pull/3457>
<https://github.com/jupyterlab/jupyterlab/pull/3445>
<https://github.com/jupyterlab/jupyterlab/pull/3431>
<https://github.com/jupyterlab/jupyterlab/pull/3428>
<https://github.com/jupyterlab/jupyterlab/pull/3408>
<https://github.com/jupyterlab/jupyterlab/pull/3418>

Dec 05, 2017

- Semantic menus: <https://github.com/jupyterlab/jupyterlab/pull/3182>
- Settings editor now allows comments and provides setting validation:
<https://github.com/jupyterlab/jupyterlab/pull/3167>
- Switch to Yarn as the package manager:
<https://github.com/jupyterlab/jupyterlab/pull/3182>
- Support for carriage return in outputs:
[2761](https://github.com/jupyterlab/jupyterlab/issues/2761)
- Upgrade to TypeScript 2.6:
<https://github.com/jupyterlab/jupyterlab/pull/3288>
- Cleanup of the build, packaging, and extension systems.
`jupyter labextension install` is now the recommended way to install
a local directory. Local directories are considered linked to the
application. cf <https://github.com/jupyterlab/jupyterlab/pull/3182>
- `--core-mode` and `--dev-mode` are now semantically different.
`--core-mode` is a version of JupyterLab using released JavaScript
packages and is what we ship in the Python package. `--dev-mode` is
for unreleased JavaScript and shows the red banner at the top of the
page. <https://github.com/jupyterlab/jupyterlab/pull/3270>