Docserver: Display API features that are available to content scripts

chrome/common/extensions/docs/server2/api_list_data_source.py

 # 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.
 
 from data_source import DataSource
 from future import Future
 from operator import itemgetter
 from platform_util import GetPlatforms
 
 from docs_server_utils import MarkLast
@@ skipping 13 matching lines @@
       "extension_types" property where either/both "extension"/"platform_app"
       values are present.
   """
   def __init__(self, server_instance, _):
     self._platform_bundle = server_instance.platform_bundle
     self._object_store = server_instance.object_store_creator.Create(
         # Update the model when the API or Features model updates.
         APIListDataSource, category=self._platform_bundle.GetIdentity())
 
   def _GenerateAPIDict(self):
+    def make_list_for_content_scripts():
+      content_scripts_apis = self._platform_bundle.GetAPIModels(
+          'extensions').GetContentScriptsAPIs().Get()
+      content_scripts_apis_list = content_scripts_apis.values()
+      content_scripts_apis_list.sort(key=itemgetter('name'))
+      return content_scripts_apis_list

[not at google - send to devlin, 2014/07/09 03:03:00]

we should filter out undocumented APIs here, much as we do for the normal API
list.

+
     def make_dict_for_platform(platform):
       platform_dict = {
         'chrome': {'stable': [], 'beta': [], 'dev': [], 'trunk': []},
       }
       private_apis = []
       experimental_apis = []
       all_apis = []
       for api_name, api_model in self._platform_bundle.GetAPIModels(
           platform).IterModels():
         if not self._platform_bundle.GetAPICategorizer(platform).IsDocumented(
@@ skipping 26 matching lines @@
         platform_dict['chrome'][channel] = apis_by_channel
 
       for key, apis in (('all', all_apis),
                         ('private', private_apis),
                         ('experimental', experimental_apis)):
         apis.sort(key=itemgetter('name'))
         MarkLast(apis)
         platform_dict[key] = apis
 
       return platform_dict
-    return dict((platform, make_dict_for_platform(platform))
-                for platform in GetPlatforms())
+    api_dict = dict((platform, make_dict_for_platform(platform))
+                     for platform in GetPlatforms())
+    api_dict['content_scripts'] = make_list_for_content_scripts()
+    return api_dict
 
   def _GetCachedAPIData(self):
     data_future = self._object_store.Get('api_data')
     def resolve():
       data = data_future.Get()
       if data is None:
         data = self._GenerateAPIDict()
         self._object_store.Set('api_data', data)
       return data
     return Future(callback=resolve)
 
   def get(self, key):
     return self._GetCachedAPIData().Get().get(key)
 
   def Cron(self):
     return self._GetCachedAPIData()