A data seeder for models for Django.
Project description
This app provides a simple way of seeding data for your data models into your development or test database. This can be achieved through the Admin site, via a management command, or by writing your own scripts that use a seeder object.
It is often necessary to be able to seed large datasets, especially in complex projects, where having pre-loaded data can save time in the development lifecycle. Additionally, by allowing simple data seeding, you can more effectively conduct load tests or test complex edge case scnearios.
Requirements
Django 2.2+
Python 3.6+
Installation
You can install data_seeder using pip
pip install django-data-seeder
Quick Start
Add data_seeder to your INSTALLED_APPS in settings.py
INSTALLED_APPS = [ ... 'data_seeder', ]
Seed data with the following command
python manage.py seeddata [options] app.models.Model [app.models.Model2, ...]
This will generate a single seed for each model provided.
Advanced Usage of the Management Command
In addition to generating single seeds for models, the seeddata can also create as many seeds as you want
python manage.py seeddata --seeds=N apps.model.Model
This will generate N seeds for apps.model.Model
Another option that you can use is to generate related models. This is used for foreign key references where we need to recursively generate seeds for models. The default behaviour for this is disabled, meaning that a randomly selected existing model will be used for the related model field. We override this by doing the following
python manage.py seeddata --generate-related apps.model.Model
One limitation to this behavior is that the data seeder will not generate a related model if the relation is the model itself. This would cause an infinite recursion.
For more information about the seeddata command, please look at the help page.
python manage.py help seeddata
Using the Django Admin Site
For convenience, you can also use the out-of-the-box Administrator site included with Django to generate your seeds.
To do this, you must register your models with the admin site using the custom ModelAdmin class provided. For example, in admin.py for your app
from django.contrib import admin
from .models import MyModel
from data_seeder.admin import DataGeneratorAdmin
admin.site.register(MyModel, DataGeneratorAdmin)
This will add a button to the model page in the admin site to generate data, which will provide you with the same options available in the management command.
You can also register your models using a decorator instead
from django.contrib import admin
from .models import MyModel
from data_seeder.admin import data_generator_register
@admin.register(MyModel)
@data_generator_register
class MyModelAdmin(admin.ModelAdmin):
pass
Contribute
You can find the latest development version on GitHub. Feel free to fork it, file bugs, or contribute.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_data_seeder-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1eae99da0b08cfcf8aee39f56b972bedb76796dc0fad076258733149d5a6128e |
|
MD5 | 6e07a8d44c8f5a3294da61120de1c37b |
|
BLAKE2b-256 | b034e5fc8a4c3be1bd25dc2dc1495ec8342b9cd62a111de1a1d6a91c56429ebf |