Skip to content

RED 0.6.2

Compare
Choose a tag to compare
@KrzysztofJozefowicz KrzysztofJozefowicz released this 16 Mar 08:11
· 10518 commits to master since this release

RED - Robot Editor v0.6.2

Introduction

RED Robot Editor is Eclipse based editor for RobotFramework test cases.
Release contains Eclipse feature of RED Robot Editor to be installed into Eclipse.

Requirements

How to install

Product

Product zip is ready to use RED installation bundled with Eclipse Mars. There is no need to install RED feature into it. Choose proper OS version from Downloads section.

Feature

Download RED eclipse feature zip: https://github.com/nokia/RED/releases/download/0.6.2/RED_0.6.2.201603151414.zip
Please refer to First Steps doc under https://github.com/nokia/RED/blob/master/First_steps.md

Install on clean Eclipse

In short:

  • GUI: Help -> Install New software -> Add -> Archive and continue with prompts (unselect "Contact all update sites)
  • CLI: by issuing command:

eclipse -application org.eclipse.equinox.p2.director -nosplash -consoleLog --launcher.suppressErrors -repository jar:file:<PATH_TO_ZIP>\!/,http://download.eclipse.org/releases/mars/ -installIU org.robotframework.ide.eclipse.main.feature.feature.group

Update existing RED installation

We recommend to not to do direct update of newer version, instead perform uninstall old RED and install new RED after Eclipse restart.
Uninstall:
Open Help -> Installation Details, select old RED feature and perform uninstall

Updates

  • RED product as separate binary
  • Keyword arguments (definition and usage) validation.
  • "Linked mode" assist for filling out KW arguments, new scalars,lists and dictionaries. Use TAB to navigate.
  • Fixed issues with Jython - now generating libspecs and test execution should work.
  • Python libs inside jar files are supported.
  • When editing libraries, lib file change is noticed - RED places icon on changed lib files and can reload libspecs automatically (option in red.xml).
  • When there is only one class in library when adding, class selection window is suppressed.
  • Console links from Robot execution are clickable
  • Check changelog.txt for details

What's in the package

  • Robot Perspective & Robot nature (Project,files and other file artifacts)
  • Text Source editor with syntax coloring, code assistance and real-time validation
  • Table editors (non persistent for trial usage)
  • Debug Perspective for test case debugging with breakpoints, stepping, variable watch
  • Remote debug
  • Support for dictionaries & lists
  • Eclipse help
  • File support: .robot, .txt, .tsv

Known issues

  • Under Ubuntu/Xubuntu it was discovered that NullPointerException is shown when opening file from Project Explorer and clicking on file structure instead of file name. As a workaround open file by clicking on filename.
  • GTK3 seems to mess up with Eclipse under Linux. Force usage of GTK2 by executing command in terminal: export SWT_GTK3=0
  • Eclipse does not have UTF-8 support in editors by default. Check Preferences and RED help to get how to change it.
  • Table editors edits are not persistent, changes done in Table editors will not be visible in source nor saved to file. Sync is done from Source -> Table only.
  • Library auto-discovery is not yet supported thus user needs to add any external library to red.xml by themselves, if not then validation will show unknown library error. Either you add it in red.xml or invoke option Quick Fix on item in Source editor or in Problems view.
  • Due to difficult to comprehend and countless exceptions in RF syntax, validation can show false positive errors. In such case please provide us sample test case for us to have a look at.

Short term plans

  • Table Editor
  • Library auto-discovery

Notes

By default, Eclipse is shipped with limited heap size which impacts performance while working with bigger projects. It is recommended to increase Xmx and Xmx parameters to higher values. Memory allocation can be done via startup arguments or by editing eclipse.ini in Eclipse folder.
We recommend to set following lines to eclipse.ini :

-vmargs
-Xms512m
-Xmx1024m

For details visit Eclipse Wiki: https://wiki.eclipse.org/FAQ_How_do_I_increase_the_heap_size_available_to_Eclipse%3F

Feedback

We would appreciate any feedback about RED - Robot Editor, especially in every day functions like editors usability, false positive validation errors, problem with source parsing& coloring, performance etc. We are open for improvements and new functionalities. Fell free to create issue in GitHub issue tracker.