Added --examine to produce analysis of IDL files

tools/dom/scripts/fremontcutbuilder.py

 #!/usr/bin/python
 # Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 # for details. All rights reserved. Use of this source code is governed by a
 # BSD-style license that can be found in the LICENSE file.
 
 import database
 import databasebuilder
 import logging.config
 import os.path
 import sys
@@ skipping 18 matching lines @@
     'ENABLE_ENCRYPTED_MEDIA_V2',
     'ENABLE_INPUT_SPEECH', # Not on Android
     'ENABLE_LEGACY_NOTIFICATIONS', # Not on Android
     'ENABLE_NAVIGATOR_CONTENT_UTILS', # Not on Android
     'ENABLE_NOTIFICATIONS', # Not on Android
     'ENABLE_SVG_FONTS',
     'ENABLE_WEB_AUDIO', # Not on Android
 ]
 
 def build_database(idl_files, database_dir, feature_defines=None,
-                   logging_level=logging.WARNING):
+                   logging_level=logging.WARNING, examine_idls=False):
   """This code reconstructs the FremontCut IDL database from W3C,
   WebKit and Dart IDL files."""
   current_dir = os.path.dirname(__file__)
   logging.config.fileConfig(os.path.join(current_dir, "logging.conf"))
 
   _logger.setLevel(logging_level)
 
   db = database.Database(database_dir)
 
   # Delete all existing IDLs in the DB.
@@ skipping 41 matching lines @@
 
   builder.fetch_constructor_data(webkit_options)
   builder.fix_displacements('WebKit')
 
   # Cleanup:
   builder.normalize_annotations(['WebKit', 'Dart'])
 
   # Map any IDL defined dictionaries to Dictionary.
   builder.map_dictionaries()
 
+  # Examine all IDL and produce a diagnoses of areas (e.g., list dictionaries
+  # declared and usage, etc.)
+  if examine_idls:
+    builder.examine_database()
+
   conditionals_met = set(
       'ENABLE_' + conditional for conditional in builder.conditionals_met)
   known_conditionals = set(FEATURE_DEFINES + FEATURE_DISABLED)
 
   unused_conditionals = known_conditionals - conditionals_met
   if unused_conditionals:
     _logger.warning('There are some unused conditionals %s' %
         sorted(unused_conditionals))
     _logger.warning('Please update fremontcutbuilder.py')
 
   unknown_conditionals = conditionals_met - known_conditionals
   if unknown_conditionals:
     _logger.warning('There are some unknown conditionals %s' %
         sorted(unknown_conditionals))
     _logger.warning('Please update fremontcutbuilder.py')
 
   print 'Merging interfaces %s seconds' % round(time.time() - start_time, 2)
 
-# TODO(terry): Don't generate the database cache.
-#  db.Save()
-
   return db
 
-def main(parallel=False, logging_level=logging.WARNING):
+def main(parallel=False, logging_level=logging.WARNING, examine_idls=False):
   current_dir = os.path.dirname(__file__)
 
   idl_files = []
 
   # Check default location in a regular dart enlistment.
   webcore_dir = os.path.join(current_dir, '..', '..', '..', 'third_party',
                              'WebCore')
 
   if not os.path.exists(webcore_dir):
     # Check default location in a dartium enlistment.
@@ skipping 25 matching lines @@
     for name in names:
       file_name = os.path.join(dir_name, name)
       (interface, ext) = os.path.splitext(file_name)
       if ext == '.idl' and not(name in FILES_TO_IGNORE):
         idl_files.append(file_name)
 
   os.path.walk(webcore_dir, visitor, webcore_dir)
 
   database_dir = os.path.join(current_dir, '..', 'database')
 
-  return build_database(idl_files, database_dir, logging_level=logging_level)
+  return build_database(idl_files, database_dir, logging_level=logging_level, examine_idls=examine_idls)
 
 if __name__ == '__main__':
   sys.exit(main())