#26654: Better forms for django.contrib.postgres.fields
-------------------------+-------------------------------------------------
Reporter: | Owner:
primal100 |
Type: New | Status: new
feature |
Component: | Version: master
contrib.postgres | Keywords: postgres, array, hstore, json,
Severity: Normal | forms
Triage Stage: | Has patch: 1
Unreviewed |
Easy pickings: 0 | UI/UX: 0
-------------------------+-------------------------------------------------
I'm working on a pull request which provides the following features to
django.contrib.postgres:
django.contrib.postgres.fields.array.ArrayField:
1) Currently the Array Field uses a SimpleArrayField. New feature is to
accepts a form_size argument in which case a Split Array Field will be
used.
2) If the choices argument is given to an ArrayField, the choices would
now expect to be of the BaseField Type and a TypedMultipleChoiceField will
be used. The array value will be composed of the choices given in this
field.
django.contrib.postgres.forms.nested_form:
1) A NestedFormWidget and NestedFormField (subclassed from MultiWidget and
MultiValueField) which can be used to create a nested form. Unlike with
MultiWidget, each widget has a label and the widgets are presented in list
form. The form compress and widget decompress methods work with data as a
dictionary of field names and values.
The NestedFormField accept either a list of tuples, with each tuple
containing a field name and field instance, or a tuple of field names
("keys" keyword argument), in which case the NestedForm will consist of a
charfield for each given field name.
NestedFormFields can contain other NestedFormFields.
django.contrib.postgres.fields.hstore.HStoreField:
1) Now accepts a "fields" keyword argument which is the same format as the
NestedFormField fields keyword argument. If given, a NestedFormField will
be used consisting of the given fields. The NestedFormField will return a
dictionary which can then be used to populate the HStore Field. The fields
argument should only contain field types which have string values.
2) Accepts a keys argument. If given a NestedFormField will be created
consisting only of CharFields, one for each key.
3) Accepts a require_all_fields argument in which case all fields in the
NestedForm will be required (default is False).
4) Accepts a max_value_length argument - if given with the keys argument,
this will be the max length of each CharField.
JSONField:
1) Now accepts a "fields" keyword argument which is the same format as the
NestedFormField fields keyword argument. If given, a NestedFormField will
be used consisting of the given fields. The NestedFormField will return a
dictionary which can then be used to populate the JSON Field. The fields
can consist of any form field types, including another NestedFormField or
a SplitArrayField.
2) Accepts a require_all_fields argument in which case all fields in the
NestedForm will need to be not blank (default is False).
I've written the first revision of the patch and also tests in
tests.postgres_tests. All the above features have been verified. This
includes some Selenium tests. I need to start working on documentation but
I will upload a branch today.
Would love to have some feedback on what people think of these features.
Example usage:
{{{
#!python
class Product(models.Model):
name = models.CharField(max_length=15)
keywords = ArrayField(models.CharField(max_length=20), default=[],
form_size=10, blank=True)
sports = ArrayField(models.IntegerField(),default=[], blank=True,
choices=(
(0, 'Football'), (1, 'Tennis'), (2, 'Golf'), (3, 'Basketball'),
(4, 'Hurling'), (5, 'Baseball')))
shipping = HStoreField(keys=('Address', 'City', 'Region', 'Country'),
blank=True, default={})
details = JSONField(blank=True, default={}, fields=(
('Brand', NestedFormField(keys=('Name', 'Country'))),
('Type', forms.CharField(max_length=25, required=False)),
('Colours',
SplitArrayField(base_field=forms.CharField(max_length=10, required=False),
size=10)),
)
)
def __str__(self):
return self.name
}}}
I will attach an image showing how the above would look in the admin add
form.
--
Ticket URL: <https://code.djangoproject.com/ticket/26654>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/052.6be2208d9d01af6445debe794a1d3431%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
