Python Templating Language

2007年3月1日 (四) 23:06的版本

PTL = Python Templating Language

def f [html] (): content

First Example

touch test_page.ptl

def numbers [plain] (N):
   for i in range(N):
       i
       " "

>>>import quixote
>>>quixote.enable_ptl()
>>> import test_page
>>> test_page.numbers(5)
' 0 1 2 3 4 '

Example

example.ptl:

To callers, templates behave like regular Python functions

def cell [html] (content):
    '<td>'         # Literal expressions are appended to the output
    content        # Expressions are evaluated, too.
    '</td>'

def row [html] (L):
    # L: list of strings containing cell content
    '<tr>'
    for s in L:
        cell(s)
    '</tr>\n'

def loop (n):  # No [html], so this is a regular Python function
    output = ""
    for i in range(1, 10):
        output += row([str(i), i*'a', i*'b'])
    return output

Using templates

Templates live in .ptl files, which can be imported. To enable this:

import quixote ; quixote.enable_ptl() # Enable import hook

Templates behave just like Python functions:

>>> import example
>>> example.cell('abc')
<htmltext '<td>abc</td>'>
>>> example.loop()
<htmltext '<tr><td>1</td><td>a</td><td>b</td>...</tr>\n'>

In .ptl files, methods can even be PTL files.

Automatic escaping

def no_quote [plain] (arg):
    '<title>'
    arg              # Converted to string
    '</title>'

def quote [html] (arg):
    '<title>'
    arg              # Converted to string and HTML-escaped
    '</title>'

>>> no_quote('A history of the < symbol')
'<title>A history of the < symbol</title>'
>>> quote('A history of the < symbol')
<htmltext '<title>A history of the < symbol</title>'>