几个bottle插件

上篇《Bottle的插件与view装饰器冲突问题》里说到的问题就是我在写这几个插件时碰到的问题。

为便于使用bottle写了一组插件。最初自己用的时候是把所有功能都写在一个插件里,感觉有点笨重,不适合灵活组合,所以分拆改写成现在的样子。

包含

  1. beaker.BeakerPlugin
  2. params.ParamsPlugin
  3. login.LoginPlugin

 

beaker.BeakerPlugin

Beaker session插件,比bottle的官方beaker插件更便于使用——其实官方的beaker插件什么事都没做,跟直接用beaker没什么区别。

构造函数:

BeakerPlugin(keyword="session")

参数:

  1. keyword : beaker session使用的参数名,默认为session,如请求响应函数不包含此参数,则此插件被忽略,如包含此参数,则自动从请求环境中读取beaker的session对象

无可用route参数。

必须配合beaker midware使用,使用方法见beaker文档或示例程序demo.py。

 

params.ParamsPlugin

参数插件,自动把请求参数转为函数调用参数,默认使用utf-8编码转为Unicode,自动根据请求方法读取query或forms,如果设置了json_params选项,则读取json。

构造函数:

ParamsPlugin(json_params=False, encode="utf-8")

参数:

  1. json_params : 是否使用json参数。默认为False,如果设置为True则解析 bottle.request.json 的值,以dict方式解析为对应参数。
  2. encode : 指定请求编码方式。默认为utf-8。

route参数:

在请求的route中也可以使用 json_params ,用于对特定请求使用json格式。

 

login.LoginPlugin

简单的登录处理插件。如果请求需要用户登录时加上登录参数(默认为login),则会在处理请求前调用login_func处理登录操作,成功则将结果返回给login参数。

因为处理登录操作通常需要依赖数据库和session,所以需要两个额外参数:db和session。这两个参数将会被传递给login_func。

所以使用本插件至少需要同时安装一个数据库(或类似的如sqlalchemy)插件,和类似本插件包中的BeakerPlugin这样的session插件。

构造函数:

LoginPlugin(login_func, keyword="login", dbkeyword="db", sessionkeyworkd="session")

参数:

  1. login_func:登录处理函数,无默认值,带两个参数:db和session用于传入数据库和session,参数值来值相应插件(所以其它插件必须先于本插件安装),返回值将被赋给login参数。
  2. keyword:login参数名,默认为login。
  3. dbkeyword:数据库插件的参数名,默认为db。
  4. sessionkeyword:session插件的参数名,默认为session

无可用route参数

源码已发在github

推送到[go4pro.org]