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
