以参加捕蛇者说播客录制 Ep 30 为契机，创建了一个 Flask 用户调查问卷，用来收集 Flask 用户的反馈和建议。尽管这个问卷是由我个人而不是 Flask 官方（Pallets）发起（不过 Flask 官方也在计划着做一个调查问卷），但是我会把收集到的信息反馈到 Flask 开发团队进行讨论。因此，你的建议的确有可能让 Flask 变得更好。
不管你对于 Flask 是有明确的变动建议，还是只是对某个功能不甚满意，都可以把你的想法写下来。谢谢！
问卷地址：https://jinshuju.net/f/UY6Rd8
同时借这个问卷送出四本《Flask Web 开发实战》，填写问卷即可参与。每份问卷会有一个提交序号，中奖序号为 27、36、41、58。预计抽奖会在 7 月 22 号完成，届时抽奖结果会更新到这篇文章。
7 月 21 日更新，抽奖结果已产生：
我在连续三年 PyCon China 的三个演讲里，试图以重复三遍的方式来澄清非常普遍的对于 Flask 的 logo 是什么的误解。成效怎么样暂且不说，但是最近发现我其实是在用一个新的误解来替换前一个误解……我一直以为 Flask 的 logo 是用动物角制成用来装火药粉末的容器，即 powder horn，但它其实是用来装饮品的容器，即 drinking horn（或许可以翻译成「牛角杯」？）。录制捕蛇者说播客 Ep 30 第一次聊到了这件事，这里再写一篇文章来广而告之，作为对自己传播错误知识的救赎 :P。
这是 Flask 的 logo：
因为它的形状，很多人以为 Flask 的 logo 是辣椒：
但从外观上看，它显然更像是 powder horn（而且 powder horn 也叫做 powder flask，再加上它们都像 Flask logo 一样有盖子）：
尽管看起来很像 powder horn，但是考虑到它的名字和 WSGI（经常被读作 whiskey，威士忌）的隐含关联（类似 Bottle 框架，都是用来装 WSGI 的容器），再加上它标语里的「one drop at a time」，所以它其实是 drinking horn：
这一次不会再错了，因为我已经跟 Armin Ronachor（Flask 作者）确认过了：
Armin Ronachor: it was supposed to be a drinking horn.
顺便说一下，Flask 及其相关依赖所属的 Pallets 组织的 logo 是一种木质运载托盘（wiki），在欧洲被用来运送货物，这里的双关语是「用 pallet 来 ship software」：
相关链接：
六月初，应 laike9m 邀请做客捕蛇者说录了一期播客。今天中午发布了上半部分：Ep 30. 和李辉聊聊 Flask 2.0，关于自由职业的下半部分正在剪辑中，预计八月初发布。
这是我第一次录播客。录制那一天，房间里还没有装空调，而开风扇会导致风声录进去，我只能用静静降温法；为了防止录进邻居打骂孩子的声音，我又把门窗闭紧，所以录到临近中午，感觉越来越热。一开始还有点紧张和兴奋，但是我从来没有和别人聊过两小时那么久，录到后面，我就像漏气的气球一样，慢慢瘪了下去。
七月初拿到剪好的第一期，觉得可以再优化一下，所以就自告奋勇再剪一遍。花了接近十个小时，剪掉了很多「呃」、「嗯」、「对」、「然后」、「所以」……在这个过程里也发现不少自己说话上的毛病。
这一期上半部分聊了我从学习 Flask 到成为维护者的经历，这些在 19 年的 COSCUP 演讲简单介绍过。下半部分关于自由职业本来有不少内容想聊，但是因为说太多话有点累，所以有一些漏掉的话题就没有再提出来。录完的这些天有时会突然想到一些很有趣但忘记说的事情，偶尔还会想要不要再约着录一个补丁，也计划着写文章作补充。另外这一期虽然聊到了 FastAPI，但我对它了解并不多，如果有机会的话，以后还想再录一期详细聊聊 FastAPI 和 APIFlask，或是再聊一聊技术写作、翻译和演讲。
最后，如果你用过 Flask，欢迎来填写这个 Flask 用户调查问卷。关于捕蛇者说播客的更多信息，可以访问它的主页和 Twitter 了解。
下期：和捕蛇者说聊聊自由职业
GOTC（The Global Opensource Technology Conference，全球开源技术峰会）是由开源中国（OSCHINA）和 Linux 软件基金会（The Linux Foundation）联合主办的开源技术大会。上海站（上海世博中心 SECC）在 7 月 9 日 ~ 7 月 10 日举办；深圳站（深圳会展中心）在 7 月 31 日 ~ 8 月 1 日举办。大会邀请到很多非常厉害的开发者，比如 Linus Torvalds。两个会场均免费开放，仅需报名即可。欢迎参加！
我的演讲主题是《基于 Python 的 OpenAPI 实践》，介绍如下：
OpenAPI（原 Swagger）是一个流行的 REST API 描述规范，围绕它有许多非常实用的 Web API 开发工具。而 Python 是一门流行的编程语言，使用它可以非常高效地开发 Web API。这个议题将会以 OpenAPI 的入门介绍开始，探索如何在流行的 Python Web 框架中实现 OpenAPI 支持，并在最后介绍一些现有的解决方案和工具。
这个演讲基本上是正在写的《Python Web API 设计与开发》第八章的内容概括 + 开发 APIFlask 的一些想法 + 周边项目（FastAPI、Connexion 等）研究总结。暂定大纲为：
我的演讲在深圳站第一天分会场「编程语言艺术」专题论坛。如果你感兴趣的话，欢迎来听；如果对演讲内容有任何建议，欢迎提出。
今天在捕蛇者说录制了第一个播客，聊得很开心，虽然有时不知道自己在说什么……一开始还有点紧张，感觉像是在进行一场面试，而且一次来了四个面试官（大概是因为我已经很久没有这样跟别人聊过天了）。这次节目也让我偶尔想象做一个自己的播客，它大概会叫做「真实人类计划」，专门随机采访各种陌生人（尤其是活得不开心的那些人）。经过这一阵疲惫之后，刚好一年过半，是时候来一个中场休息了。
漫天的杨絮一飘完，天气就开始热了起来。西边的房间到下午就会被午后的太阳晒成桑拿房，所以我又搬回了冬天会被冻得头疼的东边的房间。院子外的蔷薇花开得非常鲜艳（不过下图里花已经快要谢了），我帮忙授粉的猕猴桃也结了非常多的果子，另外我还有幸参与了（一点点）今年的出蒜、种花生和种山芋活动。
这半年来，家里的饮水机、洗衣机、楼下的莲蓬头和电视、厨房的灯泡都接连坏掉。因为爸不在家，所以我只好买了新的饮水机，但是洗衣机还是扔在一边，只能用来脱水。前段时间终于得知爸要回来了，我就去打印了一个欢迎横幅（「热烈欢迎李**同志回家！」），在院子里提前一周挂上，邻居们还以为我要结婚了。
虽然家人希望我有一个稳定的工作，但我如果可以一年写一本书，那就可以生活的很好不用找工作（基于暂时不结婚没孩子不买房和车的前提）。糟糕的是，我已经在一本书上耗了两年了，我想我可以给自己起一个新的笔名——「拖稿李天王」。两年里，大多数时间都偏离了写作这个主线，把精力过多的分散在了能够获得短期回馈的事情上，比如外包项目、演讲和开源。
我决定明天休息一天 ，然后开始专注写作。接下来的目标是：十月前完成《Python Web API 设计与开发》初稿，十月底交稿。
Meta：
这是我第一次参加 PyCon US，也是第一次做英文演讲。也许会有一些语法和发音的问题，不过因为时间有限，我已经尽力了……这次开始准备的比较晚，演讲基本是在三天内完成的，演讲前一天花了一整天时间准备，从早上一直到第二天两点。总耗时 18 小时 41 分钟。相比之下，同样是五分钟的闪电演讲，在 PyCon China 2019 上海场的闪电演讲《Python 虚拟环境和依赖管理工具大乱斗》却花费了接近 40 个小时（大部分时间都用来做幻灯片了）。
这个演讲本来是一个比较深入的主题演讲，不过因为主题演讲申请惨遭淘汰，只好换成闪电演讲。演讲灵感来自前段时间的那篇《请不要把 Flask 和 FastAPI 放到一起比较》。
尽管是预录制演讲，但是不知道主办方哪里没弄好，实际大会直播的时候音画不同步，卡顿很严重（见官方发布的演讲视频）。
我在上周开始策划 Flask 文档翻译的事，制定了大致的翻译流程，创建了翻译协调仓库和翻译模板仓库。中文翻译作为这个流程的试水项目，在上周末正式（静悄悄）启动。
启动中文翻译项目的第一步是把 logo 里的标语「web development, one drop at a time」翻译成中文，这让我想起来一个也许冷也许不冷的冷知识。很多人知道 Flask 的名字是对 Bottle 的双关语——另一个容器/另一个 Python Web 框架。那为什么 Python Web 框架爱用容器做名字？其实是因为这些 Python Web 框架都是基于 WSGI 规范实现的，而 WSGI 不知从哪天起流行被读作 Whiskey（威士忌），所以这两个 Python Web 框架才叫做 Bottle 和 Flask，所以才有「Web 开发，一次一滴」。
欢迎在这些 discussions 中分别投票选出最佳翻译词汇、中文 logo 字体和中文标语。
回到正题。如果你对 Flask 足够熟悉，并且擅长翻译，欢迎参与进来！翻译通过 GitHub 进行协作（greyli/flask-docs-zh）。除了翻译文档，我们也需要有丰富翻译经验的朋友来审阅提交的翻译，欢迎在 GitHub 上关注（点 Watch 按钮）这个项目以接收新增翻译提醒。
下面是参与翻译之前要了解的三件事：
.po 文件并勾选完成的章节条目。先认领，再翻译，一次只认领一章。如果有其他问题和相关想法，请创建 discussion 发起讨论；如果对翻译流程和项目设置有改进建议，或是发现了翻译错误和笔误，请创建 issue 反馈。
这个项目在后期会转移到 FlaskCWG 组织，并在翻译完成后链接到 Flask 官方文档。
Flask 以及 Flask 依赖的 5 个 Pallets 项目都在今天发布了新的主版本（下面的链接指向各个项目的主版本变动日志）：
你可以使用下面的命令更新 Flask：
pip install -U flask
如果你使用的国内 PyPI 镜像还没有同步最新版本，可以通过下面的命令临时切换到官方 PyPI 源：
pip install -U flask -i https://pypi.org/simple/
这篇文章会介绍一些 Flask 新增的特性，完整的变动可以参考上面各个项目的变动日志。
嵌套蓝本（#3923）
对于一个比较大的项目，一般会使用蓝本来组织不同的模块。而如果你的项目非常大，那么嵌套蓝本就可以派上用场了。借助嵌套蓝本支持，你可以在某个蓝本之上再创建多个子蓝本，对项目进行多层模块化组织（而且支持无限嵌套，你可以嵌套很多层）：
parent = Blueprint("parent", __name__) # 创建父蓝本
child = Blueprint("child", __name__) # 创建子蓝本
parent.register_blueprint(child, url_prefix="/child") # 把子蓝本注册到父蓝本上
app.register_blueprint(parent, url_prefix="/parent") # 把父蓝本注册到程序实例上
这样在生成子蓝本的 URL 时需要传入完整的端点链：
url_for('parent.child.create')
/parent/child/create
这个特性来源于一个 2012 年创建的 feature request issue。
基本的 async/await 支持（#3412）
Flask 2.0 带来了基本的异步支持，现在你可以定义异步视图（以及异步错误处理函数、异步请求钩子函数）：
import asyncio
from flask import Flask
app = Flask(__name__)
@app.route('/')
async def say_hello():
await asyncio.sleep(1)
return {'message': 'Hello!'}
注意要先安装额外依赖：
pip install -U flask[async]
顺便说一句，如果你在 Windows 上使用 Python 3.8，那么会有一个来自 Python 或 asgiref 的 bug 导致出错：ValueError: set_wakeup_fd only works in main thread。可以通过下面两种方式（任选一种）处理（具体参考这个 SO 回答）：
# top of the file
import sys, asyncio
if sys.platform == "win32" and (3, 8, 0) <= sys.version_info < (3, 9, 0)::
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
不过目前只是一个基于 asgiref 的异步实现，作为异步支持的第一步，后续还会进行更多的优化和改进，更多相关信息可以参考文档。
快捷路由装饰器（#3907）
新增了下面的快捷路由装饰器：
app.post()app.delete()app.put()app.post() 等同于 app.route(methods=['POST'])
from flask import Flask
app = Flask(__name__)
@app.post('/')
def index():
return {'message': 'Hello!'}
methods 参数。如果需要在单个视图处理多个方法的请求，使用 app.route()
我在某次 pallets 会议上提议添加这些装饰器时一开始是被拒绝的，后来 Phil Jones 创建了 #3907 经过二次讨论后才最终合并（被拒绝后我就把当时正在开发的 APIFlask 从扩展改成了继承 Flask 基类的框架，然后加了这些装饰器）。
修复执行 flask run 找不到程序的奇怪设定（#3560）
这个像 bug 又像是 feature 的设定我在《一个困扰我两年的 Flask「Bug」》里详细说过，最终终于在两年后修复了。
支持在 .flaskenv 和 .env 文件里写中文（#3932）
我在《Flask Web 开发实战》第一章介绍 .flaskenv 文件时给了一个示例，演示如何添加注释：
SOME_VAR=1 # 这是注释
但这个示例没有实际测试……加了中文其实会报错，后来有两次收到读者反馈，最终终于在三年后修复了。
为文档添加命令切换面板（#3714）
这个或许算不上特性，不过在我看来是对用户非常友好的变动。除了个别不需要区分操作系统和命令行程序的命令外，我给文档里所有的命令添加了支持切换 Bash/CMD/Powershell 以及 macOS/Linux/Windows 的切换面板（面板的样式后续会有一些优化）：
Config.from_file() 方法支持从任意文件加载器导入配置（比如 toml.load、json.load），未来会取代 Config.from_json() 方法。FLASK_APP 指定工厂函数时支持传入关键字参数。flask shell 支持 tab 和历史补全（需要安装 readline）。主要的破坏性变动（breaking change）是意外的把 send_from_directory() 函数的第二个参数名称直接由 filename 重命名为 path，将会在 2.0.1 加回来（#4019）。
另外 send_file() 函数的三个参数也进行了重命名（旧名称将在 2.1.0 移除）：
attachment_filename -> download_namecache_timeout -> max_ageadd_etags -> etag git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a
这次更新对于整个 Pallets 项目来说是一个新的里程碑。接下来还有许多事情要做：FlaskCon 2021 正在准备中，新建立的 Flask 社区工作小组（Flask Community Work Group）正在进行 Flask 文档翻译（如果你对中文翻译感兴趣，可以订阅这个讨论）、被遗弃扩展收容计划（这是我一直想做的事情）等等。感谢支持，敬请期待！
欢迎通过下列途径关注 Pallets 项目：
相关文章：
The war has begun.Let’s end the war between Flask and FastAPI.
去年在知乎上看到一篇文章，后来想找却找不到了，最后通过关键词「5 分钟」和「四年」在掘金上找到了原文——《用它5分钟以后，我放弃用了四年的 Flask》。作者先是给出了一个手动用 if 验证请求数据的 Flask 视图函数：
@app.route('/insert', methods=['POST'])
def insert():
info = request.json
name = info.get('name', '')
if not name:
return {'success': False, 'msg': 'name 参数不可省略，不可为空！'}
age = info.get('age', 0)
if not isinstance(age, int):
return {'success': False, 'msg': 'age参数不是数字！'}
age_after_10_years = age + 10
msg = f'此人名叫：{name}，10年后，此人年龄：{age_after_10_years}'
return {'success': True, 'msg': msg} 然后给出了一个使用 Pydantic 编写数据模型类 + FastAPI 路径操作函数的代码：
class People(BaseModel):
name: str
age: int
address: str
salary: float
@app.post('/insert')
def insert(people: People):
age_after_10_years = people.age + 10
msg = f'此人名字叫做：{people.name}，十年后此人年龄：{age_after_10_years}'
return {'success': True, 'msg': msg} 通过这两段代码进行对比，文章作者得出结论「我用了 Flask 四年，但在使用了5分钟 FastApi 以后，我决定以后不再使用 Flask 了」。你确定你用了四年的是 Flask 而不是 Flash？在此后的很长一段时间里，经常看到类似的对比和结论，所以我打算用这篇文章来澄清这个非常普遍的误解。如果看到有人把 Flask 和 FastAPI 放到一起比较，请把这篇文章的链接丢过去。
利益相关：笔者系 Flask 维护者和 APIFlask 作者。本文观点仅代表个人看法，与 Pallets 团队无关。
我在此前介绍 APIFlask 的文章里一开始就提到过这件事情：
经常看到有人把 FastAPI 和 Flask 放到一起比较，但是却没有意识到这完全是两种东西——前者是基于 Web 框架 Starlette 添加了 Web API 功能支持的（框架之上的）框架，而后者是和 Starlette 同类的通用 Web 框架。你怎么能让小明和骑电动车的小军赛跑然后还夸小军好快好强？
前两天看了 Reddit 上 Flask 2.0rc 帖子下的很多回复，预感到在 Flask 2.0 发布后在中文网络上也许会出现许多类似的问题和讨论，所以想着还是值得单独写一篇文章来谈这件事。
受那个 Reddit 主题里某个评论启发，想到一个更好的比喻： Flask 和 FastAPI 就像是苹果和橙汁。你不能把苹果和添加了更多蔗糖和添加剂的橙汁放在一起比较哪一个更甜。苹果（Flask）应该和橙子（Starlette）比较，橙汁（FastAPI）当然也应该和苹果汁（基于 Flask 的 Web API 框架）进行比较。也就是说，Flask 是一个通用型框架，和 FastAPI 依赖的 Starlette 一样，而 FastAPI 是添加 Web API 支持的二次框架。因此，Flask 应该和 FastAPI 所依赖的 Starlette 进行比较，而 FastAPI 应该和基于 Flask 的 Web API 框架进行比较。
同理，FastAPI 也不能和 Django、Tornado、web2py、Bottle、CherryPy、Pyramid、Sanic 等通用型 Web 框架比较。
既然「FastAPI 应该和基于 Flask 的 Web API 框架比较」，那么合适的比较对象有哪些？Flask-RESTX、Flask-Rebar、flask-apispec、flask-smorest、Flask-RESTful、APIFairy 这些虽然试图做成框架，但在具体实现上仍然是 Flask 扩展，所以真正公平合理的比较对象是：
这三个框架都是基于 Flask 实现的 Web API 框架。不过 Eve 没有内置 OpenAPI 支持，而 Connexion 是一个 Spec-First 框架，也就是 OpenAPI spec 优先（先编写 spec，然后生成项目基础代码进行开发）的框架。因此，尽管 APIFlask 只是一个刚发布没多久的实验项目，但它是最适合和 FastAPI 进行比较的项目。
FastAPI 和 APIFlask 有着同样的组成结构，都是作为一层胶水粘起来一个 Web 框架和一个数据序列化/验证库，然后加一点 Web API 功能支持：
在主要功能上也有很多交集：
当然，相对于发布已经三年的 FastAPI，APIFlask 还只是一个三个月大的新项目，还有很多地方需要改进和完善。如果你对 APIFlask 感兴趣的话，可以在这篇文章了解详细介绍或是在它的 GitHub 仓库查看源码。
为什么会有那么多人把 FastAPI 和 Flask 放到一起比较？在我看来有三个原因：
首先是 FastAPI 采用了和 Flask 类似的装饰器路由，很容易让人联想到 Flask。
二是 FastAPI 没有给它的项目构成做足够的说明。如果 FastAPI 在其介绍的第一句就加上「based on Starlette and Pydantic」而不是放到 Requirements 部分才提及，这样也许会让 Starlette 和 Pydantic 获得更多应有的关注，也就不会有这么多人拿 Flask 和它比较。
再就是 FastAPI 的推介者对 FastAPI 了解的不够多。不清楚它的项目结构，自然就不了解它和其他 Web 框架的区别。而介绍时为了带来足够的吸引力，推介者常常选择拉上和用户量足够大的「竞品」进行对比这种方式，所以才会有大量类似本文开头提到的那种文章。这些文章甚至完全没有提及 Starlette 和 Pydantic，只是一味强调「这是一个超高性能的、碾压 Flask 的框架」。
FastAPI 只是说它能把「功能开发速度提升约 200% 至 300%」，距离十倍还差了一些，自然不能算是银弹。但是这两年看到了很多对 FastAPI 的盲目吹捧，仿佛 FastAPI 就是完美的解决方案。这也许都要归功于 FastAPI 在其 README 和文档里「大胆」的措辞和承诺以及不厌其烦的特性介绍。举例来说，如果它只是说「Very high performance, it is comparable to some frameworks in Go and NodeJS」，那么用户也许就会认为「和 Go/NodeJS 有一拼」，但是说成「Very high performance, on par with NodeJS and Go」，那么用户就会想「和 Go/NodeJS 不相上下」（以至于中文翻译是「可与 NodeJS 和 Go 比肩的极高性能」），这当然会带来一些争议。再比如，如果只是说「double or triple the development speed」，那么用户大概会想「效率还不错」，但是它用了「Increase the speed to develop features by about 200% to 300%」，数学不好的用户就会惊呼「哇，提高 30 倍开发效率」。同时这种营销带来的狂热用户，也很容易被煽动去给 Python Steering Council 施加压力——在 Python 3.10 快要发布的时候突然跳出来要求撤销一个 PEP。
这种营销至上的项目运营方式带来的直接后果是糟糕的维护状态。FastAPI 似乎在慢慢变成一个翻译项目，在代码里的文档字符串都还没写的情况下，其用户文档就已经开始扩展到十几种语言。而这十几种语言的翻译和项目源码都放在同一个仓库里，这导致所有开启的近 300 个 PR 里有过半是翻译。issue tracker 和 discussion 不做区分的使用，这导致所有开启的近 600 个 issue 里有九成是提问）。我在此前创建过一个 issue 来反馈这个问题，但并没有得到回应。另外凭个人喜好来说，在每个 commit 信息里都加上 emoji 并不可爱。而每一个 commit 都要触发 bot 更新 changelog，带来的是一份丑陋的 commit 历史（所有 commit 里有三分之一是在更新 changelog）。这些也许是发展社区或是让项目看起来很活跃的有效方法，但很显然这带来的是建立在混乱之上的虚假繁荣。
另外，许多推介文章都会在最后贴出来一张 benchmark 截图来证明 FastAPI 有多么 fast，但是完全不会提及的是：贴出来的 benchmark 对于开发生产应用来说有多大的意义？这里的 benchmark 背后有没有任何的 hacky？异步是否等同于高性能还是要看情况？框架本身的性能在一个请求处理流程中占多大的影响？asyncio 的生态怎么样？
从长远看这些大都是一些临时问题，而且 FastAPI 作者已经开始全职开发开源项目，这些问题在未来应该都会慢慢得到改善。指出这些是希望更多的人可以客观看待 FastAPI，吹捧并不能让一个东西变得更好，参与开发、介绍用法和回答社区提问是比盲目吹捧更有意义的事情。我当然期待 FastAPI 能够越来越好，也期待看到有更多优秀的 Python 框架出现，但我不喜欢过度炒作、盲目的吹捧和错误的对比。
顺便说一句，Flask、Werkzeug、Jinja 等 Pallets 项目都将在 5 月 11 日（PyCon 开始）之前发布下一个主版本，主要包含下面这些新特性（完整变动见 changelog）：
你可以使用下面的命令安装 Flask 2.0.0rc 版本进行测试：
$ pip install --pre flask 欢迎反馈 bug 和提改进建议。关于 2.0 版本的详细介绍将会在发布后另外撰文说明。
2021 年已经过去四个月了，每次到某个重要的时间节点都想完成这篇 2020 年总结，结果总是有各种事情挤占时间，所以错过了元旦、错过了大年初一、错过了 26 岁生日、错过了植树节和愚人节，最后来到这一天。
照例，先从好坏两方面总结一下。
Good：
Bad：
很高兴我的书和项目在这一年帮到了更多的人：
而且我的读者群已经扩展到小学五年级了（继上一次某位正在上初中的读者邀请我评审他用 Flask 做的博客程序后）。如果还有三年级或是一年级的读者小朋友，记得吱一声 :P
2020 年只写了 23 篇文章，花了比较多时间写的是下面这几篇：
相比之下，文章数量要比 2019 年少 40 篇，也许是因为这一年花了更多时间来挣钱（虽然最后没剩下多少）。年初做了一个糟糕的外包项目，烂摊子接手，慢慢明白转手的原因，最后以没有拿到尾款结束。这之后就更谨慎了，半年时间里只做了一个微信小程序的后端 API。
除此之外，第一次通过写文章挣到了钱——给 Twilio 博客写文章的稿费。第一篇文章是做一个协作白板，因为 SocketIO 有一个类似的示例程序，所以做程序加上写文章只花了 17 小时 34 分钟。但是第二篇文章就没那么幸运了，这一篇做一个演讲程序，因为 Twilio 文档写的不是很详细，所以卡在程序实现上很久，断断续续花了两个月，最终耗时 50 小时 24 分钟，时薪骤降。
今年的收入大部分都用作房租和生活开支了。买了一个很大的显示器（43 寸），不过并没有让写书进度加快……买了 Switch，玩了一段时间《喷射战士 2》（Splatoon 2，拒绝官方译名），偶尔还会换回一代玩，喜欢第一代 Carbon Roller Deco 和 Rainmaker 鱼头的无敌效果。
去年在年总结里说要重新开始记录时间花销，说到做到，2020 年记录在案的时间一共 8769 小时 48 分钟（99.8% 覆盖率）：
P.S. 上面的分类是时间大类，其中娱乐包括游戏（491 小时 4 分钟）、电影电视剧（283 小时 39 分钟）和上网（269 小时 22 分钟）；休息时间大多是不同事项之间的切换和走神时间；工作包括外包开发（332 小时 49 分钟）和开源项目（136 小时 47 分钟）；写作包括写书（158 小时 50 分钟）和写文章（129 小时 58 分钟）；学习包括学编程（101 小时 16 分钟）和学英语（81 小时 52 分钟）。
下面是包含所有时间分类的年度柱状图（紫色系是睡觉和吃饭，黄色系是外包和演讲，绿色系是开源项目和写作，蓝色系是清洁活动，红色系是娱乐）：
这也很好的解释了为什么这一年没有太多成果：玩了太多游戏，在各种网站上转来转去，写书的时间甚至没超过写文章多少。
2021 年开始没有再记录详细的时间开支——完整记录时间太花费精力了。比起每天的详细时间花销数据，我更关心的其实是有没有达到设定的时间目标，所以现在改为只记录两类时间：一类是想要达到的时间目标，比如写作、编程和学习；另一类是需要限制的时间花销，比如娱乐（计划 2021 年娱乐花销控制在 500 小时以内，目前是 123 小时 44 分钟）。
年底和女友一起离开了南京，接下来整个 2021 年都会呆在家里，目标是完成下面三件事：
经常看到有人把 FastAPI 和 Flask 放到一起比较，但是却没有意识到这完全是两种东西——前者是基于 Web 框架 Starlette 添加了 Web API 功能支持的（框架之上的）框架，而后者是和 Starlette 同类的通用 Web 框架。你怎么能让小明和骑电动车的小军赛跑然后还夸小军好快好强？为了让框架 PK 爱好者们有一个更公平的比较对象，从一份 0.6.2 版本的 fork 开始，我实现了一个基于 Flask 的 Web API 框架——：
APIFlask 在 Flask 的基础上添加了更多 Web API 相关的功能支持，核心特性包括：
@app.input()、@app.output()、@app.get()、@app.post() 等等下面是一个最基础的示例程序：
from apiflask import APIFlask, Schema, abort
from apiflask.fields import Integer, String
from apiflask.validators import Length, OneOf
app = APIFlask(__name__) # 可以使用 title 和 version 参数来自定义 API 的名称和版本
pets = [
{
'id': 0,
'name': 'Kitty',
'category': 'cat'
},
{
'id': 1,
'name': 'Coco',
'category': 'dog'
}
]
# 定义一个请求数据模式类
class PetInSchema(Schema):
name = String(required=True, validate=Length(0, 10)) # 可以使用 description 参数添加字段描述
category = String(required=True, validate=OneOf(['dog', 'cat']))
# 定义一个响应数据模式类
class PetOutSchema(Schema):
id = Integer()
name = String()
category = String()
@app.get('/pets/<int:pet_id>')
@app.output(PetOutSchema) # 使用 @output 装饰器标记响应数据模式
def get_pet(pet_id):
if pet_id > len(pets) - 1:
abort(404)
# 在真实程序里，你可以直接返回 ORM 模型类的实例，比如
# return Pet.query.get(1)
return pets[pet_id]
@app.patch('/pets/<int:pet_id>')
@app.input(PetInSchema(partial=True)) # 使用 @input 装饰器标记请求数据模式
@app.output(PetOutSchema)
def update_pet(pet_id, json_data): # 通过验证后的请求数据字典会注入到视图函数，默认参数名为 json_data
if pet_id > len(pets) - 1:
abort(404)
for attr, value in json_data.items():
pets[pet_id][attr] = value
return pets[pet_id]
P.S. 你也可以使用类视图（class-based views），具体示例见这里。
如果你想在你的电脑上运行这个示例，可以先用下面的命令安装 APIFlask（需要 Python 3.7 及以上版本，Flask 1.1 及以上版本）：
Linux 和 macOS:
$ pip3 install apiflask
Windows:
> pip install apiflask
安装完成后把上面的代码保存到文件 app.py，然后执行下面的命令运行程序：
$ flask run
现在你可以在浏览器访问 http://localhost:5000/docs 查看基于 Swagger UI 自动生成的交互式 API 文档：
或者访问 http://localhost:5000/redoc 查看基于 Redoc 生成的 API 文档：
访问 http://localhost:5000/openapi.json 可以获取自动生成的 OpenAPI spec 文件。
这个示例程序的完整版本可以在 https://github.com/greyli/apiflask/tree/master/examples 看到。如果你想了解更多用法，可以阅读文档中的一章（目前只有英文）。
APIFlask 类（from apiflask import APIFlask）。APIBlueprint 类（from apiflask import APIBlueprint）。apiflask.abort() 函数返回 JSON 格式的错误响应。以下面的 Flask 程序为例：
from flask import Flask, request, escape
app = Flask(__name__)
@app.route('/')
def hello():
name = request.args.get('name', 'Human')
return f'Hello, {escape(name)}'
迁移到 APIFlask 只需要改动两行代码：
from apiflask import APIFlask # 第一行
from flask import request, escape
app = APIFlask(__name__) # 第二行
@app.route('/')
def hello():
name = request.args.get('name', 'Human')
return f'Hello, {escape(name)}'
欢迎提出改进建议，报告 bug 或是分享其他任何相关的想法。你也可以在
「（Hour of Code）」是由非盈利组织 发起的公益活动，会在每年十二月初举办（）。简单来说，类似「地球一小时」活动，「编程一小时」活动就是在中小学引导学生们学习编程一小时。使用的材料大都是一些图形化的（比如），在游戏里使用类似 Scratch 的拖拽式编程逻辑块来操纵游戏中的人物做各种事情。
中国的「编程一小时」活动主要由微软和苹果这些大公司发起和主办。月初的时候，微软 MVP 项目组开始召集 MVP 做活动的讲师。南京有好几个学校需要讲师，但是我已经不在南京了，所以就想着在当地（徐州某县级市某镇某村）的中小学组织一次。在网上找了一些往年的活动记录，发现也有，想着应该没什么问题。
先是给高中的老师发了消息，没回；然后去村里的小学找校长，爬了三层楼没找到校长室，找到校长的电话打过去，校长说电脑坏了；发消息给初中的老师，老师说他们学校没有电脑；去了乡里的小学，门卫大叔说校长刚走；趁还没放学，我又赶到邻村的小学，老师告诉我要有教育局的通知才行。
第二天，我花了五十分钟车程到达教育局，但是没到五分钟就出来了——没成想连教育局的门都进不去。教育局门卫室的保安问我找谁，我说：「我是……我来……」。保安又问：「你到底要找谁？要去哪个科室？」。我说：「我想来咨询一下关于进学校做免费编程培训的许可问题」。保安说：「没有这个科室，你想去哪个学校直接去找学校谈」。我说学校让我来找教育局，保安说来教育局没用得去找学校。在来回进行了几遍类似的对话后，保安有点生气，气冲冲地说「你这个人年纪轻轻怎么听不懂话呢！」。我也有点生气，但也只能气冲冲说句「好，谢谢！」。
既然到了市里，就想着再碰碰运气，所以紧接着我又去了市里最好的初中。这所初中的北门离公交站近，所以先去了北门。门卫师傅说校长室在南门，办事都走南门。因为校园不让进，所以我只能绕墙去南门（两门相距 530 米）。到了南门后，门卫师傅说校长不在，去开会了。我说那我找年级主任也行，师傅问我找哪一个年级主任……沟通（扯皮）半天后终于让我进了门卫室，让我等等看，说校长兴许一会儿来。一阵沉默。沉默之后我多介绍了一下自己，拿出来更多的宣传材料。门卫师傅指着玻璃桌面下的某个电话，让我打到校长室试一试，没人接。又是一段沉默。接着我又详细介绍了自己要做的事情。师傅提议让我去找副校长，副校长室在北门八号楼五楼，让我去北门。于是我绕墙回到北门，北门师傅问我找哪一位副校长？打过电话没有？预约了吗？我说南门师傅让我走北门找副校长，北门师傅说办事都走南门，没有预约校园不给外人进，让我走南门。如此重复几遍，直到师傅不耐烦了，我又绕墙回到南门。和南门师傅说着说着，师傅又指了桌面下某位副校长的手机让我打，打不通。继续沉默，沉默是今晚的南京市长江大桥。过了一会儿师傅又翻出另一本电话簿，找到校长的手机让我打，依然没人接。我看了看崭新的教学楼，告别门卫师傅，再绕墙走回北门，准备坐公交车离开这冰冷的城市。不幸的是，因为太晚了，回乡下的公交车已经没了，我只好斥巨资打车回家。
第三天一早我试着加上了副校长的微信，这是我离成功最近的一次。我们聊得很顺利，直到校长告诉我他们新教学楼刚建成，学校计算机教室还没装配……擦干眼泪，我又去了乡里的小学，上次去校长刚走，这次去校长刚好在门卫室。我听到了熟悉的答案：「这个活动挺好，不过校外的培训要有教育局的批准才能做，你得去教育局申请」。至此，耗时 7 小时 54 分的「编程一小时」活动策划正式宣告失败。
2021/11/24 Update：我去联系了去年约好今年合作的那位校长。校长三天后回复我说计算机教室还没有安装好，我说可以进行「不插电编程」，校长说下午再聊。