# Copyright (c) 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 pyauto_tracing
import pyauto
import tab_tracker
from timeline_model import TimelineModel
import os
class Tracer(object):
"""Controlls chrome and system tracing, returning a TimelineModel."""
def __init__(self, browser, tab_tracker):
"""
Args:
browser: an instance of a PyUITest
tab_tracker: an instance of a TabTracker
"""
self._browser = browser
self._tab_tracker = tab_tracker
self._tab_uuid = tab_tracker.CreateTab('chrome://tracing')
# TODO(eatnumber): Find a way to import timeline_model_shim.js from within
# TimelineModelProxy
# I'm not happy with importing timeline_model_shim.js
# here. I'd rather pull it in from within TimelineModelProxy.
# tracing_test.js depends on timeline_model_shim.js however.
files = ['timeline_model_shim.js', 'tracer.js']
for fileName in files:
with open(os.path.join(os.path.dirname(__file__), fileName), 'r') as fd:
self._ExecuteJavascript(fd.read())
def __del__(self):
self._tab_tracker.ReleaseTab(self._tab_uuid)
def _ExecuteJavascript(self, js):
return self._browser.ExecuteJavascript(
js = js,
windex = self._tab_tracker.GetWindowIndex(),
tab_index = self._tab_tracker.GetTabIndex(self._tab_uuid)
)
def BeginTracing(self, system_tracing=True):
"""Start tracing.
Args:
system_tracing: whether or not to gather system traces along with chrome
traces.
"""
self._ExecuteJavascript("""
window.domAutomationController.send(
window.pyautoRecordTrace(%s)
);
""" % ('true' if system_tracing else 'false'))
def EndTracing(self):
"""End tracing and return a TimelineModel.
Returns:
an instance of a TimelineModel which contains the results of the trace
"""
return TimelineModel(
js_executor = self._ExecuteJavascript.__get__(self, Tracer),
shim_id = self._ExecuteJavascript('tracingController.endTracing();')
)
class TracerFactory(object):
"""A TracerFactory is used to produce a Tracer.
It's recommended to use the same TracerFactory to produce all Tracers so that
the same TabTracker can be used throughout
Args:
browser: an instance of a PyUITest
"""
def __init__(self, browser):
self._tab_tracker = tab_tracker.TabTracker(browser)
self._browser = browser
def Produce(self):
"""Produce an instance of a Tracer"""
return Tracer(self._browser, self._tab_tracker)