Django Fixture Generator 技术文档

1. 安装指南

环境要求

• Django 1.2 或更高版本

安装步骤

1. 将 "fixture_generator" 添加到 Django 项目的 INSTALLED_APPS 设置中。

   INSTALLED_APPS = [
       ...
       "fixture_generator",
       ...
   ]
   

2. 在项目的某个应用中创建一个名为 fixture_gen.py 的文件。

2. 项目的使用说明

创建 Fixture 生成器

在 fixture_gen.py 文件中，定义一个或多个 Fixture 生成器函数。每个函数使用 @fixture_generator 装饰器进行装饰，并指定需要生成的模型。

示例：

from fixture_generator import fixture_generator
from django.contrib.auth.models import User, Group

@fixture_generator(User, requires=["my_app.test_groups"])
def test_users():
    muggles, wizards = Group.objects.order_by("name")
    simon = User.objects.create(username="simon")
    adrian = User.objects.create(username="adrian")
    jacob = User.objects.create(username="jacob")
    
    simon.groups.add(wizards)
    adrian.groups.add(muggles)
    jacob.groups.add(muggles)

@fixture_generator(Group)
def test_groups():
    Group.objects.create(name="Muggles")
    Group.objects.create(name="Wizards")

生成 Fixture

运行以下命令生成 Fixture：

python manage.py generate_fixture my_app.test_users

生成的 Fixture 可以保存到文件中，例如：

python manage.py generate_fixture my_app.test_users > initial_data.txt

3. 项目 API 使用文档

@fixture_generator 装饰器

• 参数:
  • models: 需要生成的 Django 模型类。
  • requires: 依赖的其他 Fixture 生成器函数名称，格式为 "app_name.fixture_function_name"。

generate_fixture 命令

• 命令: python manage.py generate_fixture <fixture_name>
• 参数:
  • fixture_name: 需要生成的 Fixture 函数名称，格式为 "app_name.fixture_function_name"。

4. 项目安装方式

通过 INSTALLED_APPS 安装

将 "fixture_generator" 添加到 Django 项目的 INSTALLED_APPS 设置中，即可完成安装。

创建 fixture_gen.py 文件

在项目的某个应用中创建 fixture_gen.py 文件，并在其中定义 Fixture 生成器函数。

运行命令生成 Fixture

使用 python manage.py generate_fixture <fixture_name> 命令生成 Fixture 数据。

---

通过以上步骤，您可以轻松地使用 django-fixture-generator 项目生成 Django 项目的 Fixture 数据。