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.3.dev4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ee89e9f13d2e87ccfda1b8f26dc98532d4082ed9fe184c892e19eef4d8ddc70 |
|
MD5 | 688eb1b2d5979877ade3e010d9881c4c |
|
BLAKE2b-256 | 7d95df2bdf2bef0967c64b39e0b0419b54efc5c938d3f06c23f1434f9b01d48e |