githubcommit
githubcommit is a jupyter notebook extension enabling users push ipython notebooks to a git repo. The git button gets displayed in the notebook toolbar. After saving any notebook the user can push notebook to pre-specified git repository. There are few environment variables that must be exported. Currently this extension supports commits to a single github repo defined in environment variable but in the long run need help to modify this extension allowing user to select his repo and branch.
Installation
You can currently install this directly from git:
pip install git+https://github.com/sat28/githubcommit.git
jupyter serverextension enable --py githubcommit
jupyter nbextension install --py githubcommit --user
To enable this extension for all notebooks:
jupyter nbextension enable githubcommit --user --py
Steps
I have made this short video in which I install the extension from scratch (click on the image)-
- Install package using above commands
- Create Git repo where notebooks will be pushed if not already exists and clone it in your
GIT_PARENT_DIR
- Clone this repo as well in your
GIT_PARENT_DIR
directory - Replace the values in env.sh present in this repo itself
- Run the command - source ~/githubcommit/env.sh
- Configure ssh key (present in ~/.ssh/id_rsa.pub or specified location) in github account
- Run jupyter notebook from within your repo directory
Example git configuration
export GIT_PARENT_DIR=~
export GIT_REPO_NAME=gitjupyter
export GIT_BRANCH_NAME=master
export GIT_USER=sat28
export GIT_EMAIL=anand.shaleen@gmail.com
export GITHUB_ACCESS_TOKEN=#access-token from github developer settings
export GIT_USER_UPSTREAM=sat28
Screenshots
Credits
Thanks to https://github.com/Lab41/sunny-side-up for laying the foundation of this extension.
Thanks to https://github.com/justvarshney for support.