Docserver: Consolidate features caching and access.

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

 # Copyright 2013 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.
 
 '''
 Utility functions for working with the Feature abstraction. Features are grouped
 into a dictionary by name. Each Feature is guaranteed to have the following two
 keys:
   name - a string, the name of the feature
-  platform - a list containing 'app' or 'extension', both, or neither.
+  platform - a list containing 'apps' or 'extensions', both, or neither.
 
 A Feature may have other keys from a _features.json file as well. Features with
 a whitelist are ignored as they are only useful to specific apps or extensions.
 '''
 
 from copy import deepcopy
 
 def Parse(features_json):
   '''Process JSON from a _features.json file, standardizing it into a dictionary
   of Features.
   '''
   features = {}
 
   for name, value in deepcopy(features_json).iteritems():
-    # Some feature names corrispond to a list; force a list down to a single
+    # Some feature names correspond to a list; force a list down to a single
     # feature by removing entries that have a 'whitelist'.
     if isinstance(value, list):
       values = [subvalue for subvalue in value if not 'whitelist' in subvalue]
       if values:
         value = values[0]
       else:
         continue
 
     if 'whitelist' in value:
       continue
 
     features[name] = { 'platforms': [] }
 
-    platforms = value.pop('extension_types')
-    if platforms == 'all' or 'platform_app' in platforms:
-      features[name]['platforms'].append('app')
-    if platforms == 'all' or 'extension' in platforms:
-      features[name]['platforms'].append('extension')
+    extension_types = value.pop('extension_types', None)
+    if extension_types is not None:
+      features[name]['platforms'] = GetPlatformsForExtensionTypes(
+          extension_types)
 
     features[name]['name'] = name
     features[name].update(value)
 
   return features
 
 def Filtered(features, platform=None):
   '''Create a new Features dictionary from |features| that contains only items
   relevant to |platform|. Items retained are deepcopied. Returns new features
   dictionary.
@@ skipping 18 matching lines @@
     else:
       features[key] = value
 
     # Ensure the Feature schema is enforced for all added items.
     if not 'name' in features[key]:
       features[key]['name'] = key
     if not 'platforms' in features[key]:
       features[key]['platforms'] = []
 
   return features
+
+def GetPlatformsForExtensionTypes(extension_types):

[not at google - send to devlin, 2013/10/01 16:34:34]

this can be private?

[Ken Rockot(use gerrit already), 2013/10/01 22:18:16]

Done.

+  platforms = []
+  if extension_types == 'all' or 'platform_app' in extension_types:
+    platforms.append('apps')
+  if extension_types == 'all' or 'extension' in extension_types:
+    platforms.append('extensions')
+  return platforms
+
+def AddPlatformsFromDependencies(feature, features_bundle):

[not at google - send to devlin, 2013/10/01 16:34:34]

as I mentioned earlier - you can put this in features_bundle.py.

[Ken Rockot(use gerrit already), 2013/10/01 22:18:16]

Done.

+  features_map = {
+    'api': features_bundle.GetAPIFeatures(),
+    'manifest': features_bundle.GetManifestFeatures(),
+    'permission': features_bundle.GetPermissionFeatures()
+  }
+  dependencies = feature.get('dependencies')
+  if dependencies is None:
+    return ['apps', 'extensions']
+  platforms = set()
+  for dependency in dependencies:
+    dep_type, dep_name = dependency.split(':')
+    dependency_features = features_map[dep_type]
+    dependency_feature = dependency_features.get(dep_name)
+    # If the dependency can't be resolved, it is inaccessible and therefore
+    # so is this feature.
+    if dependency_feature is None:
+      return []
+    platforms = platforms.union(dependency_feature['platforms'])
+  feature['platforms'] = list(platforms)