robotframework-jupyterlibrary

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

pip	conda	docs	demo	actions

Using

Write .robot files that use JupyterLibrary keywords.

*** Settings ***
Library           JupyterLibrary
Suite Setup       Wait for New Jupyter Server to be Ready
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

or use magics in notebooks.

See the acceptance tests for examples.

Installation

pip install robotframework-jupyterlibrary

Or

conda install -c conda-forge robotframework-jupyterlibrary

Development Installation

• get Firefox

  • Chrome works, too, but more fickle

• get Miniforge (as in Python 3.6+)

• clone this repo...

  git clone https://github.com/robots-from-jupyter/robotframework-jupyterlibrary
  cd robotframework-jupyterlibrary
  

• update and activate...

  conda env update
  conda activate robotframework-jupyterlibrary
  

• then...

  pip install -e . --no-deps --ignore-installed
  

• run the tests...

  python -m scripts.atest
  

Free Software

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

• Jyve (BSD-3-Clause)
  • Initial implementations of robot keywords