codegen – Instruction generator

Instruction generator for tayra.runtime.StackMachine. Generates intermediate python file.

Module contents

class tayra.codegen.InstrGen(compiler)

Bases: builtins.object

Instruction generator to compile template script to an intermediate python file. This file can be loaded as template module and executed in the context of a HTTP request to generate the final HTML response. Since creating an instance of this class every time can be a costly operation, create it once and use _init() to initialize for subsequent uses.

codeindent(up=None, down=None, indent=True)

Increase or decrease python code-indentation for subsequently generated code.

codetext()

Return the final text of python code.

comment(comment, force=False)

Optionally create a comment line inside the python code. Happens only when TTLCompiler[‘debug’] option is set true.

cr(count=1)

Generate a new-line (along with current indentation level) in python generated text.

evalexprs(s)

Evaluate a string as python expression and append the result into the stack buffer.

finish()

Call this when there is no more instruction to generate. Before calling this footer() method must have been called.

flushtext()

puttext() method’s text string are not immediately appended to the stack buffer. They are accumulated and appended only when this method is called.

footer(ttlhash, ttlfile)

Add the footer python code.

handletag(**kwargs)

Pop the last two buffers from the stack and supply them to ITayraTags plugins. The returned HTML text from the plugin is only again pushed into the stack buffer.

implement_interface(implements, interfaces)

Special method to handle @implement directive and @interface functions implementations.

importttl(modname, ttlfile)

Special method to handle @import directive.

initialize()

Initialize and begin generating the intermediate python file. Generates import statements and in debug mode generate trace-back generator.

popappend(astext=True)

Pop the last buffer in the stack and append the text into the previous buffer in the stack.

popobject(returnwith=None)

Some times a function might want to return something else other than stacked buffers.

popreturn(astext=True)

Pop the last buffer in the stack and return the text.

pushbuf()

Create a new buffer in the stack. The newly created buffer will start accumulated text string.

putblock(codeblock, indent=True)

Add a block of python statements in the intermediate code.

putinherit(ttlloc)

Special method to handle @inherit directive.

putstatement(stmt)

Add a python statement in the intermediate code.

puttext(text, force=False)

Append text into the stack machine.