/annotated-py-flask

flask 源码注释版本. flask 是一个非常赞的Python web framework.

Primary LanguagePythonMIT LicenseMIT

flask-annotated

flask 源码注释版本. flask 是一个非常赞的Python web framework.

源码版本挑选:

  • 0.1: 任何项目,第一个版本提交,都值得深入学习.
  • 0.4: 单文件的最后一个版本.代码1k+行.值得和 0.5 版本作对比.
  • 0.5: 第一次模块化重构,单文件拆分成多模块.学习项目模块组织架构.
  • 0.70.10.1, 跟最新版本, 差异并不大, 故不再注解.
  • 0.11.1: 最新版本, 以此为准注解, 代码质量很高.
  • 其他版本,可能会作为对比用,不会去详细注解

推荐阅读顺序:

  • v0.1 版本, 建议有时间读, 没时间可直接读 v0.4
  • v0.4 版本, 最后一个单文件版本, 值得阅读
  • v0.5 版本, 首个作模块拆分的版本, 对比 v0.4, 代码并未增长.
  • v0.11.1 版本, 当前最新版本, 对比 v0.5 阅读, 更佳.

flask 官方资源:

注解版本说明:

  • flask 0.1 ~ 0.4 版本, 整个框架代码,只有一个单文件.
  • flask 0.5 版本, 开始拆分成多文件结构.
  • 发布时间: 16 Apr 2010
  • 代码行数: 539 (含注释,不含空行)
  • 点评:
    • 代码非常精简.
    • 一个mini的web 框架模型.

flask 0.2, 0.3 不再注解.

  • 点评:
    • 比0.1版本新增了几个模块,优化了部分代码.
    • 代码少量更新.用IDE 作文件对比后, 可知代码更新很少,只是在重构代码.
    • 故 0.2, 0.3 版本的代码,不再注解,跳过.直接注解 0.4版本.
  • 发布时间: 18 Jun 2010
  • 代码行数: 1238 (含注释,不含空行)
  • 点评:
  • 发布时间: 6 Jul 2010
  • 代码行数: 1594 (含注释,不含空行)
  • 点评:
    • 第一次对代码结构作了模块化拆分.(之前的版本,都是单文件)
    • 对比 0.4 版本, 没多几行代码.(注意学习模块化拆分**)

flask 0.7

  • 发布时间: 28 Jun 2011
  • 代码行数: 2613
  • 点评:
    • 此版本功能模块已经非常丰富:
      • blueprint
      • logging
      • session
      • template
      • view
      • test
      • wrapper
    • 与其他框架比较:
      • django: 显然不用比,这无比臃肿的货
      • tornado: 比之,较少
      • bottle.py: 并不多(bottle也有3k~1w行)
    • 不再注解此版本, 只注解最新版本 v0.11.1

flask 0.10.1

  • 发布时间: 14 Jun 2013
  • 代码行数: 8484-4043(测试) = 4441
  • 点评:
    • 截至当前: 2016-01-27, 这依然是当前发布最新版本代码.(此版本2013年就发布了)
    • 可以看到,代码并没有想象中的多.flask官方是属于比较保守的发版本策略.
    • 对比 0.7 版本:
      • 模块结构并无重大调整
      • 基本上没有添加太多内容.(可能是模块重构,优化居多)
    • 不再注解此版本, 只注解最新版本 v0.11.1
  • 发布时间:
  • 点评:
    • 目前最新版本.
    • 跟 v0.10.1 差异并不大.
    • 故以此版本为准, 完善注解.