APIFlask 2.0 版本的 codename 是 Gongqing（年初我从五角场搬到了共青森林公园旁边。没错，1.0 版本是 Wujiaochang）。

回到正题，这次最主要的一个变动（breaking change）是把所有 input 装饰器的参数改成了关键字参数。

@app.post('/pets')
@app.input(PetQuery, location='query')
@app.input(PetIn)  # equals to app.input(PetIn, location='json')
def create_pet(query_data, json_data):
    pass

关键字参数的名字默认是 {location}_data，通过 arg_name 参数可以自定义。这个改动让我删掉了很多 hack Flask 的代码。推动这个功能在上游 webargs 实现，所以不用加代码在自己这里。再加上一些改动已经在 Flask 实现了，又删掉一些。非常轻松。理想情况是，文档越来越多，代码越来越少。

如果你感兴趣的话，下面是 2.0 版本的详细内容：

• Changelog
• 2.0 migration guide

1. 给 WTForms 添加 537 个句号

https://github.com/wtforms/wtforms/pull/620

WTForms 从添加 CSRF 保护功能作为分界，之前定义的验证错误消息都包含结尾的句号，之后的错误消息都漏掉了句号。这会导致错误消息不一致（想象同一个表单显示两个输入框的错误消息，一个有句号，一个没有句号）。这个 PR 补齐了源码、测试、本地化文本（POT 和部分 PO 文件）中错误消息的句号，包括 506 个英文句号和 31 个中文句号。

本地化文件在翻译时大都按照源文本决定是否添加句号，所以也存在错误消息不一致的问题。因为精力有限，在 32 个本地化文件里，我只更新了简体中文、繁体中文、日文、德文和俄文。大概还有二十几个本地化文件需要进行确认和更新，如果感兴趣的话，你可以考虑去做这件事。

2. 给 Flask 添加 96 个美元符号

https://github.com/pallets/flask/pull/2877

Flask 文档、和各类 README.md 文件里对于命令行命令的标识很混乱，有时没有命令提示符，有时用「>」，有时用「$」，有时用「#」。这个 PR 统一了所有命令行命令，统一添加美元符号作为提示符，仅在需要明确区分 Windows 命令的几处使用「>」。

3. 给 Flask 更换 13 个 URL

https://github.com/pallets/flask/pull/3427

Flask 去年陆续把文档迁移到了 palletsprojects.com 域名下， 访问旧的 pocoo.org 会进行跳转，这个 PR 更新了所有文档和源码里的旧 URL。

4. 给 PyCon China 和 FlaskCon 压缩 119 张图片

除此之外，勉强能沾上边的还有给 PyCon China 和 FlaskCon 的网站分别压缩了 105 和 14 张图片。因为缺乏规范，有些技术大会的网站图片在上传之前没有经过压缩和裁剪，这会让页面加载变得非常慢。这两个 PR（PyConChina #3，FlaskCon #7）分别让两个网站的图片总大小从 25M 和 4M 降低到 5M 和 967KB。

给文档修 typo 是很常见的开源贡献类型，这也是很多人一开始参与开源的方式。有人甚至会走火入魔最后变成专业的「开源 typo 修复专家」，不停的用英文语法检查工具去检查每一个流行的开源项目文档……相比之下，上面这一类 PR 要比修 typo 更简单（在智力上），有时也更有价值。

我发现相对于技术实现，我其实更关注 API 设计和用户体验，总想要尽可能的追求设计的一致和美观。这也导致我会在写作和编程时花费大量时间在命名、文件组织、措辞、章节安排、排版、文案和彩蛋这些事情上。这大概就是我编程水平进步缓慢、写作速度缓慢的原因。

P.S. 文中的数字都是估算，大概会有 1~5 左右的偏差。精确的数字是为了让措辞看起来更一致和美观瞎编的。