Lazily load API schemas from resource files and convert all APIs to features

chrome/common/extensions/api/_api_features.json

 // 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.
 
 {
   "app": {
     "channel": "stable",
     "extension_types": ["hosted_app", "extension", "packaged_app"],
     "contexts": [
       "blessed_extension", "unblessed_extension", "content_script", "web_page"
@@ skipping 38 matching lines @@
   "fileBrowserHandlerInternal": {
     "internal": true,
     "channel": "stable",
     "contexts": ["blessed_extension", "unblessed_extension", "content_script"]
   },
   "runtime": {
     "channel": "stable",
     "extension_types": ["extension", "packaged_app", "platform_app"],
     "contexts": ["blessed_extension"]
   },
   "runtime.connect": {

[not at google - send to devlin, 2013/05/20 17:19:04]

As I said in ExtensionAPI in order to impement GetAPINames we'll need to know
how to distinguish this from an API name. And just looking at the substring
isn't enough obviously, sine there's chrome.app and chrome.app.window as
distinct APIs.

Maybe we can kill 2 birds with 1 stone. There is a bunch of repetition here.
Perhaps we could have a property that expresses both inheritance of properties,
and the fact that it's a specialisation of the API? Brainstorm:

"runtime.connect": {
  // One of the following...
  "belongs_to": "api:runtime",
  "specializes": "api:runtime",
  "parent": "api:runtime",
  "super_feature": "api:runtime",
  "super": "api:runtime",
  "api": "runtime",
  // And finally just this.
  "contexts": ["blessed_extension", "unblessed_extension", "content_script"]
}

so far "specializes" is my favourite. Pls help me brainstorm...

[cduvall, 2013/05/21 23:50:28]

I like "specializes" or "parent". We could also do something like "inherits" or
"inherits_from".

So then this feature would just take the properties from the parent feature, and
replace any that are specifically specified?

     "channel": "stable",
     "extension_types": ["extension", "packaged_app", "platform_app"],
     "contexts": ["blessed_extension", "unblessed_extension", "content_script"]
   },
   "runtime.getManifest": {
     "channel": "stable",
     "extension_types": ["extension", "packaged_app", "platform_app"],
     "contexts": ["blessed_extension", "unblessed_extension", "content_script"]
   },
   "runtime.getURL": {
@@ skipping 41 matching lines @@
     "channel": "stable",
     "contexts": ["blessed_extension", "unblessed_extension", "content_script"]
   },
   "webstore": {
     // Hosted apps can use the webstore API from within a blessed context.
     "channel": "stable",
     "extension_types": ["hosted_app"],
     "contexts": ["blessed_extension", "web_page"],
     // Any webpage can use the webstore API.
     "matches": ["http://*/*", "https://*/*"]
+  },
+
+  // NEW APIS BEGIN HERE

[cduvall, 2013/05/17 03:09:30]

I'll move these up with the other ones after you check them.

[not at google - send to devlin, 2013/05/20 17:19:04]

Ok. Let's figure out the architecture of this change and then you can do it.

I'll get everybody on the extensions team to review this list.

+  "alarms": {
+    "channel": "stable",
+    "dependencies": ["permission:alarms"],
+    "contexts": ["blessed_extension"]
+  },
+  "autotestPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:autotestPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "bluetooth": {
+    "channel": "dev",
+    "dependencies": ["permission:bluetooth"],
+    "contexts": ["blessed_extension"]
+  },
+  "bookmarkManagerPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:bookmarkManagerPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "browserAction": {
+    "channel": "stable",
+    "dependencies": ["manifest:browser_action"],
+    "contexts": ["blessed_extension"]
+  },
+  "browsingData": {
+    "channel": "stable",
+    "dependencies": ["permission:browsingData"],
+    "contexts": ["blessed_extension"]
+  },
+  "chromeosInfoPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:chromeosInfoPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "cloudPrintPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:cloudPrintPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "commands": {
+    "channel": "stable",
+    "dependencies": ["manifest:commands"],
+    "contexts": ["blessed_extension"]
+  },
+  "contentSettings": {
+    "channel": "stable",
+    "dependencies": ["permission:contentSettings"],
+    "contexts": ["blessed_extension"]
+  },
+  "contextMenus": {
+    "channel": "stable",
+    "dependencies": ["permission:contextMenus"],
+    "contexts": ["blessed_extension"]
+  },
+  "cookies": {
+    "channel": "stable",
+    "dependencies": ["permission:cookies"],
+    "contexts": ["blessed_extension"]
+  },
+  "debugger": {
+    "channel": "stable",
+    "dependencies": ["permission:debugger"],
+    "contexts": ["blessed_extension"]
+  },
+  "declarativeContent": {
+    "channel": "stable",
+    "dependencies": ["permission:declarativeContent"],
+    "contexts": ["blessed_extension"]
+  },
+  "declarativeWebRequest": {
+    "channel": "stable",
+    "dependencies": ["permission:declarativeWebRequest"],
+    "contexts": ["blessed_extension"]
+  },
+  "developerPrivate": {
+    "channel": "dev",
+    "dependencies": ["permission:developerPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "dial": {
+    "channel": "stable",
+    "dependencies": ["permission:dial"],
+    "contexts": ["blessed_extension"]
+  },
+  "downloads": {
+    "channel": "stable",
+    "dependencies": ["permission:downloads"],
+    "contexts": ["blessed_extension"]
+  },
+  "echoPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:echoPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.accessibility": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.discovery": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.dns": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.idltest": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.infobars": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.input.virtualKeyboard": {
+    "channel": "stable",
+    "dependencies": ["permission:input", "permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.processes": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.mediaGalleries": {
+    "channel": "stable",
+    "dependencies": ["permission:mediaGalleries", "permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.record": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.rlz": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.speechInput": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.systemInfo.cpu": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.systemInfo.display": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.systemInfo.memory": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "experimental.systemInfo.storage": {
+    "channel": "stable",
+    "dependencies": ["permission:experimental"],
+    "contexts": ["blessed_extension"]
+  },
+  "extension": {
+    "channel": "stable",
+    "extension_types": ["extension", "packaged_app"],
+    "contexts": ["blessed_extension", "unblessed_extension"]
+  },
+  "fileBrowserHandler": {
+    "channel": "stable",
+    "dependencies": ["permission:fileBrowserHandler"],
+    "contexts": ["blessed_extension"]
+  },
+  "fileBrowserPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:fileBrowserPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "fileSystem": {
+    "channel": "stable",
+    "dependencies": ["permission:fileSystem"],
+    "contexts": ["blessed_extension"]
+  },
+  "fontSettings": {
+    "channel": "stable",
+    "dependencies": ["permission:fontSettings"],
+    "contexts": ["blessed_extension"]
+  },
+  "history": {
+    "channel": "stable",
+    "dependencies": ["permission:history"],
+    "contexts": ["blessed_extension"]
+  },
+  "i18n": {
+    "channel": "stable",
+    "extension_types": ["extension", "packaged_app", "platform_app"],
+    "contexts": ["blessed_extension", "unblessed_extension"]
+  },
+  "identity": {
+    "channel": "stable",
+    "dependencies": ["permission:identity"],
+    "contexts": ["blessed_extension"]
+  },
+  "idle": {
+    "channel": "stable",
+    "dependencies": ["permission:idle"],
+    "contexts": ["blessed_extension"]
+  },
+  "input.ime": {
+    "channel": "stable",
+    "dependencies": ["permission:input"],
+    "contexts": ["blessed_extension"]
+  },
+  "input.methodPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:input"],
+    "contexts": ["blessed_extension"]
+  },
+  "managedModePrivate": {
+    "channel": "dev",
+    "dependencies": ["permission:managedModePrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "location": {
+    "channel": "stable",
+    "dependencies": ["permission:location"],
+    "contexts": ["blessed_extension"]
+  },
+  "management": {
+    "channel": "stable",
+    "dependencies": ["permission:management"],
+    "contexts": ["blessed_extension"]
+  },
+  "mediaGalleries": {
+    "channel": "stable",
+    "dependencies": ["permission:mediaGalleries"],
+    "contexts": ["blessed_extension"]
+  },
+  "mediaGalleriesPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:mediaGalleriesPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "mediaPlayerPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:mediaPlayerPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "metricsPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:metricsPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "networkingPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:networkingPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "notifications": {
+    "channel": "stable",
+    "dependencies": ["permission:notifications"],
+    "contexts": ["blessed_extension"]
+  },
+  "omnibox": {
+    "channel": "stable",
+    "dependencies": ["manifest:omnibox"],
+    "contexts": ["blessed_extension"]
+  },
+  "pageAction": {
+    "channel": "stable",
+    "dependencies": ["manifest:page_action"],
+    "contexts": ["blessed_extension"]
+  },
+  "pageActions": {
+    "channel": "stable",
+    "dependencies": ["manifest:page_actions"],
+    "contexts": ["blessed_extension"]
+  },
+  "pageCapture": {
+    "channel": "stable",
+    "dependencies": ["permission:pageCapture"],
+    "contexts": ["blessed_extension"]
+  },
+  "pageLauncher": {
+    "channel": "dev",
+    "dependencies": ["manifest:page_launcher"],
+    "contexts": ["blessed_extension"]
+  },
+  "permissions": {
+    "channel": "stable",
+    "extension_types": ["extension", "packaged_app", "platform_app"],
+    "contexts": ["blessed_extension"]
+  },
+  "power": {
+    "channel": "stable",
+    "dependencies": ["permission:power"],
+    "contexts": ["blessed_extension"]
+  },
+  "privacy": {
+    "channel": "stable",
+    "dependencies": ["permission:privacy"],
+    "contexts": ["blessed_extension"]
+  },
+  "proxy": {
+    "channel": "stable",
+    "dependencies": ["permission:proxy"],
+    "contexts": ["blessed_extension"]
+  },
+  "pushMessaging": {
+    "channel": "stable",
+    "dependencies": ["permission:pushMessaging"],
+    "contexts": ["blessed_extension"]
+  },
+  "rtcPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:rtcPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "scriptBadge": {
+    "channel": "trunk",
+    "dependencies": ["manifest:script_badge"],
+    "contexts": ["blessed_extension"]
+  },
+  "serial": {
+    "channel": "stable",
+    "dependencies": ["permission:serial"],
+    "contexts": ["blessed_extension"]
+  },
+  "sessionRestore": {
+    "channel": "dev",
+    "dependencies": ["permission:sessionRestore"],
+    "contexts": ["blessed_extension"]
+  },
+  "socket": {
+    "channel": "stable",
+    "dependencies": ["permission:socket"],
+    "contexts": ["blessed_extension"]
+  },
+  "storage": {
+    "channel": "stable",
+    "dependencies": ["permission:storage"],
+    "contexts": ["blessed_extension", "unblessed_extension"]
+  },
+  "syncFileSystem": {
+    "channel": "stable",
+    "dependencies": ["permission:syncFileSystem"],
+    "contexts": ["blessed_extension"]
+  },
+  "systemIndicator": {
+    "channel": "dev",
+    "dependencies": ["permission:systemIndicator", "manifest:system_indicator"],
+    "contexts": ["blessed_extension"]
+  },
+  "systemInfo.display": {
+    "channel": "stable",
+    "dependencies": ["permission:systemInfo.display"],
+    "contexts": ["blessed_extension"]
+  },
+  "systemPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:systemPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "tabCapture": {
+    "channel": "stable",
+    "dependencies": ["permission:tabCapture"],
+    "contexts": ["blessed_extension"]
+  },
+  "tabs": {
+    "channel": "stable",
+    "extension_types": ["extension", "packaged_app"],
+    "contexts": ["blessed_extension"]
+  },
+  "terminalPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:terminalPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "test": {
+    "channel": "stable",
+    "extension_types": ["extension", "hosted_app", "packaged_app", "platform_app"],
+    "contexts": ["blessed_extension"]
+  },
+  "topSites": {
+    "channel": "stable",
+    "dependencies": ["permission:topSites"],
+    "contexts": ["blessed_extension"]
+  },
+  "tts": {
+    "channel": "stable",
+    "dependencies": ["permission:tts"],
+    "contexts": ["blessed_extension"]
+  },
+  "ttsEngine": {
+    "channel": "stable",
+    "dependencies": ["permission:ttsEngine"],
+    "contexts": ["blessed_extension"]
+  },
+  "types": {
+    "channel": "stable",
+    "extension_types": ["extension", "hosted_app", "packaged_app", "platform_app"],
+    "contexts": ["blessed_extension"]
+  },
+  "usb": {
+    "channel": "stable",
+    "dependencies": ["permission:usb"],
+    "contexts": ["blessed_extension"]
+  },
+  "wallpaperPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:wallpaperPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "webNavigation": {
+    "channel": "stable",
+    "dependencies": ["permission:webNavigation"],
+    "contexts": ["blessed_extension"]
+  },
+  "webRequest": {
+    "channel": "stable",
+    "dependencies": ["permission:webRequest"],
+    "contexts": ["blessed_extension"]
+  },
+  "webSocketProxyPrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:webSocketProxyPrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "webstorePrivate": {
+    "channel": "stable",
+    "dependencies": ["permission:webstorePrivate"],
+    "contexts": ["blessed_extension"]
+  },
+  "webview": {
+    "channel": "stable",
+    "dependencies": ["permission:webview"],
+    "contexts": ["blessed_extension"]
+  },
+  "windows": {
+    "channel": "stable",
+    "dependencies": ["permission:tabs"],
+    "contexts": ["blessed_extension"]
   }
 }