Hack together a quick doc generator for IDL files.

chrome/common/extensions/docs/build/build.py

 #!/usr/bin/python
 # Copyright (c) 2012 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.
 
 """Docbuilder for extension docs."""
 
 import glob
 import os
 import os.path
 import shutil
 import sys
 import time
 import urllib
 
 from subprocess import Popen, PIPE
 from optparse import OptionParser
 
 _script_path = os.path.realpath(__file__)
 _build_dir = os.path.dirname(_script_path)
 _base_dir = os.path.normpath(_build_dir + "/..")
 _static_dir = _base_dir + "/static"
 _js_dir = _base_dir + "/js"
 _template_dir = _base_dir + "/template"
 _samples_dir = _base_dir + "/examples"
 _extension_api_dir = os.path.normpath(_base_dir + "/../api")
 
 _extension_api_json_schemas = glob.glob(_extension_api_dir +
                                         '/[a-zA-Z0-9]*.json')
+_extension_api_idl_schemas = glob.glob(_extension_api_dir +
+                                       '/[a-zA-Z0-9]*.idl')
 _api_template_html = _template_dir + "/api_template.html"
 _page_shell_html = _template_dir + "/page_shell.html"
 _generator_html = _build_dir + "/generator.html"
 _samples_json = _base_dir + "/samples.json"
 
 _expected_output_preamble = "#BEGIN"
 _expected_output_postamble = "#END"
 
 # HACK! This is required because we can only depend on python 2.4 and
 # the calling environment may not be setup to set the PYTHONPATH
@@ skipping 146 matching lines @@
                     default=True)
   options, args = parser.parse_args()
 
   if (options.dump_render_tree_path and
       os.path.isfile(options.dump_render_tree_path)):
     dump_render_tree = options.dump_render_tree_path
   else:
     dump_render_tree = FindDumpRenderTree()
 
   # Load the manifest of existing API Methods
-  api_manifest = ApiManifest(_extension_api_json_schemas)
+  api_manifest = ApiManifest(_extension_api_json_schemas,
+                             _extension_api_idl_schemas)
 
   # Read static file names
   static_names = GetStaticFileNames()
 
   # Read module names
   module_names = api_manifest.getModuleNames()
 
   # All pages to generate
   page_names = static_names | module_names
 
   # Allow the user to render a single page if they want
   if options.page_name:
     if options.page_name in page_names:
       page_names = [options.page_name]
     else:
       raise Exception("--page-name argument must be one of %s." %
                       ', '.join(sorted(page_names)))
 
+  # Write temporary JSON files based on the IDL inputs
+  api_manifest.generateJSONFromIDL()
+
   # Render a manifest file containing metadata about all the extension samples
   samples_manifest = SamplesManifest(_samples_dir, _base_dir, api_manifest)
   samples_manifest.writeToFile(_samples_json)
 
   # Write zipped versions of the samples listed in the manifest to the
   # filesystem, unless the user has disabled it
   if options.zips:
     modified_zips = samples_manifest.writeZippedSamples()
   else:
     modified_zips = []
@@ skipping 11 matching lines @@
     for f in modified_files:
       print " * %s" % f
 
   # Hack. Sleep here, otherwise windows doesn't properly close the debug.log
   # and the os.remove will fail with a "Permission denied".
   time.sleep(1)
   debug_log = os.path.normpath(_build_dir + "/" + "debug.log")
   if (os.path.isfile(debug_log)):
     os.remove(debug_log)
 
+  # Cleanup our temporary IDL->JSON files
+  api_manifest.cleanupGeneratedFiles()
+
   if 'EX_OK' in dir(os):
     return os.EX_OK
   else:
     return 0
 
 if __name__ == '__main__':
   sys.exit(main())