1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
# ###################################################
# Copyright (C) 2008-2017 The Unknown Horizons Team
# team@unknown-horizons.org
# This file is part of Unknown Horizons.
#
# Unknown Horizons is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the
# Free Software Foundation, Inc.,
# 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
# ###################################################
from tests.gui import gui_test
# The `gui_test` decorator is needed to identify gui tests. You can use it
# without argument, but is has to be `@gui_test()` (notice the parantheses).
#
# It accepts either one of these arguments:
#
# use_dev_map=True - Game launches with --start-dev-map (no main menu)
# use_fixture='name' - Game launches with --load-game=tests/gui/ingame/fixtures/name.sqlite
# ai_players=1 - Game launches with --ai-players=1
# timeout=3 - Game will be killed after 3 seconds
#
@gui_test(timeout=60)
def test_example(gui):
"""
Documented example test.
Every gui test has to accept one argument, an instance of `tests.gui.GuiHelper`.
"""
gui.disable_autoscroll()
# Main menu
gui.trigger('menu/single_button')
gui.trigger('singleplayermenu/okay')
# Hopefully we're ingame now
assert gui.active_widgets
gold_label = gui.find(name='gold_available')
assert gold_label.text == '30000'
# All commands above run sequentially, neither the engine nor the timer
# will be run. If you need the game to run for some time (or have to wait for
# something to happen), make multiple gui.run() calls.
# Game will run for 2 seconds
gui.run(seconds=2)
"""
while not condition:
gui.run()
"""
# When you call `gui.run()` the engine is allowed to run, therefore updating the display.
# You can also interact with the game as normal, but please don't mess with the test. :)
#
# TIP: You can watch the test in slow-motion if you insert these waits between
# interactions.
# Open game menu
gui.trigger('mainhud/gameMenuButton')
# gui.trigger accepts both a string (container name), or a object returned by gui.find
# Cancel current game
def dialog():
gui.trigger('popup_window/okButton')
# Dialog handling has to be done by a separate generator.
with gui.handler(dialog):
gui.trigger('menu/quit')
# Code execution will continue here once `dialog` has ended.
# Back at the main menu
assert gui.find(name='menu')
# If a test returns None (either implicitly or explicitly) the game will exit, return
# something else and it will continue to run. Useful if you want to check your test's
# action.
# TODO not yet supported, use gui.run(2**10)
#return 1
|
