tools/telemetry/telemetry/core/possible_browser.py

# 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.

from telemetry.core import platform


class PossibleBrowser(object):
  """A browser that can be controlled.

  Call Create() to launch the browser and begin manipulating it..
  """

  def __init__(self, browser_type, target_os, finder_options):
    self._browser_type = browser_type
    self._target_os = target_os
    self._finder_options = finder_options
    self._platform = None

  def __repr__(self):
    return 'PossibleBrowser(browser_type=%s)' % self.browser_type

  @property
  def browser_type(self):
    return self._browser_type

  @property
  def target_os(self):
    """Target OS, the browser will run on."""
    return self._target_os

  @property
  def finder_options(self):
    return self._finder_options

  @property
  def platform(self):
    if not self._platform:
      self._platform = platform.Platform(self._platform_backend)
    return self._platform

  def Create(self):
    raise NotImplementedError()

  def SupportsOptions(self, finder_options):
    """Tests for extension support."""
    raise NotImplementedError()

  def last_modification_time(self):
    return -1