//tools/binary_size: source_path information, change file format, fixes

tools/binary_size/describe.py

 # Copyright 2017 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.
 """Methods for converting model objects to human-readable formats."""
 
+import datetime
 import itertools
+import time
 
 import models
 
 
 class Describer(object):
   def __init__(self, verbose=False):
     self.verbose = verbose
 
   def _DescribeSectionSizes(self, section_sizes):
     relevant_names = models.SECTION_TO_SECTION_NAME.values()
@@ skipping 11 matching lines @@
         yield '{}: {:,} bytes ({:.1%})'.format(name, size, percent)
 
   def _DescribeSymbol(self, sym):
     # SymbolGroups are passed here when we don't want to expand them.
     if sym.IsGroup():
       yield '{} {:<8} {} (count={})'.format(sym.section, sym.size, sym.name,
                                             len(sym))
       return
 
     yield '{}@0x{:<8x}  {:<7} {}'.format(
-        sym.section, sym.address, sym.size, sym.path or '<no path>')
+        sym.section, sym.address, sym.size,
+        sym.source_path or sym.object_path or '{no path}')
     if sym.name:
       yield '{:22}{}'.format('', sym.name)
 
   def _DescribeSymbolGroup(self, group, prefix_func=None):
     yield 'Showing {:,} symbols with total size: {:} bytes'.format(
         len(group), group.size)
     yield 'First columns are: running total, type, size'
 
     running_total = 0
     prefix = ''
@@ skipping 22 matching lines @@
       if sym.size:
         return '~ '
       return '= '
 
     diff = diff if self.verbose else diff.WhereNotUnchanged()
     group_desc = self._DescribeSymbolGroup(diff, prefix_func=prefix_func)
     return itertools.chain((header_str,), group_desc)
 
   def GenerateLines(self, obj):
     if isinstance(obj, models.SizeInfo):
+      metadata_desc = 'Metadata: %s' % DescribeSizeInfoMetadata(obj)
       section_desc = self._DescribeSectionSizes(obj.section_sizes)
       group_desc = self.GenerateLines(obj.symbols)
-      return itertools.chain(section_desc, ('',), group_desc)
+      return itertools.chain((metadata_desc,), section_desc, ('',), group_desc)
 
     if isinstance(obj, models.SymbolDiff):
       return self._DescribeSymbolDiff(obj)
 
     if isinstance(obj, models.SymbolGroup):
       return self._DescribeSymbolGroup(obj)
 
     if isinstance(obj, models.Symbol):
       return self._DescribeSymbol(obj)
 
@@ skipping 28 matching lines @@
     attributed_syms = star_syms.Inverted().WhereHasAnyAttribution()
     anonymous_syms = attributed_syms.Inverted()
     if star_syms or anonymous_syms:
       missing_size = star_syms.size + anonymous_syms.size
       yield ('+ Without %d merge sections and %d anonymous entries ('
                   'accounting for %d bytes):') % (
           len(star_syms),  len(anonymous_syms), missing_size)
       yield '+ ' + one_stat(attributed_syms)
 
 
+def _UtcToLocal(utc):
+    epoch = time.mktime(utc.timetuple())
+    offset = (datetime.datetime.fromtimestamp(epoch) -
+              datetime.datetime.utcfromtimestamp(epoch))
+    return utc + offset
+
+
+def DescribeSizeInfoMetadata(size_info):
+  time_str = 'Unknown'
+  if size_info.timestamp:
+    time_str = _UtcToLocal(size_info.timestamp).strftime('%Y-%m-%d %H:%M:%S')
+  return 'time=%s tag=%s' % (time_str, size_info.tag)
+
+
 def GenerateLines(obj, verbose=False):
   return Describer(verbose).GenerateLines(obj)
 
 
 def WriteLines(lines, func):
   for l in lines:
     func(l)
     func('\n')