[Findit] Adding support for triaging suspected builds from flake analysis

appengine/findit/model/base_triaged_model.py

Index: appengine/findit/model/base_triaged_model.py
diff --git a/appengine/findit/model/base_triaged_model.py b/appengine/findit/model/base_triaged_model.py
new file mode 100644
index 0000000000000000000000000000000000000000..b12f2dd7563c38267bc9418ced6bedfa52ca9797
--- /dev/null
+++ b/appengine/findit/model/base_triaged_model.py
@@ -0,0 +1,83 @@
+# Copyright 2016 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 google.appengine.ext import ndb
+from google.appengine.api import users
+
+from common import appengine_util
+from common import time_util
+from model import triage_status
+
+
+class TriageResult(ndb.Model):
+  # The user who updated this result.
+  user_name = ndb.StringProperty(default=None, indexed=False)
+
+  # The time this triage result was determined.
+  triaged_time = ndb.DateTimeProperty(indexed=False, auto_now=True)
+
+  # The result of the analysis as correct or not. If not triaged, the value
+  # should be None. Other traige result codes are up to the child class to set.
+  triage_result = ndb.IntegerProperty(default=None, indexed=True)
+
+  # The version of findit that generated this result. Should primarily be
+  # relevant for entities that are not versioned.
+  findit_version = ndb.StringProperty(default=None, indexed=False)
+
+  # The version number of the entity that is being triaged. Should primarily be
+  # relevant for versioned entites.
+  version_number = ndb.IntegerProperty(default=None, indexed=False)
+
+  # Other information about this result. For example, cl_info for suspected CLs
+  # which may contain repo/revision or the suspected range for a flake analysis.
+  suspect_info = ndb.JsonProperty(default={}, indexed=False)

[chanli, 2016/10/15 01:47:21]

I remembered default to {} is problematic. One way to avoid it is to use
default=None here, and In UpdateTriageResult make it default to {}

[lijeffrey, 2016/10/15 02:16:41]

Done.

+
+
+class TriagedModel(ndb.Model):
+  """The parent class for models that can have traige results."""
+
+  def UpdateTriageResult(self, triage_result, suspect_info, user_name,
+                         version_number=None):
+    result = TriageResult()
+    result.user_name = user_name
+    result.triage_result = triage_result
+    result.findit_version = appengine_util.GetCurrentVersion()
+    result.version_number = version_number
+    result.suspect_info = suspect_info
+    self.triage_history.append(result)
+
+  @staticmethod
+  def GetTriageHistory(analysis):
+    """Gets the triage history of a triaged model as a list.
+
+    Args:
+      analysis (TriagedModel): An instance of an entity assumed to inherit from
+      TriagedModel.
+
+    Returns:
+      A list of dicts representing the triage history of the analysis.
+    """
+    if (not users.is_current_user_admin() or
+        not analysis.completed or
+        not analysis.triage_history):  # pragma: no cover

[chanli, 2016/10/15 01:47:21]

Not sure if we should check if user is admin here... 

Shouldn't we do this at handler's side and pass the check result to template and
then decide if we display triage_history or not? 

[lijeffrey, 2016/10/15 02:16:41]

This function was originally only on the handler side, but is general enough
that other classes can use it too so I moved it to this parent class. I agree
though, the handler side should do this checking and this function should just
return the history

+      return None
+
+    triage_history = []
+    for triage_record in analysis.triage_history:
+      triage_history.append({
+          'triaged_time': time_util.FormatDatetime(triage_record.triaged_time),
+          'user_name': triage_record.user_name,
+          'suspect_info': triage_record.suspect_info,
+          'triage_result': (
+              triage_status.TRIAGE_STATUS_TO_DESCRIPTION.get(
+                  triage_record.triage_result)),
+          'findit_version': triage_record.findit_version,
+          'version_number': triage_record.version_number
+      })
+
+    return triage_history
+
+  # Record the triage result history.
+  triage_history = ndb.LocalStructuredProperty(
+      TriageResult, repeated=True, indexed=False, compressed=True)