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


// Note: This grpc service is a short term solution that will be deprecated
// once the CTRv2 is complete

syntax = "proto3";

package chromiumos.test.api;

option go_package = "go.chromium.org/chromiumos/config/go/test/api";

service CrosTestRunnerService {
    // Executes the given tests on the given dut
    rpc Run(RunCrosTestRequest) returns (RunCrosTestResponse) {}
}

message RunCrosTestRequest {
    message AutotestArg {
        // The name of the autotest argument
        string flag = 1;
        // The value of the autotest argument
        string value = 2;
    }
    // The ip of the dut
    string host = 1;
    // The board name of the dut
    string board = 2;
    // The tast and tauto tests to run on the dut
    repeated string tests = 3;
    // The directory where test results and logs will be placed
    string results_dir_name = 4;
    // Custom arguments passed into the autotest test harness
    repeated AutotestArg autotest_args = 5;
    // The docker image tag of cros-test container to run
    string cros_test_image_tag = 6;
}

message RunCrosTestResponse {
    // standard out from the run
    string stdout = 1;
    // standard err from the run
    string stderr = 2;
    // return code
    int32 return_code = 3;
}