// 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[] = "https://www.googleapis.com/auth/appremoting.runapplication" " https://www.googleapis.com/auth/googletalk" " https://www.googleapis.com/auth/userinfo.email" " https://docs.google.com/feeds" " https://www.googleapis.com/auth/drive"; std::string GetAuthorizationCodeUri() { // Replace space characters with a '+' sign when formatting. bool use_plus = true; return base::StringPrintf( "https://accounts.google.com/o/oauth2/auth" "?scope=%s" "&redirect_uri=https://chromoting-oauth.talkgadget.google.com/" "talkgadget/oauth/chrome-remote-desktop/dev" "&response_type=code" "&client_id=%s" "&access_type=offline" "&approval_prompt=force", net::EscapeUrlEncodedData(kAppRemotingAuthScopeValues, use_plus).c_str(), net::EscapeUrlEncodedData( google_apis::GetOAuth2ClientID(google_apis::CLIENT_REMOTING), use_plus).c_str()); } void PrintUsage() { printf("\n**************************************\n"); printf("*** App Remoting Test Driver Usage ***\n"); printf("**************************************\n"); printf("\nUsage:\n"); printf(" ar_test_driver --username= [options]\n"); printf("\nRequired Parameters:\n"); printf(" %s: Specifies which account to use when running tests\n", switches::kUserNameSwitchName); printf("\nOptional Parameters:\n"); printf(" %s: Exchanged for a refresh and access token for authentication\n", switches::kAuthCodeSwitchName); printf(" %s: Path to a JSON file containing username/refresh_token KVPs\n", switches::kRefreshTokenFileSwitchName); printf(" %s: Displays additional usage information\n", switches::kHelpSwitchName); printf( " %s: Retrieves and displays the connection status for all known " "hosts, no tests will be run\n", switches::kShowHostAvailabilitySwitchName); printf( " %s: Send a message to the service after all tests have been run to " "release remote hosts the tool used for testing.\n", switches::kReleaseHostsAfterTestingSwitchName); printf( " %s: Specifies the optional logging level of the tool (0-3)." " [default: off]\n", switches::kLoggingLevelSwitchName); } void PrintAuthCodeInfo() { printf("\n*******************************\n"); printf("*** Auth Code Example Usage ***\n"); printf("*******************************\n\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"); printf( "\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( "https://chromoting-oauth.talkgadget.google.com/talkgadget/oauth/" "chrome-remote-desktop/dev?code=4/AKtf...\n"); printf("\nTool usage example with the newly created auth code:\n"); printf("ar_test_driver --%s=example@gmail.com --%s=4/AKtf...\n\n", switches::kUserNameSwitchName, switches::kAuthCodeSwitchName); } void PrintJsonFileInfo() { printf("\n*****************************************\n"); printf("*** Refresh Token File Example Usage ***\n"); printf("****************************************\n\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("{\n"); printf(" \"username1@fauxdomain.com\": \"1/3798Gsdf898shksdvfyi8sshad\",\n"); printf(" \"username2@fauxdomain.com\": \"1/8974sdf87asdgadfgaerhfRsAa\",\n"); printf("}\n\n"); printf("\nTool usage example:\n"); printf("ar_test_driver --%s=%s --%s=./example_file.json\n\n", switches::kUserNameSwitchName, "username1@fauxdomain.com", switches::kRefreshTokenFileSwitchName); } } // 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(); DCHECK(command_line); // 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. command_line->AppendSwitch(switches::kSingleProcessTestsSwitchName); // 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)) { PrintUsage(); PrintJsonFileInfo(); PrintAuthCodeInfo(); 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 = command_line->GetSwitchValueASCII(switches::kUserNameSwitchName); if (options.user_name.empty()) { LOG(ERROR) << "No user name passed in, can't authenticate without that!"; PrintUsage(); 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( command_line->GetSwitchValueASCII(switches::kAuthCodeSwitchName)); options.refresh_token_file_path = command_line->GetSwitchValuePath(switches::kRefreshTokenFileSwitchName); options.release_hosts_when_done = command_line->HasSwitch(switches::kReleaseHostsAfterTestingSwitchName); options.service_environment = remoting::test::ServiceEnvironment::kDeveloperEnvironment; // Update the logging verbosity level is user specified one. std::string verbosity_level( command_line->GetSwitchValueASCII(switches::kLoggingLevelSwitchName)); if (!verbosity_level.empty()) { // Turn on logging for the test_driver and remoting components. // This switch is parsed during logging::InitLogging. command_line->AppendSwitchASCII("vmodule", "*/remoting/*=" + verbosity_level); logging::LoggingSettings logging_settings; logging::InitLogging(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. scoped_ptr shared_data( remoting::test::CreateAppRemotingTestDriverEnvironment(options)); 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. shared_data->ShowHostAvailability(); } // 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(); testing::AddGlobalTestEnvironment(remoting::test::AppRemotingSharedData); // 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. return base::LaunchUnitTestsSerially( argc, argv, base::Bind(&base::TestSuite::Run, base::Unretained(&test_suite))); }