A jupyter content manager for Girder
Project description
The Jupyter Notebook web application provides a graphical interface for creating, opening, renaming, and deleting files in a virtual filesystem. girder_jupyter is a python package that implements a contents manager to allow Girder to become a backend for this virtual filesystem. This allows notebooks and files to be stored in a Girder server from within Jupyter.
Getting Started
Install the package in the Python environment you are running your Jupyter server in:
pip install girder-jupyter
Add the following options to your jupyter_notebook_config.py
c.NotebookApp.contents_manager_class = 'girder_jupyter.contents.manager.GirderContentsManager'
c.GirderContentsManager.api_key = '<api key>'
c.GirderContentsManager.api_url = '<api url>'
Where <api key>
is replaced with a Girder API key for the Girder server and <api url>
is the URL to Girder instance you want
to use for example http://localhost:8080/api/v1.
Configuration Parameters
api_url
- An API URL for the Girder server. Defaults to ‘http://localhost:8080/api/v1’api_key
-A Girder API key key for the Girder server atapi_url
. The key should have read and write permission scope.token
- A Girder token for the Girder server atapi_url
. This parameter is particularly useful when running instances from JupyterHub.root
- The root in the Girder hierarchy to use as the content managers root. This path can include{login}
which will be replace with the current users login. Defaults to'user/{login}'
Note that either api_key
or token
must be provided for the contents manager to be able to
authenticate with the Girder server.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for girder-jupyter-0.2.2.dev1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e1e9fb2ed0794303f74167a90a037368f45991afa6f87b2d4541c554d794b14c |
|
MD5 | cd692bd2ff5f850fdca37916735c47ff |
|
BLAKE2b-256 | 954c2cc3377a4cec61ae1cec72e608d9ff0e777e3b5a529f37ca0f82e6801c04 |