server/site_tests/tast/control.generic

# Copyright 2020 The ChromiumOS Authors
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

from autotest_lib.client.common_lib import error
from autotest_lib.client.common_lib import utils
from autotest_lib.server.site_tests.tast import tast

AUTHOR = 'The ChromiumOS Authors'
NAME = 'tast.generic'
METADATA = {
    'contacts': ['tauto-core@google.com'],
    'bug_component': 'b:1034523', # ChromeOS > Test > Harness > Tauto
    'criteria': 'Tauto wrapper for specified tast tests',
}
TIME = 'MEDIUM'
TEST_TYPE = 'Server'
# This test belongs to no suite; it is intended mainly for manual invocation
# via test_that.
ATTRIBUTES = ''
MAX_RESULT_SIZE_KB = 256 * 1024
PY_VERSION = 3

# tast.py uses binaries installed from autotest_server_package.tar.bz2.
REQUIRE_SSP = True

DOC = '''
Run arbitrary Tast tests.

Tast is an integration-testing framework analagous to the test-running portion
of Autotest. See https://chromium.googlesource.com/chromiumos/platform/tast/ for
more information.

This test runs arbitary Tast-based tests specified by args given to test_that.
This test might be useful on debugging to simulate Tast test runs invoked via
Autotest.

Examples:
    test_that --args=tast_expr=example.Pass ${DUT} tast.generic
    test_that --args=tast_expr='("group:mainline")' ${DUT} tast.generic
    test_that --args='tast_expr=example.RuntimeVars tast.example.strvar="Hello_World"' ${DUT} tast.generic
'''

command_args, varslist = tast.split_arguments(args)

def run(machine):
    args_dict = utils.args_to_dict(command_args)
    try:
        expr = args_dict['tast_expr']
    except KeyError:
        raise error.TestFail(
            'Attribute expression is unspecified; set --args=tast_expr=...')
    job.run_test('tast',
                 host=hosts.create_host(machine),
                 test_exprs=[expr],
                 ignore_test_failures=False, max_run_sec=36000,
                 command_args=command_args,
                 varslist=varslist,
                 is_cft=is_cft)

parallel_simple(run, machines)