https://github.com/marketsquare/robotframework-tidy

Robot Framework code formatter
https://github.com/marketsquare/robotframework-tidy

codeformatter robotframework robotidy

Last synced: about 18 hours ago
JSON representation

Robot Framework code formatter

• Host: GitHub
• URL: https://github.com/marketsquare/robotframework-tidy
• Owner: MarketSquare
• License: apache-2.0
• Created: 2020-11-30T17:57:04.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-12T10:43:38.000Z (15 days ago)
• Last Synced: 2024-09-22T16:32:07.878Z (4 days ago)
• Topics: codeformatter, robotframework, robotidy
• Language: RobotFramework
• Homepage: https://robotidy.readthedocs.io/
• Size: 1.65 MB
• Stars: 103
• Watchers: 7
• Forks: 17
• Open Issues: 38
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
![Codecov](https://img.shields.io/codecov/c/github/MarketSquare/robotframework-tidy/main "Code coverage on master branch")

![PyPI](https://img.shields.io/pypi/v/robotframework-tidy?label=version "PyPI package version")

![Python versions](https://img.shields.io/pypi/pyversions/robotframework-tidy "Supported Python versions")

![Licence](https://img.shields.io/pypi/l/robotframework-tidy "PyPI - License")

---



Robotidy

===============

- [Introduction](#introduction)

- [Documentation](#documentation)

- [Requirements](#requirements)

- [Installation](#installation)

- [Usage](#usage)

- [Example](#example)

Introduction 

------------

Robotidy is a tool for autoformatting Robot Framework code.

It is spiritual descendant of Robot Framework's internal robot.tidy package.

Documentation 

-------------

Full documentation available [here](https://robotidy.readthedocs.io). :open_book:

Requirements 

------------

Python 3.8+ :snake: and Robot Framework 4.0.0+ :robot:.

Installation 

------------

You can install Robotidy simply by running:

```

pip install -U robotframework-tidy

```

Usage 

-----

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 

-------

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

```