Skip to main content

A Jupyter kernel for interactive acceptance-test-driven development with the Robot Framework

Project description

Robotkernel

Smoketest Badge

RobotKernel is a Robot Framework IPython kernel for Jupyter Notebook and JupyterLab. It powers RobotLab – the Robot Framework JupyterLab distribution. Check a video to see it in action and read the documentation.

RobotKernel requires Python 3.6 or later with setuptools 40.5.0 later and Robot Framework Robot Framework 3.1 or later.

For alternative Robot Framework IPython kernel, check out ipythonrobotframework or xeus-robot.

Try RobotKernel

You can try RobotKernel instantly without installing it at MyBinder cloud:

Note: Log | Report -links on saved notebooks may not be clickable until notebook is “trusted” (“Trust Notebook” in JupyterLab Commands) the related cells have been executed again.

Install RobotKernel

RobotKernel can be installed using the usual Python package manager tools, like pip:

$ pip install robotkernel

For JupyterLab it is recommended to also install the Robot Framework syntax highlighting and Jupyter widgets support:

$ jupyter labextension install jupyterlab_robotmode
$ jupyter labextension install @jupyter-widgets/jupyterlab-manager

For some environments it might be required to run the following command to manually register robotkernel as an available Jupyter kernel:

$ python -m robotkernel.install

Export to .robot

It is possible to export Robot Framework Jupyter notebooks to regular plain text .robot files for usage without Jupyter:

$ jupyter nbconvert --to script example.ipynb

Execute notebooks

RobotKernel installs a script named nbrobot. It can be used instead of Robot Framework’s robot test runner to execute Robot Framework with .ipynb-extension support:

$ nbrobot example.ipynb

Hacking RobotKernel

Create and activate a new Python virtual environment:

$ venv myenv
$ source myenv/bin/activate

Install Jupyter:

$ pip install --upgrade pip setuptools
$ pip install jupyter

Clone this kernel:

$ git clone https://github.com/robots-from-jupyter/robotkernel.git
$ cd robotkernel

Install the kernel into the virtualenv in develop mode:

$ python setup.py develop
$ python -m robotkernel.install

Launch the jupyter:

$ jupyter notebook

Reloading the kernel reloads the code.

Learn more about Jupyter kernel development.

Nix-shell

This repository includes an opinionated environment for running and developing RobotKernel with Nix with Cachix-powered binary cache.

Launch Jupyter Notebook with RobotKernel:

$ nix-shell -E 'import (fetchTarball https://github.com/robots-from-jupyter/robotkernel/archive/master.tar.gz + "/shell.nix")' --run "jupyter notebook"

Launch JupyterLab with RobotKernel:

$ nix-shell -E 'import (fetchTarball https://github.com/robots-from-jupyter/robotkernel/archive/master.tar.gz + "/shell.nix")'
$ jupyter labextension install jupyterlab_robotmode --app-dir=.jupyterlab
$ jupyter lab --app-dir=.jupyterlab
$ exit

Add --arg vim true to enable vim bindings.

Open development environment with Nix:

$ git clone https://github.com/robots-from-jupyter/robotkernel.git
$ cd robotkernel
$ nix-build setup.nix -A env  # to generate ./result/bin/python for IDE
$ nix-shell setup.nix -A develop

Changelog

1.6rc3 (2022-09-23)

  • Add support for robotframework==5.1b2 [Asko Soukka]

1.6rc2 (2022-09-22)

  • Fix issue where multiple keyword buttons did not work as expected on ipywidgets >= 8 [datakurre]

  • Update Selenium helpers to current Selenium API [RomaCZ]

1.6rc1 (2022-04-07)

  • Fix support for ipywidgets >= 8.0.0rc0 [datakurre]

  • Update classic Notebook mode with Robot Framework 5 features [bollwyvl, datakurre]

  • Add pyolite support [datakurre]

  • Add %sticky magic LibraryName -magic to optionally preserve state of global and suite scope libraries between executions [datakurre]

1.5.1 (2021-09-28)

  • Fix set_parent signature [martinRenou]

1.5.0 (2021-04-22)

  • Add support for robotframework 4.0 [datakurre]

1.4.0 (2020-04-27)

  • Add support for robotframework 3.2 [datakurre]

  • Change kernel mimetype to “text/x-robotframework” [datakurre]

1.3.0 (2020-01-09)

  • Add jupyterlab-starters’ based quick start and tutorial [datakurre]

  • Fix issue where Selenium test or task execution resulted in breaking exception, because temporary execution directory could not be cleared due to open geckodriver.log [datakurre]

1.2.2 (2020-01-05)

  • Fix regression where wrong nbimporter was not automatically imported [datakurre]

1.2.1 (2019-12-30)

  • Fix issue where data uri images were not displayed on notebook [datakurre]

  • Fix issue where list type suite variables were not correctly restored [datakurre]

1.2 (2019-12-06)

  • Add support for Robot Framework 3.2a1 [datakurre]

  • Add support for displaying multiline text return values [datakurre]

  • Add support for sticky JupyterLibrary webdriver connections [datakurre]

  • Fix issue where updated global variables were overridden from saved variables from the previous execution [datakurre]

1.1.1 (2019-12-05)

  • Fix issue where library autocompletion override settings keywords autocompletion [datakurre]

1.1.0 (2019-12-05)

  • Add Library autocompletion after Library keyword within Settings [datakurre]

1.0.2 (2019-12-04)

  • Fix issue where text strings feed to JSON displayed a warning [datakurre]

  • Fix JupyterLab context help support to work when clicked in the middlle of a keyword [datakurre]

  • Fix to close dangling Selenium connections [datakurre]

1.0.1 (2019-09-19)

  • Fix issue where ${CURDIR} was broken on Windows, because it contained path without escaped path separators required by Robot Framework [datakurre]

  • Fix issue where suite variable listener reported errors when running robot suites, because it tried to restore dictionary variables with empty value [datakurre]

1.0 (2019-09-12)

  • Fix issue where log and report links did not open on JupyterLab 1.0 [datakurre]

1.0rc1 (2019-04-01)

  • Move tutorials notebooks into notebooks folder [datakurre]

  • Fix WhiteLibrary autocompletion to suggest selectors with :-separator instead of =-separator [datakurre]

0.12.2 (2019-03-30)

  • Fix remaining where keeping state of suite level variables between cell executions since 0.12.0 caused regression by fixing the listener to ignore all known built-in variables [datakurre]

0.12.1 (2019-03-27)

  • Fix issue where keeping state of suite level variables between cell executions resulted in errors caused by outdated output directory from the old variables [datakurre]

0.12.0 (2019-03-26)

New features:

  • Add keyword execution widgets below executed keyword cells; Add to toggle widgets on consecutive executions without code changes [datakurre]

  • Add listener to keep state of suite level variables between robot executions [datakurre]

  • Add IPython display hooks [datakurre]

New features:

  • Add updates to highlighting from ipythonrobotframework [datakurre]

0.11.0 (2019-01-29)

  • Add WhiteLibrary state support and interactive element picker [datakurre]

  • Add WhiteLibraryCompanion keyword library to interactively select elements and click elements with OpenCV templates [datakurre]

0.10.2 (2019-01-11)

  • Fix syntax highlighting issue where only the first variable of many was highlighted [datakurre]

0.10.1 (2019-01-10)

  • Update package trove classifiers [datakurre]

0.10.0 (2019-01-08)

Breaking:

  • Setuptools 40.5.0 later and Robot Framework 3.1 or later. [datakurre]

new features:

  • Add pregenerated kernel.json in data_files to auto-install robotkernel, but requiring [datakurre]

0.9.0 (2019-01-04)

New features:

  • Rewrite status updater to the status of currently run test as trobber | test name | keyword name | robot.api.logger.console message [datakurre]

  • Add embedded log and report to include Download-links at top right corner [datakurre]

  • Add to display the results of the last executed keyword as the notebook result for the executed code cell [datakurre]

  • Add syntax highlighting for variables and assignment operators [datakurre]

Bug fixes:

  • Fix issue where setup.cfg contained OS specific path separators preventing build on Windows [datakurre]

  • Fix issue where PNGs were interpreted as APNG on Windows preventing them from being rendered on Windows [datakurre]

  • Update example notebook to use SeleniumLibrary and SeleniumScreenshots instead of SeleniumLibrary and Selenium2Screenshots [datakurre]

  • Add to always reload libraries imported from other notebooks [datakurre]

0.8.0 (2018-12-14)

  • Add to auto-import nbimporter when available to make it possible to import eg. keyword libraries from Python notebooks [datakurre]

  • Fix issue where nbrobot did support %%python module magic [datakurre]

0.7.1 (2018-11-20)

  • Add to require robotframework >= 3.1b1 in requires

0.7.0 (2018-10-31)

Breaking:

  • Requires robotframework >= 3.1b1

Other:

  • Add to create nbreader and nblibdoc cli to run robot with notebook reader support [datakurre]

  • Add Selenium completions to sometimes include raw Simmer results with simplfied id completion results [datakurre]

  • Add proof-of-concept selector completion for Appium and AutoIT libraries [datakurre]

  • Fix screenshot processor to also discover images with absolute path or within the current working directory [datakurre]

0.6.3 (2018-10-19)

This is the last release compatible with robotframework < 3.1

  • Remove deprecated replace-flag from kernel installer [datakurre]

0.6.2 (2018-10-19)

  • Fix compatibility issue with robotframework < 3.1 [datakurre]

0.6.1 (2018-10-19)

  • Fix issue where kernel installation produced broken kernel.json on Windows [datakurre]

0.6.0 (2018-10-18)

  • Revert data source path from temporary directory into current working directory to allow local libraries and resources work in the usual use cases [datakurre]

  • Add experimental Simmerjs based CSS-selector builder and element picker with when auto-completion is called with empty “css:”-selector [datakurre]

  • Add experimental Selenium selector auto-completion [datakurre]

  • Add dummy variable completion with only variables from current suite without context knowledge [datakurre]

  • Add inline documentation links to Robot Framework User Guide for structural keywords [datakurre]

0.5.4 (2018-10-09)

  • Fix issue where single term keywords got no completions [datakurre]

0.5.3 (2018-10-09)

  • Update README [datakurre]

0.5.1 (2018-10-08)

  • Auto completion and keyword doc inspection enhancements [datakurre]

0.5.0 (2018-10-08)

  • Add auto-completion, keyword doc inspection and support for replacing and deleting cell history on Jupyter lab [datakurre]

0.4.0 (2018-09-26)

  • Add support for robotframework 3.1a2 [datakurre]

  • Add support for reporting RPA suites with “Tasks” instead of “Tests” [datakurre]

0.3.5 (2018-09-25)

  • Update README with notebook execution instructions [datakurre]

0.3.4 (2018-09-25)

  • Update README [datakurre]

0.3.3 (2018-09-25)

  • Note on README that Log | Report -links require trusting the notebook [datakurre]

  • Fix to wrap test execution updates with ‘<pre>’ for better readability [datakurre]

0.3.2 (2018-09-25)

  • Change to always send display data updates in text/html to workaround a bug that caused ‘undefined’ to be rendered in JupyterLab [datakurre]

0.3.1 (2018-09-24)

  • Update README [datakurre]

0.3.0 (2018-09-23)

  • First release. [datakurre]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robotkernel-1.6rc3.tar.gz (11.7 MB view hashes)

Uploaded Source

Built Distribution

robotkernel-1.6rc3-py3-none-any.whl (4.2 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page