jupyterlab

June 28, 2019

See the JupyterLab 1.0.0 milestone on GitHub for the full list of pull requests and issues closed in 1.0.0, and other 1.0.x milestones for bugs fixed in patch releases.

Find and Replace

<img alt="A notebook with multiple cells and the find and replace interface in the upper right." src="https://raw.githubusercontent.com/jupyterlab/jupyterlab/3.1.x/docs/source/getting_started/find.png" class="jp-screenshot">

We have added first class support for find and replace across JupyterLab. It is currently supported in notebooks and text files and is extensible for other widgets who wish to support it. (#6350, #6322, #6301, #6282, #6256, #6241, #6237, #6159, #6081, #6155, #6094, #6024, #5937, #5795, #1074)

Status Bar

<img alt="A screenshot of the updated JupyterLab status bar." src="https://raw.githubusercontent.com/jupyterlab/jupyterlab/3.1.x/docs/source/getting_started/statusbar.png" class="jp-screenshot">

We have integrated the JupyterLab Status Bar package package into the core distribution. Extensions can add their own status to it as well (#5577, #5525 #5990, #5982, #5514, #5508, #5352).

JupyterHub Integration

• We now include the JupyterHub extension in core JupyterLab, so you no longer need to install @jupyterlab/hub-extension. (#6451, #6428)
• JupyterLab now has a File > Logout menu entry when running with JupyterHub (#6087, #5966)

Printing

We now have a printing system that allows extensions to customize how documents and activities are printed. (#5850, #1314)

Other User Facing Changes

• The launcher displays longer kernel names and supports keyboard navigation (#6587)
• Notebook outputs without any valid MimeType renderers will not be displayed, instead of displaying an error (#6559, #6216)
• Add tooltip to file browser root breadcrumb icon showing the server root, if it is available (#6552)
• Downloading a file will no longer open a new browser window (#6546)
• Rename the help "Inspector" to "Contextual Help" and move it to the "Help" menu (#6493, #6488, #6678, #6671)
• Update many of the icons to make them more consistent (#6672, #6618, #6664, #6621)
• Update the settings UI to remove the table view (#6654, #6622, #6653, #6623, #6646, #6642)
• Replace FAQ Extension with link to JupyterLab documentation (#6628, #6608, #6625, #6610)
• Change the default keyboard shortcut for closing a tab to be Alt+w instead of Cmd/Ctrl+w to avoid conflicts with operating systems. (#6486, #6357)
• Show help text in Inspector window to describe you should select a function (#6476)
• Fixes SVG rendering (#6469, #6295)
• Add support for dropping a tab in the tab bar area. (#6454, #5406)
• Switch some default shortcuts to use Accel instead of Ctrl so they are more natural for Mac users (#6447, #5023)
• Add ability to tell between hover and selected command palette items (#6407, #279)
• Hide the "Last Modified" column when the file browser is narrow (#6406, #6093)
• Support copy/paste in terminal and Mac OS using Ctrl+C and Ctrl+V (#6391, #6385, #1146)
• Support scrolling in running kernels panel (#6383, #6371)
• Adds ability to "Merge Selected Cells" in the context menu in the notebook (#6375, #6318)
• Turn On Accessibility In Xterm.js to make it more compatible for screen readers (#6359)
• When selecting cells using the keyboard shortcuts, we now skip collapsed cells (#6356, #3233)
• Supporting opening .geojson files in JSON viewer (#6349)
• Performance fixes for text-based progress bars (#6304, #4202)
• Add support for rendering Vega 5 and Vega Lite 3 while keeping the existing Vega 4 and Vega Lite 2 renderers (#6294, #6133, #6128, #6689, #6685, #6684, #6675, #6591, #6572)
• Drag and drop console cells into a notebook or text editor (#5585, #4847)
• Drag and drop notebook cells into a console or text editor (#5571, #3732)
• The extension manager search now sorts extensions by the score assigned to them by NPM instead of alphabetically (#5649)
• Notify the user when a kernel is automatically restarted, for example, if crashes from an out of memory error (#6246, #4273)
• Expose the extension manager in a command and menu item (#6200)
• Add command to render all Markdown cells (#6029, #6017)
• Supports using shift to select text in output area (#6015, #4800)
• Output areas that opened in new views are restored properly now on reload (#5981, #5976)
• Add support for managing notebook metadata under a new "Advanced Tools" section in the cell tools area. The cell and notebook metadata now always reflect the current state of the notebook (#5968, #5200)
• Inherit terminal theme from core theme (#5964)
• Adds a built-in HTML viewer so that you can view HTML files (#5962, #5855, #2369)
• New workspaces are now automatically generated when you create a new window with the same workspace name. (#5950, #5854, #5830, #5214)
• We now add a hint to the context menu to describe how you can access the native browser menu (#5940, #4023)
• The tabs on the left panel have changed to make them more understandable (#5920, #5269)
• Start a new terminal when the page is refreshed and the old terminal has died (#5917)
• Add a command to open the main menus, which can be assigned to a keyboard shortcut to open and navigate menus without a mouse (#5910, #3074)
• The contextual help now updates based on changes in the cursor from the mouse instead of just from the keyboard (#5906, #5899)
• The launcher now updates when the kernels change on the server (#5904, #5676)
• Retain cell auto scroll behavior even when a cell output is cleared (#5817, #4028)
• If you link to a relative path that is not a file in a markdown cell, this will now be preserved instead of changing it to a file URL (#5814)
• Adds the ability to link to a certain row in a CSV file and have the viewer open to that row (#5727, #5720)
• We have improved the performance of switching to a large notebook (#5700, #4292, #2639)
• The vdom extension now supports event handling, so that you can have kernel code run in response to user interaction with the UI (#5670)
• Adds the ability to run "Run All Code" and "Restart Kernel and Run All Code" in code and markdown files (#5641, #5579)
• We now remember what line ending a text file has when loading it, so that files with CRLF line endings will properly be saved with the same endings (#5622, #4464, #3901, #3706)
• Fixes rendering of SVG elements in HTML MimeType output (#5610, #5610, #5589)
• Allow copying files by holding down Ctrl when dragging them in the file browser (#5584, #3235)
• Switch the hover modified time in the file browser to use the local format (#5567)
• We have added a default keyboard shortcut of Ctrl Shift Q for closing and cleaning up a file (#5534, #4390)
• Adds the ability to find and go to a certain line in the CSV viewer (#5523)
• Add the ability to create new text and markdown files from the launcher and command palette (#5512, #5511)
• A "New Folder" option has been added to the file browser context menu (#5447)
• The ANSI colors are now the same as those in the classic notebook (#5336, #3773)
• Send complete statements instead of current lines when stepping through code in a cell (#6515, #6063)
• Description list styles (dl, dt, dd) are improved to be consistent with the nteract project (#5682, #2399)

Settings

• The settings system has been rewritten (#5470, #5298) and now uses json5 as the syntax, which supports comments and other features for better human readability (#6343, #6199).
• The keyboard shortcut system has been rewritten and now displays a list of system commands in the settings comments (#5812, #5562).

There are new settings for many following items, including:

• Adds an option to shut down terminals and notebook kernels when they are closed (#6285, #6275)
• Scrolling past the end of a notebooks and text editor document (#5542, #5271, #5652, #4429)
• Text editor code folding, rulers, and active line highlighting (#5761, #4083, #5750, #4179, #5529, #5528)
• Markdown viewer options (#5901, #3940)
• Terminal scrollback and other settings (#5609, #3985)
• The autosave interval (#5645, #5619)
• The file browser showing the current active file (#5698, #4258)
• Custom scrollbar styling for dark themes (#6026, #4867)

Command Line Changes

• Installing extensions will be quieter and adds a --debug to extension installing (#6567, #6499, #5986)
• We now support running JupyterLab when its application directory is a symlink (#6240, #6166)
• Add --all flag to labextension uninstall to remove all extensions (#6058, #6006)
• Adds the ability to override the base URLs from the config (#5518, #5503)
• Updates to workspaces CLI command (#6473, #5977, #6276, #6234, #6210, #5975, #5695, #5694)

Extension Development Changes

• We have rewritten how extensions provide keyboard shortcuts and interact with the settings system. If you previously defined keyboard shortcuts or used the settings mechanism, you will need to update your extension (#5470, #5298)
• We have renamed the plugin type from JupyterLabPlugin to JupyterFrontEndPlugin. The application arg is also renamed from JupyterLab to JupyterFrontEnd and some its functionality has been moved to a separate ILabShell plugin (#5845, #5919)
• The lab shell addToMainArea, addToLeftArea, addToTopArea, addToRightArea, and addToBottomArea functions have been replaced with a single add() function that takes the area as an argument. Replace addToMainArea(widget, options) with add(widget, 'main', options), etc. (#5845)
• Rename pageUrl to appUrl in the server connection (#6509, #6508, #6585, #6584)
• MainAreaWidget instances now forward update requests to their content (#6586, #6571)
• The theme data attributes are renamed and moved to the document body element. If you are relying on these attributes in CSS to conditionally style based on the theme, you should update their names. For example data-theme-light is now data-jp-theme-light. (#6566, #6554)
• Extensions which require CSS should no longer import their CSS files into their Javascript files. Instead, they should specify a root CSS file in the style attribute in their package.json, and JupyterLab will automatically import that CSS file. (#6533, #6530, #6395, #6390)
• Dialog.prompt has been replaced by a number of type-specific dialogs such as InputDialog.getString, InputDialog.getBoolean, etc. (#6522, #6378, #6327, #6326)
• When a RenderMime widget is re-rendered, the default behavior is to remove any existing content in the DOM. This can be overridden if needed. (#6513, #6505, #6497)
• We have updated our internal TypeScript version to 3.5.1 and our compile target to ES2017. Extensions may need to upgrade their TypeScript version and target as well. (#6440, #6224)
• We have updated the typings for some of the Kernel messages so that they better match the spec. (#6433)
• A connectionFailure signal has been added to some of the manager classes, which can be used to detect when a connection to the server is lost (#6399, #6176, #3324)
• Add rate limiting and polling utilities to coreutils to use for throttling and debouncing of API requests (#6345, #6346, #6401, #6305, #6157, #6192, #6186, #6141, #3929, #6141, #3929, #6186, #6192, #6401 ,#6305, #6157)
• Require session when instantiating terminal widget (#6339, #5061)
• Provides a signal to see what items are opened in a directory listing (#6270, #6269)
• Ads the ability to add widget above the main work area to a top header area (#5936)
• Renames contextMenuFirst to contextMenuHitTest in the JupyterFrontEnd (#5932)
• Removes the initialCommand arg from the terminal creation command. (#5916)
• Adds --jp-code-cursor-width0, --jp-code-cursor-width1, and --jp-code-cursor-width2 variables to the themes to support changing the cursor width if you change the font size (#5898)
• Adds the ability to insert a new item to the toolbar before or after another item (#5896, #5894)
• Adds the ability for extensions to register new CodeMirror modes (#5829)
• We have removed the JUPYTERLAB_xxx_LOADER Webpack loaders, instead you should use the loader directly in the URL as Webpack supports it (#5709, #4406)
• Adds the ability to handle fragments for document widgets (#5630, #5599)
• We have added a @jupyterlab/ui-components package that contains reusable React components to be used internally and in extensions. Feel free to use this to create extension UIs with consistent styles (#5538)
• The showErrorMessage function now lets you customize the buttons it uses (#5513)
• We now provide helpers for using React components within JupyterLab. If you were previously using ReactElementWidget you should switch to using ReactWidget. (#5479, #5766, #6595, #6595)
• The share link command has been moved to its own extension so that it can be overridden (#5460, #5388)
• Creating a new services session now requires passing a kernel model instead of a kernel instance (#6503, #6142)
• We upgraded the Webpack raw file loader. The new version of the raw loader exports ES2015 modules, so this may require changes in extensions that import files using the raw loader. For example, if you did require('myfile.md') to get the content of myfile.md as a string, you now should import it using ES2015 import syntax, or use require(\'myfile.md\').default.
• Widget factories now can support custom cloning behavior from an optional source widget (#6060, #6044)
• We have renamed the type InstanceTracker to WidgetTracker (#6569).
• In order to add widgets to the main area (e.g. as in the old XKCD extension tutorial), the correct syntax is now app.shell.add(widget) or app.shell.add(widget, 'main'), see here.

October 3, 2018

See the JupyterLab 0.35.0 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, #1312)
• Add "Go To Line" in the Edit menu for text editors. (#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, #5054, #3707)
• Make the sidebar a bit narrower, and make the minimum width adjustable from a theme. (#5245)
• Populate the File, Export Notebook As... submenu from the server nbconvert capabilities. (#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, #4924)
• Add a command-line interface for managing workspaces. (#5166)
• Allow safe inline CSS styles in Markdown. (#5012, #1812)
• Add Quit to File menu when appropriate. (#5226, #5252, #5246, #5280)
• Rework extension manager user experience. (#5147, #5042)

Dark theme

• Show a dark splash screen when using a dark theme. (#5339, #5338, #5403)
• Fix code completion menu for a dark theme. (#5364, #5349)
• Style CSV viewer for a dark theme. (#5304, #3456)
• Make Matplotlib figures legible in a dark theme. (#5232)
• Fix notebook cell dropdown legibility in a dark theme. (#5168)

Bug fixes

• Various save options in the file menu and toolbar are now disabled when a file is not writable. (#5376, #5391)
• Kernel selector dialog no longer cuts off kernel names. (#5260, #5181)
• Fix focus issues with the toolbar. (#5344, #5324, #2995, #5328)
• Fix toolbar button enabled/disabled status. (#5278)
• Table alignment is now respected in Markdown. (#5301, #3180)
• Fix syntax highlighting for Markdown lists. (#5297, #2741)
• Use the current filebrowser instead of the default one for various commands. (#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, #5340, #5153)

Build system

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

For Developers

• Default toolbar buttons can be overridden, and mime renderers can now specify toolbar buttons. (#5398, #5370, #5363)
• A JupyterLab application instance can now be given a document registry, service manager, and command linker. (#5291)

August 18, 2018

See the JupyterLab 0.34.0 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)

• 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)

• 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

  [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)

• 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)

• 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)

• 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)

• 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)

• 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)

• The Toolbar.createFromCommand function has been replaced by a dedicated ToolbarButton subclass called CommandToolbarButton, that wraps a similarly named React component. (#5117)

• The design and styling of the right and left sidebars tabs has been improved to address #5054. 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)

• The style of buttons in JupyterLab has been updated to a borderless design. (#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)

• JupyterLab now uses yarn 1.9.4 (aliased as jlpm), which now allows uses to use Node 10+. (#5121)

• Clean up handling of baseUrl and wsURL for PageConfig and ServerConnection. (#5111)

Other Changes

• Added the pipe (|) character as a CSV delimiter option. (#5112)
• Added Open From Path... to top level File menu. (#5108)
• Added a saveState signal to the document context object. (#5096)
• Added "Copy Download Link" to context menu for files. (#5089)
• Extensions marked as deprecated are no longer shown in the extension manager. (#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 and #5130)

Bug Fixes

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