| name | robotframework-results |
| description | Parse Robot Framework output.xml results into JSON summaries, detailed suite/test breakdowns, tag and criticality stats, execution errors, failed test messages, keyword-level errors, and timing. Use when asked to read/merge output.xml, compute pass/fail counts, tag stats, criticality, error messages, elapsed time, slowest tests/keywords, or combine/merge multiple outputs via rebot. |
Robot Framework Results
Use the bundled script to read Robot Framework output.xml and return JSON. It supports:
- summary totals
- detailed suite/test breakdowns
- tag statistics and criticality grouping
- execution errors, failed test messages, and keyword-level errors
- timing (keyword timing is opt-in)
- single or multiple outputs (merge or combine with rebot)
Quick start
Single file summary:
python scripts/rf_results.py --output output.xml --sections summary
Multiple outputs, merged (--merge replaces earlier results when tests overlap):
python scripts/rf_results.py --outputs out1.xml out2.xml --merge --sections summary,details
Multiple outputs, combined under a new top-level suite (no --merge):
python scripts/rf_results.py --outputs out1.xml out2.xml --name Combined --sections summary
Include keyword timing in timing output:
python scripts/rf_results.py --output output.xml --sections timing --include-keyword-timing
Output sections
summary: totals, suite/test counts, overall statusdetails: suites, tests, failed tests, tag stats, criticality statserrors: execution errors, failed test messages, keyword errorstiming: totals and slowest tests; keyword timing requires --include-keyword-timing
Notes
- Criticality grouping: prefer
test.critical when available; otherwise infer from tags critical, noncritical, or non-critical. If neither is set, group as unspecified.
- For multiple outputs, use
--merge to mirror rebot --merge behavior. Without --merge, rebot combines outputs under a new top-level suite (name via --name).
- JSON output is written to stdout. Use
--pretty for indented JSON.
