本文主要整理下几个Flask扩展:
0.Flask-Bootstrap:集成Twitter开发的一个开源框架Bootstrap。
1.Flask-Script:为Flask程序添加一个命令行解析器
2.Flask-Moment:本地化日期和时间
本篇基于前两篇博文,需要使用虚拟环境、使用pip安装flask等。
0.什么是扩展
Flask被设计为可扩展形式,故而没有提供一些重要的功能,例如数据库和用户认证,所以我们可以选择最适合的程序的包,或者按需求自行开发。
说白了扩展就是一些附加功能,独立完成某种功能。
1.Flask-Bootstrap
Bootstrap 是 Twitter 开发的一个开源框架,它提供的用户界面组件可用于创建整洁且具有吸引力的网页,而且这些网页还能兼容所有现代 Web 浏览器。
Bootstrap是客户端框架,因此不会直接涉及服务器。
服务器需要做的指示提供引用了 Bootstrap 层叠样式表(CSS)和 Javascript 文件的 HTML 响应,并在 HTML、CSS 和 JavaScript 代码中实例化所需组件。这些操作最理想的执行场所就是模板。
0.安装Flask-Bootstrap扩展
pip install flask-bootstrap
1.创建app.py文件
app.py文件中写入:
from flask import Flask,render_template
from flask.ext.bootstrap import Bootstrap
app = Flask(__name__)
bootstrap = Bootstrap(app)#注意这个地方
@app.route('/')
def index():
return render_template('index.html')
if __name__ == "__main__":
app.run(debug = True)
解释下:
0.from flask.ext.bootstrap import Bootstrap:专为 Flask 开发的扩展都暴露在 flask.ext 命名空间下,Flask-Bootstrap 输出了一个 Bootstrap 类。
1.bootstrap = Bootstrap(app):Flask 扩展一般都在创建程序实例时初始化,这行代码是 Flask-Bootstrap 的初始化方法。
2.创建templates文件夹并创建base.html
base.html中写入:
{% extends "bootstrap/base.html" %}
{% block title %}Flask{% endblock %}
{% block navbar %}
Toggle navigation
Flasky
• Home
{% endblock %}
{% block content %}
{% block page_content %}{% endblock %}
{% endblock %}
解释下:
0.{% extends "bootstrap/base.html" %}:base.html模板继承自bootstrap/base.html
1.其中title、navbar、content都是bootstrap/base.html中定义的块(还有script等)。navbar是显示导航栏。其中的代码比较多,作用是添加Flasky和Home两个链接,理解下即可。
2.page_content块是自己加的。
3.以后的html页面直接继承base.html就可以啦。
3.创建index.html
index.html中写入:
{% extends "base.html" %}
{% block title %}首页{% endblock %}
{% block page_content %}
这里是首页,Hello World!
{% endblock %}
解释下:
0.{% extends "base.html" %}:继承自base.html
1.page_content块就是上面的自己定义的块。
4.运行程序
显示如下:
运行结果.png
2.Flask-Script
Flask的开发Web服务器支持很多启动设置选项,但只能在脚本中作为参数传给app.run()函数。这种方式很不方便,传递设置选项的理想方式是使用命令行参数。
Flask-Scrip就是这么一个Flask扩展,为Flask程序添加一个命令行解析器。Flask-Script自带了一组常用选项,而且还支持自定义命令。
0.安装Flask-Script扩展
pip install flask-script
1.修改app.py文件
from flask import Flask,render_template
from flask.ext.bootstrap import Bootstrap
from flask.ext.script import Manager
app = Flask(__name__)
manager = Manager(app)#注意这个地方
@app.route('/')
def index():
return render_template('index.html')
if __name__ == "__main__":
manager.run()#注意这个地方
解释下:
0.from flask.ext.script import Manager:Flask-Script输出了一个名为Manager的类,同样也是***flask.ext.XXX***下。
1.manager.run()代替了app.run(),启动后就能解析命令行啦。
2.使用Flask-Script
0.运行app.py:python app.py
3.Flask-Moment
服务器需要统一时间单位,这和用户所在的地理位置无关,所以一般使用协调世界时间(Coordinated Universal Time,UTC)。用户不愿意看到UTC时间,他们更希望看到当地时间,而且采用当地惯用的格式。
要想在服务器上只使用UTC时间,一个优雅的解决方案是,把时间单位发送给Web浏览器。转换成当地时间,然后渲染。Web浏览器可以更好的完成这一任务,因为它能获取用户电脑中的时区和区域设置。
有一个使用JavaScript开发的优秀客户端开源代码,名为moment.js(http://momentjs.com/),它可以在浏览器中渲染日期和时间。
0.安装Flask-Moment扩展
pip install flask-moment
1.修改app.py文件
from flask import Flask,render_template
from flask.ext.bootstrap import Bootstrap
from flask.ext.script import Manager
from flask.ext.moment import Moment
from datetime import datetime
app = Flask(__name__)
manager = Manager(app)
bootstrap = Bootstrap(app)
moment = Moment(app)
@app.route('/')
def index():
return render_template('index.html',current_time=datetime.utcnow())
if __name__ == "__main__":
manager.run()
解释下:
0.from flask.ext.moment import Moment:导入一个Moment类
1.from datetime import datetime:导入一个datetime类,用于获取UTC时间
2.moment = Moment(app):向模板开放了moment类,可以在模板中使用
3.current_time=datetime.utcnow():获取当前UTC时间,作为参数传入index.html
2.修改base.html
base.html修改为:
{% extends "bootstrap/base.html" %}
{% block title %}Flask{% endblock %}
{% block navbar %}
Toggle navigation
Flasky
• Home
{% endblock %}
{% block content %}
{% block page_content %}{% endblock %}
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}
{% endblock %}
解释下:
0.除了moment.js,Flask-Moment还依赖jquery.js。但是Bootstrap中已经引入了jquery.js,故只需要引入moment.js
1.{{ moment.include_moment() }}:引入moment.js,请注意上方的{{ super() }}
3.修改index.html
index.html内容修改为如下:
{% extends "base.html" %}
{% block title %}首页{% endblock %}
{% block page_content %}
这里是首页,Hello World!
{{ moment(current_time).format('LLL') }}
{{ moment(current_time).fromNow(refresh=True) }}
{% endblock %}
解释下:
0.{{ moment(current_time).format('LLL') }}:根据客户端电脑中的时区和区域设置渲染日期和时间。参数决定了渲染的方式,'L'到'LLL'分别对应不同的复杂度。format()函数还可以接受自定义的格式说明符。
1.{{ moment(current_time).fromNow(refresh=True) }}:moment是app.py开放的类,current_time是app.py传递过来的参数,fromNow()渲染相对时间戳,参数refresh=True会随着时间的推移自动刷新显示时间。
4.一个完整的Demo
这个Demo,包含上方未介绍到的东西:
0.url_for()函数的使用
1.静态文件的引入:设置网页的小图标(如百度网页的那个小熊掌)
2.自定义404错误页面
0.创建文件夹,包含文件
文件夹结构如下:
--app
--app.py
--templates
--base.html
--index.html
--user.html
--404.html
--static
--favicon.png
--venv
1.app.py
from flask import Flask,render_template
from flask.ext.bootstrap import Bootstrap
from flask.ext.script import Manager
from flask.ext.moment import Moment
from datetime import datetime
app = Flask(__name__)
manager = Manager(app)
bootstrap = Bootstrap(app)
moment = Moment(app)
@app.route('/')
def index():
return render_template('index.html',current_time=datetime.utcnow())
@app.route('/user/')
def user(name):
return render_template('user.html',name=name)
@app.errorhandler(404)
def page_not_found(e):
return render_template('404.html'),404
if __name__ == "__main__":
manager.run()
2.base.html
{% extends "bootstrap/base.html" %}
{% block head %}
{{ super() }}
{% endblock %}
{% block title %}Flask{% endblock %}
{% block navbar %}
Toggle navigation
Flasky
• Home
{% endblock %}
{% block content %}
{% block page_content %}{% endblock %}
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}
{% endblock %}
3.index.html
{% extends "base.html" %}
{% block title %}首页{% endblock %}
{% block page_content %}
这里是首页,Hello World!
{{ moment(current_time).format('LLL') }}
{{ moment(current_time).fromNow(refresh=True) }}
{% endblock %}
4.user.html
{% extends "base.html" %}
{% block title %}User{% endblock %}
{% block page_content %}
{% if name %}
Hello {{ name }}
{% else %}
Hello Stranger
{% endif %}
{% endblock %}
5.404.html
{% extends "base.html" %}
{% block title %} 404 {% endblock %}
{% block page_content %}
404错误:页面没有找到
{% endblock %}
6.favicon.png