blob: b84c717cc08d8c3d00486f1c188831269c7f9012 [file] [log] [blame]
# Copyright 2015 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.
Generator that produces an interface file for the Closure Compiler.
Note: This is a work in progress, and generated interfaces may require tweaking.
from code import Code
from js_util import JsUtil
from model import *
from schema_util import *
import os
import sys
import re
ASSERT = """
assertNotReached('Interface file for Closure Compiler should not be executed.');
class JsInterfaceGenerator(object):
def Generate(self, namespace):
return _Generator(namespace).Generate()
class _Generator(object):
def __init__(self, namespace):
self._namespace = namespace
first =[0].upper()
rest =[1:]
self._interface = first + rest
self._js_util = JsUtil()
def Generate(self):
"""Generates a Code object with the schema for the entire namespace.
c = Code()
c.Sblock('%s.prototype = {' % self._interface)
for function in self._namespace.functions.values():
self._AppendFunction(c, function)
for event in
self._AppendEvent(c, event)
return c
def _GetHeader(self, tool, namespace):
"""Returns the file header text.
return (self._js_util.GetLicense() + '\n' +
self._js_util.GetInfo(tool) + '\n' +
('/** @fileoverview Interface for %s that can be overriden. */' %
namespace) + '\n' +
def _AppendInterfaceObject(self, c):
"""Appends the code creating the interface object.
For example:
/** @interface */
function SettingsPrivate() {}
(c.Append('/** @interface */')
.Append('function %s() {}' % self._interface))
def _AppendFunction(self, c, function):
"""Appends the inteface for a function, including a JSDoc comment.
if function.deprecated:
self._js_util.AppendFunctionJsDoc(c,, function)
c.Append('%s: assertNotReached,' % (
def _AppendEvent(self, c, event):
"""Appends the interface for an event.
c.Sblock(line='/**', line_prefix=' * ')
if (event.description):
c.Comment(event.description, comment_prefix='')
c.Append('@type {!ChromeEvent}')
self._js_util.AppendSeeLink(c,, 'event',
c.Eblock(' */')
c.Append('%s.prototype.%s;' % (self._interface,