A JupyterLab extension for version control using git

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

• JupyterLab

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

To install perform the following steps:

pip install --upgrade jupyterlab-git
jupyter lab build

• When you run JupyterLab, if you can see the Git sidepanel UI but you cannot get it to work, you may need to explicitly enable the serverextension by running:

jupyter serverextension enable --py jupyterlab_git

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

JupyterLab follows the official Jupyter Code of Conduct.

The Jupyter Git extension is part of Project Jupyter and is developed by an open community of contributors. Our maintainer team is accompanied by a much larger group of contributors to JupyterLab and Project Jupyter as a whole.

JupyterLab Git's current maintainers are listed in alphabetical order, with affiliation, and main areas of contribution:

• Brian Granger, Cal Poly (co-creator, strategy, vision, management, UI/UX design, architecture).
• Saul Shanabrook, Quansight(software engineering)
• Jaipreet Singh, AWS (software engineering, UI/UX design, management)
• Frederic Collonval, Safran Group (software engineering)

A lot of awesome people have contributed to this repo - See the contributors tab for more details!

This list is provided to help provide context about who we are and how our team functions. If you would like to be listed, please submit a pull request with your information.

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 execute the tests

pytest jupyterlab_git
jlpm run test