Flask Web 测试驱动开发最佳实践之 Flask 实例

image

前言

前一篇讲到了 TDD 测试驱动开发的相关概念和环境搭建,这篇就着手开始用TDD方式开发了。首先这篇需要编写用户相关的API接口,如用户注册、用户登录、用户验证等功能。

编写测试

这里使用 Python 自带的测试框架 unittest 来编写简单测试,后续会使用更好用的 pytest 框架来完成整个网站的测试。
首先,最基本的测试是 Flask 应用实例是否存在,新建一个 test_basic.py 文件,当前 v2ex 项目结构如下:

├── LICENSE
├── Pipfile
├── Pipfile.lock
├── README.md
└── tests
    ├── test_basic.py
    └── test_user.py

编写 test_user.py 代码如下:

import unittest
from flask import current_app
from server import create_app


class UserTestCase(unittest.TestCase):
    def setUp(self):
        self.app = create_app('testing')
        self.app_context = self.app.app_context()
        self.app_context.push()

    def tearDown(self):
        self.app_context.pop()

    def test_app_is_exist():
        """测试 Flask 实例是否存在"""
        self.assertFalse(current_app is None)


if __name__ == '__main__':
    unittest.main()

这里使用 unittest 编写了一个测试类,setUp() 和 tearDown() 允许执行每个测试用例前分别初始化和清理测试环境,setUp 可用于创建应用实例,然后测试完成后就通过 tearDown 函数清理.

很明显,这个测试肯定是失败的,因为很明显

from server import create_app 

这一行是什么东东啊,好像项目里没有存在啊,这就是 TDD 的一个概念了,先编写一个预料之中的失败,然后一步步的把失败那部分改进到测试成功为止。


TDD概念
TDD总体流程图

编写代码跑通测试


新建一个 server 包,用于保存 v2ex 的业务逻辑代码,下面是当前项目的结构:

v2ex
├── LICENSE
├── Pipfile
├── Pipfile.lock
├── README.md
├── server
│   └── __init__.py
└── tests
    ├── test_basic.py
    └── test_user.py

为了组织好模块,会将多个模块分为包。简单来说,包就是文件夹,但该文件夹下必须存在 __init__.py 文件, 然后可以在 __init__.py 文件中新增创建 Flask 实例的工厂函数,代码如下所示:

from flask import Flask
from config import config


def create_app(config_name: str):
    """ 工厂函数,用于延迟创建 Flask 实例,可用于创建多个实例.

    :param config_name: 配置名称,可根据开发环境、测试环境、生产环境区分
    :return: Flask 示例
    """
    app = Flask(__name__)
    app.config.from_object(config[config_name])
    config[config_name].init_app(app)

    return app

然后运行 tests 文件夹下的 test_basic.py 文件,

$ python3 tests/test_basic.py 

Ran 1 test in 0.007s

FAILED (errors=1)

Error
Traceback (most recent call last):
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/unittest/case.py", line 59, in testPartExecutor
    yield
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/unittest/case.py", line 611, in run
    self.setUp()
  File "/Users/guoweikuang/project/github/v2ex/tests/test_basic.py", line 14, in setUp
    self.app = create_app('testing')
  File "/Users/guoweikuang/project/github/v2ex/server/__init__.py", line 17, in create_app
    app.config.from_object(config[config_name])
NameError: name 'config' is not defined

这还不能成功,因为我们从最开始就说过,要使用最佳实践方式来一步步实现网站,因此实例化 Flask 需要单独存在一个配置模块(config.py),目的就是把配置和其它功能区分开。
而且 TDD 的思想就是每次编写最少量的代码取得一些进展,再运行测试,如此不断重复,直到测试成功为止,最后可能还要重构代码,测试能保证不破坏任何一个功能。

进一步完善

当前文件结构如下:

v2ex
├── LICENSE
├── Pipfile
├── Pipfile.lock
├── README.md
├── config.py
├── server
│   └── __init__.py
└── tests
    ├── test_basic.py
    └── test_user.py

前面一节已经知道测试失败原因,这一节就编写一个config.py 模块使单元测试通过:

class Config(object):
    """ 配置基类,所有其它配置类都要继承该类.
    """

    @staticmethod
    def init_app(app):
        pass


class DevelopmentConfig(Config):
    """ 开发环境配置 """
    DEBUG = True


class ProductionConfig(Config):
    """ 生产环境配置 """
    DEBUG = False


class TestingConfig(Config):
    """ 测试环境配置 """
    TESTING = True
    DEBUG = True


config = {
    'development': DevelopmentConfig,
    'product': ProductionConfig,
    'testing': TestingConfig,
    'default': DevelopmentConfig,
}

使用最少的代码使测试成功,然后运行 test_basic.py 看看测试是否通过

$ python tests/test_basic.py
.
----------------------------------------------------------------------
Ran 1 test in 0.001s

OK

总结

从上面步骤可以总结到,先写测试代码,然后设法使测试一步步通过的 TDD 开发方式是十分有用的,保证了开发的功能符合预期的想法。当功能越来越复杂的时候,你可能修改了一些东西,导致另外一个功能的不可用,而单元测试也能保证了原有功能被破坏后能被检测出来。这里的代码都可以到 v2ex
项目中查看,每一篇文章都对应着一个 tag, 想要查看每篇文章的修改可以切到对应标签上查看。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 156,907评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,546评论 1 289
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,705评论 0 238
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,624评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,940评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,371评论 1 210
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,672评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,396评论 0 195
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,069评论 1 238
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,350评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,876评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,243评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,847评论 3 231
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,004评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,755评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,378评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,266评论 2 259

推荐阅读更多精彩内容