summaryrefslogtreecommitdiffstats
path: root/chrome/common/extensions/docs/server2/content_providers.py
blob: 0c44d9e4a268428dcdc8fb4623bc7f947f229d93 (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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
# 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.

import logging
import traceback

from chroot_file_system import ChrootFileSystem
from content_provider import ContentProvider
from extensions_paths import CONTENT_PROVIDERS
from future import Gettable, Future
from third_party.json_schema_compiler.memoize import memoize


class ContentProviders(object):
  '''Implements the content_providers.json configuration; see
  chrome/common/extensions/docs/templates/json/content_providers.json for its
  current state and a description of the format.

  Returns ContentProvider instances based on how they're configured there.
  '''

  def __init__(self,
               compiled_fs_factory,
               host_file_system,
               github_file_system_provider):
    self._compiled_fs_factory = compiled_fs_factory
    self._host_file_system = host_file_system
    self._github_file_system_provider = github_file_system_provider
    self._cache = compiled_fs_factory.ForJson(host_file_system)

  @memoize
  def GetByName(self, name):
    '''Gets the ContentProvider keyed by |name| in content_providers.json, or
    None of there is no such content provider.
    '''
    config = self._GetConfig().get(name)
    if config is None:
      logging.error('No content provider found with name "%s"' % name)
      return None
    return self._CreateContentProvider(name, config)

  @memoize
  def GetByServeFrom(self, path):
    '''Gets a (content_provider, path_in_content_provider) tuple, where
    content_provider is the ContentProvider with the longest "serveFrom"
    property that is a subpath of |path|, and path_in_content_provider is the
    remainder of |path|.

    For example, if content provider A serves from "foo" and content provider B
    serves from "foo/bar", GetByServeFrom("foo/bar/baz") will return (B, "baz").

    Returns (None, |path|) if no ContentProvider serves from |path|.
    '''
    serve_from_to_config = dict(
        (config['serveFrom'], (name, config))
        for name, config in self._GetConfig().iteritems())
    path_parts = path.split('/')
    for i in xrange(len(path_parts), -1, -1):
      name_and_config = serve_from_to_config.get('/'.join(path_parts[:i]))
      if name_and_config is not None:
        return (self._CreateContentProvider(name_and_config[0],
                                            name_and_config[1]),
                '/'.join(path_parts[i:]))
    return None, path

  def _GetConfig(self):
    return self._cache.GetFromFile(CONTENT_PROVIDERS).Get()

  def _CreateContentProvider(self, name, config):
    supports_templates = config.get('supportsTemplates', False)
    supports_zip = config.get('supportsZip', False)

    if 'chromium' in config:
      chromium_config = config['chromium']
      if 'dir' not in chromium_config:
        logging.error('%s: "chromium" must have a "dir" property' % name)
        return None
      file_system = ChrootFileSystem(self._host_file_system,
                                     chromium_config['dir'])
    elif 'github' in config:
      github_config = config['github']
      if 'owner' not in github_config or 'repo' not in github_config:
        logging.error('%s: "github" must provide an "owner" and "repo"' % name)
        return None
      file_system = self._github_file_system_provider.Create(
          github_config['owner'], github_config['repo'])
      if 'dir' in github_config:
        file_system = ChrootFileSystem(file_system, github_config['dir'])
    else:
      logging.error(
          '%s: content provider type "%s" not supported' % (name, type_))
      return None

    return ContentProvider(name,
                           self._compiled_fs_factory,
                           file_system,
                           supports_templates=supports_templates,
                           supports_zip=supports_zip)

  def Cron(self):
    def safe(name, action, callback):
      '''Safely runs |callback| for a ContentProvider called |name| by
      swallowing exceptions and turning them into a None return value. It's
      important to run all ContentProvider Crons even if some of them fail.
      '''
      try:
        return callback()
      except:
        logging.error('Error %s Cron for ContentProvider "%s":\n%s' %
                      (action, name, traceback.format_exc()))
        return None

    futures = [(name, safe(name,
                           'initializing',
                           self._CreateContentProvider(name, config).Cron))
               for name, config in self._GetConfig().iteritems()]
    return Future(delegate=Gettable(
        lambda: [safe(name, 'resolving', f.Get) for name, f in futures if f]))