Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paulocheque/django-dynamic-fixture
A complete library to create dynamic model instances for testing purposes.
https://github.com/paulocheque/django-dynamic-fixture
database-testing django python testing-tools
Last synced: about 2 months ago
JSON representation
A complete library to create dynamic model instances for testing purposes.
- Host: GitHub
- URL: https://github.com/paulocheque/django-dynamic-fixture
- Owner: paulocheque
- License: other
- Created: 2012-04-04T22:54:41.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-07-30T14:32:49.000Z (about 2 months ago)
- Last Synced: 2024-07-30T18:23:07.849Z (about 2 months ago)
- Topics: database-testing, django, python, testing-tools
- Language: Python
- Homepage: http://django-dynamic-fixture.readthedocs.io/
- Size: 591 KB
- Stars: 389
- Watchers: 19
- Forks: 66
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
Django Dynamic Fixture
======================
[](http://django-dynamic-fixture.readthedocs.org/en/latest/index.html)
[](https://badge.fury.io/py/django-dynamic-fixture)
**Latest version: 4.0.1 (Sep 2023)**
Django Dynamic Fixture (DDF) is a complete and simple library to create dynamic model instances for testing purposes.
It lets you focus on your tests, instead of focusing on generating some dummy data which is boring and polutes the test source code.
* [Basic Examples](#basic-examples)
* [Cheat Sheet](#cheat-sheet)
* Full Documentation
Basic Examples
--------------
> Customize only the important details of the test:
```python
from ddf import G
from my_library import Author, Book
def test_search_book_by_author():
author1 = G(Author)
author2 = G(Author)
book1 = G(Book, authors=[author1])
book2 = G(Book, authors=[author2])
books = Book.objects.search_by_author(author1.name)
assert book1 in books
assert book2 not in books
```
> Using some goodies to keep the test code smaller:
```python
from ddf import G
def test_search_book_by_author():
author1, author2 = G('my_library.Author', n=2)
book1 = G('my_library.Book', authors=[author1])
book2 = G('my_library.Book', authors=[author2])
books = Book.objects.search_by_author(author1.name)
assert book1 in books
assert book2 not in books
```
> Configuring data from relationship fields:
```python
from ddf import G
def test_search_book_by_author():
book1 = G(Book, main_author__name='Eistein')
book2 = G(Book)
books = Book.objects.search_by_author(book1.main_author.name)
assert book1 in books
assert book2 not in books
assert book1.main_author.name == 'Eistein'
```
Cheat Sheet
--------------
```python
# Import the main DDF features
from ddf import N, G, F, M, C, P, teach # meaning: New, Get, ForeignKey, Mask, Copier, Print, teach
```
```python
# `N` creates an instance of model without saving it to DB
instance = N(Book)
```
```python
# `G` creates an instance of model and save it into the DB
instance = G(Book)
```
```python
# `F` customize relationship objects
instance = G(Book, author=F(name='Eistein'))
# Same as `F`
instance = G(Book, author__name='Eistein')
```
```python
# `M` receives a data mask and create a random string using it
# Known symbols: `_`, `#` or `-`
# To escape known symbols: `!`
instance = N(Book, address=M('Street ___, ### !- --'))
assert instance.address == 'Street TPA, 632 - BR'
```
```python
# `C` copies data from one field to another
instance = N(Book, address_formatted=C('address'), address=M('Street ___, ### \- --'))
assert instance.address_formatted == 'Street TPA, 632 - BR'
```
```python
# `teach` teaches DDF in how to build an instance
teach(Book, address=M('Street ___, ### !- --'))
instance = G(Book)
assert instance.address == 'Street TPA, 632 - BR'
```
```python
# `P` print instance values for debugging
P(instance)
```
```python
import ddf
ddf.__version__
```
```python
from ddf import ddf_check_models
succeeded, errors = ddf_check_models()
succeeded, errors = ddf_check_models(print_csv=True)
succeeded, errors = ddf_check_models(csv_filename='ddf_compatibility_report.csv')
```