robotframework-jupyterlibrary#

A Robot Framework library for automating (testing of) Jupyter end-user applications and extensions

pip

conda

docs

demo

actions

pip-badge

conda-forge-badge

docs-badge

binder-badge

workflow-badge

Using#

Write .robot files that use JupyterLibrary keywords… or use magics in notebooks.

*** Settings ***
Library           JupyterLibrary
Suite Setup       Wait For New Jupyter Server To Be Ready  jupyter-lab
Test Teardown     Reset JupyterLab And Close
Suite Teardown    Terminate All Jupyter Servers

*** Test Cases ***
A Notebook in JupyterLab
    Open JupyterLab
    Launch A New JupyterLab Document
    Add And Run JupyterLab Code Cell
    Wait Until JupyterLab Kernel Is Idle
    Capture Page Screenshot

See the acceptance tests for examples.

Installation#

pip install robotframework-jupyterlibrary

Or

mamba install -c conda-forge robotframework-jupyterlibrary

Or (if you must):

conda install -c conda-forge robotframework-jupyterlibrary

Or see the contributing guide for a development install.

Free Software#

JupyterLibrary is Free Software under the BSD-3-Clause License. It contains code from a number of other projects:

Some of its testing approaches (only distribtued in source form, not e.g. wheels) are also derived from other tools:

Documentation Contents#