1

"""

     2

    Template handler

     3

"""

     4

     5

# use Mako

     6

from mako import exceptions

     7

from mako.template import Template

     8

from mako.lookup import TemplateLookup

     9

    10

# for http.ResponseError

    11

import http

    12

    13

import helpers

    14

    15

# path to template files

    16

TEMPLATE_DIR = "templates"

    17

    18

# path to cached templates

    19

CACHE_DIR = "cache/templates"

    20

    21

# template file extension

    22

TEMPLATE_EXT = "tmpl"

    23

    24

    25

# our Mako template lookup handler

    26

_lookup = TemplateLookup(directories=[TEMPLATE_DIR], module_directory=CACHE_DIR)

    27

    28

    29

class TemplateError (http.ResponseError) :

    30

    """

    31

        Raised by the template module functions

    32

    """

    33

    34

    pass

    35

    36

def lookup (name) :

    37

    """

    38

        Looks up a template based on the bare "name", which does not include the path or file extension

    39

    """

    40

    41

    try :

    42

        return _lookup.get_template("%s.%s" % (name, TEMPLATE_EXT))

    43

    44

    except :

    45

        raise TemplateError("Template broken: %r" % (name, ), status='500 Internal Server Error', details=exceptions.text_error_template().render())

    46

    47

def load (path) :

    48

    """

    49

        Loads a template from a specific file

    50

    """

    51

    52

    try :

    53

        return Template(filename=path, module_directory=CACHE_DIR)

    54

    55

    except :

    56

        raise TemplateError("Template broken: %r" % (path, ), status='500 Internal Server Error', details=exceptions.text_error_template().render())

    57

    58

def render_template (tpl, **params) :

    59

    """

    60

        Render the given template, returning the output as a unicode string, or raising a TemplateError

    61

    """

    62

    63

    try :

    64

        return tpl.render_unicode(

    65

            # global helper stuff

    66

            h           = helpers,

    67

    68

            # render-specific params

    69

            **params

    70

        )

    71

    72

    # a template may render other templates

    73

    except TemplateError :

    74

        raise

    75

    76

    except :

    77

        details = exceptions.text_error_template().render()

    78

    79

        raise TemplateError("Template render failed", status='500 Internal Server Error', details=details)

    80

    81

def render (name, **params) :

    82

    """

    83

        Render a template, using lookup() on the given name

    84

    """

    85

    86

    return render_template(lookup(name), **params)

    87

    88

def render_file (path, **params) :

    89

    """

    90

        Render a template, using load() on the given path

    91

    """

    92

    93

    return render_template(load(path), **params)

    94