Version 2.1.1

robotframework · Nov 14, 2024 · d59852b · d59852b
1 parent 87c2539
commit d59852b
Show file tree

Hide file tree

Showing 4 changed files with 158 additions and 14 deletions.
diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc
@@ -22,8 +22,8 @@ the generic https://opensource.guide/[Open Source Guides] first.
 Bugs and enhancements are tracked in the
 https://github.com/robotframework/RIDE/issues[issue tracker].
 If you are unsure if something is a bug or is a feature worth
-implementing, you can first ask on link:https://forum.robotframework.org/c/tools/ride/21/[RIDE-users] 
-(#RIDE on irc.freenode.net), or on
+implementing, you can first ask on link:https://forum.robotframework.org/c/tools/ride/21/[RIDE]
+(RIDE at Forum), or on
 https://robotframework-slack-invite.herokuapp.com[Slack]. These and
 other similar forums, not the issue tracker, are also places where to
 ask general questions.
@@ -105,6 +105,33 @@ to create dedicated topic branches for pull requests instead of creating
 them based on the master branch. This is especially important if you
 plan to work on multiple pull requests at the same time.
 
+=== RIDE Code Setup
+
+The basic code setup of RIDE, needs a additional steps since v2.1.1 (November 2024):
+
+. Forking the project (Web interface)
+. Clone (for example) ``git clone [email protected]:robotframework/RIDE.git``
+. ``cd RIDE``
+. `pip install -U -r requirements-dev.txt`
+. ``git submodule init``
+. ``git submodule update``
+
+Then you may change to the ``develop`` branch, which should be the base for features or fixes branches, and the target for pull requests. Example:
+
+. ``git checkout develop``
+. ``git submodule init``
+. ``git submodule update``
+. ``git pull origin develop``
+. ``git checkout -b a_new_branch_based_on_develop``
+. After changes, you add new files, ``git add a_new_file``
+. You add and commit the modified files, ``git -a -m "The short message with info about the change``
+. You push the commit to your fork, ``git push origin a_new_branch_based_on_develop``
+. You may repeat the commit/push and when ready create a Pull Request to your ``develop`` branch, or
+. You checkout your ``develop``branch, and merge with ``git merge a_new_branch_based_on_develop``
+. Later you should keep the ``develop`` branch updated by pulling from your remote, ``git pull origin develop``, or
+. By pushing ``git push origin develop``
+. Finaly, you can create a Pull Request from your fork to the target ``develop`` branch of the original RIDE project.
+
 === Coding conventions
 
 NOTE: RIDE graphical user interface, can only exist due the use of wxPython (from wxWidgets). Users wanting to write Python code for RIDE, should be acquainted with https://wxpython.org[wxPython] in particular by exploring its demo.
@@ -122,7 +149,7 @@ should be clear enough that comments are generally not needed.
 
 All code, including test code, must be compatible with all supported
 Python interpreters and versions. Most importantly this means that the
-code must support Python 3 (actually, greater than 3.6). RIDE's code still have some Python 2 conditioning, due to its dual compatibility on version 1.7.4.2, and also in the included Robot Framework library from version 3.1.2.
+code must support Python 3 (actually, greater than 3.7, currently 3.13). RIDE's code may still have some Python 2 conditioning, due to its dual compatibility on version 1.7.4.2, and also in the included Robot Framework library from version 3.1.2.
 
 ==== Line length
 
@@ -225,7 +252,7 @@ Please contact us via Slack, if you would like to join this testing group.
 Once you have code, documentation and tests ready, it is time to
 finalize the pull request.
 
-=== Acknowledgments
+=== Acknowledgements
 
 If you have done any non-trivial change and would like to be credited,
 remind us to add `acknowledge` tag to the issue. This way we will add

diff --git a/doc/releasenotes/ride-2.1.1.rst b/doc/releasenotes/ride-2.1.1.rst
@@ -0,0 +1,119 @@
+.. container:: document
+
+   `RIDE (Robot Framework
+   IDE) <https://github.com/robotframework/RIDE/>`__ v2.1.1 is a new
+   release with some enhancements and bug fixes. The reference for valid
+   arguments is `Robot Framework <https://robotframework.org/>`__
+   installed version, which is at this moment 7.1.1. However, internal
+   library code is originally based on version 3.1.2, but adapted for
+   new versions.
+
+   -  This version supports Python 3.8 up to 3.13.
+   -  There are some changes, or known issues:
+
+      -  🐞 - When upgrading RIDE and activate Restart, some errors are
+         visible about missing /language file, and behaviour is not
+         normal. Better to close RIDE and start a new instance.
+      -  🐞 - Problems with COPY/PASTE in Text Editor have been reported
+         when using wxPython 4.2.0, but not with version 4.2.1 and
+         4.2.2, which we now *recommend*.
+      -  🐞 - Some argument types detection (and colorization) is not
+         correct in Grid Editor.
+      -  🐞 - RIDE **DOES NOT KEEP** Test Suites formatting or
+         structure, causing differences in files when used on other IDE
+         or Editors. The option to not reformat the file is not working.
+
+   **New Features and Fixes Highlights**
+
+   -  Fixed long arguments in fixtures appearing splitted in Grid
+      Editor. Still, arguments info will not be correct at calling
+      step.
+   -  Fixed double action on Linux when pressing the DEL key
+
+   **The minimal wxPython version is, 4.0.7, and RIDE supports the
+   current version, 4.2.2, which we recommend.**
+
+   *Linux users are advised to install first wxPython from .whl package
+   at*
+   `wxPython.org <https://extras.wxpython.org/wxPython4/extras/linux/gtk3/>`__,
+   or by using the system package manager.
+
+   The
+   `CHANGELOG.adoc <https://github.com/robotframework/RIDE/blob/master/CHANGELOG.adoc>`__
+   lists the changes done on the different versions.
+
+   All issues targeted for RIDE v2.2 can be found from the `issue
+   tracker
+   milestone <https://github.com/robotframework/RIDE/issues?q=milestone%3Av2.2>`__.
+
+   Questions and comments related to the release can be sent to the
+   `robotframework-users <https://groups.google.com/group/robotframework-users>`__
+   mailing list or to the channel #ride on `Robot Framework
+   Slack <https://robotframework-slack-invite.herokuapp.com>`__, and
+   possible bugs submitted to the `issue
+   tracker <https://github.com/robotframework/RIDE/issues>`__. You
+   should see `Robot Framework
+   Forum <https://forum.robotframework.org/c/tools/ride/>`__ if your
+   problem is already known.
+
+   To install the latest release with
+   `pip <https://pypi.org/project/pip/>`__ installed, just run
+
+   .. code:: literal-block
+
+      pip install --upgrade robotframework-ride==2.1.1
+
+   to install exactly the specified release, which is the same as using
+
+   .. code:: literal-block
+
+      pip install --upgrade robotframework-ride
+
+   Alternatively you can download the source distribution from
+   `PyPI <https://pypi.python.org/pypi/robotframework-ride>`__ and
+   install it manually. For more details and other installation
+   approaches, see the `installation
+   instructions <https://github.com/robotframework/RIDE/wiki/Installation-Instructions>`__.
+   If you want to help in the development of RIDE, by reporting issues
+   in current development version, you can install with:
+
+   .. code:: literal-block
+
+      pip install -U https://github.com/robotframework/RIDE/archive/develop.zip
+
+   Important document for helping with development is the
+   `CONTRIBUTING.adoc <https://github.com/robotframework/RIDE/blob/develop/CONTRIBUTING.adoc>`__.
+
+   To start RIDE from a command window, shell or terminal, just enter:
+
+   ::
+
+      ride
+
+   You can also pass some arguments, like a path for a test suite file
+   or directory.
+
+   ::
+
+      ride example.robot
+
+   Another possible way to start RIDE is:
+
+   .. code:: literal-block
+
+      python -m robotide
+
+   You can then go to Tools>Create RIDE Desktop Shortcut, or run the
+   shortcut creation script with:
+
+   .. code:: literal-block
+
+      python -m robotide.postinstall -install
+
+   or
+
+   .. code:: literal-block
+
+      ride_postinstall.py -install
+
+   RIDE v2.1.1 was released on 14/November/2024.
diff --git a/src/robotide/application/releasenotes.py b/src/robotide/application/releasenotes.py
@@ -125,7 +125,7 @@ def set_content(self, html_win, content):
 milestone = re.split('[ab-]', VERSION)[0]
 
 WELCOME_TEXT = f"""
-<h2>Welcome to use RIDE <b>DEVELOPMENT</b> version {version}</h2>
+<h2>Welcome to use RIDE version {version}</h2>
 
 <p>Thank you for using the <a href="https://robotframework.org/">Robot Framework</a> IDE (RIDE).</p>
 
@@ -171,8 +171,7 @@ def set_content(self, html_win, content):
 <ul class="simple">
 <li>Fixed broken go to definition after editing content in resource files.</li>
 <li>Fixed long arguments in fixtures appearing splitted in Grid Editor. Still, arguments info will not be correct at
- calling step. Fixed long arguments in fixtures appearing splitted in Grid Editor.
- Still, arguments info will not be correct at calling step.</li>
+ calling step.</li>
 <li>Fixed double action on Linux when pressing the DEL key</li>
 </ul>
 <!-- <p>We hope to implement or complete features and make fixes on next major version 2.1 (in mid Autumm of 2024).</p>
@@ -184,8 +183,8 @@ def set_content(self, html_win, content):
   manager.</p>
 <p>The <a class="reference external" href="https://github.com/robotframework/RIDE/blob/master/CHANGELOG.adoc">
 CHANGELOG.adoc</a> lists the changes done on the different versions.</p>
-<p>All issues targeted for RIDE v2.1 can be found
-from the <a class="reference external" href="https://github.com/robotframework/RIDE/issues?q=milestone%3Av2.1">issue
+<p>All issues targeted for RIDE v2.2 can be found
+from the <a class="reference external" href="https://github.com/robotframework/RIDE/issues?q=milestone%3Av2.2">issue
  tracker milestone</a>.</p>
 <p>Questions and comments related to the release can be sent to the
 <a class="reference external" href="https://groups.google.com/group/robotframework-users">robotframework-users</a>
@@ -197,7 +196,7 @@ def set_content(self, html_win, content):
  Forum</a> if your problem is already known.</p>
 <p>To install the latest release with <a class="reference external" href="https://pypi.org/project/pip/">pip</a> installed, just run</p>
 <pre class="literal-block">
-pip install --upgrade robotframework-ride==2.1
+pip install --upgrade robotframework-ride==2.1.1
 </pre>
 <p>to install exactly the specified release, which is the same as using</p>
 <pre class="literal-block">

diff --git a/src/robotide/postinstall/__init__.py b/src/robotide/postinstall/__init__.py
@@ -15,7 +15,6 @@
 
 from .desktopshortcut import ShortcutPlugin
 
-
 import sys
 try:
     import wx
@@ -30,7 +29,7 @@
                      "or pip install wxPython")
     exit(-1)
 
-from os import environ
+from os import environ, getlogin
 from os.path import exists, join
 from robotide.widgets import RIDEDialog
 
@@ -180,7 +179,7 @@ def _create_desktop_shortcut_linux(frame=None):
     desktop = {"de": "Desktop", "en": "Desktop", "es": "Escritorio",
                "fi": r"Työpöytä", "fr": "Bureau", "it": "Scrivania",
                "pt": r"Área de Trabalho"}
-    user = str(subprocess.check_output(['logname']).strip(), encoding='utf-8')
+    user = getlogin()
     try:
         ndesktop = desktop[DEFAULT_LANGUAGE[0][:2]]
         directory = join("/home", user, ndesktop)
@@ -254,7 +253,7 @@ def _create_desktop_shortcut_mac(frame=None):
         if exists(ride_app_pc_path):
             shutil.rmtree(ride_app_pc_path, True)
         shutil.copytree(ride_app_module_path, ride_app_pc_path)
-        user = str(subprocess.check_output(['logname']).strip(), encoding='utf-8')
+        user = getlogin()
         user_desktop_link = '/Users/' + user + '/Desktop/' + ride_app_name
         if exists(user_desktop_link):
             os.remove(user_desktop_link)