Skip to main content

A server extension for JupyterLab's git extension

Project description

jupyterlab-git

Binder Build Status Version Version Downloads Version Downloads

A JupyterLab extension for version control using git

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

Prerequisites

  • JupyterLab

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

Troubleshooting

  • 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

Development

Contributing

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

JupyterLab follows the official Jupyter Code of Conduct.

Team

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.

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

pytest jupyterlab_git
jlpm run test

Project details


Release history Release notifications | RSS feed

This version

0.9.0

Download files

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

Source Distribution

jupyterlab_git-0.9.0.tar.gz (148.7 kB view hashes)

Uploaded Source

Built Distribution

jupyterlab_git-0.9.0-py3-none-any.whl (144.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page