2008-07-19 07:54:34 +08:00
|
|
|
from forms import Form
|
2010-01-05 11:56:19 +08:00
|
|
|
from django.core.exceptions import ValidationError
|
2008-07-19 07:54:34 +08:00
|
|
|
from django.utils.encoding import StrAndUnicode
|
|
|
|
from django.utils.safestring import mark_safe
|
2008-08-26 06:55:24 +08:00
|
|
|
from django.utils.translation import ugettext as _
|
2008-07-19 07:54:34 +08:00
|
|
|
from fields import IntegerField, BooleanField
|
2008-07-22 11:24:09 +08:00
|
|
|
from widgets import Media, HiddenInput
|
2010-01-05 11:56:19 +08:00
|
|
|
from util import ErrorList
|
2008-07-19 07:54:34 +08:00
|
|
|
|
|
|
|
__all__ = ('BaseFormSet', 'all_valid')
|
|
|
|
|
|
|
|
# special field names
|
|
|
|
TOTAL_FORM_COUNT = 'TOTAL_FORMS'
|
|
|
|
INITIAL_FORM_COUNT = 'INITIAL_FORMS'
|
2010-02-01 22:14:56 +08:00
|
|
|
MAX_NUM_FORM_COUNT = 'MAX_NUM_FORMS'
|
2008-07-19 07:54:34 +08:00
|
|
|
ORDERING_FIELD_NAME = 'ORDER'
|
|
|
|
DELETION_FIELD_NAME = 'DELETE'
|
|
|
|
|
|
|
|
class ManagementForm(Form):
|
|
|
|
"""
|
|
|
|
``ManagementForm`` is used to keep track of how many form instances
|
|
|
|
are displayed on the page. If adding new forms via javascript, you should
|
|
|
|
increment the count field of this form as well.
|
|
|
|
"""
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
|
|
self.base_fields[TOTAL_FORM_COUNT] = IntegerField(widget=HiddenInput)
|
|
|
|
self.base_fields[INITIAL_FORM_COUNT] = IntegerField(widget=HiddenInput)
|
2010-03-28 07:03:56 +08:00
|
|
|
self.base_fields[MAX_NUM_FORM_COUNT] = IntegerField(required=False, widget=HiddenInput)
|
2008-07-19 07:54:34 +08:00
|
|
|
super(ManagementForm, self).__init__(*args, **kwargs)
|
|
|
|
|
|
|
|
class BaseFormSet(StrAndUnicode):
|
|
|
|
"""
|
|
|
|
A collection of instances of the same Form class.
|
|
|
|
"""
|
|
|
|
def __init__(self, data=None, files=None, auto_id='id_%s', prefix=None,
|
|
|
|
initial=None, error_class=ErrorList):
|
|
|
|
self.is_bound = data is not None or files is not None
|
2009-03-10 19:19:26 +08:00
|
|
|
self.prefix = prefix or self.get_default_prefix()
|
2008-07-19 07:54:34 +08:00
|
|
|
self.auto_id = auto_id
|
2010-11-22 01:27:01 +08:00
|
|
|
self.data = data or {}
|
|
|
|
self.files = files or {}
|
2008-07-19 07:54:34 +08:00
|
|
|
self.initial = initial
|
|
|
|
self.error_class = error_class
|
|
|
|
self._errors = None
|
|
|
|
self._non_form_errors = None
|
|
|
|
# construct the forms in the formset
|
|
|
|
self._construct_forms()
|
|
|
|
|
|
|
|
def __unicode__(self):
|
|
|
|
return self.as_table()
|
|
|
|
|
2010-12-19 21:41:43 +08:00
|
|
|
def __iter__(self):
|
|
|
|
"""Yields the forms in the order they should be rendered"""
|
|
|
|
return iter(self.forms)
|
|
|
|
|
|
|
|
def __getitem__(self, index):
|
|
|
|
"""Returns the form at the given index, based on the rendering order"""
|
|
|
|
return list(self)[index]
|
|
|
|
|
|
|
|
def __len__(self):
|
|
|
|
return len(self.forms)
|
|
|
|
|
2009-03-30 23:58:52 +08:00
|
|
|
def _management_form(self):
|
|
|
|
"""Returns the ManagementForm instance for this FormSet."""
|
2010-11-22 01:27:01 +08:00
|
|
|
if self.is_bound:
|
2009-03-30 23:58:52 +08:00
|
|
|
form = ManagementForm(self.data, auto_id=self.auto_id, prefix=self.prefix)
|
|
|
|
if not form.is_valid():
|
|
|
|
raise ValidationError('ManagementForm data is missing or has been tampered with')
|
|
|
|
else:
|
|
|
|
form = ManagementForm(auto_id=self.auto_id, prefix=self.prefix, initial={
|
|
|
|
TOTAL_FORM_COUNT: self.total_form_count(),
|
2010-02-01 22:14:56 +08:00
|
|
|
INITIAL_FORM_COUNT: self.initial_form_count(),
|
|
|
|
MAX_NUM_FORM_COUNT: self.max_num
|
2009-03-30 23:58:52 +08:00
|
|
|
})
|
|
|
|
return form
|
|
|
|
management_form = property(_management_form)
|
|
|
|
|
|
|
|
def total_form_count(self):
|
|
|
|
"""Returns the total number of forms in this FormSet."""
|
2010-11-22 01:27:01 +08:00
|
|
|
if self.is_bound:
|
2009-03-30 23:58:52 +08:00
|
|
|
return self.management_form.cleaned_data[TOTAL_FORM_COUNT]
|
|
|
|
else:
|
2010-03-28 07:03:56 +08:00
|
|
|
initial_forms = self.initial_form_count()
|
|
|
|
total_forms = initial_forms + self.extra
|
|
|
|
# Allow all existing related objects/inlines to be displayed,
|
|
|
|
# but don't allow extra beyond max_num.
|
|
|
|
if initial_forms > self.max_num >= 0:
|
|
|
|
total_forms = initial_forms
|
|
|
|
elif total_forms > self.max_num >= 0:
|
2009-03-30 23:58:52 +08:00
|
|
|
total_forms = self.max_num
|
|
|
|
return total_forms
|
|
|
|
|
|
|
|
def initial_form_count(self):
|
|
|
|
"""Returns the number of forms that are required in this FormSet."""
|
2010-11-22 01:27:01 +08:00
|
|
|
if self.is_bound:
|
2009-03-30 23:58:52 +08:00
|
|
|
return self.management_form.cleaned_data[INITIAL_FORM_COUNT]
|
|
|
|
else:
|
|
|
|
# Use the length of the inital data if it's there, 0 otherwise.
|
|
|
|
initial_forms = self.initial and len(self.initial) or 0
|
2010-03-28 07:03:56 +08:00
|
|
|
if initial_forms > self.max_num >= 0:
|
2009-03-30 23:58:52 +08:00
|
|
|
initial_forms = self.max_num
|
|
|
|
return initial_forms
|
|
|
|
|
2008-07-19 07:54:34 +08:00
|
|
|
def _construct_forms(self):
|
|
|
|
# instantiate all the forms and put them in self.forms
|
|
|
|
self.forms = []
|
2009-03-30 23:58:52 +08:00
|
|
|
for i in xrange(self.total_form_count()):
|
2008-07-19 07:54:34 +08:00
|
|
|
self.forms.append(self._construct_form(i))
|
2009-03-10 19:19:26 +08:00
|
|
|
|
2008-07-19 07:54:34 +08:00
|
|
|
def _construct_form(self, i, **kwargs):
|
|
|
|
"""
|
|
|
|
Instantiates and returns the i-th form instance in a formset.
|
|
|
|
"""
|
|
|
|
defaults = {'auto_id': self.auto_id, 'prefix': self.add_prefix(i)}
|
2010-11-22 01:27:01 +08:00
|
|
|
if self.is_bound:
|
2008-07-19 07:54:34 +08:00
|
|
|
defaults['data'] = self.data
|
|
|
|
defaults['files'] = self.files
|
|
|
|
if self.initial:
|
|
|
|
try:
|
|
|
|
defaults['initial'] = self.initial[i]
|
|
|
|
except IndexError:
|
|
|
|
pass
|
|
|
|
# Allow extra forms to be empty.
|
2009-03-30 23:58:52 +08:00
|
|
|
if i >= self.initial_form_count():
|
2008-07-19 07:54:34 +08:00
|
|
|
defaults['empty_permitted'] = True
|
|
|
|
defaults.update(kwargs)
|
|
|
|
form = self.form(**defaults)
|
|
|
|
self.add_fields(form, i)
|
|
|
|
return form
|
|
|
|
|
|
|
|
def _get_initial_forms(self):
|
2009-03-30 23:58:52 +08:00
|
|
|
"""Return a list of all the initial forms in this formset."""
|
|
|
|
return self.forms[:self.initial_form_count()]
|
2008-07-19 07:54:34 +08:00
|
|
|
initial_forms = property(_get_initial_forms)
|
|
|
|
|
|
|
|
def _get_extra_forms(self):
|
|
|
|
"""Return a list of all the extra forms in this formset."""
|
2009-03-30 23:58:52 +08:00
|
|
|
return self.forms[self.initial_form_count():]
|
2008-07-19 07:54:34 +08:00
|
|
|
extra_forms = property(_get_extra_forms)
|
|
|
|
|
2010-01-26 23:02:53 +08:00
|
|
|
def _get_empty_form(self, **kwargs):
|
|
|
|
defaults = {
|
|
|
|
'auto_id': self.auto_id,
|
|
|
|
'prefix': self.add_prefix('__prefix__'),
|
|
|
|
'empty_permitted': True,
|
|
|
|
}
|
2010-11-22 01:27:01 +08:00
|
|
|
if self.is_bound:
|
2010-01-26 23:02:53 +08:00
|
|
|
defaults['data'] = self.data
|
|
|
|
defaults['files'] = self.files
|
|
|
|
defaults.update(kwargs)
|
|
|
|
form = self.form(**defaults)
|
|
|
|
self.add_fields(form, None)
|
|
|
|
return form
|
|
|
|
empty_form = property(_get_empty_form)
|
|
|
|
|
2008-07-19 07:54:34 +08:00
|
|
|
# Maybe this should just go away?
|
|
|
|
def _get_cleaned_data(self):
|
|
|
|
"""
|
|
|
|
Returns a list of form.cleaned_data dicts for every form in self.forms.
|
|
|
|
"""
|
|
|
|
if not self.is_valid():
|
|
|
|
raise AttributeError("'%s' object has no attribute 'cleaned_data'" % self.__class__.__name__)
|
|
|
|
return [form.cleaned_data for form in self.forms]
|
|
|
|
cleaned_data = property(_get_cleaned_data)
|
|
|
|
|
|
|
|
def _get_deleted_forms(self):
|
|
|
|
"""
|
2009-03-10 19:19:26 +08:00
|
|
|
Returns a list of forms that have been marked for deletion. Raises an
|
2008-08-27 23:39:00 +08:00
|
|
|
AttributeError if deletion is not allowed.
|
2008-07-19 07:54:34 +08:00
|
|
|
"""
|
|
|
|
if not self.is_valid() or not self.can_delete:
|
|
|
|
raise AttributeError("'%s' object has no attribute 'deleted_forms'" % self.__class__.__name__)
|
|
|
|
# construct _deleted_form_indexes which is just a list of form indexes
|
|
|
|
# that have had their deletion widget set to True
|
|
|
|
if not hasattr(self, '_deleted_form_indexes'):
|
|
|
|
self._deleted_form_indexes = []
|
2009-03-30 23:58:52 +08:00
|
|
|
for i in range(0, self.total_form_count()):
|
2008-07-19 07:54:34 +08:00
|
|
|
form = self.forms[i]
|
|
|
|
# if this is an extra form and hasn't changed, don't consider it
|
2009-03-30 23:58:52 +08:00
|
|
|
if i >= self.initial_form_count() and not form.has_changed():
|
2008-07-19 07:54:34 +08:00
|
|
|
continue
|
2010-03-12 23:51:00 +08:00
|
|
|
if self._should_delete_form(form):
|
2008-07-19 07:54:34 +08:00
|
|
|
self._deleted_form_indexes.append(i)
|
|
|
|
return [self.forms[i] for i in self._deleted_form_indexes]
|
|
|
|
deleted_forms = property(_get_deleted_forms)
|
|
|
|
|
|
|
|
def _get_ordered_forms(self):
|
|
|
|
"""
|
|
|
|
Returns a list of form in the order specified by the incoming data.
|
2009-03-31 03:36:19 +08:00
|
|
|
Raises an AttributeError if ordering is not allowed.
|
2008-07-19 07:54:34 +08:00
|
|
|
"""
|
|
|
|
if not self.is_valid() or not self.can_order:
|
|
|
|
raise AttributeError("'%s' object has no attribute 'ordered_forms'" % self.__class__.__name__)
|
|
|
|
# Construct _ordering, which is a list of (form_index, order_field_value)
|
|
|
|
# tuples. After constructing this list, we'll sort it by order_field_value
|
|
|
|
# so we have a way to get to the form indexes in the order specified
|
|
|
|
# by the form data.
|
|
|
|
if not hasattr(self, '_ordering'):
|
|
|
|
self._ordering = []
|
2009-03-30 23:58:52 +08:00
|
|
|
for i in range(0, self.total_form_count()):
|
2008-07-19 07:54:34 +08:00
|
|
|
form = self.forms[i]
|
|
|
|
# if this is an extra form and hasn't changed, don't consider it
|
2009-03-30 23:58:52 +08:00
|
|
|
if i >= self.initial_form_count() and not form.has_changed():
|
2008-07-19 07:54:34 +08:00
|
|
|
continue
|
|
|
|
# don't add data marked for deletion to self.ordered_data
|
2010-03-12 23:51:00 +08:00
|
|
|
if self.can_delete and self._should_delete_form(form):
|
2008-07-19 07:54:34 +08:00
|
|
|
continue
|
|
|
|
self._ordering.append((i, form.cleaned_data[ORDERING_FIELD_NAME]))
|
|
|
|
# After we're done populating self._ordering, sort it.
|
2009-04-28 22:17:18 +08:00
|
|
|
# A sort function to order things numerically ascending, but
|
|
|
|
# None should be sorted below anything else. Allowing None as
|
|
|
|
# a comparison value makes it so we can leave ordering fields
|
2010-08-07 00:31:44 +08:00
|
|
|
# blank.
|
|
|
|
def compare_ordering_key(k):
|
|
|
|
if k[1] is None:
|
|
|
|
return (1, 0) # +infinity, larger than any number
|
|
|
|
return (0, k[1])
|
|
|
|
self._ordering.sort(key=compare_ordering_key)
|
2008-07-19 07:54:34 +08:00
|
|
|
# Return a list of form.cleaned_data dicts in the order spcified by
|
|
|
|
# the form data.
|
|
|
|
return [self.forms[i[0]] for i in self._ordering]
|
|
|
|
ordered_forms = property(_get_ordered_forms)
|
|
|
|
|
2009-03-10 19:19:26 +08:00
|
|
|
#@classmethod
|
|
|
|
def get_default_prefix(cls):
|
|
|
|
return 'form'
|
|
|
|
get_default_prefix = classmethod(get_default_prefix)
|
|
|
|
|
2008-07-19 07:54:34 +08:00
|
|
|
def non_form_errors(self):
|
|
|
|
"""
|
|
|
|
Returns an ErrorList of errors that aren't associated with a particular
|
|
|
|
form -- i.e., from formset.clean(). Returns an empty ErrorList if there
|
|
|
|
are none.
|
|
|
|
"""
|
|
|
|
if self._non_form_errors is not None:
|
|
|
|
return self._non_form_errors
|
|
|
|
return self.error_class()
|
|
|
|
|
|
|
|
def _get_errors(self):
|
|
|
|
"""
|
|
|
|
Returns a list of form.errors for every form in self.forms.
|
|
|
|
"""
|
|
|
|
if self._errors is None:
|
|
|
|
self.full_clean()
|
|
|
|
return self._errors
|
|
|
|
errors = property(_get_errors)
|
|
|
|
|
2010-03-12 23:51:00 +08:00
|
|
|
def _should_delete_form(self, form):
|
|
|
|
# The way we lookup the value of the deletion field here takes
|
|
|
|
# more code than we'd like, but the form's cleaned_data will
|
|
|
|
# not exist if the form is invalid.
|
|
|
|
field = form.fields[DELETION_FIELD_NAME]
|
|
|
|
raw_value = form._raw_value(DELETION_FIELD_NAME)
|
|
|
|
should_delete = field.clean(raw_value)
|
|
|
|
return should_delete
|
|
|
|
|
2008-07-19 07:54:34 +08:00
|
|
|
def is_valid(self):
|
|
|
|
"""
|
|
|
|
Returns True if form.errors is empty for every form in self.forms.
|
|
|
|
"""
|
|
|
|
if not self.is_bound:
|
|
|
|
return False
|
|
|
|
# We loop over every form.errors here rather than short circuiting on the
|
|
|
|
# first failure to make sure validation gets triggered for every form.
|
|
|
|
forms_valid = True
|
2009-03-31 03:36:19 +08:00
|
|
|
for i in range(0, self.total_form_count()):
|
|
|
|
form = self.forms[i]
|
|
|
|
if self.can_delete:
|
2010-03-12 23:51:00 +08:00
|
|
|
if self._should_delete_form(form):
|
2009-03-31 03:36:19 +08:00
|
|
|
# This form is going to be deleted so any of its errors
|
|
|
|
# should not cause the entire formset to be invalid.
|
|
|
|
continue
|
|
|
|
if bool(self.errors[i]):
|
2008-07-19 07:54:34 +08:00
|
|
|
forms_valid = False
|
|
|
|
return forms_valid and not bool(self.non_form_errors())
|
|
|
|
|
|
|
|
def full_clean(self):
|
|
|
|
"""
|
|
|
|
Cleans all of self.data and populates self._errors.
|
|
|
|
"""
|
|
|
|
self._errors = []
|
|
|
|
if not self.is_bound: # Stop further processing.
|
|
|
|
return
|
2009-03-30 23:58:52 +08:00
|
|
|
for i in range(0, self.total_form_count()):
|
2008-07-19 07:54:34 +08:00
|
|
|
form = self.forms[i]
|
|
|
|
self._errors.append(form.errors)
|
|
|
|
# Give self.clean() a chance to do cross-form validation.
|
|
|
|
try:
|
|
|
|
self.clean()
|
|
|
|
except ValidationError, e:
|
2010-02-24 04:55:42 +08:00
|
|
|
self._non_form_errors = self.error_class(e.messages)
|
2008-07-19 07:54:34 +08:00
|
|
|
|
|
|
|
def clean(self):
|
|
|
|
"""
|
|
|
|
Hook for doing any extra formset-wide cleaning after Form.clean() has
|
|
|
|
been called on every form. Any ValidationError raised by this method
|
|
|
|
will not be associated with a particular form; it will be accesible
|
|
|
|
via formset.non_form_errors()
|
|
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
|
|
def add_fields(self, form, index):
|
|
|
|
"""A hook for adding extra fields on to each form instance."""
|
|
|
|
if self.can_order:
|
|
|
|
# Only pre-fill the ordering field for initial forms.
|
2010-01-26 23:02:53 +08:00
|
|
|
if index is not None and index < self.initial_form_count():
|
2008-08-26 06:55:24 +08:00
|
|
|
form.fields[ORDERING_FIELD_NAME] = IntegerField(label=_(u'Order'), initial=index+1, required=False)
|
2008-07-19 07:54:34 +08:00
|
|
|
else:
|
2008-08-26 06:55:24 +08:00
|
|
|
form.fields[ORDERING_FIELD_NAME] = IntegerField(label=_(u'Order'), required=False)
|
2008-07-19 07:54:34 +08:00
|
|
|
if self.can_delete:
|
2008-08-26 06:55:24 +08:00
|
|
|
form.fields[DELETION_FIELD_NAME] = BooleanField(label=_(u'Delete'), required=False)
|
2008-07-19 07:54:34 +08:00
|
|
|
|
|
|
|
def add_prefix(self, index):
|
|
|
|
return '%s-%s' % (self.prefix, index)
|
|
|
|
|
|
|
|
def is_multipart(self):
|
|
|
|
"""
|
|
|
|
Returns True if the formset needs to be multipart-encrypted, i.e. it
|
|
|
|
has FileInput. Otherwise, False.
|
|
|
|
"""
|
2009-03-18 03:23:23 +08:00
|
|
|
return self.forms and self.forms[0].is_multipart()
|
2008-07-19 07:54:34 +08:00
|
|
|
|
|
|
|
def _get_media(self):
|
|
|
|
# All the forms on a FormSet are the same, so you only need to
|
|
|
|
# interrogate the first form for media.
|
|
|
|
if self.forms:
|
|
|
|
return self.forms[0].media
|
|
|
|
else:
|
|
|
|
return Media()
|
|
|
|
media = property(_get_media)
|
|
|
|
|
|
|
|
def as_table(self):
|
|
|
|
"Returns this formset rendered as HTML <tr>s -- excluding the <table></table>."
|
|
|
|
# XXX: there is no semantic division between forms here, there
|
|
|
|
# probably should be. It might make sense to render each form as a
|
|
|
|
# table row with each field as a td.
|
2010-12-19 21:41:43 +08:00
|
|
|
forms = u' '.join([form.as_table() for form in self])
|
2008-07-19 07:54:34 +08:00
|
|
|
return mark_safe(u'\n'.join([unicode(self.management_form), forms]))
|
|
|
|
|
2010-10-18 12:44:49 +08:00
|
|
|
def as_p(self):
|
|
|
|
"Returns this formset rendered as HTML <p>s."
|
2010-12-19 21:41:43 +08:00
|
|
|
forms = u' '.join([form.as_p() for form in self])
|
2010-10-18 12:44:49 +08:00
|
|
|
return mark_safe(u'\n'.join([unicode(self.management_form), forms]))
|
|
|
|
|
|
|
|
def as_ul(self):
|
|
|
|
"Returns this formset rendered as HTML <li>s."
|
2010-12-19 21:41:43 +08:00
|
|
|
forms = u' '.join([form.as_ul() for form in self])
|
2010-10-18 12:44:49 +08:00
|
|
|
return mark_safe(u'\n'.join([unicode(self.management_form), forms]))
|
|
|
|
|
2008-07-19 07:54:34 +08:00
|
|
|
def formset_factory(form, formset=BaseFormSet, extra=1, can_order=False,
|
2010-03-28 07:03:56 +08:00
|
|
|
can_delete=False, max_num=None):
|
2008-07-19 07:54:34 +08:00
|
|
|
"""Return a FormSet for the given form class."""
|
|
|
|
attrs = {'form': form, 'extra': extra,
|
|
|
|
'can_order': can_order, 'can_delete': can_delete,
|
2008-07-23 12:28:52 +08:00
|
|
|
'max_num': max_num}
|
2008-07-19 07:54:34 +08:00
|
|
|
return type(form.__name__ + 'FormSet', (formset,), attrs)
|
|
|
|
|
|
|
|
def all_valid(formsets):
|
|
|
|
"""Returns true if every formset in formsets is valid."""
|
|
|
|
valid = True
|
|
|
|
for formset in formsets:
|
|
|
|
if not formset.is_valid():
|
|
|
|
valid = False
|
|
|
|
return valid
|