robotframework 6.1.1__zip → 7.0__zip

{robotframework-6.1.1 → robotframework-7.0}/INSTALL.rst

@@ -28,13 +28,13 @@ is having Python or its alternative implementation `PyPy <https://pypy.org>`_
 installed. Another recommended precondition is having the pip_ package manager
 available.
 
-Robot Framework requires Python 3.6 or newer. If you need to use Python 2,
+Robot Framework requires Python 3.8 or newer. The latest version that supports
+Python 3.6 and 3.7 is `Robot Framework 6.1.1`__. If you need to use Python 2,
 `Jython <http://jython.org>`_ or `IronPython <http://ironpython.net>`_,
 you can use `Robot Framework 4.1.3`__.
-The forthcoming Robot Framework 7.0 will require `Python 3.8 or newer`__.
 
+__ https://github.com/robotframework/robotframework/blob/v6.1.1/INSTALL.rst
 __ https://github.com/robotframework/robotframework/blob/v4.1.3/INSTALL.rst
-__ https://github.com/robotframework/robotframework/issues/4294
 
 Installing Python on Linux
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -50,7 +50,7 @@ command in a terminal:
 .. sourcecode:: bash
 
   $ python --version
-  Python 3.8.10
+  Python 3.10.13
 
 Notice that if your distribution provides also older Python 2, running `python`
 may use that. To use Python 3, you can use `python3` command or even more version
@@ -60,10 +60,10 @@ one to use:
 
 .. sourcecode:: bash
 
-  $ python3.9 --version
-  Python 3.9.10
-  $ python3.10 --version
-  Python 3.10.2
+  $ python3.11 --version
+  Python 3.11.7
+  $ python3.12 --version
+  Python 3.12.1
 
 Installing Robot Framework directly under the system provided Python
 has a risk that possible problems can affect the whole Python installation
@@ -92,7 +92,7 @@ added to `PATH`, you can open the command prompt and execute `python --version`:
 .. sourcecode:: batch
 
   C:\>python --version
-  Python 3.9.4
+  Python 3.10.9
 
 If you install multiple Python versions on Windows, the version that is used
 when you execute `python` is the one first in `PATH`. If you need to use others,
@@ -101,9 +101,9 @@ the easiest way is using the `py launcher`__:
 .. sourcecode:: batch
 
   C:\>py --version
-  Python 3.9.4
-  C:\>py -3.10 --version
-  Python 3.10.2
+  Python 3.10.9
+  C:\>py -3.12 --version
+  Python 3.12.1
 
 __ https://docs.python.org/3/using/windows.html
 __ https://docs.python.org/3/using/windows.html#windows-full
@@ -203,18 +203,18 @@ Examples on Linux:
 .. sourcecode:: bash
 
   $ pip --version
-  pip 20.2 from ... (python 3.8)
-  $ python3.10 -m pip --version
-  pip 20.2 from ... (python 3.10)
+  pip 23.2.1 from ... (python 3.10)
+  $ python3.12 -m pip --version
+  pip 23.3.1 from ... (python 3.12)
 
 Examples on Windows:
 
 .. sourcecode:: batch
 
   C:\> pip --version
-  pip 20.2.2 from ... (python 3.9)
-  C:\> py -m 3.10 -m pip --version
-  pip 20.2.1 from ... (python 3.10)
+  pip 23.2.1 from ... (python 3.10)
+  C:\> py -m 3.12 -m pip --version
+  pip 23.3.2 from ... (python 3.12)
 
 In the subsequent sections pip is always run using the `pip` command. You may
 need to use some of the other approaches explained above in your environment.
@@ -241,10 +241,10 @@ __ PyPI_
     pip install --upgrade --pre robotframework
 
     # Install a specific version
-    pip install robotframework==5.0
+    pip install robotframework==7.0
 
     # Install separately downloaded package (no network connection needed)
-    pip install robotframework-5.0-py3-none-any.whl
+    pip install robotframework-7.0-py3-none-any.whl
 
     # Install latest (possibly unreleased) code directly from GitHub
     pip install https://github.com/robotframework/robotframework/archive/master.zip
@@ -283,7 +283,7 @@ the following command:
 .. sourcecode:: bash
 
    $ robot --version
-   Robot Framework 5.0 (Python 3.8.10 on linux)
+   Robot Framework 7.0 (Python 3.10.3 on linux)
 
 If running these commands fails with a message saying that the command is
 not found or recognized, a good first step is double-checking the PATH_
@@ -296,11 +296,11 @@ version.
 
 .. sourcecode:: bash
 
-   $ python3.10 -m robot --version
-   Robot Framework 5.0 (Python 3.10.2 on linux)
+   $ python3.12 -m robot --version
+   Robot Framework 7.0 (Python 3.12.1 on linux)
 
-   C:\>py -3.10 -m robot --version
-   Robot Framework 5.0 (Python 3.10.3 on win32)
+   C:\>py -3.11 -m robot --version
+   Robot Framework 7.0 (Python 3.11.7 on win32)
 
 Virtual environments
 --------------------

{robotframework-6.1.1 → robotframework-7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: robotframework
-Version: 6.1.1
+Version: 7.0
 Summary: Generic automation framework for acceptance testing and robotic process automation (RPA)
 Home-page: https://robotframework.org
 Author: Pekka Klärck
@@ -10,9 +10,8 @@ Download-URL: https://pypi.org/project/robotframework
 Project-URL: Source, https://github.com/robotframework/robotframework
 Project-URL: Issue Tracker, https://github.com/robotframework/robotframework/issues
 Project-URL: Documentation, https://robotframework.org/robotframework
-Project-URL: Release Notes, https://github.com/robotframework/robotframework/blob/master/doc/releasenotes/rf-6.1.1.rst
+Project-URL: Release Notes, https://github.com/robotframework/robotframework/blob/master/doc/releasenotes/rf-7.0.rst
 Project-URL: Slack, http://slack.robotframework.org
-Project-URL: Twitter, https://twitter.com/robotframework
 Description: Robot Framework
         ===============
         
@@ -64,10 +63,12 @@ Description: Robot Framework
         For more detailed installation instructions, including installing Python, see
         `INSTALL.rst <https://github.com/robotframework/robotframework/blob/master/INSTALL.rst>`__.
         
-        Robot Framework requires Python 3.6 or newer and runs also on `PyPy <http://pypy.org>`_.
+        Robot Framework requires Python 3.8 or newer and runs also on `PyPy <http://pypy.org>`_.
+        The latest version that supports Python 3.6 and 3.7 is `Robot Framework 6.1.1`__.
         If you need to use Python 2, `Jython <http://jython.org>`_ or
         `IronPython <http://ironpython.net>`_, you can use `Robot Framework 4.1.3`__.
         
+        __ https://github.com/robotframework/robotframework/tree/v6.1.1#readme
         __ https://github.com/robotframework/robotframework/tree/v4.1.3#readme
         
         Example
@@ -132,7 +133,6 @@ Description: Robot Framework
         - `Forum <https://forum.robotframework.org/>`_
         - `robotframework-users
           <https://groups.google.com/group/robotframework-users/>`_ mailing list
-        - `@robotframework <https://twitter.com/robotframework>`_ on Twitter
         
         Contributing
         ------------
@@ -171,8 +171,6 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -184,5 +182,5 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Testing :: Acceptance
 Classifier: Topic :: Software Development :: Testing :: BDD
 Classifier: Framework :: Robot Framework
-Requires-Python: >=3.6
+Requires-Python: >=3.8
 Description-Content-Type: text/x-rst

{robotframework-6.1.1 → robotframework-7.0}/README.rst

@@ -49,10 +49,12 @@ you can simply run::
 For more detailed installation instructions, including installing Python, see
 `<INSTALL.rst>`__.
 
-Robot Framework requires Python 3.6 or newer and runs also on `PyPy <http://pypy.org>`_.
+Robot Framework requires Python 3.8 or newer and runs also on `PyPy <http://pypy.org>`_.
+The latest version that supports Python 3.6 and 3.7 is `Robot Framework 6.1.1`__.
 If you need to use Python 2, `Jython <http://jython.org>`_ or
 `IronPython <http://ironpython.net>`_, you can use `Robot Framework 4.1.3`__.
 
+__ https://github.com/robotframework/robotframework/tree/v6.1.1#readme
 __ https://github.com/robotframework/robotframework/tree/v4.1.3#readme
 
 Example
@@ -117,7 +119,6 @@ Support and Contact
 - `Forum <https://forum.robotframework.org/>`_
 - `robotframework-users
   <https://groups.google.com/group/robotframework-users/>`_ mailing list
-- `@robotframework <https://twitter.com/robotframework>`_ on Twitter
 
 Contributing
 ------------

{robotframework-6.1.1 → robotframework-7.0}/setup.py

@@ -6,7 +6,7 @@ from setuptools import find_packages, setup
 
 # Version number typically updated by running `invoke set-version <version>`.
 # Run `invoke --help set-version` or see tasks.py for details.
-VERSION = '6.1.1'
+VERSION = '7.0'
 with open(join(dirname(abspath(__file__)), 'README.rst')) as f:
     LONG_DESCRIPTION = f.read()
     base_url = 'https://github.com/robotframework/robotframework/blob/master'
@@ -22,8 +22,6 @@ License :: OSI Approved :: Apache Software License
 Operating System :: OS Independent
 Programming Language :: Python :: 3
 Programming Language :: Python :: 3 :: Only
-Programming Language :: Python :: 3.6
-Programming Language :: Python :: 3.7
 Programming Language :: Python :: 3.8
 Programming Language :: Python :: 3.9
 Programming Language :: Python :: 3.10
@@ -42,7 +40,7 @@ KEYWORDS = ('robotframework automation testautomation rpa '
             'testing acceptancetesting atdd bdd')
 PACKAGE_DATA = [join('htmldata', directory, pattern)
                 for directory in ('rebot', 'libdoc', 'testdoc', 'lib', 'common')
-                for pattern in ('*.html', '*.css', '*.js')]
+                for pattern in ('*.html', '*.css', '*.js')] + ['api/py.typed']
 
 
 setup(
@@ -57,7 +55,6 @@ setup(
         'Documentation': 'https://robotframework.org/robotframework',
         'Release Notes': f'https://github.com/robotframework/robotframework/blob/master/doc/releasenotes/rf-{VERSION}.rst',
         'Slack': 'http://slack.robotframework.org',
-        'Twitter': 'https://twitter.com/robotframework',
     },
     download_url = 'https://pypi.org/project/robotframework',
     license      = 'Apache License 2.0',
@@ -66,7 +63,7 @@ setup(
     long_description_content_type = 'text/x-rst',
     keywords     = KEYWORDS,
     platforms    = 'any',
-    python_requires='>=3.6',
+    python_requires='>=3.8',
     classifiers  = CLASSIFIERS,
     package_dir  = {'': 'src'},
     package_data = {'robot': PACKAGE_DATA},

{robotframework-6.1.1 → robotframework-7.0}/src/robot/api/__init__.py

@@ -61,6 +61,9 @@ Currently exposed APIs are:
   returned by the :func:`~robot.result.resultbuilder.ExecutionResult` or
   an executed :class:`~robot.running.model.TestSuite`.
 
+* :class:`~robot.running.arguments.typeinfo.TypeInfo` class for parsing
+  type hints and converting values based on them. New in Robot Framework 7.0.
+
 * :class:`~robot.conf.languages.Languages` and :class:`~robot.conf.languages.Language`
   classes for external tools that need to work with different translations.
   The latter is also the base class to use with custom translations.
@@ -81,6 +84,6 @@ from robot.parsing import (get_tokens, get_resource_tokens, get_init_tokens,
                            get_model, get_resource_model, get_init_model, Token)
 from robot.reporting import ResultWriter
 from robot.result import ExecutionResult, ResultVisitor
-from robot.running import TestSuite, TestSuiteBuilder
+from robot.running import TestSuite, TestSuiteBuilder, TypeInfo
 
 from .exceptions import ContinuableFailure, Failure, FatalError, Error, SkipExecution

{robotframework-6.1.1 → robotframework-7.0}/src/robot/api/deco.py

@@ -13,10 +13,23 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
-import inspect
+from typing import Any, Callable, Sequence, TypeVar, Union, overload
 
+from .interfaces import TypeHints
 
-def not_keyword(func):
+
+# Current annotations report `attr-defined` errors. This can be solved once Python 3.10
+# becomes the minimum version (error-free conditional typing proved too complex).
+# See: https://discuss.python.org/t/questions-related-to-typing-overload-style/38130
+F = TypeVar('F', bound=Callable[..., Any])    # Any function.
+K = TypeVar('K', bound=Callable[..., Any])    # Keyword function.
+L = TypeVar('L', bound=type)                  # Library class.
+KeywordDecorator = Callable[[K], K]
+LibraryDecorator = Callable[[L], L]
+Converter = Union[Callable[[Any], Any], Callable[[Any, Any], Any]]
+
+
+def not_keyword(func: F) -> F:
     """Decorator to disable exposing functions or methods as keywords.
 
     Examples::
@@ -41,8 +54,22 @@ def not_keyword(func):
 not_keyword.robot_not_keyword = True
 
 
+@overload
+def keyword(func: K, /) -> K:
+    ...
+
+
+@overload
+def keyword(name: 'str | None' = None,
+            tags: Sequence[str] = (),
+            types: 'TypeHints | None' = ()) -> KeywordDecorator:
+    ...
+
+
 @not_keyword
-def keyword(name=None, tags=(), types=()):
+def keyword(name: 'K | str | None' = None,
+            tags: Sequence[str] = (),
+            types: 'TypeHints | None' = ()) -> 'K | KeywordDecorator':
     """Decorator to set custom name, tags and argument types to keywords.
 
     This decorator creates ``robot_name``, ``robot_tags`` and ``robot_types``
@@ -84,10 +111,10 @@ def keyword(name=None, tags=(), types=()):
         def no_conversion(length, case_insensitive=False):
             # ...
     """
-    if inspect.isroutine(name):
+    if callable(name):
         return keyword()(name)
 
-    def decorator(func):
+    def decorator(func: F) -> F:
         func.robot_name = name
         func.robot_tags = tags
         func.robot_types = types
@@ -96,15 +123,34 @@ def keyword(name=None, tags=(), types=()):
     return decorator
 
 
+@overload
+def library(cls: L, /) -> L:
+    ...
+
+
+@overload
+def library(scope: 'str | None' = None,
+            version: 'str | None' = None,
+            converters: 'dict[type, Converter] | None' = None,
+            doc_format: 'str | None' = None,
+            listener: 'Any | None' = None,
+            auto_keywords: bool = False) -> LibraryDecorator:
+    ...
+
+
 @not_keyword
-def library(scope=None, version=None, converters=None, doc_format=None, listener=None,
-            auto_keywords=False):
+def library(scope: 'L | str | None' = None,
+            version: 'str | None' = None,
+            converters: 'dict[type, Converter] | None' = None,
+            doc_format: 'str | None' = None,
+            listener: 'Any | None' = None,
+            auto_keywords: bool = False) -> 'L | LibraryDecorator':
     """Class decorator to control keyword discovery and other library settings.
 
-    By default disables automatic keyword detection by setting class attribute
-    ``ROBOT_AUTO_KEYWORDS = False`` to the decorated library. In that mode
-    only methods decorated explicitly with the :func:`keyword` decorator become
-    keywords. If that is not desired, automatic keyword discovery can be
+    Disables automatic keyword detection by setting class attribute
+    ``ROBOT_AUTO_KEYWORDS = False`` to the decorated library by default. In that
+    mode only methods decorated explicitly with the :func:`keyword` decorator
+    become keywords. If that is not desired, automatic keyword discovery can be
     enabled by using ``auto_keywords=True``.
 
     Arguments ``scope``, ``version``, ``converters``, ``doc_format`` and ``listener``
@@ -112,7 +158,7 @@ def library(scope=None, version=None, converters=None, doc_format=None, listener
     using class attributes ``ROBOT_LIBRARY_SCOPE``, ``ROBOT_LIBRARY_VERSION``,
     ``ROBOT_LIBRARY_CONVERTERS``, ``ROBOT_LIBRARY_DOC_FORMAT`` and
     ``ROBOT_LIBRARY_LISTENER``, respectively. These attributes are only set if
-    the related arguments are given and they override possible existing attributes
+    the related arguments are given, and they override possible existing attributes
     in the decorated class.
 
     Examples::
@@ -135,10 +181,10 @@ def library(scope=None, version=None, converters=None, doc_format=None, listener
     The ``@library`` decorator is new in Robot Framework 3.2.
     The ``converters`` argument is new in Robot Framework 5.0.
     """
-    if inspect.isclass(scope):
+    if isinstance(scope, type):
         return library()(scope)
 
-    def decorator(cls):
+    def decorator(cls: L) -> L:
         if scope is not None:
             cls.ROBOT_LIBRARY_SCOPE = scope
         if version is not None:

{robotframework-6.1.1 → robotframework-7.0}/src/robot/api/exceptions.py

@@ -31,12 +31,12 @@ class Failure(AssertionError):
     """
     ROBOT_SUPPRESS_NAME = True
 
-    def __init__(self, message, html=False):
+    def __init__(self, message: str, html: bool = False):
         """
         :param message: Exception message.
         :param html: When ``True``, message is considered to be HTML and not escaped.
         """
-        AssertionError.__init__(self, message if not html else '*HTML* ' + message)
+        super().__init__(message if not html else '*HTML* ' + message)
 
 
 class ContinuableFailure(Failure):
@@ -57,12 +57,12 @@ class Error(RuntimeError):
     """
     ROBOT_SUPPRESS_NAME = True
 
-    def __init__(self, message, html=False):
+    def __init__(self, message: str, html: bool = False):
         """
         :param message: Exception message.
         :param html: When ``True``, message is considered to be HTML and not escaped.
         """
-        RuntimeError.__init__(self, message if not html else '*HTML* ' + message)
+        super().__init__(message if not html else '*HTML* ' + message)
 
 
 class FatalError(Error):
@@ -76,9 +76,9 @@ class SkipExecution(Exception):
     ROBOT_SKIP_EXECUTION = True
     ROBOT_SUPPRESS_NAME = True
 
-    def __init__(self, message, html=False):
+    def __init__(self, message: str, html: bool = False):
         """
         :param message: Exception message.
         :param html: When ``True``, message is considered to be HTML and not escaped.
         """
-        Exception.__init__(self, message if not html else '*HTML* ' + message)
+        super().__init__(message if not html else '*HTML* ' + message)