bottle
Bottle是一个快速、简洁、轻量级的基于WSIG的微型Web框架,此框架只由一个 .py 文件,除了Python的标准库外,其不依赖任何其他模块。
一、安装
pip install bottle
easy_install bottle
apt-get install python-bottle
wget http://bottlepy.org/bottle.py
二、分类
Bottle框架大致可以分为以下部分:
2、模板系统,将模板中的特殊语法渲染成字符串,值得一说的是Bottle的模板引擎可以任意指定:Bottle内置模板、mako、jinja2、cheetah
3、公共组件,用于提供处理请求相关的信息,如:表单数据、cookies、请求头等
4、服务,Bottle默认支持多种基于WSGI的服务,如:
server_names = {
'cgi': CGIServer,
'flup': FlupFCGIServer,
'wsgiref': WSGIRefServer,
'waitress': WaitressServer,
'cherrypy': CherryPyServer,
'paste': PasteServer,
'fapws3': FapwsServer,
'tornado': TornadoServer,
'gae': APPEngineServer,
'twisted': TwistedServer,
'diesel': DieselServer,
'meinheld': MeinheldServer,
'gunicorn': GunicornServer,
'eventlet': EventletServer,
'gevent': GeventServer,
'geventsocketIO':GeventSocketiOServer,
'rocket': RocketServer,
'bjoern' : BjoernServer,
'auto': AutoServer,
}
三、框架的基本使用
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from bottle import template, Bottle
root = Bottle()
@root.route('/hello/')
def index():
return "hello world"
# return template('<b>Hello {{name}}</b>!', name="World")
if __name__ == '__main__':
root.run(host='localhost', port=8080)
四、路由系统
路由系统是的url对应指定函数,当用户请求某个url时,就由指定函数处理当前请求,对于Bottle的路由系统可以分为一下几类:
静态路由
动态路由
请求方法路由
二级路由(路由转发)
1、静态路由
@root.route('/hello/')
def index():
return template('<b>Hello {{name}}</b>!', name="World")
2、动态路由
@root.route('/wiki/<pagename>')
def callback(pagename):
...
@root.route('/object/<id:int>')
def callback(id):
...
@root.route('/show/<name:re:[a-z]+>')
def callback(name):
...
#创建static目录,把静态文件放在该目录下
@root.route('/static/<path:path>')
def callback(path):
return static_file(path, root='static')
3、请求方法路由
@root.route('/hello/', method='POST')
def index():
...
@root.get('/hello/')
def index():
...
@root.post('/hello/')
def index():
...
@root.put('/hello/')
def index():
...
@root.delete('/hello/')
def index():
...
@root.route('/hello/', method=['GET','POST'])
def index():
...
4、二级路由
①app01.py
#!/usr/bin/env python
# -*- coding:utf-8 -*-
#script name:app01.py
from bottle import template, Bottle
app01 = Bottle()
@app01.route('/hello/', method='GET')
def index():
return template('<b>App01</b>!')
②app02.py
#!/usr/bin/env python
# -*- coding:utf-8 -*-
#script name:app02.py
from bottle import template, Bottle
app02 = Bottle()
@app02.route('/hello/', method='GET')
def index():
return template('<b>App02</b>!')
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from bottle import template, Bottle
from bottle import static_file
root = Bottle()
@root.route('/hello/')
def index():
return template('<b>Hello {{name}}</b>!', name="World")
from framwork_bottle import app01
from framwork_bottle import app02
root.mount('app01', app01.app01)
root.mount('app02', app02.app02)
if __name__ == '__main__':
root.run(host='localhost', port=8080)
五、模板系统
模板系统用于将Html和自定的值两者进行渲染,从而得到字符串,然后将该字符串返回给客户端。我们知道在Bottle中可以使用 内置模板系统、mako、jinja2、cheetah等,以内置模板系统为例:
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from bottle import template, Bottle,TEMPLATE_PATH
TEMPLATE_PATH.append('templates') #创建一个templates目录,把html文件放到这里面
root = Bottle()
@root.route('/hello/')
def index():
# 默认情况下去目录:['./', './views/']中寻找模板文件 hello_template.html
# 配置在 bottle.TEMPLATE_PATH 中
return template('hello_template.tpl', name='root')
if __name__ == '__main__':
root.run(host='localhost', port=8080)
页面
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
</head>
<body>
<h1>{{name}}</h1>
</body>
</html>
1、语法
单值
单行Python代码
Python代码快
Python、Html混合
<h1>1、单值</h1>
{{name}}
<h1>2、单行Python代码</h1>
% s1 = "hello" /*声明变量*/
<h1>3、Python代码块</h1>
<%
# A block of python code
name = name.title().strip()
if name == "Tony":
name="seven"
%>
<h1>4、Python、Html混合</h1>
% if True:
<span>{{name}}</span>
% end
<ul>
% for item in name:
<li>{{item}}</li>
% end
</ul>
2、函数
①include(sub_template, **variables)
# 导入其他模板文件
% include('header.tpl', title='Page Title')
Page content
% include('footer.tpl')
rebase(name, **variables)
②base.tpl(公共模板)
<html>
<head>
<title>{{title or 'No title'}}</title>
</head>
<body>
{{!base}} /*!为转义作用*/
</body>
</html>
# 导入母版
% rebase('base.tpl', title='Page Title')
<p>Page Content ...</p>
③设置变量
# 检查当前变量是否已经被定义,已定义True,未定义False
defined(name)
# 获取某个变量的值,不存在时可设置默认值
get(name, default=None)
# 如果变量不存在时,为变量设置默认值
setdefault(name, default)
④扩展:自定义函数
模板文件:hello_template.html
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
</head>
<body>
<h1>自定义函数</h1>
{{ simpledefine() }}
</body>
</html>
python代码:
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from bottle import template, Bottle,SimpleTemplate
root = Bottle()
def custom():
return '123123'
@root.route('/hello/')
def index():
# 默认情况下去目录:['./', './views/']中寻找模板文件 hello_template.html
# 配置在 bottle.TEMPLATE_PATH 中
return template('hello_template.html', name='tony', simpledefine=custom)
root.run(host='localhost', port=8080)
备注:变量或函数前添加 【 ! 】,则会关闭转义的功能
六、公共组件
由于Web框架就是用来【接收用户请求】-> 【处理用户请求】-> 【响应相关内容】,对于具体如何处理用户请求,开发人员根据用户请求来进行处理,而对于接收用户请求和相应相关的内容均交给框架本身来处理,其处理完成之后将产出交给开发人员和用户。
【接收用户请求】
当框架接收到用户请求之后,将请求信息封装在Bottle的request中,以供开发人员使用
【响应相关内容】
当开发人员的代码处理完用户请求之后,会将其执行内容相应给用户,相应的内容会封装在Bottle的response中,然后再由框架将内容返回给用户
所以,公共组件本质其实就是为开发人员提供接口,使其能够获取用户信息并配置响应内容。
1、request
Bottle中的request其实是一个LocalReqeust对象,其中封装了用户请求的相关信息:
request.headers #请求头信息
request.query #get请求信息
request.forms #post请求信息
request.files #上传文件信息
request.params #get和post请求信息
request.GET #get请求信息
request.POST #post和上传信息
request.cookies #cookie信息
request.environ #环境相关相关
2、response
Bottle中的request其实是一个LocalResponse对象,其中框架即将返回给用户的相关信息:
response
response.status_line #状态行
response.status_code #状态码
response.headers #响应头
response.charset #编码
response.set_cookie #在浏览器上设置cookie
response.delete_cookie #在浏览器上删除cookie
3、示例
①基本Form请求
from bottle import route, request
@route('/login')
def login():
return '''
<form action="/login" method="post">
Username: <input name="username" type="text" />
Password: <input name="password" type="password" />
<input value="Login" type="submit" />
</form>
'''
@route('/login', method='POST')
def do_login():
username = request.forms.get('username')
password = request.forms.get('password')
if check_login(username, password):
return "<p>Your login information was correct.</p>"
else:
return "<p>Login failed.</p>"
②上传文件
<form action="/upload" method="post" enctype="multipart/form-data">
Category: <input type="text" name="category" />
Select a file: <input type="file" name="upload" />
<input type="submit" value="Start upload" />
</form>
@route('/upload', method='POST')
def do_upload():
category = request.forms.get('category')
upload = request.files.get('upload')
name, ext = os.path.splitext(upload.filename)
if ext not in ('.png','.jpg','.jpeg'):
return 'File extension not allowed.'
save_path = get_save_path_for_category(category)
upload.save(save_path) # appends upload.filename automatically
return 'OK'
七、服务
对于Bottle框架其本身未实现类似于Tornado自己基于socket实现Web服务,所以必须依赖WSGI,默认Bottle已经实现并且支持的WSGI有:
server_names = {
'cgi': CGIServer,
'flup': FlupFCGIServer,
'wsgiref': WSGIRefServer,
'waitress': WaitressServer,
'cherrypy': CherryPyServer,
'paste': PasteServer,
'fapws3': FapwsServer,
'tornado': TornadoServer,
'gae': AppEngineServer,
'twisted': TwistedServer,
'diesel': DieselServer,
'meinheld': MeinheldServer,
'gunicorn': GunicornServer,
'eventlet': EventletServer,
'gevent': GeventServer,
'geventSocketIO':GeventSocketIOServer,
'rocket': RocketServer,
'bjoern' : BjoernServer,
'auto': AutoServer,
}
使用时,只需在主app执行run方法时指定参数即可:
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from bottle import Bottle
root = Bottle()
@root.route('/hello/')
def index():
return "Hello World"
# 默认server ='wsgiref'
if __name__ == '__main__':
root.run(host='localhost', port=8080, server='wsgiref')
默认server=”wsgiref”,即:使用Python内置模块wsgiref,如果想要使用其他时,则需要首先安装相关类库,然后才能使用。如:
bottle.py源码
# 如果使用Tornado的服务,则需要首先安装tornado才能使用
class TornadoServer(ServerAdapter):
""" The super hyped asynchronous server by facebook. Untested. """
def run(self, handler): # pragma: no cover
# 导入Tornado相关模块
import tornado.wsgi, tornado.httpserver, tornado.ioloop
container = tornado.wsgi.WSGIContainer(handler)
server = tornado.httpserver.HTTPServer(container)
server.listen(port=self.port,address=self.host)
tornado.ioloop.IOLoop.instance().start()
备注:以上WSGI中提供了19种,如果想要使期支持其他服务,则需要扩展Bottle源码来自定义一个ServerAdapter
更多参见:http://www.bottlepy.org/docs/dev/index.html
文章最后发布于: 2018-08-23 11:38:08