Source code for robot.libraries.Dialogs

#  Copyright 2008-2015 Nokia Solutions and Networks
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.

"""A test library providing dialogs for interacting with users.

``Dialogs`` is Robot Framework's standard library that provides means
for pausing the test execution and getting input from users. The
dialogs are slightly different depending on whether tests are run on
Python, IronPython or Jython but they provide the same functionality.

Long lines in the provided messages are wrapped automatically since
Robot Framework 2.8. If you want to wrap lines manually, you can add
newlines using the ``\\n`` character sequence.

The library has a known limitation that it cannot be used with timeouts
on Python. Support for IronPython was added in Robot Framework 2.9.2.
"""

from robot.version import get_version
from robot.utils import IRONPYTHON, JYTHON, is_truthy

if JYTHON:
    from .dialogs_jy import MessageDialog, PassFailDialog, InputDialog, SelectionDialog
elif IRONPYTHON:
    from .dialogs_ipy import MessageDialog, PassFailDialog, InputDialog, SelectionDialog
else:
    from .dialogs_py import MessageDialog, PassFailDialog, InputDialog, SelectionDialog


__version__ = get_version()
__all__ = ['execute_manual_step', 'get_value_from_user',
           'get_selection_from_user', 'pause_execution']


[docs]def pause_execution(message='Test execution paused. Press OK to continue.'): """Pauses test execution until user clicks ``Ok`` button. ``message`` is the message shown in the dialog. """ MessageDialog(message).show()
[docs]def execute_manual_step(message, default_error=''): """Pauses test execution until user sets the keyword status. User can press either ``PASS`` or ``FAIL`` button. In the latter case execution fails and an additional dialog is opened for defining the error message. ``message`` is the instruction shown in the initial dialog and ``default_error`` is the default value shown in the possible error message dialog. """ if not _validate_user_input(PassFailDialog(message)): msg = get_value_from_user('Give error message:', default_error) raise AssertionError(msg)
[docs]def get_value_from_user(message, default_value='', hidden=False): """Pauses test execution and asks user to input a value. Value typed by the user, or the possible default value, is returned. Returning an empty value is fine, but pressing ``Cancel`` fails the keyword. ``message`` is the instruction shown in the dialog and ``default_value`` is the possible default value shown in the input field. If ``hidden`` is given a true value, the value typed by the user is hidden. ``hidden`` is considered true if it is a non-empty string not equal to ``false`` or ``no``, case-insensitively. If it is not a string, its truth value is got directly using same [http://docs.python.org/2/library/stdtypes.html#truth-value-testing|rules as in Python]. Example: | ${username} = | Get Value From User | Input user name | default | | ${password} = | Get Value From User | Input password | hidden=yes | Possibility to hide the typed in value is new in Robot Framework 2.8.4. Considering strings ``false`` and ``no`` to be false is new in 2.9. """ return _validate_user_input(InputDialog(message, default_value, is_truthy(hidden)))
[docs]def get_selection_from_user(message, *values): """Pauses test execution and asks user to select a value. The selected value is returned. Pressing ``Cancel`` fails the keyword. ``message`` is the instruction shown in the dialog and ``values`` are the options given to the user. Example: | ${username} = | Get Selection From User | Select user name | user1 | user2 | admin | """ return _validate_user_input(SelectionDialog(message, values))
def _validate_user_input(dialog): value = dialog.show() if value is None: raise RuntimeError('No value provided by user.') return value