---
<img style="float:right" src="https://raw.githubusercontent.com/MarketSquare/robotframework-tidy/main/docs/source/_static/robotidy_logo_small.png">
Robotidy
===============
- [Introduction](#introduction)
- [Documentation](#documentation)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Example](#example)
Introduction <a name="introduction"></a>
------------
Robotidy is a tool for autoformatting Robot Framework code.
It is spiritual descendant of Robot Framework's internal robot.tidy package.
Documentation <a name="documentation"></a>
-------------
Full documentation available [here](https://robotidy.readthedocs.io). :open_book:
Requirements <a name="requirements"></a>
------------
Python 3.8+ :snake: and Robot Framework 4.0.0+ :robot:.
Installation <a name="installation"></a>
------------
You can install Robotidy simply by running:
```
pip install -U robotframework-tidy
```
Usage <a name="usage"></a>
-----
Call robotidy with path(s) to file/directory with robot files:
```
robotidy tests
robotidy test.robot
robotidy tests/resources test.robot
```
All command line options can be displayed in help message by executing:
```
robotidy --help
```
See [documentation](https://robotidy.readthedocs.io/en/latest/configuration/index.html) for information how to configure
robotidy.
Example <a name="example"></a>
-------
Ugly code before transforming with robotidy:
```robotframework
*** Settings ***
Force Tags tags tag2
Library Collections
Resource important.robot
Library MyCustomLibrary.py
Test Setup Setup Keyword
*** test case*
Test1
[ teardown] Teardown Keyword
Keyword
FOR ${var} IN RANGE 10
Run Keyword If ${var}>5 Other Keyword
END
*** Variables ***
${var}= 2
${bit_longer} 10
${var2} a
... b
*** Keywords ***
```
A lot prettier code after:
```robotframework
*** Settings ***
Library Collections
Library MyCustomLibrary.py
Resource important.robot
Test Setup Setup Keyword
Force Tags tags tag2
*** Variables ***
${var} 2
${bit_longer} 10
${var2} a
... b
*** Test Cases ***
Test1
Keyword
FOR ${var} IN RANGE 10
IF ${var}>5
Other Keyword
END
END
[Teardown] Teardown Keyword
```
Raw data
{
"_id": null,
"home_page": "https://github.com/MarketSquare/robotframework-tidy",
"name": "robotframework-tidy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "robotframework",
"author": "MarketSquare - Robot Framework community",
"author_email": "bartek.hirsz@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c5/d1/d15a27322558105d3df6c1c41a497fe57f1d75a1b00028e515d84cdc9d88/robotframework_tidy-4.14.0.tar.gz",
"platform": "any",
"description": "![Codecov](https://img.shields.io/codecov/c/github/MarketSquare/robotframework-tidy/main \"Code coverage on master branch\")\n![PyPI](https://img.shields.io/pypi/v/robotframework-tidy?label=version \"PyPI package version\")\n![Python versions](https://img.shields.io/pypi/pyversions/robotframework-tidy \"Supported Python versions\")\n![Licence](https://img.shields.io/pypi/l/robotframework-tidy \"PyPI - License\")\n\n---\n\n<img style=\"float:right\" src=\"https://raw.githubusercontent.com/MarketSquare/robotframework-tidy/main/docs/source/_static/robotidy_logo_small.png\">\n\nRobotidy\n===============\n- [Introduction](#introduction)\n- [Documentation](#documentation)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Example](#example)\n\nIntroduction <a name=\"introduction\"></a>\n------------\nRobotidy is a tool for autoformatting Robot Framework code.\n\nIt is spiritual descendant of Robot Framework's internal robot.tidy package.\n\nDocumentation <a name=\"documentation\"></a>\n-------------\nFull documentation available [here](https://robotidy.readthedocs.io). :open_book:\n\nRequirements <a name=\"requirements\"></a>\n------------\n\nPython 3.8+ :snake: and Robot Framework 4.0.0+ :robot:.\n\nInstallation <a name=\"installation\"></a>\n------------\n\nYou can install Robotidy simply by running:\n```\npip install -U robotframework-tidy\n```\n\nUsage <a name=\"usage\"></a>\n-----\nCall robotidy with path(s) to file/directory with robot files:\n\n```\nrobotidy tests\nrobotidy test.robot\nrobotidy tests/resources test.robot\n```\n \nAll command line options can be displayed in help message by executing:\n\n```\nrobotidy --help\n```\n\nSee [documentation](https://robotidy.readthedocs.io/en/latest/configuration/index.html) for information how to configure \nrobotidy.\n\nExample <a name=\"example\"></a>\n-------\nUgly code before transforming with robotidy:\n```robotframework\n*** Settings ***\nForce Tags tags tag2\nLibrary Collections\nResource important.robot\nLibrary MyCustomLibrary.py\n\nTest Setup Setup Keyword\n\n\n*** test case*\nTest1\n [ teardown] Teardown Keyword\n Keyword\n FOR ${var} IN RANGE 10\n Run Keyword If ${var}>5 Other Keyword\n END\n*** Variables ***\n${var}= 2\n${bit_longer} 10\n${var2} a\n... b\n\n*** Keywords ***\n\n```\nA lot prettier code after:\n```robotframework\n*** Settings ***\nLibrary Collections\nLibrary MyCustomLibrary.py\nResource important.robot\n\nTest Setup Setup Keyword\n\nForce Tags tags tag2\n\n*** Variables ***\n${var} 2\n${bit_longer} 10\n${var2} a\n... b\n\n*** Test Cases ***\nTest1\n Keyword\n FOR ${var} IN RANGE 10\n IF ${var}>5\n Other Keyword\n END\n END\n [Teardown] Teardown Keyword\n\n```\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Code autoformatter for Robot Framework",
"version": "4.14.0",
"project_urls": {
"Homepage": "https://github.com/MarketSquare/robotframework-tidy"
},
"split_keywords": [
"robotframework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cc66d4b6917a947877b1b5ba36f184843832f77bcf816a0da845289897e94adc",
"md5": "074ab0dbd45d3ce61ab5831c90305199",
"sha256": "17fc46c9c77f7abdddf6f172901d94e1ac87b5f66990cc6849920a052331d90b"
},
"downloads": -1,
"filename": "robotframework_tidy-4.14.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "074ab0dbd45d3ce61ab5831c90305199",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 110455,
"upload_time": "2024-08-22T08:50:45",
"upload_time_iso_8601": "2024-08-22T08:50:45.987176Z",
"url": "https://files.pythonhosted.org/packages/cc/66/d4b6917a947877b1b5ba36f184843832f77bcf816a0da845289897e94adc/robotframework_tidy-4.14.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c5d1d15a27322558105d3df6c1c41a497fe57f1d75a1b00028e515d84cdc9d88",
"md5": "5d6af1e79868da3dc562148cef619d54",
"sha256": "70d40544b66579f36c4dfcee40942d28985f1003f2441ff502c997a3d7e2a2b7"
},
"downloads": -1,
"filename": "robotframework_tidy-4.14.0.tar.gz",
"has_sig": false,
"md5_digest": "5d6af1e79868da3dc562148cef619d54",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 83292,
"upload_time": "2024-08-22T08:50:47",
"upload_time_iso_8601": "2024-08-22T08:50:47.299626Z",
"url": "https://files.pythonhosted.org/packages/c5/d1/d15a27322558105d3df6c1c41a497fe57f1d75a1b00028e515d84cdc9d88/robotframework_tidy-4.14.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-22 08:50:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MarketSquare",
"github_project": "robotframework-tidy",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "robotframework-tidy"
}
JSON
