Merging 18 commit(s) from Chromium's toolchain-utils am: 0ae38c8498 am: 2a19d36a82 am: e617e3393dr_aml_301500702android-mainline-12.0.0_r55android-mainline-11.0.0_r9android-mainline-11.0.0_r8android-mainline-11.0.0_r7android-mainline-11.0.0_r6android-mainline-11.0.0_r5android-mainline-11.0.0_r45android-mainline-11.0.0_r44android-mainline-11.0.0_r43android-mainline-11.0.0_r42android-mainline-11.0.0_r41android-mainline-11.0.0_r40android-mainline-11.0.0_r4android-mainline-11.0.0_r39android-mainline-11.0.0_r38android-mainline-11.0.0_r37android-mainline-11.0.0_r36android-mainline-11.0.0_r35android-mainline-11.0.0_r34android-mainline-11.0.0_r33android-mainline-11.0.0_r32android-mainline-11.0.0_r31android-mainline-11.0.0_r30android-mainline-11.0.0_r3android-mainline-11.0.0_r29android-mainline-11.0.0_r28android-mainline-11.0.0_r27android-mainline-11.0.0_r26android-mainline-11.0.0_r25android-mainline-11.0.0_r24android-mainline-11.0.0_r23android-mainline-11.0.0_r22android-mainline-11.0.0_r21android-mainline-11.0.0_r20android-mainline-11.0.0_r2android-mainline-11.0.0_r19android-mainline-11.0.0_r18android-mainline-11.0.0_r17android-mainline-11.0.0_r16android-mainline-11.0.0_r15android-mainline-11.0.0_r14android-mainline-11.0.0_r13android-mainline-11.0.0_r12android-mainline-11.0.0_r10android-mainline-11.0.0_r1android-11.0.0_r48android-11.0.0_r47android-11.0.0_r46android-11.0.0_r45android-11.0.0_r44android-11.0.0_r43android-11.0.0_r42android-11.0.0_r41android-11.0.0_r40android-11.0.0_r39android-11.0.0_r38android-11.0.0_r37android-11.0.0_r36android-11.0.0_r35android-11.0.0_r34android-11.0.0_r33android-11.0.0_r32android-11.0.0_r31android-11.0.0_r30android-11.0.0_r29android-11.0.0_r28android-11.0.0_r27android-11.0.0_r26android-11.0.0_r24android-11.0.0_r23android-11.0.0_r22android-11.0.0_r21android-11.0.0_r20android-11.0.0_r19android-11.0.0_r18android-11.0.0_r16android11-qpr3-s1-releaseandroid11-qpr3-releaseandroid11-qpr2-releaseandroid11-qpr1-s2-releaseandroid11-qpr1-s1-releaseandroid11-qpr1-releaseandroid11-qpr1-d-s1-releaseandroid11-qpr1-d-releaseandroid11-qpr1-c-releaseandroid11-mainline-tethering-releaseandroid11-mainline-sparse-2021-jan-releaseandroid11-mainline-sparse-2020-dec-releaseandroid11-mainline-releaseandroid11-mainline-permission-releaseandroid11-mainline-os-statsd-releaseandroid11-mainline-networkstack-releaseandroid11-mainline-media-swcodec-releaseandroid11-mainline-media-releaseandroid11-mainline-extservices-releaseandroid11-mainline-documentsui-releaseandroid11-mainline-conscrypt-releaseandroid11-mainline-cellbroadcast-releaseandroid11-mainline-captiveportallogin-releaseandroid11-devandroid11-d2-releaseandroid11-d1-b-release

Change-Id: I3f25c7ee034b2e20e37ed941b8eae24eec7043eb

1 files changed, 149 insertions, 0 deletions

diff --git a/deprecated/automation/common/events.py b/deprecated/automation/common/events.py
new file mode 100644
index 00000000..ad3ec844
--- /dev/null
+++ b/deprecated/automation/common/events.py
@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+"""Tools for recording and reporting timeline of abstract events.
+
+You can store any events provided that they can be stringified.
+"""
+
+__author__ = 'kbaclawski@google.com (Krystian Baclawski)'
+
+import collections
+import datetime
+import time
+
+
+class _EventRecord(object):
+  """Internal class.  Attaches extra information to an event."""
+
+  def __init__(self, event, time_started=None, time_elapsed=None):
+    self._event = event
+    self._time_started = time_started or time.time()
+    self._time_elapsed = None
+
+    if time_elapsed:
+      self.time_elapsed = time_elapsed
+
+  @property
+  def event(self):
+    return self._event
+
+  @property
+  def time_started(self):
+    return self._time_started
+
+  def _TimeElapsedGet(self):
+    if self.has_finished:
+      time_elapsed = self._time_elapsed
+    else:
+      time_elapsed = time.time() - self._time_started
+
+    return datetime.timedelta(seconds=time_elapsed)
+
+  def _TimeElapsedSet(self, time_elapsed):
+    if isinstance(time_elapsed, datetime.timedelta):
+      self._time_elapsed = time_elapsed.seconds
+    else:
+      self._time_elapsed = time_elapsed
+
+  time_elapsed = property(_TimeElapsedGet, _TimeElapsedSet)
+
+  @property
+  def has_finished(self):
+    return self._time_elapsed is not None
+
+  def GetTimeStartedFormatted(self):
+    return time.strftime('%m/%d/%Y %H:%M:%S', time.gmtime(self._time_started))
+
+  def GetTimeElapsedRounded(self):
+    return datetime.timedelta(seconds=int(self.time_elapsed.seconds))
+
+  def Finish(self):
+    if not self.has_finished:
+      self._time_elapsed = time.time() - self._time_started
+
+
+class _Transition(collections.namedtuple('_Transition', ('from_', 'to_'))):
+  """Internal class.  Represents transition point between events / states."""
+
+  def __str__(self):
+    return '%s => %s' % (self.from_, self.to_)
+
+
+class EventHistory(collections.Sequence):
+  """Records events and provides human readable events timeline."""
+
+  def __init__(self, records=None):
+    self._records = records or []
+
+  def __len__(self):
+    return len(self._records)
+
+  def __iter__(self):
+    return iter(self._records)
+
+  def __getitem__(self, index):
+    return self._records[index]
+
+  @property
+  def last(self):
+    if self._records:
+      return self._records[-1]
+
+  def AddEvent(self, event):
+    if self.last:
+      self.last.Finish()
+
+    evrec = _EventRecord(event)
+    self._records.append(evrec)
+    return evrec
+
+  def GetTotalTime(self):
+    if self._records:
+      total_time_elapsed = sum(evrec.time_elapsed.seconds
+                               for evrec in self._records)
+
+      return datetime.timedelta(seconds=int(total_time_elapsed))
+
+  def GetTransitionEventHistory(self):
+    records = []
+
+    if self._records:
+      for num, next_evrec in enumerate(self._records[1:], start=1):
+        evrec = self._records[num - 1]
+
+        records.append(_EventRecord(
+            _Transition(evrec.event, next_evrec.event), evrec.time_started,
+            evrec.time_elapsed))
+
+      if not self.last.has_finished:
+        records.append(_EventRecord(
+            _Transition(self.last.event,
+                        'NOW'), self.last.time_started, self.last.time_elapsed))
+
+    return EventHistory(records)
+
+  @staticmethod
+  def _GetReport(history, report_name):
+    report = [report_name]
+
+    for num, evrec in enumerate(history, start=1):
+      time_elapsed = str(evrec.GetTimeElapsedRounded())
+
+      if not evrec.has_finished:
+        time_elapsed.append(' (not finished)')
+
+      report.append('%d) %s: %s: %s' % (num, evrec.GetTimeStartedFormatted(),
+                                        evrec.event, time_elapsed))
+
+    report.append('Total Time: %s' % history.GetTotalTime())
+
+    return '\n'.join(report)
+
+  def GetEventReport(self):
+    return EventHistory._GetReport(self, 'Timeline of events:')
+
+  def GetTransitionEventReport(self):
+    return EventHistory._GetReport(self.GetTransitionEventHistory(),
+                                   'Timeline of transition events:')