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

chrome/common/extensions/docs/server2/samples_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.
 
 import json
 import logging
 import re
 
 DEFAULT_ICON_PATH = '/images/sample-default-icon.png'
 
@@ skipping 93 matching lines @@
         })
         samples_list.append(l10n_data)
 
       return samples_list
 
   def __init__(self, cache, samples_path, request):
     self._cache = cache
     self._samples_path = samples_path
     self._request = request
 
+  def GetSamplesForAPI(self, api_name):
+    samples = self.values()
+    api_search = '.' + api_name + '.'
+    return [sample for sample in samples
+            if any(api_search in api['name'] for api in sample['api_calls'])]
+
   def _GetAcceptedLanguages(self):
     accept_language = self._request.headers.get('Accept-Language', None)
     if accept_language is None:
       return []
     return [lang_with_q.split(';')[0].strip()
             for lang_with_q in accept_language.split(',')]
 
   def __getitem__(self, key):
     return self.get(key)
 
+  def values(self):
+    return self.get('')
+
   def get(self, key):
     samples_list = self._cache.GetFromFileListing(self._samples_path + '/')
     return_list = []
     for dict_ in samples_list:
       name = dict_['name']
       description = dict_['description']
       if name.startswith('__MSG_') or description.startswith('__MSG_'):
         try:
           # Copy the sample dict so we don't change the dict in the cache.
           sample_data = dict_.copy()
           name_key = name[len('__MSG_'):-len('__')]
           description_key = description[len('__MSG_'):-len('__')]
           locale = sample_data['default_locale']
           for lang in self._GetAcceptedLanguages():
             if lang in sample_data['locales']:
               locale = lang
               break
           locale_data = sample_data['locales'][locale]
           sample_data['name'] = locale_data[name_key]['message']
           sample_data['description'] = locale_data[description_key]['message']
         except Exception as e:
           logging.error(e)
           # Revert the sample to the original dict.
           sample_data = dict_
         return_list.append(sample_data)
       else:
         return_list.append(dict_)
     return return_list