{"id":6861,"library":"robotframework-tidy","title":"Robot Framework Tidy","description":"Robotidy is an autoformatter for Robot Framework code, serving as the spiritual successor to Robot Framework's built-in `robot.tidy` tool. Currently at version 4.18.0, it aims to standardize code appearance across projects. While it receives regular updates, the standalone version has been deprecated since 4.17.0 in favor of its integration into Robocop 6.0+.","status":"deprecated","version":"4.18.0","language":"en","source_language":"en","source_url":"https://github.com/MarketSquare/robotframework-tidy","tags":["robot framework","formatter","linter","code quality"],"install":[{"cmd":"pip install robotframework-tidy","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Core dependency for parsing and formatting Robot Framework code.","package":"Robot Framework","optional":false},{"reason":"Command-line interface toolkit.","package":"click","optional":false},{"reason":"Enhanced command-line interface formatting.","package":"rich-click","optional":false},{"reason":"TOML parser for configuration files (Python < 3.11).","package":"tomli","optional":false},{"reason":"TOML writer for configuration files.","package":"tomli-w","optional":false}],"imports":[],"quickstart":{"code":"robotidy .","lang":"bash","description":"Formats all Robot Framework files recursively in the current directory, overwriting them. For specific files or directories, replace '.' with the target paths (e.g., `robotidy tests/ test.robot`)."},"warnings":[{"fix":"Migrate to `robotframework-robocop` and use its `robocop format` command. Install with `pip install robotframework-robocop`.","message":"The standalone `robotframework-tidy` tool is deprecated since version 4.17.0. New users and projects are strongly encouraged to use the formatter built into `robotframework-robocop` (version 6.0+). The standalone version may not support the latest Robot Framework features or receive active development in the future.","severity":"deprecated","affected_versions":">=4.17.0"},{"fix":"For best compatibility with the latest Robot Framework versions, use the `robocop format` command from `robotframework-robocop`.","message":"Although `robotframework-tidy` dependencies are now 'opened up' to allow installation with newer Robot Framework versions, the standalone tool's compatibility with very recent Robot Framework releases (especially post-RF 7.0) is not guaranteed due to its deprecated status.","severity":"gotcha","affected_versions":">=4.17.0"},{"fix":"Include `robotidy --check .` in your CI pipeline instead of just `robotidy .`.","message":"When running Robotidy in Continuous Integration (CI) pipelines, it's crucial to use the `--check` flag. This flag makes Robotidy return a non-zero exit code if any files would have been modified, preventing unformatted code from being merged.","severity":"gotcha","affected_versions":"All"},{"fix":"Ensure your `robotframework-tidy` version is compatible with your target Robot Framework version, especially when using transformers that update to newer syntax. Consider upgrading Robot Framework to 7.0+ if using `VAR` or `GROUP` features.","message":"Older Robot Framework versions (e.g., 4.x and below) do not support modern syntax elements like `BREAK`, `RETURN`, or the `VAR` statement. While `robotframework-tidy` versions 4.10.0+ added support for `VAR` syntax and 4.16.0+ for `GROUP`s (for Robot Framework 7.0+), applying such transformations on older Robot Framework installations will lead to syntax errors.","severity":"gotcha","affected_versions":"<4.10.0 for VAR, <4.16.0 for GROUPs"}],"env_vars":null,"last_verified":"2026-04-15T00:00:00.000Z","next_check":"2026-07-14T00:00:00.000Z","problems":[]}