Changes between Version 180 and Version 181 of BackwardsIncompatibleChanges

Timestamp:

Jul 7, 2008, 6:27:07 PM (16 years ago)

Author:

Jacob

Comment:

--

BackwardsIncompatibleChanges

@@ -60 +60 @@
  * [7799] June 30, 2008 [#BooleanFieldsinnewformsenforcerequired BooleanFields in newforms enforce "required"]
  * [7806] June 30, 2008 [#DefaultUserorderingremoved Default User ordering removed]
- * [7814] July 1, 2008 [#Uploadedfilechanges Uploaded file changes]
+ * [7814] July 1, 2008 & [7859] [#Uploadedfilechanges Uploaded file changes]
  * [7844] July 6, 2008 [#Translationtoolsnowpartofdjango-admin.py Translation tools now part of `django-admin.py`]
+ * [7859] July 7, 2008 [#Uploadedfilechanges More uploaded file changes].
 
 == Database constraint names changed ==
@@ -637 +638 @@
 However, as part of the change, the representation of uploaded files has changed. Previous, uploaded files -- that is, entries in {{{request.FILES}}} -- were represented by simple dictionaries with a few well-known keys. Uploaded files are now represented by an [http://www.djangoproject.com/documentation/upload_handling/#uploaded-file-objects UploadedFile object], and thus the file's information is accessible through object attributes. Thus, given {{{f = request.FILES['some_field_name']}}}:
 
-|| '''Old'''                            || '''New'''                    ||
-|| {{{f['content']}}}           || {{{f.read()}}}               ||
-|| {{{f['filename']}}}          || {{{f.file_name}}}    ||
-|| {{{f['content-type']}}}      || {{{f.content_type}}} ||
+|| '''Deprecated'''         || '''Replacement'''    ||
+|| {{{f['content']}}}       || {{{f.read()}}}       ||
+|| {{{f['filename']}}}      || {{{f.name}}}         ||
+|| {{{f['content-type']}}}  || {{{f.content_type}}} ||
 
 The old dictionary-style key access is still supported, but will raise a {{{DeprecationWarning}}}.
+
+[7859] further cleaned up and clarified this interface. It unfortunatly had to deprecate a couple of things added in [7814]:
+
+|| '''Deprecated'''  || '''Replacement'''                   ||
+|| {{{f.file_name}}} || {{{f.name}}}                        ||
+|| {{{f.file_size}}} || {{{f.size}}}                        ||
+|| {{{f.chunk()}}}   || {{{f.chunks()}}} (note the plural)  ||
+
+The old attributes will still work, but will issue deprecation warnings.
+
+Finally, [7859] removed the {{{django.newforms.fields.UploadedFile}}} class, unifying the use of {{{django.core.files.uploadedfile.UploadedFile}}} everywhere in Django. This means a few API changes when using a form with a {{{FileField}}}.
+
+|| '''Deprecated'''                                 || '''Replacement'''                              ||
+|| {{{form.cleaned_data['file_field'].filename}}}   || {{{form.cleaned_data['file_field'].name}}}     ||
+|| {{{form.cleaned_data['file_field'].data}}}       || {{{form.cleaned_data['file_field'].read()}}}   ||
 
 == Translation tools now part of `django-admin.py` ==