Extension Docs Server: Include a list of samples used in the api reference page.

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

Index: chrome/common/extensions/docs/server2/handlebar_dict_generator.py
diff --git a/chrome/common/extensions/docs/server2/handlebar_dict_generator.py b/chrome/common/extensions/docs/server2/handlebar_dict_generator.py
index 3c21bd464c352ccc437d59139652d814251d4bdf..d00f0382ee70ea3fbc98eb44f38c52c33c15331d 100644
--- a/chrome/common/extensions/docs/server2/handlebar_dict_generator.py
+++ b/chrome/common/extensions/docs/server2/handlebar_dict_generator.py
@@ -67,14 +67,15 @@ class HandlebarDictGenerator(object):
           { 'href': ref_dict['href'], 'text': ref_dict['text'], 'rest': rest })
     return ''.join(formatted_description)
 
-  def Generate(self):
+  def Generate(self, samples):
     try:
       return {
         'name': self._namespace.name,
         'types': map(self._GenerateType, self._namespace.types.values()),
         'functions': self._GenerateFunctions(self._namespace.functions),
         'events': map(self._GenerateEvent, self._namespace.events.values()),
-        'properties': self._GenerateProperties(self._namespace.properties)
+        'properties': self._GenerateProperties(self._namespace.properties),
+        'samples': self._FilterSamples(samples),
       }
     except Exception as e:
       logging.error(e)
@@ -141,6 +142,11 @@ class HandlebarDictGenerator(object):
   def _GenerateProperties(self, properties):
     return map(self._GenerateProperty, properties.values())
 
+  def _FilterSamples(self, samples):

[not at google - send to devlin, 2012/08/01 20:56:32]

Perhaps pass the filtered results directly into Generate? That way you don't
need to duplicate this code here and in samples_data_source.py.

[chebert, 2012/08/02 18:40:23]

Done.

+    api_search = '.' + self._namespace.name + '.'
+    return [sample for sample in samples
+            if any(api_search in api['name'] for api in sample['api_calls'])]
+
   def _GenerateProperty(self, property_):
     property_dict = {
       'name': self._StripPrefix(property_.name),