Robocop is a tool that performs static code analysis and formatting of Robot Framework code.
It uses official Robot Framework parsing API to parse files and runs number of checks, looking for potential errors or violations to code quality standards (commonly referred as linting issues).
Hosted on GitHub.
Full documentation is available here. 📖
Most common questions with answers can be found at the bottom ⬇ of this README file.
Python 3.9+ 🐍 and Robot Framework 4.0+ 🤖.
You can install the latest version of Robocop simply by running:
pip install -U robotframework-robocop Robocop runs by default from the current directory, and it discovers supported files recursively. To lint the files you can run:
robocop check To format the files you can run:
robocop format All command line options can be displayed in help message by executing:
robocop -h Executing command:
robocop check --report rules_by_error_type test.robot Will result in the following output:
test.robot:17:1 SPC22 Not enough whitespace after 'Test Teardown' setting | 15 | 16 | Test Setup Keyword 17 | Test Teardown Keyword2 | ^ SPC22 18 | Testtimeout 1min 19 | Documentation this is doc | test.robot:28:1 SPC14 Variable in Variables section is not left aligned | 1 | *** Variables *** 2 | ${VAR} 1 3 | ${VAR} 1 | ^ SPC14 4 | ${VAR} 1 5 | VALUE 1 Found 2 issues: 2 ERRORs, 0 WARNINGs, 0 INFO. Original RoboCop - a fictional cybernetic police officer 👮♂️ - was following 3 prime directives which also drive the progress of Robocop linter:
First Directive: Serve the public trust 👨👩👧👦
Which lies behind the creation of the project - to serve developers and testers as a tool to build applications they can trust.
Second Directive: Protect the innocent 👶
The innocent testers and developers have no intention to produce ugly code but sometimes, you know, it just happens, so Robocop is there to protect them.
Third Directive: Uphold the law 🏛️
Following the coding guidelines established in the project are something very important to keep the code clean, readable and understandable by others and Robocop can help to uphold the law.
Can I integrate Robocop with my code editor (IDE)?
Yes, Robocop integrates nicely with popular IDEs like PyCharm or VSCode thanks to RobotCode plugin. Read simple manual (README) in that project to figure out how to install & use it.
Can I load configuration from file?
Yes, you can use toml-based configuration files:
pyproject.toml file robocop.toml file robot.toml file
Example configuration file:
[tool.robocop] exclude = ["deprecated.robot"] [tool.robocop.lint] select = [ "rulename", "ruleid" ] configure = [ "line-too-long.line_length=110" ] [tool.robocop.format] select = ["NormalizeNewLines"] configure = [ "NormalizeNewLines.flatten_lines=True" ]Multiple configuration files are supported. However, global-like options such as --verbose or --reports are only loaded from top configuration file. Read more in configuration.
I use different coding standards. Can I configure rules so that they fit my needs?
Yes, some rules and formatters are configurable. You can find the configuration details in the documentation or by running:
robocop docs rule_name_or_id robocop docs formatter_name Configuring is done by using -c / --configure command line option followed by pattern <name>.<param_name>=<value> where:
<name>can either be rule name or its id, or formatter name<param_name>is a public name of the parameter<value>is a desired value of the parameter
For example:
robocop check --configure line-too-long.line_length=140 Each rule's severity can also be overwritten. Possible values are e/error, w/warning or i/info and are case-insensitive. Example:
robocop check -c too-long-test-case.severity=e If there are special cases in your code that violate the rules, you can also exclude them in the source code.
Example:
Keyword with lowercased name # robocop: off More about it in our documentation.
Can I define custom rules?
Yes, you can define and include custom rules using --custom-rules command line option by providing a path to a file containing your rule(s):
robocop --custom-rules my/own/rule.py --custom-rules rules.py,external_rules.py If you feel that your rule is very helpful and should be included in Robocop permanently, you can always share your solution by submitting a pull request. You can also share your idea by creating an issue.
More about custom rules with code examples in our documentation.
Can I use Robocop in continuous integration (CI) tools?
Yes, Robocop is able to produce different kinds of reports that are supported by most popular platforms such as GitHub, Gitlab, Sonar Qube etc. Read more in reports.
Excuse me, I have to go. Somewhere there is a crime happening. - Robocop
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
