Django单元测试中Fixtures用法详解

Django Fixtures简介与背景

在进行单元测试时，若需验证数据库交互逻辑，通常需要预设测试数据。Django提供了Fixtures机制，用于便捷地生成和载入这些初始数据。

Django是一个采用Python语言开发的开源Web框架，遵循MVT（Model-View-Template）软件设计模式。该框架于2005年7月在BSD许可证下发布，旨在简化Web应用开发流程。

在对Django项目进行单元测试时，往往需要导入或生成特定的初始数据。对于已在正式数据库中拥有数据的App而言，利用Fixture载入数据是最高效且简便的方案。

下文将通过配置myapp.json文件及tests.py测试类的具体代码实例，对Fixtures的使用方法进行详细阐述。

Fixtures基础配置与目录结构

基础配置

首先需在项目的settings.py文件中进行相关配置，具体代码如下：

FIXTURE_DIRS = ('/path/to/api/fixtures/',)

随后，在待测试的App目录下创建名为fixtures的子目录。在该目录中新建一个后缀为.json的文件（例如myapp.json），文件名可根据实际需求自定义。

JSON数据格式配置详解

配置myapp.json

该JSON文件的内容格式应遵循特定规范。实际使用时，需移除示例中的占位数据，填入真实测试数据，并删除注释行。若需导入多条数据，可在JSON数组中添加多个对象{}。

[ {
 "model": "myapp.user", # 数据库名
 "pk": "a864340d850f484bb89ea2981047bc5e", # 要导入的数据
 "fields": { # 要导入的字段，字段名跟数据库（models）内的字段一样，值，根据实际需要设置
  "username": "zhangsan",
  "user_num": "000",
  "zh_name": "张三",
  "mobile": "18712345678",
  "mail": "zhangsan@abc.com",
  "is_deleted": false,
  "create_time": "2013-01-16",
  "update_time": "2013-01-16"
 }
 },
]

测试类中的Fixture调用方法

接下来配置tests.py文件，具体代码示例如下：

class Test_user_name(TestCase):
 '''测试人员名称是否正常'''
 fixtures = ['myapp.json']  # 在这里选择你要导入要测试的用户数据

 def test_user_name(self):
  user = User.objects.get(username='zhangsan')
  self.assertEqual(user.name, "zhangsan")

完成上述配置后，即可运行单元测试用例。

注意事项：

若在测试模型中配置了Signals（信号），在载入Fixture时，相关的信号处理代码也将随之执行。

Fixture载入机制与注意事项

Fixture载入机制

若测试数据库中缺乏数据，基于数据库的网站测试将失去意义。为简化测试数据的添加过程，Django提供了专门的Fixture载入功能。

Fixture本质上是一组预定义的数据集合，Django框架内置了将其导入数据库的机制。

创建Fixture最直接的方式是使用manage.py dumpdata命令。此方法的前提是正式数据库中已存在需要导出的数据。

重要提示：

若曾执行过manage.py syncdb命令，实际上已间接使用过Fixture。在通过syncdb创建数据库表时，Django会自动创建一个名为initial_data的初始Fixture。其他名称的Fixture则可通过manage.py loaddata命令手动安装。

一旦创建了Fixture并将其放置在Django App的fixtures目录中，便可在测试类中直接引用：

from django.test import TestCase
from myapp.models import Animal
class AnimalTestCase(TestCase):
  fixtures = ['mammals.json', 'birds']
  def setUp(self):
    # Test definitions as before.
    call_setup_methods()
  def testFluffyAnimals(self):
    # A test that uses the fixtures.
    call_some_test_code()

Fixture载入的具体执行过程如下：

1. 在setup()方法执行前，Django会先清空数据库，其效果等同于重新执行syncdb。

2. 随后，所有指定的Fixture将被安装。例如中，Django会安装名为mammals的JSON格式Fixture以及名为birds的Fixture。

总结

至此，关于Django单元测试中Fixtures用法的详解介绍完毕。如需了解更多Django Fixtures相关内容，建议查阅本站过往文章或继续浏览后续教程，感谢大家的支持！