A Google Drive extension for Jupyter notebook. Automatically creates a sync directory for the user on Google Drive and autosyncs their files every 24 hours. Adds a button to allow users to sync whenever they need to.
You can currently install this directly from git:
pip install git+https://github.com/data-8/nbgdrive.git
jupyter serverextension enable --py nbgdrive
jupyter nbextension install --py nbgdrive
To enable this extension for all notebooks:
jupyter nbextension enable --py nbgdrive
Once correctly installed, you can login with Google Drive in order to grant nbgdrive the required permissions to run.
You will be redirected to a new page where you will be given a verification code to insert back in a text field in the Jupyter Notebook, as shown below:
Once you are successfully logged in, you will be able to Sync manually by pressing the cloud button. Otherwise, nbgdrive will sync your directory automatically whenever you haven't synched in the past 24 hours.
Synching will create a sync folder in the main directory of your Google Drive, and upstream sync to it the contents of the Jupyter Notebook directory /home/jovyan. As this tool was created with UC Berkeley's Data 8 class in mind, the default folder structure will be named data8/$JPY_USER.
Tampering with the contents or location of the sync folder will cause nbgdrive to break. To fix any such issue, it's recommended to log out (through the logout button next to the sync button), and reauthenticate Google Drive.
There are a few dependencies required for this repository to function currectly. Underlying nbgdrive is a Google Drive CLI. You must install and give this tool proper access before using nbgdrive. Please ensure this tool exists on your $PATH, by putting in the default /usr/bin or by modifying your bash_profile.
Additionally, there are Selenium tests located in the tests subdirectory. To run these tests, first pip install selenium. Depending on what browsers you'd like to test for, you will also need to download some drivers and place them in your /usr/bin directory.
This project was worked on in close collaboration with Cal Blueprint. Cal Blueprint is a student-run UC Berkeley organization devoted to matching the skills of its members to our desire to see social good enacted in our community. Each semester, teams of 4-5 students work closely with a non-profit to bring technological solutions to the problems they face every day.