summaryrefslogtreecommitdiffstats
path: root/chrome/common/extensions/docs/server2/permissions_data_source.py
blob: fb8c239ebad2dcb65e61d0af57721f12e47447f0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# 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.

from itertools import ifilter
from operator import itemgetter

from data_source import DataSource
from extensions_paths import PRIVATE_TEMPLATES
from features_utility import Filtered
from future import Future


def _ListifyPermissions(permissions):
  '''Filter out any permissions that do not have a description or with a name
  that ends with Private then sort permissions features by name into a list.
  '''
  def filter_permissions(perm):
    return 'description' in perm and not perm['name'].endswith('Private')

  return sorted(
      ifilter(filter_permissions, permissions.itervalues()),
      key=itemgetter('name'))


def _AddDependencyDescriptions(permissions, api_features):
  '''Use |api_features| to determine the dependencies APIs have on permissions.
  Add descriptions to |permissions| based on those dependencies.
  '''
  for name, permission in permissions.iteritems():
    # Don't overwrite the description created by expanding a partial template.
    if 'partial' in permission or not permission['platforms']:
      continue

    has_deps = False
    if name in api_features:
      for dependency in api_features[name].get('dependencies', ()):
        if dependency.startswith('permission:'):
          has_deps = True

    if has_deps:
      permission['partial'] = 'permissions/generic_description.html'

class PermissionsDataSource(DataSource):
  '''Load and format permissions features to be used by templates.
  '''
  def __init__(self, server_instance, request):
    self._features_bundle = server_instance.features_bundle
    self._object_store = server_instance.object_store_creator.Create(
        PermissionsDataSource)
    self._template_cache = server_instance.compiled_fs_factory.ForTemplates(
        server_instance.host_file_system_provider.GetTrunk())

  def _CreatePermissionsData(self):
    api_features_future = self._features_bundle.GetAPIFeatures()
    permission_features_future = self._features_bundle.GetPermissionFeatures()
    def resolve():
      permission_features = permission_features_future.Get()
      _AddDependencyDescriptions(permission_features, api_features_future.Get())

      # Turn partial templates into descriptions, ensure anchors are set.
      for permission in permission_features.values():
        if not 'anchor' in permission:
          permission['anchor'] = permission['name']
        if 'partial' in permission:
          permission['description'] = self._template_cache.GetFromFile(
              PRIVATE_TEMPLATES + permission['partial']).Get()
          del permission['partial']

      def filter_for_platform(permissions, platform):
        return _ListifyPermissions(Filtered(permissions, platform))
      return {
        'declare_apps': filter_for_platform(permission_features, 'apps'),
        'declare_extensions': filter_for_platform(
            permission_features, 'extensions')
      }
    return Future(callback=resolve)

  def _GetCachedPermissionsData(self):
    data = self._object_store.Get('permissions_data').Get()
    if data is None:
      data = self._CreatePermissionsData().Get()
      self._object_store.Set('permissions_data', data)
    return data

  def Cron(self):
    return self._CreatePermissionsData()

  def get(self, key):
    return self._GetCachedPermissionsData().get(key)