robotframework-jupyterlibrary

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

docs	demo	pipes

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

See the acceptance tests for examples.

Installation

TODO: release on pypi, conda-forge

Development Installation

• get Firefox

  • Chrome works, too, but more fickle

• get Miniconda3 (as in Python 3.6+)

• clone this repo...

  git clone https://github.com/bollwyvl/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:

• SeleniumLibrary (APL-2.0)
  • backport of Press Keys
• Jyve (BSD-3-Clause)
  • Initial implementations of robot keywords