|
| 1 | +.. container:: document |
| 2 | + |
| 3 | + `RIDE (Robot Framework |
| 4 | + IDE) <https://github.com/robotframework/RIDE/>`__ v2.0.8.1 is a new |
| 5 | + release with minor enhancements and bug fixes. The reference for |
| 6 | + valid arguments is `Robot Framework <https://robotframework.org/>`__ |
| 7 | + installed version, which is at this moment 6.1.1. However, internal |
| 8 | + library is based on version 3.1.2, to keep compatibility with old |
| 9 | + formats. |
| 10 | + |
| 11 | + - This version supports Python 3.6 up to 3.11. |
| 12 | + - There are some changes, or known issues: |
| 13 | + |
| 14 | + - On Text Editor, pressing **Ctrl** when the caret/cursor is near |
| 15 | + a Keyword will show a detachable window with the documentation, |
| 16 | + at Mouse Pointer position. |
| 17 | + - RIDE tray icon now shows a context menu with options Show, Hide |
| 18 | + and Close. |
| 19 | + - Highlighting and navigation of selected Project Explorer items, |
| 20 | + in Text Editor. |
| 21 | + - When editing in Grid Editor with content assistance, the |
| 22 | + selected content can be edited by escaping the list of |
| 23 | + suggestions with keys ARROW_LEFT or ARROW_RIGHT. |
| 24 | + - Newlines in Grid Editor can be made visible with the **filter |
| 25 | + newlines** set to False. |
| 26 | + - On Text Editor when Saving the selection of tests in Test |
| 27 | + Suites (Tree) is cleared. |
| 28 | + - Test Suite with *\**\* Comments \**\** can be edited but |
| 29 | + newlines are introduced. |
| 30 | + - Problems with COPY/PASTE in Text Editor have been reported when |
| 31 | + using wxPython 4.2.0, but not with version 4.2.1, which we now |
| 32 | + *recommend*. |
| 33 | + - Some argument types detection (and colorization) is not correct |
| 34 | + in Grid Editor. |
| 35 | + - RIDE **DOES NOT KEEP** Test Suites formatting or structure, |
| 36 | + causing differences in files when used on other IDE or Editors. |
| 37 | + |
| 38 | + **New Features and Fixes Highlights** |
| 39 | + |
| 40 | + - Fixed escaped spaces showing in Text Editor on commented cells |
| 41 | + - Improved keywords documentation search, by adding current dir to |
| 42 | + search |
| 43 | + - Improved Move up/down, **Alt-UpArrow**/**Alt-DownArrow** in Text |
| 44 | + Editor, to have proper indentation and selection |
| 45 | + - Added auto update check when development version is installed |
| 46 | + - Added menu option **Help->Check for Upgrade** which allows to |
| 47 | + force update check and install development version |
| 48 | + - Added **Upgrade Now** action to update dialog. |
| 49 | + - Added **Test Tags** field (new, since Robot Framework 6.0) to Test |
| 50 | + Suites settings. This field will replace **Default** and **Force |
| 51 | + Tags** settings, after Robot Framework 7.0 |
| 52 | + - Improved **RIDE Log** and **Parser Log** windows to allow Zoom |
| 53 | + In/Out with **Ctrl-Mouse Wheel** |
| 54 | + - Hide continuation markers in Project Tree |
| 55 | + - Improved content assistance in Text Editor by allowing to filter |
| 56 | + list as we type |
| 57 | + - Fixed resource files disappearing from Project tree on Windows |
| 58 | + - Fixed missing indication of link for User Keyword, when pressing |
| 59 | + **Ctrl** in Grid Editor |
| 60 | + - Added content help pop-up on Text Editor by pressing **Ctrl** for |
| 61 | + text at cursor position or selected autocomplete list item |
| 62 | + - Added Exclude option in context nenu for Test files, previously |
| 63 | + was only possible for Test Suites folders |
| 64 | + - Added exclusion of monitoring filesystem changes for files and |
| 65 | + directories excluded in Preferences |
| 66 | + - Fixed exception when finding GREY color for excluded files and |
| 67 | + directories in Project Tree |
| 68 | + - Added support for JSON variables, by using the installed Robot |
| 69 | + Framework import method |
| 70 | + - Colorization of Grid Editor cells after the continuation marker |
| 71 | + **...** and correct parsing of those lines |
| 72 | + - Colorization of Grid Editor cells when contents is list or |
| 73 | + dictionary variables |
| 74 | + - Added indication of matching brackets, **()**, **{}**, **[]**, in |
| 75 | + Text Editor |
| 76 | + - Fixed non synchronized expanding/collapse of Settings panel in |
| 77 | + Grid Editor, on Linux |
| 78 | + - Fixed not working the deletion of cells commented with **#** in |
| 79 | + Grid Editor with **Ctrl-Shift-D** |
| 80 | + - Fixed empty line being always added to the Variables section in |
| 81 | + Text Editor |
| 82 | + - Improved project file system changes and reloading |
| 83 | + - Added context menu to RIDE tray icon. Options Show, Hide and Close |
| 84 | + - Added synchronization with Project Explorer to navigate to |
| 85 | + selected item, Test Case, Keyword, Variable, in Text Editor |
| 86 | + - Control commands (**FOR**, **IF**, **TRY**, etc) will only be |
| 87 | + colorized as valid keywords when typed in all caps in Grid Editor |
| 88 | + - Newlines in Grid Editor can be made visible with the **filter |
| 89 | + newlines** set to False, by editing *settings.cfg* |
| 90 | + - Improve auto-suggestions of keywords in Grid Editor by allowing to |
| 91 | + close suggestions list with keys ARROW_LEFT or ARROW_RIGHT |
| 92 | + - Improve Text Editor auto-suggestions by using: selected text, text |
| 93 | + at left or at right of cursor |
| 94 | + |
| 95 | + We hope to implement or complete features and make fixes on next |
| 96 | + major version 2.1 (in the end of 2023). |
| 97 | + |
| 98 | + **The minimal wxPython version is, 4.0.7, and RIDE supports the |
| 99 | + current version, 4.2.1.** |
| 100 | + |
| 101 | + *Linux users are advised to install first wxPython from .whl package |
| 102 | + at* |
| 103 | + `wxPython.org <https://extras.wxpython.org/wxPython4/extras/linux/gtk3/>`__, |
| 104 | + or by using the system package manager. |
| 105 | + |
| 106 | + The |
| 107 | + `CHANGELOG.adoc <https://github.com/robotframework/RIDE/blob/master/CHANGELOG.adoc>`__ |
| 108 | + lists the changes done on the different versions. |
| 109 | + |
| 110 | + All issues targeted for RIDE v2.1 can be found from the `issue |
| 111 | + tracker |
| 112 | + milestone <https://github.com/robotframework/RIDE/issues?q=milestone%3Av2.1>`__. |
| 113 | + |
| 114 | + Questions and comments related to the release can be sent to the |
| 115 | + `robotframework-users <https://groups.google.com/group/robotframework-users>`__ |
| 116 | + mailing list or to the channel #ride on `Robot Framework |
| 117 | + Slack <https://robotframework-slack-invite.herokuapp.com>`__, and |
| 118 | + possible bugs submitted to the `issue |
| 119 | + tracker <https://github.com/robotframework/RIDE/issues>`__. You |
| 120 | + should see `Robot Framework |
| 121 | + Forum <https://forum.robotframework.org/c/tools/ride/>`__ if your |
| 122 | + problem is already known. |
| 123 | + |
| 124 | + To install with `pip <https://pypi.org/project/pip/>`__ installed, |
| 125 | + just run |
| 126 | + |
| 127 | + .. code:: literal-block |
| 128 | +
|
| 129 | + pip install --upgrade robotframework-ride==v2.0.8.1 |
| 130 | +
|
| 131 | + to install exactly this release, which is the same as using |
| 132 | + |
| 133 | + .. code:: literal-block |
| 134 | +
|
| 135 | + pip install --upgrade robotframework-ride |
| 136 | +
|
| 137 | + Alternatively you can download the source distribution from |
| 138 | + `PyPI <https://pypi.python.org/pypi/robotframework-ride>`__ and |
| 139 | + install it manually. For more details and other installation |
| 140 | + approaches, see the `installation |
| 141 | + instructions <https://github.com/robotframework/RIDE/wiki/Installation-Instructions>`__. |
| 142 | + If you want to help in the development of RIDE, by reporting issues |
| 143 | + in current development version, you can install with: |
| 144 | + |
| 145 | + .. code:: literal-block |
| 146 | +
|
| 147 | + pip install -U https://github.com/robotframework/RIDE/archive/master.zip |
| 148 | +
|
| 149 | + Important document for helping with development is the |
| 150 | + `CONTRIBUTING.adoc <https://github.com/robotframework/RIDE/blob/master/CONTRIBUTING.adoc>`__. |
| 151 | + |
| 152 | + See the `FAQ <https://github.com/robotframework/RIDE/wiki/F.A.Q.>`__ |
| 153 | + for important info about : FOR changes and other known issues and |
| 154 | + workarounds. |
| 155 | + |
| 156 | + A possible way to start RIDE is: |
| 157 | + |
| 158 | + .. code:: literal-block |
| 159 | +
|
| 160 | + python -m robotide.__init__ |
| 161 | +
|
| 162 | + You can then go to Tools>Create RIDE Desktop Shortcut, or run the |
| 163 | + shortcut creation script with: |
| 164 | + |
| 165 | + .. code:: literal-block |
| 166 | +
|
| 167 | + python -m robotide.postinstall -install |
| 168 | +
|
| 169 | + RIDE v2.0.8.1 was released on 1/Nov/2023. |
0 commit comments