You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
o3de/Tests/shared/hydra_test_utils.py

79 lines
3.2 KiB
Python

"""
All or portions of this file Copyright (c) Amazon.com, Inc. or its affiliates or
its licensors.
For complete copyright and license terms please see the LICENSE at the root of this
distribution (the "License"). All use of this software is governed by the License,
or, if provided, by the license below or the license accompanying this file. Do not
remove or modify any license notices. This file is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
"""
import logging
import os
import tempfile
import test_tools.shared.log_monitor
import test_tools.launchers.phase
logger = logging.getLogger(__name__)
def prepare_cfg_file(editor_python_script_name, args=[]):
"""
Create a temporary .cfg file containing the python script and args to pass to the Editor.
Ex: If you pass in 'create_level.py', ['LevelName'], you'll get a cfg file with this:
pyRunFile create_level.py LevelName
:param editor_python_script_name: Name of script that will execute in the Editor.
:param args: Additional arguments for CFG, such as LevelName.
:return Config file for Hydra execution
"""
cfg_contents = '-- Auto-generated cfg file\n'
cfg_contents += 'pyRunFile ' + editor_python_script_name
for arg in args:
cfg_contents += ' ' + arg
cfg_contents += '\n'
logger.debug("Preparing a cfg file with the following contents:\n{}".format(cfg_contents))
f = tempfile.NamedTemporaryFile(mode='w+', suffix='.cfg', delete=False)
cfg_filename = f.name
f.write(cfg_contents)
f.close()
logger.debug("Cfg file name: {}".format(cfg_filename))
return cfg_filename
def cleanup_cfg_file(cfg_filename):
"""
Removes the temporary cfg file created in prepare_cfg_file.
:param cfg_filename: Config file for Hydra execution to delete
"""
logger.debug('Cleaning up the generated cfg file')
if os.path.exists(cfg_filename):
os.remove(cfg_filename)
def launch_and_validate_results(test_directory, editor, editor_script, editor_timeout, expected_lines, cfg_args=[]):
"""
Creates a temporary config file for Hydra execution, runs the Editor with the specified script, and monitors for
expected log lines.
:param test_directory: Path to test directory that editor_script lives in.
:param editor: Configured editor object to run test against.
:param editor_script: Name of script that will execute in the Editor.
:param editor_timeout: Timeout for editor run.
:param expected_lines: Expected lines to search log for.
:param cfg_args: Additional arguments for CFG, such as LevelName.
"""
cfg_file_name = prepare_cfg_file(os.path.join(test_directory, editor_script), cfg_args)
logger.debug("Running automated test: {}".format(editor_script))
editor.deploy()
editor.launch(["--skipWelcomeScreenDialog", "--autotest_mode", "--exec", cfg_file_name])
editorlog_file = os.path.join(editor.workspace.release.paths.project_log(), 'Editor.log')
test_tools.shared.log_monitor.monitor_for_expected_lines(editor, editorlog_file, expected_lines)
# Rely on the test script to quit after running
editor.run(test_tools.launchers.phase.WaitForLauncherToQuit(editor, editor_timeout))