from django.db import models
class Author(models.Model):
name = models.CharField(max_length=100)
def __unicode__(self):
return self.name
class Book(models.Model):
author = models.ForeignKey(Author)
title = models.CharField(max_length=100)
def __unicode__(self):
return self.title
__test__ = {'API_TESTS': """
>>> from django.newforms.models import formset_for_queryset, formset_for_model
>>> qs = Author.objects.all()
>>> AuthorFormSet = formset_for_model(Author, extra=3)
>>> formset = AuthorFormSet()
>>> for form in formset.forms:
... print form.as_p()
>>> data = {
... 'form-COUNT': '3',
... 'form-0-name': 'Charles Baudelaire',
... 'form-1-name': 'Arthur Rimbaud',
... 'form-2-name': '',
... }
>>> formset = AuthorFormSet(data=data)
>>> formset.is_valid()
True
>>> formset.save()
[, ]
>>> for author in Author.objects.order_by('name'):
... print author.name
Arthur Rimbaud
Charles Baudelaire
Gah! We forgot Paul Verlaine. Let's create a formset to edit the existing
authors with an extra form to add him. This time we'll use formset_for_queryset.
We *could* use formset_for_queryset to restrict the Author objects we edit,
but in that case we'll use it to display them in alphabetical order by name.
>>> qs = Author.objects.order_by('name')
>>> AuthorFormSet = formset_for_queryset(qs, extra=1, deletable=False)
>>> formset = AuthorFormSet()
>>> for form in formset.forms:
... print form.as_p()
>>> data = {
... 'form-COUNT': '3',
... 'form-0-id': '2',
... 'form-0-name': 'Arthur Rimbaud',
... 'form-1-id': '1',
... 'form-1-name': 'Charles Baudelaire',
... 'form-2-name': 'Paul Verlaine',
... }
>>> formset = AuthorFormSet(data=data)
>>> formset.is_valid()
True
>>> formset.save()
[, , ]
>>> for author in Author.objects.order_by('name'):
... print author.name
Arthur Rimbaud
Charles Baudelaire
Paul Verlaine
This probably shouldn't happen, but it will. If an add form was marked for
deltetion, make sure we don't save that form.
>>> qs = Author.objects.order_by('name')
>>> AuthorFormSet = formset_for_queryset(qs, extra=1, deletable=True)
>>> formset = AuthorFormSet()
>>> for form in formset.forms:
... print form.as_p()
>>> data = {
... 'form-COUNT': '4',
... 'form-0-id': '2',
... 'form-0-name': 'Arthur Rimbaud',
... 'form-1-id': '1',
... 'form-1-name': 'Charles Baudelaire',
... 'form-2-id': '3',
... 'form-2-name': 'Paul Verlaine',
... 'form-3-name': 'Walt Whitman',
... 'form-3-DELETE': 'on',
... }
>>> formset = AuthorFormSet(data=data)
>>> formset.is_valid()
True
>>> formset.save()
[, , ]
>>> for author in Author.objects.order_by('name'):
... print author.name
Arthur Rimbaud
Charles Baudelaire
Paul Verlaine
We can also create a formset that is tied to a parent model. This is how the
admin system's edit inline functionality works.
>>> from django.newforms.models import inline_formset
>>> AuthorBooksFormSet = inline_formset(Author, Book, deletable=False, extra=3)
>>> author = Author.objects.get(name='Charles Baudelaire')
>>> formset = AuthorBooksFormSet(author)
>>> for form in formset.forms:
... print form.as_p()
>>> data = {
... 'book_set-COUNT': '3',
... 'book_set-0-title': 'Les Fleurs du Mal',
... 'book_set-1-title': '',
... 'book_set-2-title': '',
... }
>>> formset = AuthorBooksFormSet(author, data=data)
>>> formset.is_valid()
True
>>> formset.save()
[]
>>> for book in author.book_set.all():
... print book.title
Les Fleurs du Mal
Now that we've added a book to Charles Baudelaire, let's try adding another
one. This time though, an edit form will be available for every existing
book.
>>> AuthorBooksFormSet = inline_formset(Author, Book, deletable=False, extra=2)
>>> author = Author.objects.get(name='Charles Baudelaire')
>>> formset = AuthorBooksFormSet(author)
>>> for form in formset.forms:
... print form.as_p()
>>> data = {
... 'book_set-COUNT': '3',
... 'book_set-0-id': '1',
... 'book_set-0-title': 'Les Fleurs du Mal',
... 'book_set-1-title': 'Le Spleen de Paris',
... 'book_set-2-title': '',
... }
>>> formset = AuthorBooksFormSet(author, data=data)
>>> formset.is_valid()
True
>>> formset.save()
[, ]
As you can see, 'Le Spleen de Paris' is now a book belonging to Charles Baudelaire.
>>> for book in author.book_set.order_by('title'):
... print book.title
Le Spleen de Paris
Les Fleurs du Mal
"""}