docs: Add a test example written in Python

See: https://progress.opensuse.org/issues/91257

docs/WritingTests.asciidoc

@@ -157,6 +157,37 @@ sub run() {
 }
 --------------------------------------------------------------
 
+In addition to Perl, it is possible to write tests in Python. Although the
+boilerplate is slightly different the function names are the same.
+
+[caption="Example: "]
+.Test for the openQA web UI written in Python
+[source,python]
+--------------------------------------------------------------
+from testapi import *
+
+
+def run(self):
+    assert_screen('openqa-logged-in')
+    assert_and_click('openqa-search')
+    type_string('shutdown.pm')
+    send_key('ret')
+    assert_screen('openqa-search-results')
+
+
+def switch_to_root_console():
+    send_key('ctrl-alt-f3')
+
+
+def post_fail_hook(self):
+    switch_to_root_console()
+    assert_script_run('openqa-cli api experimental/search q=shutdown.pm')
+
+
+def test_flags(self):
+    return {'fatal': 1}
+--------------------------------------------------------------
+
 == Variables
 
 Test case behavior can be controlled via variables. Some basic