4.4.1.1 Field class

Field ()
This class is used internally by FieldStorage and is not meant to be instantiated by the user. Each instance of a Field class represents an HTML Form input.

Field instances have the following attributes:

name
The input name.

value
The input value. This attribute can be used to read data from a file upload as well, but one has to excercise caution when dealing with large files since when accessed via value, the whole file is read into memory.

file
This is a file object. For file uploads it points to a temporary file. For simple values, it is a StringIO object, so you can read simple string values via this attribute instead of using the value attribute as well.

filename
The name of the file as provided by the client.

type
The content-type for this input as provided by the client.

type_opyions
This is what follows the actual content type in the content-type header provided by the client, if anything. This is a dictionary.

disposition
The value of the first part of the content-disposition header.

disposition_options
The second part (if any) of the content-disposition header in the form of a dictionary.

See Also:

RFC 1867, Form-based File Upload in HTML
for a description of form-based file uploads