Opened 7 years ago

Closed 7 years ago

Last modified 4 years ago

#8486 closed (fixed)

Incorrect 'UploadedFile' attributes on 'Request and response objects' page

Reported by: mrsanders Owned by: nobody
Component: Documentation Version: master
Severity: Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:


The description of the FILES attribute of HttpRequest objects (at is incorrect:

A dictionary-like object containing all uploaded files. Each key in FILES is the name from the <input type="file" name="" />. Each value in FILES is an UploadedFile object containing the following attributes:

  • read(num_bytes=None) — Read a number of bytes from the file.
  • file_name — The name of the uploaded file.
  • file_size — The size, in bytes, of the uploaded file.
  • chunk() — A generator that yields sequential chunks of data.


The attributes file_name and file_size are actually called name and size.

Attachments (1)

8486.typo.diff (839 bytes) - added by julien 7 years ago.

Download all attachments as: .zip

Change History (5)

comment:1 Changed 7 years ago by julien

  • Has patch set
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted

Thanks for the report. Also note that the chunks() method takes an 's'.

Changed 7 years ago by julien

comment:2 Changed 7 years ago by cgrady

  • Triage Stage changed from Accepted to Ready for checkin

comment:3 Changed 7 years ago by russellm

  • Resolution set to fixed
  • Status changed from new to closed

(In [8518]) Fixed #8486: Corrected some file attribute names in the request/response docs. Thanks to mrsanders for the report.

comment:4 Changed 4 years ago by jacob

  • milestone 1.0 deleted

Milestone 1.0 deleted

Note: See TracTickets for help on using tickets.
Back to Top