就在五个小时前，Flask终于发布了8年来的第一个主版本——1.0，这个版本带来了很多新的变化，让我们拥抱变化吧，请使用下面的命令来更新：

$ pip install -U flask

主要的变化

• 从0.11开始，Flask引入了命令行支持，建议使用flask run命令来取代app.run()方法。1.0版本支持将Flask_APP环境变量设为包名称。Flask会自动在app.py、wsgi.py寻找名称为app或application的程序实例，同时会在传入的模块或包中寻找名称为create_app()或make_app()的0参数的工厂函数。
• 新添加了一个FLASK_ENV环境变量来设置Flask运行的环境，默认为production。在开发时需要设为development，这会自动开启调试器和重载器（即调试模式），避免直接使用FLASK_DEBUG。
• 当安装了python-dotenv时，flask命令（比如flask run、flask shell等）会自动从项目根目录下的.flaskenv或.env文件中导入环境变量，这样可以避免每次都手动设置环境变量。前者用来存储公开的Flask相关的环境变量，比如FLASK_APP和FLASK_ENV等，后者用来存储包含敏感信息的环境变量，比如邮箱密码，API密钥等等，需要将文件名添加到.gitignore中。
• 开发服务器默认开启多线程支持。
• 日志系统被极大的简化，日志器总是命名为flask.app，它只会在没有日志处理器注册的情况下才添加处理器，而且不会移除已经存在的处理器。
• 测试客户端（test_client）支持使用json参数来传入JSON数据，你可以使用这个特性来测试Web API。返回的响应对象添加了get_json方法来获取JSON数据。
• 添加了一个 test_cli_runner() 方法，它可以用来触发使用Click注册的flask命令，我们可以使用它来测试自定义的flask命令。
• 添加了一个flask routes命令，用来输出程序所有注册的路由。
• 移除了旧的扩展导入代码flask.ext，还在使用旧的导入方式的扩展将无法使用。
• 带来了一个重写后的Flaskr教程，包含了大量重构和改进，其他部分的文档也包含大量更新。
• 和大多数项目一样，1.0版本不再支持Python2.6和3.3。

你可以访问Flask Changelog – Flask 1.0 documentation查看完整的Changelog，并了解每一个变化所对应的PR或Issue。

顺便说一句

正在写的Flask书将在五月初结束写作，不过距离上市还需要一小段时间（按照正常的出版流程，大概是40天~三个月区间内）。这本书的内容完全采用1.0版本的Flask，其他库也都使用最新版，包括Bootstrap等前端库。另外，专栏之前发布的文章相关的示例程序已经过时，请不要参考，可以阅读Flask文档中更新的Flaskr教程。如果不着急的话，可以等一等，新书会带来几个更完善的示例程序。

在Flask项目中，我们会用到很多配置（Config）。比如说设置秘钥，设置数据库地址，像下面这样：

...
app.config['SECRET_KEY'] = 'some strange words'

Flask的配置对象（config）是一个字典的子类（subclass），所以你可以把配置用键值对的方式存储进去。这是一个通用的处理接口，Flask内置的配置，扩展提供的配置，你自己的配置，都集中在一处。

为什么需要使用自己的配置？
假设你在做一个博客，有十个视图函数都定义了每页显示的文章数。当你写好以后，发现每页的文章太多，想把这个值改小一点，这时你要找到这十个视图函数，分别修改这个值，很蠢吧？使用配置你就使用一行控制所有的变量：

app.config['POST_PER_PAGE'] = 12

在十个视图函数里使用配置变量代替固定值：

post_per_page = app.config['POST_PER_PAGE']

其实不就是设置了一个变量嘛……

你有两种方式来设置配置：

1. 直接写出配置的值，像上面那样。
2. 对于不适合写在程序里的配置，比如密码等，需要把配置写入系统环境变量，然后使用os模块提供的方法获取：

set MAIL_USERNAME=me@greyli.com  # windows
export MAIL_USERNAME=me@greyli.com  # *unix

获取变量并写入：

import os

from flask import Flask

app = Flask(__name__)
app.config['MAIL_USERNAME'] = os.environ.get('MAIL_USERNAME')

如果你使用虚拟环境，设置环境变量时注意要激活虚拟环境，同时不要给变量值加引号。

set MAIL_USERNAME=me@greyli.com  # 结果是'me@greyli.com'
set MAIL_USERNAME='me@greyli.com'  # 结果是"'me@greyli.com'"

你有三种方式来处理配置。

直接写入主脚本

当你的程序很小的时候，可以直接把配置写在主脚本里：

from flask import Flask

app = Flask(__name__)
app.config['SECRET_KEY'] = 'some secret words'
app.config['DEBUG'] = True
app.config['ITEMS_PER_PAGE'] = 10

使用字典的update方法可以简化代码：

from flask import Flask

app = Flask(__name__)
app.config.update(
    DEBUG=True,
    SECRET_KEY='some secret words',
    ITEMS_PER_PAGE=10
)

单独的配置文件

程序逐渐变大时，配置也逐渐增多，写在主脚本里太占地方，不够优雅（这时你应该已经把表单，路由，数据库模型等等分成独立的文件了。关于大型项目结构，后续会总结）。我们可以创建一个单独的配置文件。和上面同样的配置，现在可以改写为：

config.py

SECRET_KEY = 'some secret words'
DEBUG = True
ITEMS_PER_PAGE = 10

在创建程序实例后导入配置：

import config

...
app = Flask(__name__)
app.config.from_object(config)
...

创建不同的配置类

大型项目需要多个配置组合，比如开发时的配置，测试的配置，部署的配置……这样我们需要在配置文件里创建不同的配置类，然后在创建程序实例时引入相应的配置类。

最佳实践是创建一个存储通用配置的基类，然后为不同的使用使用场景创建新的继承基类的配置类：

config.py（这里为开发和测试创建了不同的数据库）

import os
basedir = os.path.abspath(os.path.dirname(__file__))


class Config:  # 基类
    SECRET_KEY = 'some secret words'
    ITEMS_PER_PAGE = 10


class DevelopmentConfig(Config):
    DEBUG = True
    SQLALCHEMY_DATABASE_URI = os.environ.get('DEV_DATABASE_URL') or \
        'sqlite:///' + os.path.join(basedir, 'data-dev.sqlite')


class TestingConfig(Config):
    TESTING = True
    SQLALCHEMY_DATABASE_URI = os.environ.get('TEST_DATABASE_URL') or \
        'sqlite:///' + os.path.join(basedir, 'data-test.sqlite')
    WTF_CSRF_ENABLED = False


config = {
    'development': DevelopmentConfig,
    'testing': TestingConfig,

    'default': DevelopmentConfig
}

通过from_object()方法导入配置：

from config import config  # 导入存储配置的字典

...
app = Flask(__name__)
app.config.from_object(config['development'])  # 获取相应的配置类
...

关于大型项目结构，扩展的初始化，使用程序工厂函数创建程序实例等内容见后续。

相关链接

• Flask的内置配置值：http://flask.pocoo.org/docs/0.11/config/#builtin-configuration-values
• Flask配置文档：http://flask.pocoo.org/docs/0.11/config/#configuration-handling
• 《Flask Web开发》中的配置文件：https://github.com/greyli/flasky/blob/master/config.py

– – – – –

更多关于Flask和Web开发的优质原创内容，欢迎关注Hello, Flask! – 知乎专栏。

这一次我用Flask实现了一个待办事项（To-Do List）应用。这篇文章主要介绍这个应用的大致实现过程和一些让交互更简洁的处理技巧。这个App用了这篇文章里提到的Materialize框架。

程序界面

Demo体验：http://task5.herokuapp.com/

简化模板

不论是从用户体验的角度，还是从减少工作量，提高加载速度等方面考虑，页面和跳转应该尽可能的少一些，尤其是这样的工具类应用。这可以通过优化模板实现，也可以通过JavaScript实现。

举两个例子。

一、编辑条目

我找到了另一个使用Flask实现的To-Do List应用，做个参照。在这个应用里，加上基模板，他一共用了4个页面。

Demo：http://flask-todoapp.herokuapp.com/

编辑一个条目的流程是这样的：

1. 点击编辑按钮，页面跳转到另一个模板
2. 渲染出表单，编辑内容
3. 提交后跳转回主页面。

当你点击新建或是编辑条目/分类时，会跳转到另一个页面：

跳转到新页面编辑条目

这其实只要一个页面就够了。

借助jQuery，我们可以这样实现：

1. 渲染主页面的条目时，为每一个条目附加一个编辑表单，使用CSS隐藏它（display: none）
2. 点击编辑按钮时，隐藏条目，显示表单（使用jQuery的hide和show函数）
3. 表单提交后跳转到原页面

编辑条目

这样一来，就只需要一个页面了。在续篇里，使用AJAX技术在后台传送数据，体验会更好。

二、删除条目

想象一下，你在豆瓣收藏了很多喜欢的条目，你想清理一下，在页面最底端你删除了一个条目，如果这时页面在删除后跳转，就回到页面顶端了，可你还想删除在底端的另一些条目。因为删除不用传递数据，我们可以用这个小技巧解决：

在页面上，点击删除按钮后，使用jQuery的slideUp()函数隐藏条目，在后台仍然指定相应的视图函数，但是这个函数不跳转到任何页面（只是在数据库里删除条目），只返回下面的204状态码（代表无内容）。

return (''), 204

这样删除条目的体验会更加流畅和自然。

数据库框架Flask-SQLAlchemy

因为程序很小，我这次仍然把配置选项放在单个文件里。这次使用了数据库框架Flask-SQLAlchemy，数据库使用SQLite。和其他扩展一样，安装后初始化并配置数据库：

from flask_sqlalchemy import SQLAlchemy

basedir = os.path.abspath(os.path.dirname(__file__))
app = Flask(__name__)
app.config['SECRET_KEY'] = 'a secret string'
app.config['SQLALCHEMY_DATABASE_URI'] = \
   'sqlite:///' + os.path.join(basedir, 'data.sqlite')
app.config['SQLALCHEMY_COMMIT_ON_TEARDOWN'] = True
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True

db = SQLAlchemy(app)

解释一下这里的配置选项：

• SQLALCHEMY_DATABASE_URI：这里要注意拼写，不要把URI写成URL。前一个是通用资源表示号（Universal Resource Identifier），后者是统一资源定位符（Uniform Resource Locator）。
  • 在《Flask Web开发》里，介绍数据库时用的是URL，导致很多人在后面的配置里也写成了URL。简单来说，URL是URI的子集。更详细的解释见：http://stackoverflow.com/questions/176264/what-is-the-difference-between-a-uri-a-url-and-a-urn
  • 注意在Linux主机部署时，数据库URI里是四根斜线。

• SQLALCHEMY_COMMIT_ON_TEARDOWN：按字面理解就是，在每次请求结束后自动提交数据库会话，也就是db.session.commit()。
  • 在2.0版本里，这个配置选项被认为有害，从文档里删掉了，在这个issue里讨论了这个问题。如果不想手动提交数据库会话，你可以继续使用它。
  • 但是有时候，你需要手动提交，比如在这个应用里，有一个创建新的分类的函数，创建后使用redirect函数跳转到这个新建的分类（需要分类的id作为参数），如果不提交数据库会话，就没法获得新建分类的id。

@app.route('/new-category', methods=['GET', 'POST'])
def new_category():
    name = request.form.get('name')
    category = Category(name=name)
    db.session.add(category)
    db.session.commit()  # commit后使下面的category.id获得实际值
return redirect(url_for('category', id=category.id))

• SQLALCHEMY_TRACK_MODIFICATIONS：启动项目后会出现一个警告，我不太清楚这个配置的作用（跟踪对象的修改？）。将它设为True可以抑制这个警告。

上述配置会在你程序根目录下生成一个data.sqlite文件。而最后实例SQLAlchemy类的db对象表示程序的数据库，你在视图函数里使用它（db）来操作数据库。

一对多关系

在这个应用里，用到了一对多关系（条目和分类）。这是条目和分类的模型（Model）：

class Item(db.Model):
    __tablename__ = 'items'
    id = db.Column(db.Integer, primary_key=True)
    body = db.Column(db.Text)
    category_id = db.Column(db.Integer, db.ForeignKey('categories.id'))  # step2


class Category(db.Model):
    __tablename__ = 'categories'
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64))
    items = db.relationship('Item', backref='category')  # step1

实现一个一对多关系需要两步（这里父模型指分类Category，子模型指条目Item）：

1. 在父模型里relationship函数定义一个引向子模型的对象（items）
2. 在子模型里定义一个外键（category_id），并添加一个到父模型的反向引用（backref）

在存储一个条目到数据库时，同时也要指定一个分类，这里的分类需要是一个对象（Object），而不是id：

body = request.form.get('item')  # 条目的内容
id = request.form.get('category')  # 分类的id
category = Category.query.get_or_404(id)  # 分类的对象
item = Item(body=body, category=category)
db.session.add(item)

这次还用到了另一个扩展——Flask-Script，用来增强命令行功能。暂时没有太深入的应用，有机会再作总结。

具体实现

程序比较简单，具体实现没太多需要介绍的。和之前不同的是，这次我使用jQuery对表单进行简单的验证。感兴趣的话，可以去体验一下demo，或是看看源码。为了方便体验（偷懒），没有添加用户系统，你可以随便玩，但条目和分类的数量做了一些限制。

目前功能比较简单，后续会加上拖拽排序，设置日期，设置优先级等功能（考虑加上像wunderlist那样的音效……）。

安装和下载见介绍页：https://helloflask.github.io/todo/

在续篇里，我会介绍使用jQuery（AJAX）把它改造成一个单页应用（SPA，Single-page application）。

相关链接

• Demo：http://task5.herokuapp.com/
• 介绍页：https://helloflask.github.io/todo/
• 源码：https://github.com/helloflask/todo
• http://docs.sqlalchemy.org/en/latest/orm/backref.html
• https://github.com/mitsuhiko/flask-sqlalchemy/issues/216
• http://flask-sqlalchemy.pocoo.org/2.1/models/#one-to-many-relationships

– – – – –

更多关于Flask和Web开发的优质原创内容，欢迎关注Hello, Flask! – 知乎专栏。