Skip to main content

A JupyterLab extension to open notebooks from websites with just one click.

Project description


Pasarela is a Jupyterlab server extension that allows a user to open a Jupyter Notebook with pre-populated code provided either in base64 format or as the URL of an external publicly available notebook file.


Contents


Why?

Work in progress...


Installation

We are working on having a package in PyPi available. At the moment you can do the following:

pip install oss-pasarela

or

git clone https://github.com/Navteca/oss-pasarela.git
cd oss-pasarela/
npm install
python -m build
pip install oss_pasarela-<version>-py3-none-any

if the installation process runs successfully, check if the extension has been activated:
jupyter labextension list
jupyter serverextension list

If not, you might need to run:
jupyter labextension enable --py oss_pasarela
jupyter serverextension enable --py oss_pasarela

Usage

To use the extension on this system, you open a new window with a specially crafted URL as follows:

Base URL:

https://[jupyterhub_domain]/hub/user-redirect/pasarela/open

First, replace [jupyterhub_domain] with your JupyterHub domain.

Required Parameters (use only one):

code - the base64 encoded source code that will pre-populate a cell in a new notebook on this system

-or-

url - the URL of a publicly-accessible Jupyter notebook file, the contents of which will be opened in a new notebook on system

Optional Parameters:

kernel_name - the specific Notebook kernel on this system to use to open the new Notebook. If unspecified, Jupyterlab will ask you to select a kernel to use when you first open the notebook.

Open a Notebook with a base64 string code

The following URL will open a notebook and it will be pre-populated with the base64 decoded content provided. Jupyterlab will ask which kernel is to be used for the notebook

https://[jupyterhub_domain]/hub/user-redirect/pasarela/open?code=cHJpbnQoIkhlbGxvIFdvcmxkIik=

The following URL will open a notebook and it will be pre-populated with the base64 decoded content provided and will use the “python3” kernel.

https://[jupyterhub_domain]/hub/user-redirect/pasarela/open?code=cHJpbnQoIkhlbGxvIFdvcmxkIik=&kernel_name=python3

Open a Notebook with a URL

The following URL will open a notebook and it will be pre-populated with contents of the Jupyter notebook file at the specified URL. Jupyterlab will ask which kernel is to be used for the notebook

https://[jupyterhub_domain]/hub/user-redirect/pasarela/open?url=https://cdaweb.gsfc.nasa.gov/WebServices/REST/jupyter/CdasWsExampleXarray.ipynb


Current Status

We are in a very early stage in terms of all the features we want to add to the extension to be even with other extensions. Currently you can do the following:

  • Open a Notebook with a base64 string code
  • Open a Notebook with a URL

Want to contribute?

First of all, thank you for taking the time to contribute!

Do you find this extension useful, with potential to be great and you like writing code? Please, don't hesitate to contribute. There is so much to do from improving an already existing feature, implement a new one to fixing bugs, etc.

There are a couple ways you can contribute to the extension:

  • Opening issues: you can open an issue either to report a bug, request an enhancement, ask a question, suggest a new feature, etc.
  • Pull Requests: This would be awesome. We suggest you to open an issue or comment an issue before creating the Pull Request.

We are working on a contributor document and guidelines with additional information you might to work on the extension.


Found an issue? Have suggestions?

Please open an issue, we would like yo hear from you.


Licensing

BSD 3-Clause License


Notes for your consideration

  • This project is in early stage. We are continuously working on it to make it better.
  • This is one of our first extensions we put out there. We are aware we have so much to learn from the FLOSS communities and that is one of the reasons we why decided to publish it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oss_pasarela-0.1.6.tar.gz (698.6 kB view details)

Uploaded Source

Built Distribution

oss_pasarela-0.1.6-py3-none-any.whl (716.5 kB view details)

Uploaded Python 3

File details

Details for the file oss_pasarela-0.1.6.tar.gz.

File metadata

  • Download URL: oss_pasarela-0.1.6.tar.gz
  • Upload date:
  • Size: 698.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for oss_pasarela-0.1.6.tar.gz
Algorithm Hash digest
SHA256 99b2b7b07895771cbe310fbf2ffc4fc1adcb52faf0d456ee3edcc32e7cb13f1d
MD5 0050c7ae22f79bad1350929339503198
BLAKE2b-256 93fcf6470276278f38740493457b3848ebdad1f86bb3e8e43fa03aaa41fdb100

See more details on using hashes here.

File details

Details for the file oss_pasarela-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: oss_pasarela-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 716.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.10

File hashes

Hashes for oss_pasarela-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4eab9004c3ca55a9a9a2cf382034eca6df79325162a8eb78716d3d564b36bf00
MD5 f1bdd696a1487679d1a034e2139c7071
BLAKE2b-256 a4cedee5b0a965305081a18bccbeb4108149a59c324ddfc135f6598a87c9b4a8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page