django-autofixture 使用文档

本文档旨在帮助用户了解和使用 django-autofixture 项目，包括安装指南、使用说明、API 使用文档和项目安装方式。

1. 安装指南

项目要求

• 支持 Django 1.4 至 1.9 版本

安装方式

1. 将 autofixture 包复制到项目目录中。
2. 使用 pip 命令从 Python 包索引安装 django-autofixture：

   pip install django-autofixture
   

3. 如果没有 pip，可以使用 easy_install 命令安装：

   easy_install django-autofixture
   

4. 在 Django 设置文件中，将 'autofixture' 添加到 INSTALLED_APPS 设置中。

2. 项目使用说明

管理命令

loadtestdata 命令用于加载测试数据，其语法如下：

python manage.py loadtestdata [options] app.Model:# [app.Model:# ...]

示例：创建三个 Category 对象和二十个 Entry 对象

python manage.py loadtestdata blog.Category:3 blog.Entry:20

使用 autofixture 作为单元测试工具

创建 AutoFixture 实例，并调用 create 方法生成测试数据。

示例：创建十个 Entry 对象

from autofixture import AutoFixture
fixture = AutoFixture(Entry)
entries = fixture.create(10)

设置字段值

可以使用 field_values 属性为特定字段设置默认值。

示例：设置 Listing 模型中的 needed_players 字段为 5

from main.models import Listing
fixture = AutoFixture(Listing, field_values={'needed_players': 5})
entries = fixture.create(30)

生成相关模型

可以使用 generate_fk 和 generate_m2m 属性为外键和多对多关系生成相关模型。

示例：自动生成 Entry 模型的作者和分类

fixture = AutoFixture(Entry, generate_fk=['author'], generate_m2m={'categories': (1, 3)})
entries = fixture.create(10)

限制外键模型集合

可以使用 limit_choices_to 属性限制外键字段的模型集合。

示例：将 Entry 模型的 blog 字段限制为不属于 Yoko Ono 的博客

from autofixture import AutoFixture, generators
fixture = AutoFixture(Entry, field_values={
    'blog': generators.InstanceSelector(Blog, limit_choices_to={'name__ne': "Yoko Ono's blog"})
})

自定义 autofixture

可以通过子类化 AutoFixture 创建自定义 autofixture。

示例：为 MyModel 模型创建自定义 autofixture

from models import MyModel
from autofixture import generators, register, AutoFixture

class MyModelAutoFixture(AutoFixture):
    field_values = {
        'name': generators.StaticGenerator('this_is_my_static_name'),
    }

register(MyModel, MyModelAutoFixture)

3. 项目 API 使用文档

详细 API 文档请参考 GitHub 项目 wiki。

4. 项目安装方式

请参考第 1 节中的安装指南。