# Robot Framework GUI Debugger 🔧🧪
An interactive GUI-based debugger and retry tool for Robot Framework — built for **live test control, keyword retrying, and flexible keyword execution**.
✅ Compatible with both **SeleniumLibrary** and **AppiumLibrary**
✅ Works with **Robot Framework 6.x+**
✅ Designed to handle test failures **live** — no restart needed.
---
## ✨ Features
### 🚦 Failure Debugging
- Pops up automatically on test failure
- Edit arguments and retry failed keyword live
- Continue test execution if retry passes
- Skip test or abort suite via GUI
- Retry-safe, non-blocking design
### 🔧 Custom Keyword Execution (Better than rf-debugger)
- Select any imported library + keyword
- Auto-displays full signature and documentation
- Dynamically generates argument input fields
- Pre-fills default argument values
- Lets you remove/add arguments manually
- Hover tooltips for argument info
- Fully type-parsed input (e.g., `1` → int, `[1,2]` → list)
### 💻 GUI Features
- Log display panel with timestamped results
- Results from custom keyword runs are shown in the main log
- Clear log button
- Keyboard shortcut: `Ctrl+Enter` to run custom keyword
- Retry/skip/abort buttons always available
- Thread-safe execution (GUI won't freeze)
---
## 🖥️ Screenshots
_(Include screenshots here of retry tab, custom keyword tab, and result log)_
---
## 🛠️ Requirements
- **Python** 3.7+
- **Robot Framework** 6.0+
- **Tkinter** (usually built into Python; install separately on Linux with `sudo apt install python3-tk`)
Optional:
- `robotframework-seleniumlibrary` or `robotframework-appiumlibrary`, depending on your test type
---
## 🚀 Installation
This tool is a Robot Framework listener + GUI module.
1. Clone or download the repo.
2. Add the listener to your test command:
```bash
robot --listener path/to/SimpleRetryListener.py tests/
Raw data
{
"_id": null,
"home_page": "https://github.com/tsuri/simple-retry-listener",
"name": "simple-retry-listener",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "robotframework testing listener retry",
"author": "Suriya",
"author_email": "tsuriya321@gmail.com",
"download_url": null,
"platform": null,
"description": "# Robot Framework GUI Debugger \ud83d\udd27\ud83e\uddea\r\n\r\nAn interactive GUI-based debugger and retry tool for Robot Framework \u2014 built for **live test control, keyword retrying, and flexible keyword execution**.\r\n\r\n\u2705 Compatible with both **SeleniumLibrary** and **AppiumLibrary** \r\n\u2705 Works with **Robot Framework 6.x+** \r\n\u2705 Designed to handle test failures **live** \u2014 no restart needed.\r\n\r\n---\r\n\r\n## \u2728 Features\r\n\r\n### \ud83d\udea6 Failure Debugging\r\n- Pops up automatically on test failure\r\n- Edit arguments and retry failed keyword live\r\n- Continue test execution if retry passes\r\n- Skip test or abort suite via GUI\r\n- Retry-safe, non-blocking design\r\n\r\n### \ud83d\udd27 Custom Keyword Execution (Better than rf-debugger)\r\n- Select any imported library + keyword\r\n- Auto-displays full signature and documentation\r\n- Dynamically generates argument input fields\r\n- Pre-fills default argument values\r\n- Lets you remove/add arguments manually\r\n- Hover tooltips for argument info\r\n- Fully type-parsed input (e.g., `1` \u2192 int, `[1,2]` \u2192 list)\r\n\r\n### \ud83d\udcbb GUI Features\r\n- Log display panel with timestamped results\r\n- Results from custom keyword runs are shown in the main log\r\n- Clear log button\r\n- Keyboard shortcut: `Ctrl+Enter` to run custom keyword\r\n- Retry/skip/abort buttons always available\r\n- Thread-safe execution (GUI won't freeze)\r\n\r\n---\r\n\r\n## \ud83d\udda5\ufe0f Screenshots\r\n\r\n_(Include screenshots here of retry tab, custom keyword tab, and result log)_\r\n\r\n---\r\n\r\n## \ud83d\udee0\ufe0f Requirements\r\n\r\n- **Python** 3.7+\r\n- **Robot Framework** 6.0+\r\n- **Tkinter** (usually built into Python; install separately on Linux with `sudo apt install python3-tk`)\r\n\r\nOptional:\r\n- `robotframework-seleniumlibrary` or `robotframework-appiumlibrary`, depending on your test type\r\n\r\n---\r\n\r\n## \ud83d\ude80 Installation\r\n\r\nThis tool is a Robot Framework listener + GUI module.\r\n\r\n1. Clone or download the repo.\r\n2. Add the listener to your test command:\r\n\r\n```bash\r\nrobot --listener path/to/SimpleRetryListener.py tests/\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Robot Framework listener for interactive retry of failed keywords",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/tsuri/simple-retry-listener"
},
"split_keywords": [
"robotframework",
"testing",
"listener",
"retry"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "780296addb45d2e05437a3e0364c6cbe5c1ec4a30385957d56cab5339b19f9fe",
"md5": "2d25f39336f99a40141eebb9b6386241",
"sha256": "f9d91fed8c869ebca3408adf01511948624b927a42d3e50091d33539122c8ae1"
},
"downloads": -1,
"filename": "simple_retry_listener-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d25f39336f99a40141eebb9b6386241",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8652,
"upload_time": "2025-07-08T23:07:18",
"upload_time_iso_8601": "2025-07-08T23:07:18.822492Z",
"url": "https://files.pythonhosted.org/packages/78/02/96addb45d2e05437a3e0364c6cbe5c1ec4a30385957d56cab5339b19f9fe/simple_retry_listener-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-08 23:07:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tsuri",
"github_project": "simple-retry-listener",
"github_not_found": true,
"lcname": "simple-retry-listener"
}
JSON
