写作
《Flask Web开发实战》花费了一年多的时间，在这期间，除了编写5个项目实例和写作外，我还花了一部分时间来和书中涉及的Python库（主要是Flask扩展）打交道。这篇文章总结了这本书的写作给整个Flask社区带来的一些改变。
国内第一本Flask书
虽然国内已经有几本书介绍过Flask，但都是顺便介绍，而不是真正意义上的Flask书。因此，这本书可以说是国内第一本Flask书，很高兴能为国内的Flask社区带来这样一本书。希望这本书能够推动更多人了解和使用Flask，进而为社区贡献更多的力量。
完善多个项目
在实际介绍和使用某个库时，总会遇到各种各样的问题，主要有两类：
-
Bug
-
不完善的用法或实现
Bug不用多说，肯定要处理。对于不完善的用法和实现，如果沿用原来的代码，一来不容易读者理解，二来还需要在书中加进很多不必要的内容。所以，我更倾向于让这些代码变得更好一点。
如果把不完善的实现写到书里，我会觉得非常不舒服。比如说，WTForms本身是支持设置内置的错误消息的语言的，我们可以设为中文，而不用手动写错误消息。但是在Flask-WTF中，因为内部重写了相关方法，导致没法在不使用Flask-Babel的情况下使用内置的翻译。问题来了：如果在第4章介绍Flask-Babel和i18n等相关概念的话，这显然需要占据大量篇幅，并不合适，而且这部分内容已经计划加入到第10章。
为此，书的安排没法改动，那么只好调整Flask-WTF的内部实现，所以就有了
这个PR。类似的情况还有很多，比如Firefox支持headless模式后，Selenium中却没有提供和Chrome相同的导入接口；Flask-OAuthlib中，传入access令牌只能使用元组或字典类型，而不能使用更直观的字符串变量传入……
下面是一些写作期间提交的开源贡献：
-
GitHub-Flask: Support API endpoint with a leading slash
-
Flask-OAuthlib: Add support for string type token
-
Selenium: Add import statement for FirefoxOptions
-
Authlib: add google_fetch_user function
-
Flask-SocketIO: Add missing json argument in send() function
-
Flask-OAuthlib： Add support for string type token
-
OAuthlib: Check access token in self.token dict
-
Flask-Moment: Add auto-detect locale support
-
Flask-Whooshee： Fix unicode decode error on Python2
-
Pipenv: Add tips for Supervisor user
-
Flask-WTF: Add support to change message language
当然，如果加上其他没有太大意义的文档更新，这个列表还可以更长。
值得特别说明的是Werkzeug的这个PR，这个PR对应的bug困扰了我很长一段时间。一开始我把问题归咎到python-dotenv身上，还创建了一个PR（
#101），但是维护者迟迟没有回复。后来再次研究，发现可以直接在Werkzeug内部解决，于是创建了
#1320，然后被lepture用更好的实现取代了（
#1321）。不过，在python-dotenv创建的那个PR倒是促成了Pipenv的这个PR（
#2386）。
推动发布新的版本
除了让PR被合并，还要让这些项目发布新的release，这样才能在项目源码公开后，让读者可以正常使用。在我的推动下，Flask-OAuthlib、Flask-Whooshee和Flask-Moment都发布了新的版本。
其他的项目，除了Werkzeug以外，大部分都在整个写作的时间跨度发布了新的版本。尤其重要的是Flask的1.0版本。从书一开始写作，我就直接采用了主分支的代码，书中我直接将版本号写为0.13。如果Flask迟迟不发布新版本，那我会陷入一个很尴尬的境地：要么大胆采用主分支代码，但是可能会出现变动，导致书中的内容不可靠；要么采用旧版本，那书出版后可能会很快面临过时的危险。还好，在写作接近尾声的4月末，新版本1.0发布了。
4个Flask扩展
用于集成Bootstrap的扩展Flask-Bootstrap目前的维护状态很糟糕：上一次release是17年1月，上一次合并commit是17年3月，而且已经很长时间不再处理PR和Issue。
原项目还存在很多问题：Jinja语法不标准、内置基模板引入不必要的复杂度、分页宏不支持传入URL片段值。除此之外，让我决定写新的扩展替代它的最主要原因是因为它不支持Bootstrap 4，而我不能接受在书中引入一个这样过时的项目。
为了解决这些问题，只好写了
Bootstrap-Flask。最终决定写替代扩展的时候，书已经完成了三分之二，大量旧的内容和源码都要改写。把书稿和源码从Flask-Bootstrap和Bootstrap3迁移到Bootstrap-Flask和Bootstrap4是一个非常痛苦的过程，到现在还记忆犹新……
对于某些空白的领域，我写了三个扩展来简化集成操作：
-
Flask-Avatars：头像处理
-
Flask-Dropzone：集成Dropzone.js，提供文件上传的客户端处理
-
Flask-CKEditor：集成富文本编辑器CKEditor
5个Flask开源项目
在此之前，完善的Flask开源项目屈指可数，除了Flask官方提供的两个示例程序外，就只有Miguel Grinberg的两个程序。而这本书带来了5个相对比较完善、所有依赖都基于最新版本的开源项目（严格来说，第1个程序比较简单，可以排除在外）：
扫一扫
2万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
