| # Copyright 2012 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 copy |
| import logging |
| import optparse |
| import os |
| import shlex |
| import sys |
| |
| from telemetry.core import browser_finder |
| from telemetry.core import profile_types |
| from telemetry.core import util |
| from telemetry.core import wpr_modes |
| from telemetry.core.platform.profiler import profiler_finder |
| |
| util.AddDirToPythonPath( |
| util.GetChromiumSrcDir(), 'third_party', 'webpagereplay') |
| import net_configs # pylint: disable=F0401 |
| |
| |
| class BrowserFinderOptions(optparse.Values): |
| """Options to be used for discovering a browser.""" |
| |
| def __init__(self, browser_type=None): |
| optparse.Values.__init__(self) |
| |
| self.browser_type = browser_type |
| self.browser_executable = None |
| self.chrome_root = None |
| self.android_device = None |
| self.cros_ssh_identity = None |
| |
| self.extensions_to_load = [] |
| |
| # If set, copy the generated profile to this path on exit. |
| self.output_profile_path = None |
| |
| self.cros_remote = None |
| |
| self.profiler = None |
| self.verbosity = 0 |
| |
| self.report_root_metrics = False |
| |
| self.browser_options = BrowserOptions() |
| self.output_file = None |
| self.skip_navigate_on_repeat = False |
| |
| self.android_rndis = False |
| |
| def __repr__(self): |
| return str(sorted(self.__dict__.items())) |
| |
| def Copy(self): |
| return copy.deepcopy(self) |
| |
| def CreateParser(self, *args, **kwargs): |
| parser = optparse.OptionParser(*args, **kwargs) |
| |
| # Selection group |
| group = optparse.OptionGroup(parser, 'Which browser to use') |
| group.add_option('--browser', |
| dest='browser_type', |
| default=None, |
| help='Browser type to run, ' |
| 'in order of priority. Supported values: list,%s' % |
| ','.join(browser_finder.ALL_BROWSER_TYPES)) |
| group.add_option('--browser-executable', |
| dest='browser_executable', |
| help='The exact browser to run.') |
| group.add_option('--chrome-root', |
| dest='chrome_root', |
| help='Where to look for chrome builds.' |
| 'Defaults to searching parent dirs by default.') |
| group.add_option('--device', |
| dest='android_device', |
| help='The android device ID to use' |
| 'If not specified, only 0 or 1 connected devcies are supported.') |
| group.add_option( |
| '--remote', |
| dest='cros_remote', |
| help='The IP address of a remote ChromeOS device to use.') |
| identity = None |
| testing_rsa = os.path.join( |
| util.GetChromiumSrcDir(), |
| 'third_party', 'chromite', 'ssh_keys', 'testing_rsa') |
| if os.path.exists(testing_rsa): |
| identity = testing_rsa |
| group.add_option('--identity', |
| dest='cros_ssh_identity', |
| default=identity, |
| help='The identity file to use when ssh\'ing into the ChromeOS device') |
| parser.add_option_group(group) |
| |
| # Debugging options |
| group = optparse.OptionGroup(parser, 'When things go wrong') |
| profiler_choices = profiler_finder.GetAllAvailableProfilers() |
| group.add_option( |
| '--profiler', default=None, type='choice', |
| choices=profiler_choices, |
| help='Record profiling data using this tool. Supported values: ' + |
| ', '.join(profiler_choices)) |
| group.add_option( |
| '--interactive', dest='interactive', action='store_true', |
| help='Let the user interact with the page; the actions specified for ' |
| 'the page are not run.') |
| group.add_option( |
| '-v', '--verbose', action='count', dest='verbosity', |
| help='Increase verbosity level (repeat as needed)') |
| group.add_option('--print-bootstrap-deps', |
| action='store_true', |
| help='Output bootstrap deps list.') |
| parser.add_option_group(group) |
| |
| # Platform options |
| group = optparse.OptionGroup(parser, 'Platform options') |
| group.add_option('--no-performance-mode', action='store_true', |
| help='Some platforms run on "full performance mode" where the ' |
| 'test is executed at maximum CPU speed in order to minimize noise ' |
| '(specially important for dashboards / continuous builds). ' |
| 'This option prevents Telemetry from tweaking such platform settings.') |
| group.add_option( |
| '--report-root-metrics', action='store_true',dest='report_root_metrics', |
| help='Enable metrics that require root access to record.') |
| group.add_option('--android-rndis', dest='android_rndis', default=False, |
| action='store_true', help='Use RNDIS forwarding on Android.') |
| group.add_option('--no-android-rndis', dest='android_rndis', |
| action='store_false', help='Do not use RNDIS forwarding on Android.' |
| ' [default]') |
| parser.add_option_group(group) |
| |
| # Browser options. |
| self.browser_options.AddCommandLineArgs(parser) |
| |
| real_parse = parser.parse_args |
| def ParseArgs(args=None): |
| defaults = parser.get_default_values() |
| for k, v in defaults.__dict__.items(): |
| if k in self.__dict__ and self.__dict__[k] != None: |
| continue |
| self.__dict__[k] = v |
| ret = real_parse(args, self) # pylint: disable=E1121 |
| |
| if self.verbosity >= 2: |
| logging.getLogger().setLevel(logging.DEBUG) |
| elif self.verbosity: |
| logging.getLogger().setLevel(logging.INFO) |
| else: |
| logging.getLogger().setLevel(logging.WARNING) |
| |
| if self.browser_executable and not self.browser_type: |
| self.browser_type = 'exact' |
| if self.browser_type == 'list': |
| try: |
| types = browser_finder.GetAllAvailableBrowserTypes(self) |
| except browser_finder.BrowserFinderException, ex: |
| sys.stderr.write('ERROR: ' + str(ex)) |
| sys.exit(1) |
| sys.stdout.write('Available browsers:\n') |
| sys.stdout.write(' %s\n' % '\n '.join(types)) |
| sys.exit(0) |
| |
| # Parse browser options. |
| self.browser_options.UpdateFromParseResults(self) |
| |
| return ret |
| parser.parse_args = ParseArgs |
| return parser |
| |
| def AppendExtraBrowserArgs(self, args): |
| self.browser_options.AppendExtraBrowserArgs(args) |
| |
| def MergeDefaultValues(self, defaults): |
| for k, v in defaults.__dict__.items(): |
| self.ensure_value(k, v) |
| |
| class BrowserOptions(object): |
| """Options to be used for launching a browser.""" |
| def __init__(self): |
| self.browser_type = None |
| self.show_stdout = False |
| |
| # When set to True, the browser will use the default profile. Telemetry |
| # will not provide an alternate profile directory. |
| self.dont_override_profile = False |
| self.profile_dir = None |
| self.profile_type = None |
| self._extra_browser_args = set() |
| self.extra_wpr_args = [] |
| self.wpr_mode = wpr_modes.WPR_OFF |
| self.netsim = None |
| |
| self.no_proxy_server = False |
| self.browser_user_agent_type = None |
| |
| self.clear_sytem_cache_for_browser_and_profile_on_start = False |
| self.startup_url = None |
| |
| # Background pages of built-in component extensions can interfere with |
| # performance measurements. |
| self.disable_component_extensions_with_background_pages = True |
| |
| self.platform = None |
| |
| # Whether to use the new code path for choosing an ephemeral port for |
| # DevTools. The bots set this to true. When Chrome 37 reaches stable, |
| # remove this setting and the old code path. http://crbug.com/379980 |
| self.use_devtools_active_port = False |
| |
| def __repr__(self): |
| return str(sorted(self.__dict__.items())) |
| |
| @classmethod |
| def AddCommandLineArgs(cls, parser): |
| |
| ############################################################################ |
| # Please do not add any more options here without first discussing with # |
| # a telemetry owner. This is not the right place for platform-specific # |
| # options. # |
| ############################################################################ |
| |
| group = optparse.OptionGroup(parser, 'Browser options') |
| profile_choices = profile_types.GetProfileTypes() |
| group.add_option('--profile-type', |
| dest='profile_type', |
| type='choice', |
| default='clean', |
| choices=profile_choices, |
| help=('The user profile to use. A clean profile is used by default. ' |
| 'Supported values: ' + ', '.join(profile_choices))) |
| group.add_option('--profile-dir', |
| dest='profile_dir', |
| help='Profile directory to launch the browser with. ' |
| 'A clean profile is used by default') |
| group.add_option('--extra-browser-args', |
| dest='extra_browser_args_as_string', |
| help='Additional arguments to pass to the browser when it starts') |
| group.add_option('--extra-wpr-args', |
| dest='extra_wpr_args_as_string', |
| help=('Additional arguments to pass to Web Page Replay. ' |
| 'See third_party/webpagereplay/replay.py for usage.')) |
| group.add_option('--netsim', default=None, type='choice', |
| choices=net_configs.NET_CONFIG_NAMES, |
| help=('Run benchmark under simulated network conditions. ' |
| 'Will prompt for sudo. Supported values: ' + |
| ', '.join(net_configs.NET_CONFIG_NAMES))) |
| group.add_option('--show-stdout', |
| action='store_true', |
| help='When possible, will display the stdout of the process') |
| # This hidden option is to be removed, and the older code path deleted, |
| # once Chrome 37 reaches Stable. http://crbug.com/379980 |
| group.add_option('--use-devtools-active-port', |
| action='store_true', |
| help=optparse.SUPPRESS_HELP) |
| parser.add_option_group(group) |
| |
| group = optparse.OptionGroup(parser, 'Compatibility options') |
| group.add_option('--gtest_output', |
| help='Ignored argument for compatibility with runtest.py harness') |
| parser.add_option_group(group) |
| |
| group = optparse.OptionGroup(parser, 'Synthetic gesture options') |
| synthetic_gesture_source_type_choices = [ 'default', 'mouse', 'touch' ] |
| group.add_option('--synthetic-gesture-source-type', |
| dest='synthetic_gesture_source_type', |
| default='default', type='choice', |
| choices=synthetic_gesture_source_type_choices, |
| help='Specify the source type for synthetic gestures. Note that some ' + |
| 'actions only support a specific source type. ' + |
| 'Supported values: ' + |
| ', '.join(synthetic_gesture_source_type_choices)) |
| parser.add_option_group(group) |
| |
| |
| def UpdateFromParseResults(self, finder_options): |
| """Copies our options from finder_options""" |
| browser_options_list = [ |
| 'extra_browser_args_as_string', |
| 'extra_wpr_args_as_string', |
| 'netsim', |
| 'profile_dir', |
| 'profile_type', |
| 'show_stdout', |
| 'synthetic_gesture_source_type', |
| 'use_devtools_active_port', |
| ] |
| for o in browser_options_list: |
| a = getattr(finder_options, o, None) |
| if a is not None: |
| setattr(self, o, a) |
| delattr(finder_options, o) |
| |
| self.browser_type = finder_options.browser_type |
| |
| if hasattr(self, 'extra_browser_args_as_string'): # pylint: disable=E1101 |
| tmp = shlex.split( |
| self.extra_browser_args_as_string) # pylint: disable=E1101 |
| self.AppendExtraBrowserArgs(tmp) |
| delattr(self, 'extra_browser_args_as_string') |
| if hasattr(self, 'extra_wpr_args_as_string'): # pylint: disable=E1101 |
| tmp = shlex.split( |
| self.extra_wpr_args_as_string) # pylint: disable=E1101 |
| self.extra_wpr_args.extend(tmp) |
| delattr(self, 'extra_wpr_args_as_string') |
| if self.profile_type == 'default': |
| self.dont_override_profile = True |
| |
| if self.profile_dir and self.profile_type != 'clean': |
| logging.critical( |
| "It's illegal to specify both --profile-type and --profile-dir.\n" |
| "For more information see: http://goo.gl/ngdGD5") |
| sys.exit(1) |
| |
| if self.profile_dir and not os.path.isdir(self.profile_dir): |
| logging.critical( |
| "Directory specified by --profile-dir (%s) doesn't exist " |
| "or isn't a directory.\n" |
| "For more information see: http://goo.gl/ngdGD5" % self.profile_dir) |
| sys.exit(1) |
| |
| if not self.profile_dir: |
| self.profile_dir = profile_types.GetProfileDir(self.profile_type) |
| |
| # This deferred import is necessary because browser_options is imported in |
| # telemetry/telemetry/__init__.py. |
| from telemetry.core.backends.chrome import chrome_browser_options |
| finder_options.browser_options = ( |
| chrome_browser_options.CreateChromeBrowserOptions(self)) |
| |
| @property |
| def extra_browser_args(self): |
| return self._extra_browser_args |
| |
| def AppendExtraBrowserArgs(self, args): |
| if isinstance(args, list): |
| self._extra_browser_args.update(args) |
| else: |
| self._extra_browser_args.add(args) |
