Testing
Package
Meta

Importobot is a Python package for converting test case exports from Zephyr, TestRail, Xray, and TestLink into runnable Robot Framework suites. It was built to automate the tedious process of manually migrating large test libraries.

Recent Improvements:

• MongoDB Library Support: Fixed MongoDB library integration by replacing broken robotframework-mongodblibrary with modern robot-mongodb-library
• Type Safety: Enhanced type checking and fixed enum conversion issues
• Code Quality: Improved linting compliance and code organization

See the changelog for a full list of changes.

For end-users, install from PyPI:

pip install importobot

For developers contributing to the project, see the Project Setup instructions.

import importobot

# Convert a single file from Zephyr JSON to a Robot Framework file
converter = importobot.JsonToRobotConverter()
summary = converter.convert_file("zephyr_export.json", "output.robot")

# Convert an entire directory of exports
result = converter.convert_directory("./exports", "./converted")

All documentation is in the project wiki.

• Getting Started: Install the tool and run your first conversion.
• User Guide: See detailed examples and usage patterns.
• How to Navigate this Codebase: For developers who want to understand the architecture.

For questions and discussions, please use the GitHub issue tracker.

Contributions are welcome. Please see the Contributing Guide for more information.

BSD 2-Clause