robotframework-jupyterlibrary

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

pip	conda	docs	demo	pipes
	TODO			![worfklow-badge]

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

pip install robotframework-jupyterlibrary

Or

conda install -c conda-forge robotframework-jupyterlibrary

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/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