This directory contains schema definitions for various Robot Framework and Libdoc output files.
Only the latest schema versions are directly available and they may not be compatible with older Robot Framework versions. If you need to access old schema files, switch to an appropriate version control tag using the selector at the top of the page.
- result.xsd - XML result (output.xml) schema in XSD format.
- result.json - JSON result (output.json) schema in JSON Schema format.
- result_suite.json - JSON Schema for
robot.result.TestSuite. - running_suite.json - JSON Schema for
robot.running.TestSuite. - libdoc.xsd - Libdoc XML spec schema in XSD format.
- libdoc.json - Libdoc JSON spec schema in JSON Schema format.
XML schema definitions use XSD 1.0 due to XSD 1.1 not being widely adopted. Schema files themselves contain embedded documentation and comments explaining the structure in more detail. They also contain instructions how to make them XSD 1.1 compatible if needed.
JSON schemas use JSON Schema Draft 2020-12.
XSD schemas are created by hand and updates need to be done directly to them.
JSON schemas are generated based on models created using pydantic. To modify these schemas, first update the appropriate pydantic model either in running_json_schema.py, result_json_schema.py, or libdoc_json_schema.py and then execute that file to regenerate the actual schema files.
Schema definitions are tested as part of acceptance test runs by validating created outputs against the appropriate schemas. Most output.xml files created during test runs are not validated, however, because that would slow down test execution a bit too much. Full validation can be enabled separately and that should be done if the schema is updated or output.xml structure is changed.