blob: 0fbe1f174499b28138522482ee5fb41de34c5ed2 [file] [log] [blame]
// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "base/at_exit.h"
#include "base/bind.h"
#include "base/command_line.h"
#include "base/files/file_path.h"
#include "base/logging.h"
#include "base/message_loop/message_loop.h"
#include "base/strings/stringprintf.h"
#include "base/test/launcher/unit_test_launcher.h"
#include "base/test/test_suite.h"
#include "base/test/test_switches.h"
#include "google_apis/google_api_keys.h"
#include "net/base/escape.h"
#include "remoting/test/app_remoting_test_driver_environment.h"
#include "testing/gtest/include/gtest/gtest.h"
namespace switches {
const char kAuthCodeSwitchName[] = "authcode";
const char kHelpSwitchName[] = "help";
const char kLoggingLevelSwitchName[] = "verbosity";
const char kRefreshTokenFileSwitchName[] = "refresh-token-file";
const char kReleaseHostsAfterTestingSwitchName[] = "release-hosts-after-tests";
const char kShowHostAvailabilitySwitchName[] = "show-host-availability";
const char kSingleProcessTestsSwitchName[] = "single-process-tests";
const char kUserNameSwitchName[] = "username";
} // namespace switches
namespace {
// Requested permissions needed for App Remoting tests. The spaces in between
// scope fragments are necessary and will be escaped properly before use.
const char kAppRemotingAuthScopeValues[] =
std::string GetAuthorizationCodeUri() {
// Replace space characters with a '+' sign when formatting.
bool use_plus = true;
return base::StringPrintf(
net::EscapeUrlEncodedData(kAppRemotingAuthScopeValues, use_plus).c_str(),
void PrintUsage() {
printf("*** App Remoting Test Driver Usage ***\n");
printf(" ar_test_driver --username=<> [options]\n");
printf("\nRequired Parameters:\n");
printf(" %s: Specifies which account to use when running tests\n",
printf("\nOptional Parameters:\n");
printf(" %s: Exchanged for a refresh and access token for authentication\n",
printf(" %s: Path to a JSON file containing username/refresh_token KVPs\n",
printf(" %s: Displays additional usage information\n",
" %s: Retrieves and displays the connection status for all known "
"hosts, no tests will be run\n",
" %s: Send a message to the service after all tests have been run to "
"release remote hosts the tool used for testing.\n",
" %s: Specifies the optional logging level of the tool (0-3)."
" [default: off]\n",
void PrintAuthCodeInfo() {
printf("*** Auth Code Example Usage ***\n");
printf("If this is the first time you are running the tool,\n");
printf("you will need to provide an authorization code.\n");
printf("This code will be exchanged for a long term refresh token which\n");
printf("will be stored locally and used to acquire a short lived access\n");
printf("token to connect to the remoting service apis and establish a\n");
printf("remote host connection.\n\n");
printf("Note: You may need to repeat this step if the stored refresh token");
printf("\n has been revoked or expired.\n");
printf(" Passing in the same auth code twice will result in an error\n");
"\nFollow these steps to produce an auth code:\n"
" - Open the Authorization URL link shown below in your browser\n"
" - Approve the requested permissions for the tool\n"
" - Copy the 'code' value in the redirected URL\n"
" - Run the tool and pass in copied auth code as a parameter\n");
printf("\nAuthorization URL:\n");
printf("%s\n", GetAuthorizationCodeUri().c_str());
printf("\nRedirected URL Example:\n");
printf("\nTool usage example with the newly created auth code:\n");
printf("ar_test_driver --%s=4/AKtf...\n\n",
switches::kUserNameSwitchName, switches::kAuthCodeSwitchName);
void PrintJsonFileInfo() {
printf("*** Refresh Token File Example Usage ***\n");
printf("In order to use this option, a valid JSON file must exist, be\n");
printf("properly formatted, and contain a username/token KVP.\n");
printf("Contents of example_file.json\n");
printf(" \"\": \"1/3798Gsdf898shksdvfyi8sshad\",\n");
printf(" \"\": \"1/8974sdf87asdgadfgaerhfRsAa\",\n");
printf("\nTool usage example:\n");
printf("ar_test_driver --%s=%s --%s=./example_file.json\n\n",
switches::kUserNameSwitchName, "",
} // namespace
int main(int argc, char** argv) {
base::TestSuite test_suite(argc, argv);
base::MessageLoopForIO message_loop;
if (!base::CommandLine::InitializedForCurrentProcess()) {
if (!base::CommandLine::Init(argc, argv)) {
LOG(ERROR) << "Failed to initialize command line singleton.";
return -1;
// The pointer returned here refers to a singleton, since we don't own the
// lifetime of the object, don't wrap in a scoped_ptr construct or release it.
base::CommandLine* command_line = base::CommandLine::ForCurrentProcess();
// We do not want to retry failures as a failed test should signify an error
// to be investigated.
command_line->AppendSwitchASCII(switches::kTestLauncherRetryLimit, "0");
// We do not want to run the tests in parallel and we do not want to retry
// failures. The reason for running in a single process is that some tests
// may share the same remoting host and they cannot be run concurrently, also
// the test output gets spammed with test launcher messages which reduces the
// readability of the results.
// If the user passed in the help flag, then show the help info for this tool
// and 'run' the tests which will print the gtest specific help and then exit.
// NOTE: We do this check after updating the switches as otherwise the gtest
// help is written in parallel with our text and can appear interleaved.
if (command_line->HasSwitch(switches::kHelpSwitchName)) {
#if defined(OS_IOS)
return base::LaunchUnitTests(
argc, argv,
base::Bind(&base::TestSuite::Run, base::Unretained(&test_suite)));
return base::LaunchUnitTestsSerially(
argc, argv,
base::Bind(&base::TestSuite::Run, base::Unretained(&test_suite)));
remoting::test::AppRemotingTestDriverEnvironment::EnvironmentOptions options;
// Verify we received the required input from the command line.
options.user_name =
if (options.user_name.empty()) {
LOG(ERROR) << "No user name passed in, can't authenticate without that!";
return -1;
VLOG(1) << "Running tests as: " << options.user_name;
// Check to see if the user passed in a one time use auth_code for
// refreshing their credentials.
std::string auth_code(
options.refresh_token_file_path =
options.release_hosts_when_done =
options.service_environment =
// Update the logging verbosity level is user specified one.
std::string verbosity_level(
if (!verbosity_level.empty()) {
// Turn on logging for the test_driver and remoting components.
// This switch is parsed during logging::InitLogging.
"*/remoting/*=" + verbosity_level);
logging::LoggingSettings logging_settings;
// Create and register our global test data object. It will handle
// retrieving an access token for the user and spinning up VMs.
// The GTest framework will own the lifetime of this object once
// it is registered below.
std::unique_ptr<remoting::test::AppRemotingTestDriverEnvironment> shared_data(
if (!shared_data->Initialize(auth_code)) {
// If we failed to initialize our shared data object, then bail.
return -1;
if (command_line->HasSwitch(switches::kShowHostAvailabilitySwitchName)) {
// When this flag is specified, we will retrieve connection information
// for all known applications and report the status. Tests can be skipped
// using a gtest_filter flag.
// Since we've successfully set up our shared_data object, we'll assign the
// value to our global* and transfer ownership to the framework.
remoting::test::AppRemotingSharedData = shared_data.release();
// Because many tests may access the same remoting host(s), we need to run
// the tests sequentially so they do not interfere with each other.
#if defined(OS_IOS)
return base::LaunchUnitTests(
argc, argv,
base::Bind(&base::TestSuite::Run, base::Unretained(&test_suite)));
return base::LaunchUnitTestsSerially(
argc, argv,
base::Bind(&base::TestSuite::Run, base::Unretained(&test_suite)));