Remove amp recipe module and related code (unused)

scripts/slave/recipe_modules/amp/api.py

-# 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.
-
-import contextlib
-import json
-
-from recipe_engine import recipe_api
-from recipe_engine import util as recipe_util
-
-class AmpApi(recipe_api.RecipeApi):
-
-  def __init__(self, *args, **kwargs):
-    super(AmpApi, self).__init__(*args, **kwargs)
-    self._trigger_file_dir = None
-    self._base_results_dir = None
-
-  def setup(self):
-    """Sets up necessary configs."""
-    self.m.chromium_android.configure_from_properties('base_config')
-
-  def _get_trigger_dir(self):
-    if not self._trigger_file_dir:
-      self._trigger_file_dir = self.m.path.mkdtemp('amp_trigger')
-    return self._trigger_file_dir
-
-  def _get_trigger_file_for_suite(self, test_run_id):
-    return self._get_trigger_dir().join('%s.json' % test_run_id)
-
-  def _get_results_dir(self, test_run_id):
-    if not self._base_results_dir:
-      self._base_results_dir = self.m.path.mkdtemp('amp_results')
-    return self._base_results_dir.join(test_run_id)
-
-  def _get_results_zip_path(self, test_run_id):
-    return self._get_results_dir(test_run_id).join('results.zip')
-
-  def _get_results_unzipped_path(self, test_run_id):
-    return self._get_results_dir(test_run_id).join('unzipped_results')
-
-  def _get_results_logcat_path(self, test_run_id):
-    return self._get_results_unzipped_path(test_run_id).join(
-        'appurify_results', 'logcat.txt')
-
-  def _get_api_key_file(self):
-    # TODO(phajdan.jr): Remove path['build'] usage, http://crbug.com/437264 .
-    local_api_key_file = self.m.path['build'].join(
-        'site_config', '.amp_%s_key' % self.c.pool)
-    return local_api_key_file
-
-  def _get_api_secret_file(self):
-    # TODO(phajdan.jr): Remove path['build'] usage, http://crbug.com/437264 .
-    local_api_secret_file = self.m.path['build'].join(
-        'site_config', '.amp_%s_secret' % self.c.pool)
-    return local_api_secret_file
-
-  def _ensure_keys_downloaded(self):
-    local_api_key_file = self._get_api_key_file() 
-    if not self.m.path.exists(local_api_key_file):
-      self.m.gsutil.download_url(name='download amp api key',
-                                 url=self.c.api_key_file_url,
-                                 dest=local_api_key_file)
-      self.m.path.mock_add_paths(local_api_key_file)
-
-    local_api_secret_file = self._get_api_secret_file()
-    if not self.m.path.exists(local_api_secret_file):
-      self.m.gsutil.download_url(name='download amp api secret',
-                                 url=self.c.api_secret_file_url,
-                                 dest=local_api_secret_file)
-      self.m.path.mock_add_paths(local_api_secret_file)
-
-  def trigger_test_suite(
-      self, suite, test_type, test_type_args, amp_args, step_name=None,
-      verbose=True):
-    step_name = step_name or suite
-    args = ([test_type] + test_type_args + amp_args
-        + ['--trigger', self.m.json.output()])
-    if verbose:
-      args += ['--verbose']
-    if self.m.chromium.c.BUILD_CONFIG == 'Release':
-      args += ['--release']
-
-    step_test_data = lambda: self.m.json.test_api.output({
-      'env': {
-        'device': {
-          'brand': 'Foo',
-          'name': 'Fone',
-          'os_version': '1.2.3',
-        },
-      },
-      'test_run': {
-        'test_run_id': 'T35TRUN1D',
-      },
-    })
-    self._ensure_keys_downloaded()
-    step_result = self.m.chromium_android.test_runner(
-        '[trigger] %s' % step_name,
-        args=args,
-        step_test_data=step_test_data)
-    trigger_data = step_result.json.output
-    try:
-      device_data = trigger_data['env']['device']
-      step_result.presentation.step_text = 'on %s %s %s' % (
-          device_data['brand'],
-          device_data['name'],
-          device_data['os_version'])
-    except KeyError:
-      step_result.presentation.status = self.m.step.WARNING
-      step_result.presentation.step_text = 'unable to find device info'
-
-    try:
-      test_run_id = trigger_data['test_run']['test_run_id']
-    except KeyError as e:
-      # Log trigger_data json for debugging.
-      with contextlib.closing(recipe_util.StringListIO()) as listio:
-        json.dump(trigger_data, listio, indent=2, sort_keys=True)
-      step_result = self.m.step.active_result
-      step_result.presentation.logs['trigger_data'] = listio.lines
-      raise self.m.step.StepFailure(
-          'test_run_id not found in trigger_data json')
-
-    self.m.file.write(
-        '[trigger] save %s' % step_name,
-        self._get_trigger_file_for_suite(test_run_id),
-        self.m.json.dumps(trigger_data))
-    return test_run_id
-
-  def collect_test_suite(
-      self, suite, test_type, test_type_args, amp_args, test_run_id,
-      step_name=None, verbose=True, json_results_file=None, **kwargs):
-    step_name = step_name or suite
-    args = ([test_type] + test_type_args + amp_args
-        + ['--collect', self._get_trigger_file_for_suite(test_run_id)]
-        + ['--results-path', self._get_results_zip_path(test_run_id)])
-    trigger_data = self.m.json.read(
-        '[collect] load %s' % step_name,
-        self._get_trigger_file_for_suite(test_run_id),
-        step_test_data=lambda: self.m.json.test_api.output({
-          'env': {
-            'device': {
-              'brand': 'Foo',
-              'name': 'Fone',
-              'os_version': '1.2.3',
-            }
-          }
-        })).json.output
-    try:
-      device_data = trigger_data['env']['device']
-      device_info_text = 'on %s %s %s' % (
-          device_data['brand'],
-          device_data['name'],
-          device_data['os_version'])
-    except KeyError:
-      device_data = None
-      device_info_text = 'unable to find device info'
-
-    if verbose:
-      args += ['--verbose']
-    if json_results_file:
-      args += ['--json-results-file', json_results_file]
-    if self.m.chromium.c.BUILD_CONFIG == 'Release':
-      args += ['--release']
-    try:
-      step_result = self.m.chromium_android.test_runner(
-          '[collect] %s' % step_name,
-          args=args, **kwargs)
-    except self.m.step.StepFailure as f:
-      step_result = f.result
-      raise
-    finally:
-      step_result.presentation.step_text = device_info_text
-      if (not device_data and
-          step_result.presentation.status == self.m.step.SUCCESS):
-        step_result.presentation.status = self.m.step.WARNING
-
-    return step_result
-
-  def upload_logcat_to_gs(self, bucket, suite, test_run_id):
-    """Upload the logcat file returned from the appurify results to
-    Google Storage.
-    """
-    step_result = self.m.json.read(
-        '[upload logcat] load %s data' % suite,
-        self._get_trigger_file_for_suite(test_run_id),
-        step_test_data=lambda: self.m.json.test_api.output({
-          'test_run': {
-            'test_run_id': '12345abcde',
-          }
-        }))
-    trigger_data = step_result.json.output
-    self.m.zip.unzip(
-        step_name='[upload logcat] unzip results for %s' % suite,
-        zip_file=self._get_results_zip_path(test_run_id),
-        output=self._get_results_unzipped_path(test_run_id))
-    self.m.gsutil.upload(
-        name='[upload logcat] %s' % suite,
-        source=self._get_results_logcat_path(test_run_id),
-        bucket=bucket,
-        dest='logcats/logcat_%s_%s.txt' % (suite, test_run_id),
-        link_name='logcat')
-
-  def gtest_arguments(
-      self, suite, isolate_file_path=None):
-    """Generate command-line arguments for running gtests.
-
-    Args:
-      suite: The name of the test suite to run.
-      isolate_file_path: The path to the .isolate file containing data
-        dependency information for the test suite.
-
-    Returns:
-      A list of command-line arguments as strings.
-    """
-    gtest_args = ['-s', suite]
-    if isolate_file_path:
-      gtest_args += ['--isolate-file-path', isolate_file_path]
-    return gtest_args
-
-  def instrumentation_test_arguments(
-      self, apk_under_test, test_apk, isolate_file_path=None,
-      additional_apks=None, annotation=None, timeout_scale=None):
-    """Generate command-line arguments for running instrumentation tests.
-
-    Args:
-      apk_under_test: The path to the APK under test.
-      test_apk: The path to the test APK.
-      isolate_file_path: The path to the .isolate file containing data
-        dependency information for the test suite.
-      annotation: Comma-separated list of annotations. Will only run
-        tests with any of the given annotations.
-      timeout_scale: Scale for the timeouts of individual tests.
-
-    Returns:
-      A list of command-line arguments as strings.
-    """
-    instrumentation_test_args = [
-        '--apk-under-test', apk_under_test,
-        '--test-apk', test_apk,
-    ]
-    if isolate_file_path:
-      instrumentation_test_args += ['--isolate-file-path', isolate_file_path]
-    if annotation:
-      instrumentation_test_args += ['--annotation', annotation]
-    if additional_apks:
-      for apk in additional_apks:
-        instrumentation_test_args += ['--additional-apk', apk]
-    if timeout_scale:
-      instrumentation_test_args += ['--timeout-scale', timeout_scale]
-    return instrumentation_test_args
-
-  def uirobot_arguments(self, app_under_test=None, minutes=5):
-    """Generate command-line arguments for running uirobot tests.
-
-    Args:
-      app_under_test: The app to run uirobot tests on.
-      minutes: The number of minutes for which the uirobot tests should be
-        run. Defaults to 5.
-
-    Returns:
-      A list of command-line arguments as strings.
-    """
-    uirobot_args = ['--minutes', minutes]
-    if app_under_test:
-      uirobot_args += ['--app-under-test', app_under_test]
-    return uirobot_args
-
-  def amp_arguments(
-      self, device_type='Android', device_minimum_os=None, device_name=None,
-      device_oem=None, device_os=None, device_timeout=None, api_address=None,
-      api_port=None, api_protocol=None, network_config=None,
-      test_run_timeout=None):
-    """Generate command-line arguments for running tests on AMP.
-
-    Args:
-      device_name: A list of names of devices to use (e.g. 'Galaxy S4').
-        Selects a device at random if unspecified.
-      device_minimum_os: A string containing the minimum OS version to use.
-        Should not be specified with |device_os|.
-      device_oem: A list of names of device OEMs to use (e.g. 'Samsung').
-        Selects an OEM at random is unspecified.
-      device_os: A list of OS versions to use (e.g. '4.4.2'). Selects an OS
-        version at random if unspecified. Should not be specified with
-        |device_minimum_os|.
-      device_timeout: An optional number of seconds to wait for a device
-        meeting the given criteria to be available.
-      api_address: The IP address of the AMP API endpoint.
-      api_port: The port of the AMP API endpoint.
-      api_protocol: The protocol to use to connect to the AMP API endpoint.
-      network_config: Use to have AMP run tests in a simulated network
-        environment. See the availible network environment options at
-        https://appurify.atlassian.net/wiki/display/APD/
-          Run+Configurations+-+Test+and+Network
-      test_run_timeout: The timeout for the test runtime on AMP.
-
-    Returns:
-      A list of command-line arguments as strings.
-    """
-    assert api_address, 'api_address not specified'
-    assert api_port, 'api_port not specified'
-    assert api_protocol, 'api_protocol not specified'
-    assert not (device_minimum_os and device_os), (
-        'cannot specify both device_minimum_os and device_os')
-    amp_args = [
-        '--enable-platform-mode',
-        '-e', 'remote_device',
-        '--api-key-file',
-        self._get_api_key_file(),
-        '--api-secret-file',
-        self._get_api_secret_file(),
-        '--api-address', api_address,
-        '--api-port', api_port,
-        '--api-protocol', api_protocol,
-        '--device-type', device_type,
-    ]
-    if device_minimum_os:
-      amp_args += ['--remote-device-minimum-os', device_minimum_os]
-
-    for d in device_name or []:
-      amp_args += ['--remote-device', d]
-
-    for d in device_oem or []:
-      amp_args += ['--device-oem', d]
-
-    for d in device_os or []:
-      amp_args += ['--remote-device-os', d]
-
-    if device_timeout:
-      amp_args += ['--remote-device-timeout', device_timeout]
-
-    if network_config:
-      amp_args += ['--network-config', network_config]
-
-    if test_run_timeout:
-      amp_args += ['--test-timeout', test_run_timeout]
-
-    return amp_args
-