Clean patch with DCC static content

chrome/common/extensions/docs/server2/sidenav_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 copy
 import logging
 
 from compiled_file_system import SingleFile, Unicode
 from data_source import DataSource
 from extensions_paths import JSON_TEMPLATES
 from future import Gettable, Future
 from third_party.json_schema_compiler.json_parse import Parse
 
 
 def _AddLevels(items, level):
   '''Add a 'level' key to each item in |items|. 'level' corresponds to how deep
   in |items| an item is. |level| sets the starting depth.
   '''
   for item in items:
     item['level'] = level
     if 'items' in item:
       _AddLevels(item['items'], level + 1)
 
 
-def _AddSelected(items, path):
-  '''Add 'selected' and 'child_selected' properties to |items| so that the
-  sidenav can be expanded to show which menu item has been selected. Returns
-  True if an item was marked 'selected'.
+def _AddAnnotations(items, path, parent=None):
+  '''Add 'selected', 'child_selected' and 'related' properties to 
+  |items| so that the sidenav can be expanded to show which menu item has 
+  been selected and the related pages section can be drawn. 'related'
+  is added to all items with the same parent as the selected item.
+  If more than one item exactly matches the path, the deepest one is considered 
+  'selected'. A 'parent' property is added to the selected path.
+  
+  Returns True if an item was marked 'selected'.
   '''
   for item in items:
+    if 'items' in item:
+      if _AddAnnotations(item['items'], path, item):
+        item['child_selected'] = True
+        return True
+
     if item.get('href', '') == path:
       item['selected'] = True
+      if parent:
+        item['parent'] = { 'title': parent.get('title', None), 
+                          'href': parent.get('href', None) }
+      
+      for sibling in items:
+        sibling['related'] = True
+        
       return True
-    if 'items' in item:
-      if _AddSelected(item['items'], path):
-        item['child_selected'] = True
-        return True
 
   return False
 
 
 class SidenavDataSource(DataSource):
   '''Provides templates with access to JSON files used to create the side
   navigation bar.
   '''
   def __init__(self, server_instance, request):
     self._cache = server_instance.compiled_fs_factory.Create(
@@ skipping 23 matching lines @@
 
       href = item.get('href')
       if href is not None and not href.startswith(('http://', 'https://')):
         if not href.startswith('/'):
           logging.warn('Paths in sidenav must be qualified. %s is not.' % href)
         else:
           href = href.lstrip('/')
         item['href'] = self._server_instance.base_path + href
 
   def Cron(self):
-    futures = [self._cache.GetFromFile('%s/%s_sidenav.json' %
-                                       (JSON_TEMPLATES, platform))
-               for platform in ('apps', 'extensions')]
-    return Future(delegate=Gettable(lambda: [f.Get() for f in futures]))
+    return self._cache.GetFromFile('%s/chrome_sidenav.json' % (JSON_TEMPLATES))
 
   def get(self, key):
-    sidenav = copy.deepcopy(self._cache.GetFromFile(
-        '%s/%s_sidenav.json' % (JSON_TEMPLATES, key)).Get())
-    _AddSelected(sidenav, self._server_instance.base_path + self._request.path)
+    # TODO(mangini/kalman): Use |key| to decide which sidenav to use,
+    # which will require a more complex Cron method.
+    sidenav = self._cache.GetFromFile(
+        '%s/chrome_sidenav.json' % JSON_TEMPLATES).Get()
+    sidenav = copy.deepcopy(sidenav)
+    _AddAnnotations(sidenav,
+                    self._server_instance.base_path + self._request.path)
     return sidenav