Skip to content

robots-from-jupyter/robotframework-jupyterlibrary

Repository files navigation

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: