RobotFramework debug shell
Project description
Introduction
This Library is a Fork by René Rohner from the original robotframework-debuglibrary by Xie Yanbo
Robotframework-RobotDebug is a debug library for RobotFramework, which can be used as an interactive shell(REPL) also.
Installation
To install using pip:
pip install robotframework-debug
Usage
You can use this as a library, import RobotDebug and call Debug keyword in your test files like this:
*** Settings *** Library RobotDebug ** test case ** SOME TEST # some keywords... Debug # some else... ${count} = Get Element Count name:div_name
Or you can run it standalone as a RobotFramework shell:
$ irobot [...snap...] >>>>> Enter interactive shell > help Input Robotframework keywords, or commands listed below. Use "libs" or "l" to see available libraries, use "keywords" or "k" to see the list of library keywords, use the TAB keyboard key to autocomplete keywords. Documented commands (type help <topic>): ======================================== EOF continue docs help keywords libs ll n pdb selenium c d exit k l list longlist next s step > log hello > get time < '2011-10-13 18:50:31' > # use TAB to auto complete commands > BuiltIn.Get Time < '2011-10-13 18:50:39' > import library String > get substring helloworld 5 8 < 'wor' > # define variables as you wish > ${secs} = Get Time epoch # ${secs} = 1474814470 > Log to console ${secs} 1474814470 > @{list} = Create List hello world # @{list} = ['hello', 'world'] > Log to console ${list} ['hello', 'world'] > &{dict} = Create Dictionary name=admin email=admin@test.local # &{dict} = {'name': 'admin', 'email': 'admin@test.local'} > Log ${dict.name} > # print value if you input variable name only > ${list} [u'hello', u'world'] > ${dict.name} admin > exit >>>>> Exit shell.
The interactive shell support auto-completion for robotframework keywords and commands. Try input BuiltIn. then hit Control + Space key to feeling it.
The history will save at ~/.rfdebug_history default or any file defined in environment variable RFDEBUG_HISTORY.
In case you don’t remember the name of keyword during using irobot, there are commands libs or ls to list the imported libraries and built-in libraries, and keywords <lib name> or k to list keywords of a library.
irobot accept any robot arguments, but by default, rfdebug disabled all logs with -l None -x None -o None -L None -r None.
Step debugging
RobotDebug support step debugging since version 2.1.0. You can use step/s, next/n, continue/c, list/l and longlist/ll to trace and view the code step by step like in pdb:
$ robot some.robot [...snap...] >>>>> Enter interactive shell > l Please run `step` or `next` command first. > s .> /Users/xyb/some.robot(7) -> log to console hello => BuiltIn.Log To Console hello > l 2 Library RobotDebug 3 4 ** test case ** 5 test 6 debug 7 -> log to console hello 8 log to console world > n hello .> /Users/xyb/some.robot(8) -> log to console world => BuiltIn.Log To Console world > c >>>>> Exit shell. world
Note: Single-step debugging does not support FOR loops currently.
Submitting issues
Bugs and enhancements are tracked in the issue tracker.
Before submitting a new issue, it is always a good idea to check is the same bug or enhancement already reported. If it is, please add your comments to the existing issue instead of creating a new one.
Development
If you want to develop and run RobotDebug locally, you can use
$ python RobotDebug/shell.py tests/step.robot
shell.py is calling robot through a child process, so it will interrupt python debugging capabilities. If you want to debug in tools like vscode, pdb, you should run
$ python -m robot tests/step.robot
If you want to run the test, please install the dependency packages first and then execute the test
$ python setup.py develop $ python setup.py test
Since RF takes over stdout, debugging information can be output with
import sys print('some information', file=sys.stdout)
License
This software is licensed under the New BSD License. See the LICENSE file in the top distribution directory for the full license text.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file robotframework-debug-4.5.0.tar.gz
.
File metadata
- Download URL: robotframework-debug-4.5.0.tar.gz
- Upload date:
- Size: 31.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 925d830cd7c17d578d9822bfb969147d153da057369e31a17e205144a368e8a4 |
|
MD5 | ad49d7fbf99d17748444a0c832fb96bd |
|
BLAKE2b-256 | 33c980ca51bc6528c4255e3a62846879d5b14e305b2c68ad49bba75a7ac23a04 |
File details
Details for the file robotframework_debug-4.5.0-py3-none-any.whl
.
File metadata
- Download URL: robotframework_debug-4.5.0-py3-none-any.whl
- Upload date:
- Size: 27.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7591c3418016a0356158c43e47548a9e9c4ca1ac51b33d7267fccf4153c0952e |
|
MD5 | ef72bf2b2803fa7866efc303e8b6f403 |
|
BLAKE2b-256 | 15a926171e61d8e2315c8c59a12206b6a4e5a313fcb834f186b2c9c3267ba47c |