[Telemetry] Add capability for values to reference external files.

tools/telemetry/telemetry/results/page_test_results.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 collections
 import copy
+import itertools
+import os
 import traceback
 
 from telemetry import value as value_module
 from telemetry.results import page_run
 from telemetry.results import progress_reporter as progress_reporter_module
 from telemetry.value import failure
 from telemetry.value import skip
 
 
 class PageTestResults(object):
@@ skipping 42 matching lines @@
       values += run.values
     if self._current_page_run:
       values += self._current_page_run.values
     return values
 
   @property
   def all_summary_values(self):
     return self._all_summary_values
 
   @property
+  def all_values(self):
+    return itertools.chain(
+        self.all_page_specific_values,
+        self.all_summary_values)
+
+  @property
   def current_page(self):
     assert self._current_page_run, 'Not currently running test.'
     return self._current_page_run.page
 
   @property
   def current_page_run(self):
     assert self._current_page_run, 'Not currently running test.'
     return self._current_page_run
 
   @property
@@ skipping 10 matching lines @@
   @property
   def pages_that_failed(self):
     """Returns the set of failed pages."""
     failed_pages = set()
     for run in self.all_page_runs:
       if run.failed:
         failed_pages.add(run.page)
     return failed_pages
 
   @property
+  def all_paths(self):
+    """Returns the set of all paths to referenced files.
+
+    Since we are dealing with paths, and paths are not necessarily unique even
+    if they refer to the same file, we canonicalize paths using
+    os.path.normcase and os.path.realpath before adding them to the set that we
+    return.
+    """
+    paths = set()
+    for v in self.all_values:
+      paths.update(os.path.normcase(os.path.realpath(path)) for path in v.paths)
+
+    return paths
+
+  @property
   def failures(self):
     values = self.all_page_specific_values
     return [v for v in values if isinstance(v, failure.FailureValue)]
 
   @property
   def skipped_values(self):
     values = self.all_page_specific_values
     return [v for v in values if isinstance(v, skip.SkipValue)]
 
   def _GetStringFromExcInfo(self, err):
@@ skipping 65 matching lines @@
       if value.page == page and value.name == value_name:
         values.append(value)
     return values
 
   def FindAllPageSpecificValuesNamed(self, value_name):
     values = []
     for value in self.all_page_specific_values:
       if value.name == value_name:
         values.append(value)
     return values