tgext.utils 0.0.4

关于tgext.utils

tgext.utils是TurboGears2 Web框架的实用工具集合。

pip install tgext.utils

CSRF保护

tgext.utils.csrf提供了两个装饰器@csrf_token和@csrf_protect，用于生成表单中的CSRF令牌并检查令牌是否有效。

用户必须将@csrf_token装饰器应用于暴露表单的动作，并在表单中添加一个值为request.csrf_token且名称为_csrf_token的隐藏输入

@csrf_token
@expose()
def form(self):
    return '''
    <form method="POST" action="/post_form">
        <input type="hidden" name="_csrf_token" value="%s">
    </form>''' % request.csrf_token

接收表单的动作必须具有@csrf_protect装饰器，无需对此动作进行特殊操作或检查

@csrf_protect
@expose()
def post_form(self, **kwargs):
    return 'OK!'

元标签

tgext.utils.meta.metatags提供了一种方便的方式来生成网页的常见元标签。

在lib/helpers.py中添加

from tgext.utils.meta import metatags

然后在您的页面中

${h.metatags(title="pagetitle", description="Page Description", image="http://url/myimage.png")}

别名

tgext.utils.slug提供了一种为您的页面生成别名的途径

要生成别名，请使用

from tgext.utils.slug import slugify
myslug = slugify(model_id, string_to_be_inserted_in_the_url)

要从别名获取ID，请使用

from tgext.utils.slug import slug2entityid
slug2entityid(myslug)

存储

tgext.utils.storage是用于将文件存储到/public目录中分离文件夹的工具。

from tgext.utils.storage import store

filename = store(ufile)  # ufile is an instance of cgi.FieldStorage

文件存储在/public/storage/${uuid1}文件夹中，因此也可以使用内部tg文件服务进行访问。