Added CSSPropertyAPI.h.tmpl to generate CSSPropertyAPI.h.

third_party/WebKit/Source/build/scripts/make_css_property_apis.py

 #!/usr/bin/env python
 # Copyright 2016 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 sys
 
 import json5_generator
 import template_expander
 import make_style_builder
@@ skipping 17 matching lines @@
     def __init__(self, json5_file_paths):
         super(CSSPropertyAPIWriter, self).__init__(None)
         # TODO(aazzam): Move the logic for loading CSSPropertyAPIMethods.json5 into a new class APIMethodsWriter().
         assert len(json5_file_paths) == 2, 'CSSPropertyAPIWriter requires 2 input json5 files files, got %d.' % len(json5_file_paths)
 
         self.css_properties = StyleBuilderWriter([json5_file_paths[0]])
         self.css_property_api_methods = Json5File.load_from_files([json5_file_paths[1]], {}, {})
 
         self._outputs = {
             'CSSPropertyDescriptor.cpp': self.generate_property_descriptor_cpp,
+            'CSSPropertyAPI.h': self.generate_property_api,
         }
 
-        # Stores a map of API method name -> (return_type, parameters)
+        # Stores a map of API method name -> (return_type, parameters, comment)
         self.all_api_methods = {}
         # Stores an ordered list of all API method names. This must match the
         # order they appear in the Descriptor object.
         self.ordered_api_method_names = []
-        ApiMethod = namedtuple('ApiMethod', ('return_type', 'parameters'))
+        ApiMethod = namedtuple('ApiMethod', ('return_type', 'parameters', 'comment'))
         for api_method in self.css_property_api_methods.name_dictionaries:
             self.ordered_api_method_names.append(api_method['name'])
             self.all_api_methods[api_method['name']] = ApiMethod(

[sashab, 2017/02/10 02:47:09]

Add TODO - wrap comment to 72 chars, will do in follow-up patch

                 return_type=api_method['return_type'],
                 parameters=api_method['parameters'],
+                comment=api_method['comment'],
             )
 
         # Temporary map of API classname to list of propertyIDs that the API class is for.
         properties_for_class = defaultdict(list)
         # Map of API classname to list of methods implemented by that class.
         self.methods_for_classes = defaultdict(list)
         for property in self.css_properties.properties().values():
             if property['api_class'] is None:
                 continue
             classname = get_classname(property)
@@ skipping 15 matching lines @@
                 methods_for_class=self.methods_for_classes[classname]
             ))
 
     @template_expander.use_jinja('CSSPropertyDescriptor.cpp.tmpl')
     def generate_property_descriptor_cpp(self):
         return {
             'api_classes': self._api_classes,
             'ordered_api_method_names': self.ordered_api_method_names,
         }
 
+    @template_expander.use_jinja('CSSPropertyAPI.h.tmpl')
+    def generate_property_api(self):
+        return {
+            'ordered_api_method_names': self.ordered_api_method_names,
+            'all_api_methods': self.all_api_methods,
+        }
+
     # Provides a function object given the classname of the property.
     def generate_property_api_h_builder(self, api_classname):
         @template_expander.use_jinja('CSSPropertyAPIFiles.h.tmpl')
         def generate_property_api_h():
             return {
                 'api_classname': api_classname,
                 'methods_for_class': self.methods_for_classes[api_classname],
                 'all_api_methods': self.all_api_methods,
             }
         return generate_property_api_h
 
 if __name__ == '__main__':
     json5_generator.Maker(CSSPropertyAPIWriter).main()