[Telemetry] Introduce SummarizableValue.

tools/telemetry/telemetry/internal/results/html_output_formatter_unittest.py

 # Copyright 2014 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 datetime
 import os
 import StringIO
 import unittest
 
 from telemetry import benchmark
 from telemetry import story
 from telemetry.internal.results import html_output_formatter
 from telemetry.internal.results import page_test_results
 from telemetry import page as page_module
+from telemetry.value import improvement_direction
 from telemetry.value import scalar
 
 
 def _MakeStorySet():
   story_set = story.StorySet(base_dir=os.path.dirname(__file__))
   story_set.AddStory(
       page_module.Page('http://www.foo.com/', story_set, story_set.base_dir))
   story_set.AddStory(
       page_module.Page('http://www.bar.com/', story_set, story_set.base_dir))
   story_set.AddStory(
@@ skipping 24 matching lines @@
     self.maxDiff = 100000
 
   def test_basic_summary(self):
     test_story_set = _MakeStorySet()
     output_file = StringIOFile()
 
     # Run the first time and verify the results are written to the HTML file.
     results = page_test_results.PageTestResults()
     results.WillRunPage(test_story_set.stories[0])
     results.AddValue(scalar.ScalarValue(
-        test_story_set.stories[0], 'a', 'seconds', 3))
+        test_story_set.stories[0], 'a', 'seconds', 3,
+        improvement_direction=improvement_direction.DOWN))
     results.DidRunPage(test_story_set.stories[0])
 
     results.WillRunPage(test_story_set.stories[1])
     results.AddValue(scalar.ScalarValue(
-        test_story_set.stories[1], 'a', 'seconds', 7))
+        test_story_set.stories[1], 'a', 'seconds', 7,
+        improvement_direction=improvement_direction.DOWN))
     results.DidRunPage(test_story_set.stories[1])
 
     formatter = DeterministicHtmlOutputFormatter(
         output_file, FakeMetadataForTest(), False, False, 'browser_type')
     formatter.Format(results)
     expected = {
       "platform": "browser_type",
       "buildTime": "1998-09-04T13:00:00.007777",
       "label": 'test_name (1998-09-04 13:00:00)',
       "tests": {
@@ skipping 23 matching lines @@
         }
       },
     }
     self.assertEquals(expected, formatter.GetResults())
 
     # Run the second time and verify the results are appended to the HTML file.
     output_file.seek(0)
     results = page_test_results.PageTestResults()
     results.WillRunPage(test_story_set.stories[0])
     results.AddValue(scalar.ScalarValue(
-        test_story_set.stories[0], 'a', 'seconds', 4))
+        test_story_set.stories[0], 'a', 'seconds', 4,
+        improvement_direction=improvement_direction.DOWN))
     results.DidRunPage(test_story_set.stories[0])
 
     results.WillRunPage(test_story_set.stories[1])
     results.AddValue(scalar.ScalarValue(
-        test_story_set.stories[1], 'a', 'seconds', 8))
+        test_story_set.stories[1], 'a', 'seconds', 8,
+        improvement_direction=improvement_direction.DOWN))
     results.DidRunPage(test_story_set.stories[1])
 
     formatter = DeterministicHtmlOutputFormatter(
         output_file, FakeMetadataForTest(), False, False, 'browser_type')
     formatter.Format(results)
     expected = [
       {
         "platform": "browser_type",
         "buildTime": "1998-09-04T13:00:00.007777",
         "label": 'test_name (1998-09-04 13:00:00)',
@@ skipping 56 matching lines @@
         },
       }]
     self.assertEquals(expected, formatter.GetCombinedResults())
     last_output_len = len(output_file.getvalue())
 
     # Now reset the results and verify the old ones are gone.
     output_file.seek(0)
     results = page_test_results.PageTestResults()
     results.WillRunPage(test_story_set.stories[0])
     results.AddValue(scalar.ScalarValue(
-        test_story_set.stories[0], 'a', 'seconds', 5))
+        test_story_set.stories[0], 'a', 'seconds', 5,
+        improvement_direction=improvement_direction.DOWN))
     results.DidRunPage(test_story_set.stories[0])
 
     results.WillRunPage(test_story_set.stories[1])
     results.AddValue(scalar.ScalarValue(
-        test_story_set.stories[1], 'a', 'seconds', 9))
+        test_story_set.stories[1], 'a', 'seconds', 9,
+        improvement_direction=improvement_direction.DOWN))
     results.DidRunPage(test_story_set.stories[1])
 
     formatter = DeterministicHtmlOutputFormatter(
        output_file, FakeMetadataForTest(), True, False, 'browser_type')
     formatter.Format(results)
     expected = [{
       "platform": "browser_type",
       "buildTime": "1998-09-04T13:00:00.007777",
       "label": 'test_name (1998-09-04 13:00:00)',
       "tests": {
@@ skipping 18 matching lines @@
               "current": [5],
               "units": "seconds",
               "important": False
             }
           }
         }
       },
     }]
     self.assertEquals(expected, formatter.GetCombinedResults())
     self.assertTrue(len(output_file.getvalue()) < last_output_len)