Skip to main content

A server extension for JupyterLab's git extension

Project description

jupyterlab-git

Binder Build Status Version Version Downloads Version Downloads All Contributors

A JupyterLab extension for version control using Git

ui_glow_up

To see the extension in action, open the example notebook included in the Binder demo.

Prerequisites

  • JupyterLab
  • Git (version >=1.7.4)

Usage

  • Open the Git extension from the Git tab on the left panel

Install

To install perform the following steps:

pip install --upgrade jupyterlab-git
jupyter lab build

Settings

Once installed, extension behavior can be modified via the following settings which can be set in JupyterLab's advanced settings editor:

  • disableBranchWithChanges: disable all branch operations, such as creating a new branch or switching to a different branch, when there are changed/staged files. When set to true, this setting guards against overwriting and/or losing uncommitted changes.
  • historyCount: number of commits shown in the history log, beginning with the most recent. Displaying a larger number of commits can lead to performance degradation, so use caution when modifying this setting.
  • refreshInterval: number of milliseconds between polling the file system for changes. In order to ensure that the UI correctly displays the current repository status, the extension must poll the file system for changes. Longer polling times increase the likelihood that the UI does not reflect the current status; however, longer polling times also incur less performance overhead.
  • simpleStaging: enable a simplified concept of staging. When this setting is true, all files with changes are automatically staged. When we develop in JupyterLab, we often only care about what files have changed (in the broadest sense) and don't need to distinguish between "tracked" and "untracked" files. Accordingly, this setting allows us to simplify the visual presentation of changes, which is especially useful for those less acquainted with Git.

Troubleshooting

Before consulting the following list, be sure the server extension and the frontend extension have the same version by executing the following commands:

jupyter serverextension list
jupyter labextension list
  • Issue: the Git panel does not recognize that you are in a Git repository.

    Possible fixes:

    • Be sure to be in a Git repository in the filebrowser tab

    • Check the server log. If you see a warning with a 404 code similar to: [W 00:27:41.800 LabApp] 404 GET /git/server_root?1576081660665

      Explicitly enable the server extension by running:

      jupyter serverextension enable --py jupyterlab_git
      
    • If you are using JupyterHub or some other technologies requiring an initialization script which includes the jupyterlab-git extension, be sure to install both the frontend and the server extension before launching JupyterLab.

  • Issue: the Git panel is not visible.

    Possible fixes:

    • Check that the JupyterLab extension is installed:

      jupyter labextension list
      

      If you don't see @jupyterlab/git v... enabled OK in the list, explicitly install the jupyter labextension by running:

      jupyter labextension install @jupyterlab/git
      

Development

Contributing

If you would like to contribute to the project, please read our contributor documentation.

JupyterLab follows the official Jupyter Code of Conduct.

Install

Requires node 4+ and npm 4+

# Install new-ish JupyterLab
pip install -U jupyterlab

# Clone the repo to your local environment
git clone https://github.com/jupyterlab/jupyterlab-git.git
cd jupyterlab-git

# Install the server extension in development mode and enable it
pip install -e .[test]
jupyter serverextension enable --py jupyterlab_git

# Build the labextension and dev-mode link it to jlab
jlpm build
jupyter labextension link .

To rebuild the package after a change and the JupyterLab app:

jlpm run build
jupyter lab build

To continuously monitor the project for changes and automatically trigger a rebuild, start Jupyter in watch mode:

jupyter lab --watch

And in a separate session, begin watching the source directory for changes:

jlpm run watch

Now every change will be built locally and bundled into JupyterLab. Be sure to refresh your browser page after saving file changes to reload the extension (note: you'll need to wait for webpack to finish, which can take 10s+ at times).

To execute the tests

pytest jupyterlab_git
jlpm run test

Contributors โœจ

The Jupyter Git extension is part of Project Jupyter and is developed by an open community of contributors. To see who has been active recently, please look at the "Contributors" tab. Below we list the people and entities who contributed in different ways to the project (emoji key):


Amazon Web Services

๐Ÿ’ต

Ashutosh Bondre

๐Ÿ’ป ๐Ÿ‘€

Athan

๐Ÿ’ป ๐Ÿ‘€ ๐Ÿ“† ๐ŸŽจ

Brian E. Granger

๐Ÿ“† ๐ŸŽจ ๐Ÿค” ๐Ÿ”

Frรฉdรฉric Collonval

๐Ÿšง

Hana Zarea

๐Ÿ’ป ๐Ÿ‘€

Jaipreet Singh

๐Ÿ“† ๐Ÿ‘€ ๐Ÿ’ป ๐ŸŽจ

Ji Zhang

๐Ÿ’ป ๐Ÿ‘€

Konstantin Taletskiy

๐Ÿ’ป ๐Ÿ‘€

Max Klein

๐Ÿ’ป ๐Ÿ‘€ ๐Ÿ“† ๐ŸŽจ ๐Ÿš‡

Neelam Gehlot

๐Ÿ’ป ๐Ÿ‘€

Noah Stapp

๐Ÿ’ป ๐Ÿ‘€

Saul Shanabrook

๐Ÿ’ป ๐Ÿ“† ๐Ÿ‘€ ๐Ÿš‡

The D. E. Shaw Group

๐Ÿ’ต

jupytercalpoly

๐Ÿ’ต

This project follows the all-contributors specification. Contributions of any kind welcome!

To add yourself, or someone else, to this list you can either use the bot (@all-contributors please add <username> for <contributions>) or the CLI (jlpm all-contributors add <username> <contributions>).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for jupyterlab-git, version 0.20.0
Filename, size File type Python version Upload date Hashes
Filename, size jupyterlab_git-0.20.0-py3-none-any.whl (209.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size jupyterlab_git-0.20.0.tar.gz (213.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page