diff options
| author | Claude Paroz <claude@2xlibre.net> | 2014-03-22 21:30:49 +0100 |
|---|---|---|
| committer | Claude Paroz <claude@2xlibre.net> | 2014-03-22 21:32:20 +0100 |
| commit | 3a97f992fbfbcf8b0480875b257e5d541a4b8315 (patch) | |
| tree | c5ac40df266f098c5b7b1378864685869fe2a324 /docs/topics/forms | |
| parent | 232181d1c5307d9af5fc292682661e91439a9289 (diff) | |
Fixed #22313 -- Removed 'u' prefixes from documentation
Diffstat (limited to 'docs/topics/forms')
| -rw-r--r-- | docs/topics/forms/formsets.txt | 166 | ||||
| -rw-r--r-- | docs/topics/forms/modelforms.txt | 6 |
2 files changed, 86 insertions, 86 deletions
diff --git a/docs/topics/forms/formsets.txt b/docs/topics/forms/formsets.txt index a1e30b341b..0e32d6131f 100644 --- a/docs/topics/forms/formsets.txt +++ b/docs/topics/forms/formsets.txt @@ -64,7 +64,7 @@ example:: >>> from myapp.forms import ArticleForm >>> ArticleFormSet = formset_factory(ArticleForm, extra=2) >>> formset = ArticleFormSet(initial=[ - ... {'title': u'Django is now open source', + ... {'title': 'Django is now open source', ... 'pub_date': datetime.date.today(),} ... ]) @@ -136,9 +136,9 @@ all forms in the formset:: >>> from myapp.forms import ArticleForm >>> ArticleFormSet = formset_factory(ArticleForm) >>> data = { - ... 'form-TOTAL_FORMS': u'1', - ... 'form-INITIAL_FORMS': u'0', - ... 'form-MAX_NUM_FORMS': u'', + ... 'form-TOTAL_FORMS': '1', + ... 'form-INITIAL_FORMS': '0', + ... 'form-MAX_NUM_FORMS': '', ... } >>> formset = ArticleFormSet(data) >>> formset.is_valid() @@ -149,19 +149,19 @@ formset is smart enough to ignore extra forms that were not changed. If we provide an invalid article:: >>> data = { - ... 'form-TOTAL_FORMS': u'2', - ... 'form-INITIAL_FORMS': u'0', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'Test', - ... 'form-0-pub_date': u'1904-06-16', - ... 'form-1-title': u'Test', - ... 'form-1-pub_date': u'', # <-- this date is missing but required + ... 'form-TOTAL_FORMS': '2', + ... 'form-INITIAL_FORMS': '0', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': 'Test', + ... 'form-0-pub_date': '1904-06-16', + ... 'form-1-title': 'Test', + ... 'form-1-pub_date': '', # <-- this date is missing but required ... } >>> formset = ArticleFormSet(data) >>> formset.is_valid() False >>> formset.errors - [{}, {'pub_date': [u'This field is required.']}] + [{}, {'pub_date': ['This field is required.']}] As we can see, ``formset.errors`` is a list whose entries correspond to the forms in the formset. Validation was performed for each of the two forms, and @@ -176,7 +176,7 @@ To check how many errors there are in the formset, we can use the >>> # Using the previous example >>> formset.errors - [{}, {'pub_date': [u'This field is required.']}] + [{}, {'pub_date': ['This field is required.']}] >>> len(formset.errors) 2 >>> formset.total_error_count() @@ -186,11 +186,11 @@ We can also check if form data differs from the initial data (i.e. the form was sent without any data):: >>> data = { - ... 'form-TOTAL_FORMS': u'1', - ... 'form-INITIAL_FORMS': u'0', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'', - ... 'form-0-pub_date': u'', + ... 'form-TOTAL_FORMS': '1', + ... 'form-INITIAL_FORMS': '0', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': '', + ... 'form-0-pub_date': '', ... } >>> formset = ArticleFormSet(data) >>> formset.has_changed() @@ -209,13 +209,13 @@ collection of forms contained in the formset. If you don't provide this management data, an exception will be raised:: >>> data = { - ... 'form-0-title': u'Test', - ... 'form-0-pub_date': u'', + ... 'form-0-title': 'Test', + ... 'form-0-pub_date': '', ... } >>> formset = ArticleFormSet(data) Traceback (most recent call last): ... - django.forms.utils.ValidationError: [u'ManagementForm data is missing or has been tampered with'] + django.forms.utils.ValidationError: ['ManagementForm data is missing or has been tampered with'] It is used to keep track of how many form instances are being displayed. If you are adding new forms via JavaScript, you should increment the count fields @@ -273,13 +273,13 @@ is where you define your own validation that works at the formset level:: >>> ArticleFormSet = formset_factory(ArticleForm, formset=BaseArticleFormSet) >>> data = { - ... 'form-TOTAL_FORMS': u'2', - ... 'form-INITIAL_FORMS': u'0', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'Test', - ... 'form-0-pub_date': u'1904-06-16', - ... 'form-1-title': u'Test', - ... 'form-1-pub_date': u'1912-06-23', + ... 'form-TOTAL_FORMS': '2', + ... 'form-INITIAL_FORMS': '0', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': 'Test', + ... 'form-0-pub_date': '1904-06-16', + ... 'form-1-title': 'Test', + ... 'form-1-pub_date': '1912-06-23', ... } >>> formset = ArticleFormSet(data) >>> formset.is_valid() @@ -287,7 +287,7 @@ is where you define your own validation that works at the formset level:: >>> formset.errors [{}, {}] >>> formset.non_form_errors() - [u'Articles in a set must have distinct titles.'] + ['Articles in a set must have distinct titles.'] The formset ``clean`` method is called after all the ``Form.clean`` methods have been called. The errors will be found using the ``non_form_errors()`` @@ -314,14 +314,14 @@ deletion, is less than or equal to ``max_num``. >>> from myapp.forms import ArticleForm >>> ArticleFormSet = formset_factory(ArticleForm, max_num=1, validate_max=True) >>> data = { - ... 'form-TOTAL_FORMS': u'2', - ... 'form-INITIAL_FORMS': u'0', - ... 'form-MIN_NUM_FORMS': u'', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'Test', - ... 'form-0-pub_date': u'1904-06-16', - ... 'form-1-title': u'Test 2', - ... 'form-1-pub_date': u'1912-06-23', + ... 'form-TOTAL_FORMS': '2', + ... 'form-INITIAL_FORMS': '0', + ... 'form-MIN_NUM_FORMS': '', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': 'Test', + ... 'form-0-pub_date': '1904-06-16', + ... 'form-1-title': 'Test 2', + ... 'form-1-pub_date': '1912-06-23', ... } >>> formset = ArticleFormSet(data) >>> formset.is_valid() @@ -329,7 +329,7 @@ deletion, is less than or equal to ``max_num``. >>> formset.errors [{}, {}] >>> formset.non_form_errors() - [u'Please submit 1 or fewer forms.'] + ['Please submit 1 or fewer forms.'] ``validate_max=True`` validates against ``max_num`` strictly even if ``max_num`` was exceeded because the amount of initial data supplied was @@ -363,14 +363,14 @@ deletion, is greater than or equal to ``min_num``. >>> from myapp.forms import ArticleForm >>> ArticleFormSet = formset_factory(ArticleForm, min_num=3, validate_min=True) >>> data = { - ... 'form-TOTAL_FORMS': u'2', - ... 'form-INITIAL_FORMS': u'0', - ... 'form-MIN_NUM_FORMS': u'', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'Test', - ... 'form-0-pub_date': u'1904-06-16', - ... 'form-1-title': u'Test 2', - ... 'form-1-pub_date': u'1912-06-23', + ... 'form-TOTAL_FORMS': '2', + ... 'form-INITIAL_FORMS': '0', + ... 'form-MIN_NUM_FORMS': '', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': 'Test', + ... 'form-0-pub_date': '1904-06-16', + ... 'form-1-title': 'Test 2', + ... 'form-1-pub_date': '1912-06-23', ... } >>> formset = ArticleFormSet(data) >>> formset.is_valid() @@ -378,7 +378,7 @@ deletion, is greater than or equal to ``min_num``. >>> formset.errors [{}, {}] >>> formset.non_form_errors() - [u'Please submit 3 or more forms.'] + ['Please submit 3 or more forms.'] .. versionchanged:: 1.7 @@ -405,8 +405,8 @@ Lets you create a formset with the ability to order:: >>> from myapp.forms import ArticleForm >>> ArticleFormSet = formset_factory(ArticleForm, can_order=True) >>> formset = ArticleFormSet(initial=[ - ... {'title': u'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, - ... {'title': u'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, + ... {'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, + ... {'title': 'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, ... ]) >>> for form in formset: ... print(form.as_table()) @@ -426,31 +426,31 @@ data it automatically assigned them a numeric value. Let's look at what will happen when the user changes these values:: >>> data = { - ... 'form-TOTAL_FORMS': u'3', - ... 'form-INITIAL_FORMS': u'2', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'Article #1', - ... 'form-0-pub_date': u'2008-05-10', - ... 'form-0-ORDER': u'2', - ... 'form-1-title': u'Article #2', - ... 'form-1-pub_date': u'2008-05-11', - ... 'form-1-ORDER': u'1', - ... 'form-2-title': u'Article #3', - ... 'form-2-pub_date': u'2008-05-01', - ... 'form-2-ORDER': u'0', + ... 'form-TOTAL_FORMS': '3', + ... 'form-INITIAL_FORMS': '2', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': 'Article #1', + ... 'form-0-pub_date': '2008-05-10', + ... 'form-0-ORDER': '2', + ... 'form-1-title': 'Article #2', + ... 'form-1-pub_date': '2008-05-11', + ... 'form-1-ORDER': '1', + ... 'form-2-title': 'Article #3', + ... 'form-2-pub_date': '2008-05-01', + ... 'form-2-ORDER': '0', ... } >>> formset = ArticleFormSet(data, initial=[ - ... {'title': u'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, - ... {'title': u'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, + ... {'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, + ... {'title': 'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, ... ]) >>> formset.is_valid() True >>> for form in formset.ordered_forms: ... print(form.cleaned_data) - {'pub_date': datetime.date(2008, 5, 1), 'ORDER': 0, 'title': u'Article #3'} - {'pub_date': datetime.date(2008, 5, 11), 'ORDER': 1, 'title': u'Article #2'} - {'pub_date': datetime.date(2008, 5, 10), 'ORDER': 2, 'title': u'Article #1'} + {'pub_date': datetime.date(2008, 5, 1), 'ORDER': 0, 'title': 'Article #3'} + {'pub_date': datetime.date(2008, 5, 11), 'ORDER': 1, 'title': 'Article #2'} + {'pub_date': datetime.date(2008, 5, 10), 'ORDER': 2, 'title': 'Article #1'} ``can_delete`` ~~~~~~~~~~~~~~ @@ -465,8 +465,8 @@ Lets you create a formset with the ability to select forms for deletion:: >>> from myapp.forms import ArticleForm >>> ArticleFormSet = formset_factory(ArticleForm, can_delete=True) >>> formset = ArticleFormSet(initial=[ - ... {'title': u'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, - ... {'title': u'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, + ... {'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, + ... {'title': 'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, ... ]) >>> for form in formset: .... print(form.as_table()) @@ -486,26 +486,26 @@ and is a ``forms.BooleanField``. When data comes through marking any of the delete fields you can access them with ``deleted_forms``:: >>> data = { - ... 'form-TOTAL_FORMS': u'3', - ... 'form-INITIAL_FORMS': u'2', - ... 'form-MAX_NUM_FORMS': u'', - ... 'form-0-title': u'Article #1', - ... 'form-0-pub_date': u'2008-05-10', - ... 'form-0-DELETE': u'on', - ... 'form-1-title': u'Article #2', - ... 'form-1-pub_date': u'2008-05-11', - ... 'form-1-DELETE': u'', - ... 'form-2-title': u'', - ... 'form-2-pub_date': u'', - ... 'form-2-DELETE': u'', + ... 'form-TOTAL_FORMS': '3', + ... 'form-INITIAL_FORMS': '2', + ... 'form-MAX_NUM_FORMS': '', + ... 'form-0-title': 'Article #1', + ... 'form-0-pub_date': '2008-05-10', + ... 'form-0-DELETE': 'on', + ... 'form-1-title': 'Article #2', + ... 'form-1-pub_date': '2008-05-11', + ... 'form-1-DELETE': '', + ... 'form-2-title': '', + ... 'form-2-pub_date': '', + ... 'form-2-DELETE': '', ... } >>> formset = ArticleFormSet(data, initial=[ - ... {'title': u'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, - ... {'title': u'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, + ... {'title': 'Article #1', 'pub_date': datetime.date(2008, 5, 10)}, + ... {'title': 'Article #2', 'pub_date': datetime.date(2008, 5, 11)}, ... ]) >>> [form.cleaned_data for form in formset.deleted_forms] - [{'DELETE': True, 'pub_date': datetime.date(2008, 5, 10), 'title': u'Article #1'}] + [{'DELETE': True, 'pub_date': datetime.date(2008, 5, 10), 'title': 'Article #1'}] If you are using a :class:`ModelFormSet<django.forms.models.BaseModelFormSet>`, model instances for deleted forms will be deleted when you call diff --git a/docs/topics/forms/modelforms.txt b/docs/topics/forms/modelforms.txt index a55e7a5ced..d01fc64cb2 100644 --- a/docs/topics/forms/modelforms.txt +++ b/docs/topics/forms/modelforms.txt @@ -913,7 +913,7 @@ extra forms displayed. >>> AuthorFormSet = modelformset_factory(Author, max_num=1) >>> formset = AuthorFormSet(queryset=Author.objects.order_by('name')) >>> [x.name for x in formset.get_queryset()] - [u'Charles Baudelaire', u'Paul Verlaine', u'Walt Whitman'] + ['Charles Baudelaire', 'Paul Verlaine', 'Walt Whitman'] If the value of ``max_num`` is greater than the number of existing related objects, up to ``extra`` additional blank forms will be added to the formset, @@ -1111,7 +1111,7 @@ a particular author, you could do this:: >>> from django.forms.models import inlineformset_factory >>> BookFormSet = inlineformset_factory(Author, Book) - >>> author = Author.objects.get(name=u'Mike Royko') + >>> author = Author.objects.get(name='Mike Royko') >>> formset = BookFormSet(instance=author) .. note:: @@ -1150,7 +1150,7 @@ Then when you create your inline formset, pass in the optional argument >>> from django.forms.models import inlineformset_factory >>> BookFormSet = inlineformset_factory(Author, Book, formset=CustomInlineFormSet) - >>> author = Author.objects.get(name=u'Mike Royko') + >>> author = Author.objects.get(name='Mike Royko') >>> formset = BookFormSet(instance=author) More than one foreign key to the same model |
