Index: third_party/coverage/templite.py |
diff --git a/third_party/coverage/templite.py b/third_party/coverage/templite.py |
new file mode 100644 |
index 0000000000000000000000000000000000000000..c39e061efd92284bff97b22446273f58d19d42c7 |
--- /dev/null |
+++ b/third_party/coverage/templite.py |
@@ -0,0 +1,166 @@ |
+"""A simple Python template renderer, for a nano-subset of Django syntax.""" |
+ |
+# Coincidentally named the same as http://code.activestate.com/recipes/496702/ |
+ |
+import re, sys |
+ |
+class Templite(object): |
+ """A simple template renderer, for a nano-subset of Django syntax. |
+ |
+ Supported constructs are extended variable access:: |
+ |
+ {{var.modifer.modifier|filter|filter}} |
+ |
+ loops:: |
+ |
+ {% for var in list %}...{% endfor %} |
+ |
+ and ifs:: |
+ |
+ {% if var %}...{% endif %} |
+ |
+ Comments are within curly-hash markers:: |
+ |
+ {# This will be ignored #} |
+ |
+ Construct a Templite with the template text, then use `render` against a |
+ dictionary context to create a finished string. |
+ |
+ """ |
+ def __init__(self, text, *contexts): |
+ """Construct a Templite with the given `text`. |
+ |
+ `contexts` are dictionaries of values to use for future renderings. |
+ These are good for filters and global values. |
+ |
+ """ |
+ self.text = text |
+ self.context = {} |
+ for context in contexts: |
+ self.context.update(context) |
+ |
+ # Split the text to form a list of tokens. |
+ toks = re.split(r"(?s)({{.*?}}|{%.*?%}|{#.*?#})", text) |
+ |
+ # Parse the tokens into a nested list of operations. Each item in the |
+ # list is a tuple with an opcode, and arguments. They'll be |
+ # interpreted by TempliteEngine. |
+ # |
+ # When parsing an action tag with nested content (if, for), the current |
+ # ops list is pushed onto ops_stack, and the parsing continues in a new |
+ # ops list that is part of the arguments to the if or for op. |
+ ops = [] |
+ ops_stack = [] |
+ for tok in toks: |
+ if tok.startswith('{{'): |
+ # Expression: ('exp', expr) |
+ ops.append(('exp', tok[2:-2].strip())) |
+ elif tok.startswith('{#'): |
+ # Comment: ignore it and move on. |
+ continue |
+ elif tok.startswith('{%'): |
+ # Action tag: split into words and parse further. |
+ words = tok[2:-2].strip().split() |
+ if words[0] == 'if': |
+ # If: ('if', (expr, body_ops)) |
+ if_ops = [] |
+ assert len(words) == 2 |
+ ops.append(('if', (words[1], if_ops))) |
+ ops_stack.append(ops) |
+ ops = if_ops |
+ elif words[0] == 'for': |
+ # For: ('for', (varname, listexpr, body_ops)) |
+ assert len(words) == 4 and words[2] == 'in' |
+ for_ops = [] |
+ ops.append(('for', (words[1], words[3], for_ops))) |
+ ops_stack.append(ops) |
+ ops = for_ops |
+ elif words[0].startswith('end'): |
+ # Endsomething. Pop the ops stack |
+ ops = ops_stack.pop() |
+ assert ops[-1][0] == words[0][3:] |
+ else: |
+ raise SyntaxError("Don't understand tag %r" % words) |
+ else: |
+ ops.append(('lit', tok)) |
+ |
+ assert not ops_stack, "Unmatched action tag: %r" % ops_stack[-1][0] |
+ self.ops = ops |
+ |
+ def render(self, context=None): |
+ """Render this template by applying it to `context`. |
+ |
+ `context` is a dictionary of values to use in this rendering. |
+ |
+ """ |
+ # Make the complete context we'll use. |
+ ctx = dict(self.context) |
+ if context: |
+ ctx.update(context) |
+ |
+ # Run it through an engine, and return the result. |
+ engine = _TempliteEngine(ctx) |
+ engine.execute(self.ops) |
+ return "".join(engine.result) |
+ |
+ |
+class _TempliteEngine(object): |
+ """Executes Templite objects to produce strings.""" |
+ def __init__(self, context): |
+ self.context = context |
+ self.result = [] |
+ |
+ def execute(self, ops): |
+ """Execute `ops` in the engine. |
+ |
+ Called recursively for the bodies of if's and loops. |
+ |
+ """ |
+ for op, args in ops: |
+ if op == 'lit': |
+ self.result.append(args) |
+ elif op == 'exp': |
+ try: |
+ self.result.append(str(self.evaluate(args))) |
+ except: |
+ exc_class, exc, _ = sys.exc_info() |
+ new_exc = exc_class("Couldn't evaluate {{ %s }}: %s" |
+ % (args, exc)) |
+ raise new_exc |
+ elif op == 'if': |
+ expr, body = args |
+ if self.evaluate(expr): |
+ self.execute(body) |
+ elif op == 'for': |
+ var, lis, body = args |
+ vals = self.evaluate(lis) |
+ for val in vals: |
+ self.context[var] = val |
+ self.execute(body) |
+ else: |
+ raise AssertionError("TempliteEngine doesn't grok op %r" % op) |
+ |
+ def evaluate(self, expr): |
+ """Evaluate an expression. |
+ |
+ `expr` can have pipes and dots to indicate data access and filtering. |
+ |
+ """ |
+ if "|" in expr: |
+ pipes = expr.split("|") |
+ value = self.evaluate(pipes[0]) |
+ for func in pipes[1:]: |
+ value = self.evaluate(func)(value) |
+ elif "." in expr: |
+ dots = expr.split('.') |
+ value = self.evaluate(dots[0]) |
+ for dot in dots[1:]: |
+ try: |
+ value = getattr(value, dot) |
+ except AttributeError: |
+ value = value[dot] |
+ if hasattr(value, '__call__'): |
+ value = value() |
+ else: |
+ value = self.context[expr] |
+ return value |