Added --event-firing-webdriver argument to test runner

An example of invoking the event firing webdriver,

python atest\run.py --nounit --event-firing-webdriver firefox --suite=selenium_move_to_workaround

Author: emanlove

atest/acceptance/2-event_firing_webdriver/selenium_move_to_workaround.robot

@@ -1,10 +1,14 @@
 *** Settings ***
 Documentation    Can be deleted when minimum Selenium version 4.0
-Library          SeleniumLibrary     event_firing_webdriver=${CURDIR}/MyListener.py
+Library          SeleniumLibrary     event_firing_webdriver=${event_firing_or_none}
 Resource         resource_event_firing_webdriver.robot
 Force Tags       NoGrid
 Suite Setup      Open Browser    ${FRONT PAGE}    ${BROWSER}    alias=event_firing_webdriver
 ...              remote_url=${REMOTE_URL}    desired_capabilities=${DESIRED_CAPABILITIES}
+Suite Teardown    Close All Browsers
+
+*** Variables ***
+${event_firing_or_none}     ${NONE}
 
 *** Test Cases ***
 Selenium move_to workaround Click Element At Coordinates
@@ -16,7 +20,7 @@ Selenium move_to workaround Scroll Element Into View
     Scroll Element Into View    id:some_id
 
 Selenium move_to workaround Mouse Out
-    [Documentation]    LOG 1:8 DEBUG  Workaround for Selenium 3 bug.
+    [Documentation]    LOG 1:5 DEBUG  Workaround for Selenium 3 bug.
     Mouse Out    id:some_id
 
 Selenium move_to workaround Mouse Over
@@ -40,7 +44,7 @@ Click Element Action Chain
     [Tags]    NoGrid
     [Documentation]
     ...    LOB 1:1 INFO        Clicking 'singleClickButton' using an action chain.
-    ...    LOG 2:5 DEBUG GLOB: *actions {"actions": [{*
+    ...    LOG 2:6 DEBUG GLOB: *actions {"actions": [{*
     [Setup]    Initialize Page For Click Element
     Click Element    singleClickButton      action_chain=True
     Element Text Should Be    output    single clicked

atest/acceptance/2-event_firing_webdriver/MyListener.py renamed to atest/resources/testlibs/MyListener.py

@@ -74,6 +74,7 @@
 SRC_DIR = os.path.normpath(os.path.join(ROOT_DIR, os.pardir, "src"))
 TEST_LIBS_DIR = os.path.join(RESOURCES_DIR, "testlibs")
 HTTP_SERVER_FILE = os.path.join(RESOURCES_DIR, "testserver", "testserver.py")
+EVENT_FIRING_LISTENER = os.path.join(RESOURCES_DIR, "testlibs", "MyListener.py")
 
 ROBOT_OPTIONS = [
     "--doc",
@@ -101,14 +102,14 @@
 ]
 
 
-def acceptance_tests(interpreter, browser, rf_options=None, grid=None):
+def acceptance_tests(interpreter, browser, rf_options=None, grid=None, event_firing=None):
     if os.path.exists(RESULTS_DIR):
         shutil.rmtree(RESULTS_DIR)
     os.mkdir(RESULTS_DIR)
     if grid:
         hub, node = start_grid()
     with http_server():
-        execute_tests(interpreter, browser, rf_options, grid)
+        execute_tests(interpreter, browser, rf_options, grid, event_firing)
     failures = process_output(browser)
     if failures:
         print(
@@ -191,7 +192,7 @@ def http_server():
         serverlog.close()
 
 
-def execute_tests(interpreter, browser, rf_options, grid):
+def execute_tests(interpreter, browser, rf_options, grid, event_firing):
     options = []
     if grid:
         runner = interpreter.split() + [
@@ -215,6 +216,11 @@ def execute_tests(interpreter, browser, rf_options, grid):
         ]
     else:
         command += ["--exclude", "OnlyGrid"]
+    if event_firing:
+        command += [
+            "--variable",
+            f"event_firing_or_none:{EVENT_FIRING_LISTENER}",
+        ]
     command += options + [ACCEPTANCE_TEST_DIR]
     log_start(command)
     syslog = os.path.join(RESULTS_DIR, "syslog.txt")
@@ -296,18 +302,25 @@ def create_zip():
         default=False,
         action="store_true",
     )
+    parser.add_argument(
+        "--event-firing-webdriver",
+        help="Run tests using event firing webdriver.",
+        default=False,
+        action="store_true",
+    )
     args, rf_options = parser.parse_known_args()
     browser = args.browser.lower().strip()
     selenium_grid = is_truthy(args.grid)
     interpreter = args.interpreter
+    event_firing_webdriver = args.event_firing_webdriver
     if args.nounit:
         print("Not running unit tests.")
     else:
         rc = subprocess.call([interpreter, UNIT_TEST_RUNNER])
         if rc != 0:
             print("Not running acceptance test, because unit tests failed.")
             sys.exit(rc)
-    failures = acceptance_tests(interpreter, browser, rf_options, selenium_grid)
+    failures = acceptance_tests(interpreter, browser, rf_options, selenium_grid, event_firing_webdriver)
     if args.zip:
         create_zip()
     sys.exit(failures)