Skip to main content
https://img.shields.io/pypi/v/yason.svg https://img.shields.io/travis/com/ktaletsk/yason.svg Documentation Status Updates

yason: Jupyter Notebook Scheduler for Argo

logo

JupyterHub deployed on Kubernetes allows teams to do data analysis in the browser and efficiently share computational resources. But when it comes to Jupyter Notebooks, it is not easy to run them remotely and non-interactively or schedule them. Fortunately, with Papermill and Argo Workflows it is now possible to do just that. Yason is Python package and CLI for scheduling the remote execution of Jupyter Notebooks.

Features

  • Check the status of all scheduled notebook jobs

  • Schedule a notebook for execution

  • Get resulting notebook after execution

  • Delete scheduled notebook job

Coming soon

  • Including multiple files/folders together with Notebook for execution

  • Integration with Argo events for scheduling

Prerequisites

Yason is intended to run on JupyterLab pods spawned by JupyterHub deployed on Kubernetes. Yason also requires Argo Workflows to be deployed on the same cluster in the namespace argo. S3 bucket is required for intermediate storage of Notebooks before and after their execution.

See more details and instructions in the full documentation https://yason.readthedocs.io

Usage

To use Yason in Python project:

from yason import yason

CLI Tool

To use Yason as CLI tool, type:

yason COMMAND [ARGS]

To see the list of all scheduled Notebooks for your JupyterHub username, type:

yason list

To schedule and execute Notebook immediately, type:

yason run <Notebook Name>.ipynb

To get the resulting Notebook after execution, type:

yason get <Workflow ID> <Destination>

i.e.:

yason get 25fe9753bc854148aac26ff7d97ba128 My_Notebook_result.ipynb

To delete the scheduled Notebook from your list, type:

yason delete <Workflow ID>

i.e.:

yason delete 25fe9753bc854148aac26ff7d97ba128

Name

Yason (or Jason) in Greek mythology is the leader of Argonauts. Yason brings your Jupyter Notebooks on board of Argo (Workflows).

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2019-05-22)

  • First release on PyPI.

Release files for yason 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for yason 0.1.4
File Size Uploaded
yason-0.1.4.tar.gz 12.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for yason 0.1.4
File Interpreter ABI Platform
yason-0.1.4-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 19.9 kB

Release files / yason-0.1.4.tar.gz

Download URL yason-0.1.4.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c05dda6856a24e915174885d0479ae0436c467ecc107484e3771d9ea8ab74c7f
BLAKE2b-256 checksum
How to use checksums
4708a372b0724164b9ad7d11e342bb8d9f1763cf0f753a752ba3dfe68075e835
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.3

Release files / yason-0.1.4-py2.py3-none-any.whl

Download URL yason-0.1.4-py2.py3-none-any.whl
Size 7.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
0b0da6074efa6f8b97a067cba74f03f3d0dd76a56b6115957a2673b6cb88870e
BLAKE2b-256 checksum
How to use checksums
52bde55871f1b0abf8246c2c6bacba27f9117a7cca753bb3e359424d09241b99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.3

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files

0.1.3

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page