Code generation for extensions api

tools/json_schema_compiler/code.py

+# 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.
+
+class Code(object):
+  """A convenience object for constructing code.
+
+  Logically each object should be a block of code. All methods except |render|
+  and |isEmpty| return self.
+  """
+  def __init__(self, indent_size=2, comment_length=80):
+    self._code = []
+    self._indent_level = 0
+    self._indent_size = indent_size
+    self._comment_length = comment_length
+
+  def append(self, line=''):
+    """Appends a line of code at the current indent level or just a newline if
+    line is not specified. Trailing whitespace is stripped.
+    """
+    self._code.append(((' ' * self._indent_level) + line).rstrip())
+    return self
+
+  def isEmpty(self):
+    """Returns True if the Code object is empty.
+    """
+    return bool(self._code)
+
+  def concat(self, obj):
+    """Concatenate another Code object onto this one. Trailing whitespace is
+    stripped.
+
+    Appends the code at the current indent level. Will fail if there are any
+    un-interpolated format specifiers eg %s, %(something)s which helps
+    isolate any strings that haven't been substituted.
+    """
+    if not isinstance(obj, Code):
+      raise TypeError()
+    assert self is not obj
+    for line in obj._code:
+      # line % () will fail if any substitution tokens are left in line
+      self._code.append(((' ' * self._indent_level) + line % ()).rstrip())
+
+    return self
+
+  def sblock(self, line=''):
+    """Starts a code block.
+
+    Appends a line of code and then increases the indent level.
+    """
+    self.append(line)
+    self._indent_level += self._indent_size
+

[Yoyo Zhou, 2012/01/23 23:16:42]

Stray newline?

[calamity, 2012/01/24 22:57:22]

Done.

+    return self
+
+  def eblock(self, line=''):
+    """Ends a code block by decreasing and then appending a line (or a blank
+    line if not given).
+    """
+    # TODO(calamity): Decide if type checking is necessary
+    #if not isinstance(line, basestring):
+    #  raise TypeError
+    self._indent_level -= self._indent_size
+    self.append(line)
+    return self
+
+  # TODO(calamity): Make comment its own class or something and render at
+  # self.render() time
+  def comment(self, comment):
+    """Adds the given string as a comment.
+
+    Will split the comment if it's too long. Use mainly for variable length
+    comments. Otherwise just use code.append('// ...') for comments.
+    """
+    comment_symbol = '// '
+    max_len = self._comment_length - self._indent_level - len(comment_symbol)
+    while len(comment) >= max_len:
+      line = comment[0:max_len]
+      last_space = line.rfind(' ')
+      if last_space != -1:
+        line = line[0:last_space]
+        comment = comment[last_space + 1:]
+      else:
+        comment = comment[max_len:]
+      self.append(comment_symbol + line)
+    self.append(comment_symbol + comment)
+    return self
+
+  def substitute(self, d):
+    """Goes through each line and interpolates using the given dict.
+
+    Raises type error if passed something that isn't a dict
+
+    Use for long pieces of code using interpolation with the same variables
+    repeatedly. This will reduce code and allow for named placeholders which
+    are more clear.
+    """
+    if not isinstance(d, dict):
+      raise TypeError('Passed argument is not a dictionary: ' + d)
+    for i, line in enumerate(self._code):
+      # Only need to check %s because arg is a dict and python will allow
+      # '%s %(named)s' but just about nothing else
+      if '%s' in self._code[i] or '%r' in self._code[i]:
+        raise TypeError('"%s" or "%r" found in substitution. '
+                        'Named arguments only. Use %%s to escape')

[Yoyo Zhou, 2012/01/23 23:16:42]

I still read this as use '%s' to escape, rather than use '%'s to escape. Is that
right? You could just write: use '%' to escape.

[calamity, 2012/01/24 22:57:22]

Done.

+      self._code[i] = line % d
+    return self
+
+  def render(self):
+    """Renders Code as a string.
+    """
+    return '\n'.join(self._code)
+