Release notes for 6.3.0

docs/SeleniumLibrary-6.3.0.rst

@@ -0,0 +1,136 @@
+=====================
+SeleniumLibrary 6.3.0
+=====================
+
+
+.. default-role:: code
+
+
+SeleniumLibrary_ is a web testing library for `Robot Framework`_ that utilizes
+the Selenium_ tool internally. SeleniumLibrary 6.3.0 is a new release with
+enhancements including minimizing browesr window, waiting on expected conditions,
+getting element attribute or properties and bug fixes.
+
+
+If you have pip_ installed, just run
+
+::
+
+   pip install --upgrade robotframework-seleniumlibrary
+
+to install the latest available release or use
+
+::
+
+   pip install robotframework-seleniumlibrary==6.3.0
+
+to install exactly this version. Alternatively you can download the source
+distribution from PyPI_ and install it manually.
+
+SeleniumLibrary 6.3.0 was released on Friday April 19, 2024. SeleniumLibrary supports
+Python 3.8 through 3.11, Selenium 4.14.0 through 4.19.0 and
+Robot Framework 5.0.1, 6.1.1 and 7.0.
+
+.. _Robot Framework: http://robotframework.org
+.. _SeleniumLibrary: https://github.com/robotframework/SeleniumLibrary
+.. _Selenium: http://seleniumhq.org
+.. _pip: http://pip-installer.org
+.. _PyPI: https://pypi.python.org/pypi/robotframework-seleniumlibrary
+.. _issue tracker: https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av6.3.0
+
+
+.. contents::
+   :depth: 2
+   :local:
+
+Most important enhancements
+===========================
+
+- Added ``Minimize Browser Window`` keyword (`#1741`_)
+  New keyword which minimizes the current browser window.
+
+- Add keywords to fetch differentiated element Attribute or Property (`#1822`_)
+  The older ``Get Element Attribute`` keyword uses the Selenium getAttribute() method which,
+  as `this SauceLabs article <https://saucelabs.com/resources/blog/selenium-4-new-element-attribute-and-property-methods>`_ describes
+  "did not actually retrieve the Attribute value." Instead it "figured out what the user
+  was most likely interested in between the Attribute value and the Property values and
+  returned it." This would mean sometimes it might return an unexpected result. Selenium 4
+  introduced newer methods which returns either the attribute or the property as specifically
+  asked for.
+
+  It is recommend that one transition to these newer ``Get DOM Attribute`` and ``Get Property``
+  keywords.
+
+- Incorporate the expected conditions of Selenium  (`#1827`_)
+  A new keyword that allows for one to wait on an expected condition.
+
+- Remove deprecation of Press Key keyword (`#1892`_)
+  The Press Keys keyword was introduced to replace Press Key. Press Key in turn was deprecated
+  but I (Ed Manlove) failed to remove. Its been noted that both keywords use different underlying
+  methods for sending or pressing keys and either one will work in differing situations. So
+  instead of removing Press Key, it has been reinstated as a library keyword.
+
+Acknowledgements
+================
+
+- `Luciano Martorella <https://github.com/lmartorella>`_ contributing the new
+  minimize keyword (`#1741`_)
+- `Yuri Verweij <https://github.com/yuriverweij>`_  and `Lisa Crispin <https://lisacrispin.com/>`_
+  for reviewing changes and additions to Attribute or Property keywords (`#1822`_)
+- `Noam Manos <https://github.com/manosnoam>`_ for reporting the issues where
+  the Open Browser 'Options' object has no attribute '' (`#1877`_)
+- Yuri for helping update the contribution guide (`#1881`_)
+- All those who have commented on the deprecation of Press Key keyword (`#1892`_)
+- Yuri and Lisa for assisting with the addition of Wait For Expected Condition keyword
+  and for the Robot Framework Foundation for the ecosystem support (`#1827`_)
+
+and **Yuri Verweij, Lisa Crispin, and Tatu Aalto** for their continued support of the library development.
+
+Full list of fixes and enhancements
+===================================
+
+.. list-table::
+    :header-rows: 1
+
+    * - ID
+      - Type
+      - Priority
+      - Summary
+    * - `#1741`_
+      - enhancement
+      - high
+      - Added minimize keyword
+    * - `#1822`_
+      - enhancement
+      - high
+      - Add keywords to fetch differentiated element Attribute or Property
+    * - `#1827`_
+      - enhancement
+      - high
+      - Incorporate the expected conditions of Selenium 
+    * - `#1892`_
+      - ---
+      - high
+      - Remove deprecation of Press Key keyword
+    * - `#1877`_
+      - enhancement
+      - medium
+      - Open Browser 'Options' object has no attribute ''
+    * - `#1881`_
+      - ---
+      - medium
+      - Update contribution guide
+    * - `#1841`_
+      - ---
+      - ---
+      - Update maintainers and email within setup.py
+
+Altogether 7 issues. View on the `issue tracker <https://github.com/robotframework/SeleniumLibrary/issues?q=milestone%3Av6.3.0>`__.
+
+.. _#1741: https://github.com/robotframework/SeleniumLibrary/issues/1741
+.. _#1822: https://github.com/robotframework/SeleniumLibrary/issues/1822
+.. _#1827: https://github.com/robotframework/SeleniumLibrary/issues/1827
+.. _#1892: https://github.com/robotframework/SeleniumLibrary/issues/1892
+.. _#1877: https://github.com/robotframework/SeleniumLibrary/issues/1877
+.. _#1881: https://github.com/robotframework/SeleniumLibrary/issues/1881
+.. _#1841: https://github.com/robotframework/SeleniumLibrary/issues/1841