Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jupyterlab/jupyterlab-google-drive
Cloud storage for JupyterLab using Google Drive
https://github.com/jupyterlab/jupyterlab-google-drive
google-drive jupyterlab jupyterlab-extension
Last synced: 5 days ago
JSON representation
Cloud storage for JupyterLab using Google Drive
- Host: GitHub
- URL: https://github.com/jupyterlab/jupyterlab-google-drive
- Owner: jupyterlab
- License: bsd-3-clause
- Archived: true
- Created: 2016-12-17T01:40:45.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-08-03T16:55:22.000Z (over 1 year ago)
- Last Synced: 2024-10-29T05:05:27.224Z (14 days ago)
- Topics: google-drive, jupyterlab, jupyterlab-extension
- Language: TypeScript
- Homepage:
- Size: 2.48 MB
- Stars: 400
- Watchers: 33
- Forks: 76
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-jupyter-resources - GitHub - 33% open · ⏱️ 28.04.2022): (JupyterLab扩展)
- best-of-jupyter - GitHub - 33% open · ⏱️ 03.08.2023): (JupyterLab Extensions)
README
**This project has been archived by lack of maintainers.**
# jupyterlab-google-drive
[](https://travis-ci.org/jupyterlab/jupyterlab-google-drive)
## Cloud storage for JupyterLab through Google Drive.
**NOTE: this is beta software and is rapidly changing.**
This extension adds a Google Drive file browser to the left sidebar of JupyterLab.
When you are logged into your Google account, you will have the
files stored in your GDrive available to JupyterLab.
If you run into trouble, see if the [troubleshooting guide](docs/troubleshooting.md) has a solution for you.
## Prerequisites
- JupyterLab 1.x / 2.x
- A Google Drive account
## Setting up credentials with Google
To run this extension you need to authenticate your JupyterLab deployment
(whether institutional or individual) with Google.
In order to identify yourself to Google, you will need to register a web application
with their Developers Console.
Detailed instructions for setting up your application credentials can be found in
[setup.md](docs/setup.md).
## Installation
To install this extension into JupyterLab (requires node 6 or later), do the following:
```bash
jupyter labextension install @jupyterlab/google-drive
```
## Development
For a development install, do the following in the repository directory:
```bash
jlpm install
jlpm run build
jupyter labextension install .
```
You can then run JupyterLab in watch mode to automatically pick up changes to `@jupyterlab/google-drive`.
Open a terminal in the `@jupyterlab/google-drive` repository directory and enter
```bash
jlpm run watch
```
Then launch JupyterLab using
```bash
jupyter lab --watch
```
This will automatically recompile `@jupyterlab/google-drive` upon changes,
and JupyterLab will rebuild itself. You should then be able to refresh the
page and see your changes.
## Getting Started from Scratch
- Install JupyterLab
```
pip install jupyterlab
```
- Install the jupyterlab-google-drive extension
```
jupyter labextension install @jupyterlab/google-drive
```
- Set up your application credentials according to [this](docs/setup.md) guide.
- Start JupyterLab
```
jupyter lab
```
- Click on the Google Drive tab in the left sidebar in the JupyterLab interface
and log in to your Google Drive account.
- Have someone share a notebook or markdown file with you.
- You should now see the file in the **Shared with Me** folder in the file browser.
Double-click to open the file and begin editing!
### Using Zero to JupyterHub (Z2JH)
When using Zero to JupyterHub to deploy a containerized environment, you can minimize the need to sign into JupyterHub and Google Drive. If you are using Google OAuth to autenticate users for JupyterHub, you can simply add the additional scopes to to the `auth` block:
```
auth:
type: google
google:
callbackUrl: "/hub/oauth_callback"
scopes:
- "openid"
- "email"
- "https://www.googleapis.com/auth/drive"
```