traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Change to use real temporary files instead of StringIO. Correct and 

add to documentation.  This will be released as cgi.py 2.0a1.
This commit is contained in:
Guido van Rossum 1996-03-09 04:04:35 +00:00
parent 0147db07ef
commit 4032c2c1ce
1 changed files with 39 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
Lib/cgi.py
View File

@ -77,14 +77,18 @@ the fields "name" and "addr" are both set to a non-empty string:
return return
...further form processing here... ...further form processing here...
If your form contains multiple fields with the same name, the value Here the fields, accessed through form[key], are themselves instances
attribute will be a list when multiple fields were actually filled by the of FieldStorage (or MiniFieldStorage, depending on the form encoding).
user. In order to test for this, use the type() function. If this is the
case, the value attribute is a list of FieldStorage items. For example,
here's code that concatenates all fields with the same name with
intervening commas:
username = form["username"].value If the submitted form data contains more than one field with the same
name, the object retrieved by form[key] is not a (Mini)FieldStorage
instance but a list of such instances. If you expect this possibility
(i.e., when your HTML form comtains multiple fields with the same
name), use the type() function to determine whether you have a single
instance or a list of instances. For example, here's code that
concatenates any number of username fields, separated by commas:
username = form["username"]
if type(username) is type([]): if type(username) is type([]):
# Multiple username fields specified # Multiple username fields specified
usernames = "" usernames = ""
@ -97,7 +101,7 @@ intervening commas:
usernames = item.value usernames = item.value
else: else:
# Single username field specified # Single username field specified
usernames = username usernames = username.value
If a field represents an uploaded file, the value attribute reads the If a field represents an uploaded file, the value attribute reads the
entire file in memory as a string. This may not be what you want. You can entire file in memory as a string. This may not be what you want. You can
@ -114,6 +118,14 @@ attribute:
if not line: break if not line: break
linecount = linecount + 1 linecount = linecount + 1
The file upload draft standard entertains the possibility of uploading
multiple files from one field (using a recursive multipart/*
encoding). When this occurs, the item will be a dictionary-like
FieldStorage item. This can be determined by testing its type
attribute, which should have the value "multipart/form-data" (or
perhaps another string beginning with "multipart/"). It this case, it
can be iterated over recursively just like the top-level form object.
When a form is submitted in the "old" format (as the query string or as a When a form is submitted in the "old" format (as the query string or as a
single data part of type application/x-www-form-urlencoded), the items single data part of type application/x-www-form-urlencoded), the items
will actually be instances of the class MiniFieldStorage. In this case, will actually be instances of the class MiniFieldStorage. In this case,
@ -567,7 +579,7 @@ class MiniFieldStorage:
filename = None filename = None
list = None list = None
type = None type = None
typ_options = {} type_options = {}
disposition = None disposition = None
disposition_options = {} disposition_options = {}
headers = {} headers = {}
@ -874,25 +886,28 @@ class FieldStorage:
The 'binary' argument is 'b' if the file should be created in The 'binary' argument is 'b' if the file should be created in
binary mode (on non-Unix systems), '' otherwise. binary mode (on non-Unix systems), '' otherwise.
The intention is that you can override this method to This version opens a temporary file for reading and writing,
selectively create a real (temporary) file or use a memory and immediately deletes (unlinks) it. The trick (on Unix!) is
file dependent on the perceived size of the file or the that the file can still be used, but it can't be opened by
presence of a filename, etc. another process, and it will automatically be deleted when it
is closed or when the current process terminates.
If you want a more permanent file, you derive a class which
overrides this method. If you want a visible temporary file
that is nevertheless automatically deleted when the script
terminates, try defining a __del__ method in a derived class
which unlinks the temporary files you have created.
""" """
import tempfile
# Prefer ArrayIO over StringIO, if it's available tfn = tempfile.mktemp()
try: f = open(tfn, "w%s+" % binary)
from ArrayIO import ArrayIO os.unlink(tfn)
ioclass = ArrayIO return f
except ImportError:
from StringIO import StringIO
ioclass = StringIO
return ioclass()
# Main classes # Backwards Compatibility Classes
# ============ # ===============================
class FormContentDict: class FormContentDict:
"""Basic (multiple values per field) form content as dictionary. """Basic (multiple values per field) form content as dictionary.