ž
¬ÿ f⊠c @ sU d Z d Z d d l m Z m Z m Z d d l m Z d d l Z d d l Z d d l
Z d d l m
Z
d d l m Z d d l m Z d d l Z d d l Z d d l Z d d
d d d
d d d d d d d d d g Z d a e a d d „ Z d d „ Z d d „ Z d d „ Z e a d a e e j d d d d „ Z d d d! d „ Z! d d d" d
„ Z" d# d „ Z# d$ d% „ Z$ d& d „ Z% Gd' d „ d ƒ Z& Gd( d
„ d
ƒ Z' e j d) d* „ Z( e e e e d+ d „ Z) e j d, d „ Z* d- d „ Z+ d. d „ Z, d/ d „ Z- d0 d „ Z. e d1 d „ Z/ e d2 d3 „ Z0 e1 d4 k rQe( ƒ n d S(5 u Support module for CGI (Common Gateway Interface) scripts.
This module defines a number of utilities for use by CGI scripts
written in Python.
u 2.6i ( u StringIOu BytesIOu
TextIOWrapper( u MappingN( u
FeedParser( u Message( u warnu MiniFieldStorageu FieldStorageu parseu parse_qsu parse_qslu parse_multipartu parse_headeru print_exceptionu
print_environu
print_formu print_directoryu print_argumentsu print_environ_usageu escapeu c G s[ t r8 t r8 y t t d ƒ a Wq8 t k
r4 Yq8 Xn t sG t a n t a t | Œ d S( u„ Write a log message, if there is a log file.
Even though this function is called initlog(), you should always
use log(); log is a variable that is set either to initlog
(initially), to dolog (once the log file has been opened), or to
nolog (when logging is disabled).
The first argument is a format string; the remaining arguments (if
any) are arguments to the % operator, so e.g.
log("%s: %s", "a", "b")
will write "a: b" to the log file, followed by a newline.
If the global logfp is not None, it should be a file object to
which log data is written.
If the global logfp is None, the global logfile may be a string
giving a filename to open, in append mode. This file should be
world writable!!! If the file can't be opened, logging is
silently disabled (since there is no safe place where we could
send an error message).
u aN( u logfileu logfpu openu IOErroru nologu logu dolog( u allargs( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu initlog: s
u initlogc G s t j | | d ƒ d S( u= Write a log message to the log file. See initlog() for docs.u
N( u logfpu write( u fmtu args( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu dolog] s u dologc G s d S( u9 Dummy function, assigned to log when logging is disabled.N( ( u allargs( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu nologa s u nologc C s) d a t r t j ƒ d a n t a d S( u Close the log file.u N( u logfileu logfpu closeu Noneu initlogu log( ( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu closeloge s
u closelogc C sé | d k r t j } n t | d ƒ r3 | j } n d } t | t ƒ rT | j } n d | k rm d | d |
d k rNd i } }
n
d i } }
| | _ |
| _# d |
k r•|
d j | j ƒ | _$ n d | _$ d } d | j k ry t% | j d ƒ } Wn t& k
rÞYn Xt' r| t' k rt& d ƒ ‚ qn | | _( | j d k r-| r-| | _ n d | _) | _* d | _+ | d k r_| j, ƒ n6 | d d … d k r‹| j- | | | ƒ n
| j. ƒ d S( u› Constructor. Read multipart/* until last part.
Arguments, all optional:
fp : file pointer; default: sys.stdin.buffer
(not used when the request method is GET)
Can be :
1. a TextIOWrapper object
2. an object whose read() and readline() methods return bytes
headers : header dictionary-like object; default:
taken from environ as per CGI spec
outerboundary : terminating multipart boundary
(for internal use only)
environ : environment dictionary; default: os.environ
keep_blank_values: flag indicating whether blank values in
percent-encoded forms should be treated as blank strings.
A true value indicates that blanks should be retained as
blank strings. The default false value indicates that
blank values are to be ignored and treated as if they were
not included.
strict_parsing: flag indicating what to do with parsing errors.
If false (the default), errors are silently ignored.
If true, errors raise a ValueError exception.
limit : used internally to read parts of multipart/form-data forms,
to exit from the reading loop when reached. It is the difference
between the form content-length and the number of bytes already
read
encoding, errors : the encoding and error handler used to decode the
binary stream to strings. Must be the same as the charset defined
for the page sending the form (content-type : meta http-equiv or
header)
u GETu REQUEST_METHODu HEADu QUERY_STRINGi Nu u surrogateescapeu! application/x-www-form-urlencodedu content-typeu POSTu CONTENT_TYPEu CONTENT_LENGTHu content-lengthu? headers must be mapping or an instance of email.message.Messageu readu readlineu fp must be file pointeru# outerboundary must be bytes, not %si u content-dispositionu nameu filenameu
text/plainu boundarys u Maximum content length exceededi
u
multipart/iÿÿÿÿ(/ u keep_blank_valuesu strict_parsingu upperu Noneu
qs_on_postu sysu argvu encodeu localeu getpreferredencodingu BytesIOu
isinstanceu Mappingu Messageu TypeErroru headersu stdinu bufferu fpu
TextIOWrapperu hasattru encodingu errorsu bytesu typeu __name__u
outerboundaryu
bytes_readu limitu parse_headeru dispositionu disposition_optionsu nameu filenameu _binary_fileu type_optionsu
innerboundaryu intu
ValueErroru maxlenu lengthu listu fileu doneu read_urlencodedu
read_multiu read_single( u selfu fpu headersu
outerboundaryu environu keep_blank_valuesu strict_parsingu limitu encodingu errorsu methodu qsu cdispu pdictu ctypeu clen( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __init__• sª +
u FieldStorage.__init__c C s d | j | j | j f S( u" Return a printable representation.u FieldStorage(%r, %r, %r)( u nameu filenameu value( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __repr__3 s u FieldStorage.__repr__c C s t | j ƒ ƒ S( N( u iteru keys( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __iter__8 s u FieldStorage.__iter__c C s{ | d k r t | ƒ ‚ n | j rV | j j d ƒ | j j ƒ } | j j d ƒ n! | j d k rq | j } n d } | S( Nu valuei ( u AttributeErroru fileu seeku readu listu None( u selfu nameu value( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __getattr__; s u FieldStorage.__getattr__c C sŽ | j d k r t d ƒ ‚ n g } x0 | j D]% } | j | k r. | j | ƒ q. q. W| sl t | ƒ ‚ n t | ƒ d k r† | d S| Sd S( u Dictionary style indexing.u
not indexablei i N( u listu Noneu TypeErroru nameu appendu KeyErroru len( u selfu keyu foundu item( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __getitem__H s u FieldStorage.__getitem__c C sH | | k r@ | | } t | t ƒ r6 d d „ | Dƒ S| j Sn | Sd S( u8 Dictionary style get() method, including 'value' lookup.c S s g | ] } | j ‘ q S( ( u value( u .0u x( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
[ s u) FieldStorage.getvalue..N( u
isinstanceu listu value( u selfu keyu defaultu value( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu getvalueV s
u FieldStorage.getvaluec C sB | | k r: | | } t | t ƒ r0 | d j S| j Sn | Sd S( u! Return the first value received.i N( u
isinstanceu listu value( u selfu keyu defaultu value( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu getfirsta s
u FieldStorage.getfirstc C sK | | k rC | | } t | t ƒ r6 d d „ | Dƒ S| j g Sn g Sd S( u Return list of received values.c S s g | ] } | j ‘ q S( ( u value( u .0u x( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
q s u( FieldStorage.getlist..N( u
isinstanceu listu value( u selfu keyu value( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu getlistl s
u FieldStorage.getlistc C s> | j d k r t d ƒ ‚ n t t d d „ | j Dƒ ƒ ƒ S( u Dictionary style keys() method.u
not indexablec s s | ] } | j Vq d S( N( u name( u .0u item( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu { s u$ FieldStorage.keys..N( u listu Noneu TypeErroru set( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu keysw s u FieldStorage.keysc s> | j d k r t d ƒ ‚ n t ‡ f d d † | j Dƒ ƒ S( u% Dictionary style __contains__ method.u
not indexablec 3 s | ] } | j ˆ k Vq d S( N( u name( u .0u item( u key( u( /opt/alt/python33/lib64/python3.3/cgi.pyu s u, FieldStorage.__contains__..N( u listu Noneu TypeErroru any( u selfu key( ( u keyu( /opt/alt/python33/lib64/python3.3/cgi.pyu __contains__} s u FieldStorage.__contains__c C s t | j ƒ ƒ S( u Dictionary style len(x) support.( u lenu keys( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __len__ƒ s u FieldStorage.__len__c C s+ | j d k r t d ƒ ‚ n t | j ƒ S( Nu Cannot be converted to bool.( u listu Noneu TypeErroru bool( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __bool__‡ s u FieldStorage.__bool__c C sõ | j j | j ƒ } t | t ƒ sI t d | j t | ƒ j f ƒ ‚ n | j | j | j
ƒ } | j r~ | d | j 7} n g | _ t
j j | | j | j d | j d | j
ƒ} x- | D]% \ } } | j j t | | ƒ ƒ q¾ W| j ƒ d S( u+ Internal: read data in query string format.u %s should return bytes, got %su &u encodingu errorsN( u fpu readu lengthu
isinstanceu bytesu
ValueErroru typeu __name__u decodeu encodingu errorsu
qs_on_postu listu urllibu parseu parse_qslu keep_blank_valuesu strict_parsingu appendu MiniFieldStorageu
skip_lines( u selfu qsu queryu keyu value( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu read_urlencodedŒ s u FieldStorage.read_urlencodedc C s7 | j } t | ƒ s+ t d | f ƒ ‚ n g | _ | j r© t j j | j | j | j d | j
d | j ƒ} x- | D]% \ } } | j j t
| | ƒ ƒ qw Wd } n | j p¸ | j } | j j ƒ }
t |
t ƒ sþ t d | j t |
ƒ j f ƒ ‚ n | j t |
ƒ 7_ xt ƒ } d } x, | j j ƒ }
| |
7} |
j ƒ s(Pq(q(| s^Pn | j t | ƒ 7_ | j | j | j
| j ƒ ƒ | j ƒ } | | j | | | | | | j | j | j
| j ƒ } | j | j 7_ | j j | ƒ | j s"| j | j k o d k n rPqq| j! ƒ d S( u/ Internal: read a part that is itself multipart.u& Invalid boundary in multipart form: %ru encodingu errorsu %s should return bytes, got %ss i N(" u
innerboundaryu valid_boundaryu
ValueErroru listu
qs_on_postu urllibu parseu parse_qslu keep_blank_valuesu strict_parsingu encodingu errorsu appendu MiniFieldStorageu Noneu FieldStorageClassu __class__u fpu readlineu
isinstanceu bytesu typeu __name__u
bytes_readu lenu
FeedParseru stripu feedu decodeu closeu limitu doneu lengthu
skip_lines( u selfu environu keep_blank_valuesu strict_parsingu ibu queryu keyu valueu FieldStorageClassu klassu
first_lineu parseru hdr_textu datau headersu part( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
read_multiŸ sL
+u FieldStorage.read_multic C sD | j d k r& | j ƒ | j ƒ n
| j ƒ | j j d ƒ d S( u Internal: read an atomic part.i N( u lengthu read_binaryu
skip_linesu
read_linesu fileu seek( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu read_singleÌ s
u FieldStorage.read_singlei i c C sØ | j ƒ | _ | j } | d k rÔ x | d k rÐ | j j t | | j ƒ ƒ } t | t ƒ s… t d | j t
| ƒ j f ƒ ‚ n | j t
| ƒ 7_ | s d | _ Pn | j j | ƒ | t
| ƒ } q' Wn d S( u Internal: read binary data.i u %s should return bytes, got %si Niÿÿÿÿ( u make_fileu fileu lengthu fpu readu minu bufsizeu
isinstanceu bytesu
ValueErroru typeu __name__u
bytes_readu lenu doneu write( u selfu todou data( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu read_binary× s u FieldStorage.read_binaryc C sV | j r t ƒ | _ | _ n t ƒ | _ | _ | j rH | j ƒ n
| j ƒ d S( u0 Internal: read lines until EOF or outerboundary.N( u _binary_fileu BytesIOu fileu _FieldStorage__fileu StringIOu
outerboundaryu read_lines_to_outerboundaryu read_lines_to_eof( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
read_linesè s
u FieldStorage.read_linesc C s | j d k rk | j j ƒ t | ƒ d k rk | j ƒ | _ | j j ƒ } | j j | ƒ d | _ qk n | j r‡ | j j | ƒ n" | j j | j | j
| j ƒ ƒ d S( u line is always bytes, not stringiè N( u _FieldStorage__fileu Noneu tellu lenu make_fileu fileu getvalueu writeu _binary_fileu decodeu encodingu errors( u selfu lineu data( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu __writeó s u FieldStorage.__writec C sQ xJ | j j d ƒ } | j t | ƒ 7_ | s= d | _ Pn | j | ƒ q d S( u Internal: read lines until EOF.i i Ni iÿÿÿÿ( u fpu readlineu
bytes_readu lenu doneu _FieldStorage__write( u selfu line( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu read_lines_to_eof s u FieldStorage.read_lines_to_eofc C s© d | j } | d } d } d } d } xy| | j k r? Pn | j j d ƒ } | j t | ƒ 7_ | t | ƒ 7} | s‰ d
| _ Pn | d k r¨ | | } d } n | j d ƒ rõ | rõ | j ƒ } | | k rÙ Pn | | k rõ d | _ Pqõ n | } | j
d ƒ r)d } | d d … } d } nh | j
d
ƒ rWd
} | d d … } d } n: | j
d ƒ r…d } | d d … } d } n d } d } | j | | ƒ q, d S( už Internal: read lines until outerboundary.
Data is read as bytes: boundaries and line ends must be converted
to bytes for comparisons.
s --s i i i s
s
Ni s
Ti iÿÿÿÿiþÿÿÿiÿÿÿÿiÿÿÿÿF(
u
outerboundaryu Trueu limitu fpu readlineu
bytes_readu lenu doneu
startswithu rstripu endswithu Falseu _FieldStorage__write( u selfu
next_boundaryu
last_boundaryu delimu last_line_lfendu _readu lineu strippedlineu odelim( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu read_lines_to_outerboundary sP
u( FieldStorage.read_lines_to_outerboundaryc C sÔ | j s | j r d Sd | j } | d } d } x™ | j j d ƒ } | j t | ƒ 7_ | sq d | _ Pn | j d ƒ r¾ | r¾ | j ƒ } | | k r¢ Pn | | k r¾ d | _ Pq¾ n | j d ƒ } q7 d S( u5 Internal: skip lines until outer boundary if defined.Ns --i i s
Ti iÿÿÿÿ( u
outerboundaryu doneu Trueu fpu readlineu
bytes_readu lenu endswithu strip( u selfu
next_boundaryu
last_boundaryu last_line_lfendu lineu strippedline( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
skip_lines= s&
u FieldStorage.skip_linesc C s6 | j r t j d ƒ St j d d | j d d ƒSd S( u¯ Overridable: return a readable & writable file.
The file will be used as follows:
- data is written to it
- seek(0)
- data is read from it
The file is opened in binary mode for files, in text mode
for other fields
This version opens a temporary file for reading and writing,
and immediately deletes (unlinks) it. The trick (on Unix!) is
that the file can still be used, but it can't be opened by
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.
u wb+u w+u encodingu newlineu
N( u _binary_fileu tempfileu
TemporaryFileu encoding( u self( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu make_fileS s
u FieldStorage.make_fileNi ( u __name__u
__module__u __qualname__u __doc__u Noneu osu environu __init__u __repr__u __iter__u __getattr__u __getitem__u getvalueu getfirstu getlistu keysu __contains__u __len__u __bool__u read_urlencodedu FieldStorageClassu
read_multiu read_singleu bufsizeu read_binaryu
read_linesu _FieldStorage__writeu read_lines_to_eofu read_lines_to_outerboundaryu
skip_linesu make_file( u
__locals__( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu FieldStoragej s6 * œ
-
1 c C sæ t d ƒ t ƒ t j t _ yb t ƒ } t ƒ t ƒ t | ƒ t | ƒ t ƒ d d „ } | d d „ } t d ƒ | ƒ Wn t
ƒ Yn Xt d ƒ d a y/ t ƒ } t ƒ t ƒ t | ƒ t | ƒ Wn t
ƒ Yn Xd S(
u— Robust test CGI script, usable as main program.
Write minimal HTTP headers and dump all information provided to
the script in HTML form.
u Content-type: text/htmlc S s t d ƒ d S( Nu, testing print_exception() -- italics?( u exec( ( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu f† s u test..fc S s | ƒ d S( N( ( u f( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu gˆ s u test..gu9 What follows is a test, not an actual exception:
u* Second try with a small maxlen...
i2 N( u printu sysu stdoutu stderru FieldStorageu print_directoryu print_argumentsu
print_formu
print_environu print_environ_usageu print_exceptionu maxlen( u environu formu fu g( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu testu s4
u testc C s§ | d k r$ t j ƒ \ } } } n d d l } t ƒ t d ƒ | j | | ƒ | j | | ƒ } t d t j d j | d d … ƒ ƒ t j | d ƒ f ƒ ~ d S( Ni u+ Traceback (most recent call last):
u %s%s
u i iÿÿÿÿiÿÿÿÿ(
u Noneu sysu exc_infou tracebacku printu format_tbu format_exception_onlyu htmlu escapeu join( u typeu valueu tbu limitu tracebacku list( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu print_exceptionœ s
c C s| t | j ƒ ƒ } t ƒ t d ƒ t d ƒ x7 | D]/ } t d t j | ƒ d t j | | ƒ ƒ q4 Wt d ƒ t ƒ d S( u# Dump the shell environment as HTML.u Shell Environment:
u u - u
- u
N( u sortedu keysu printu htmlu escape( u environu keysu key( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
print_environª s
-
c C sÕ t | j ƒ ƒ } t ƒ t d ƒ | s6 t d ƒ n t d ƒ x} | D]u } t d t j | ƒ d d d ƒ| | } t d t j t t | ƒ ƒ ƒ d ƒ t d
t j t | ƒ ƒ ƒ qG Wt d ƒ t ƒ d S(
u$ Dump the contents of a form as HTML.u Form Contents:
u No form fields.u
u - u :u endu u u u
- u
N( u sortedu keysu printu htmlu escapeu repru type( u formu keysu keyu value( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu
print_formµ s
!
'!
c C s† t ƒ t d ƒ y t j ƒ } WnD t j k
rg } z! t d t j t | ƒ ƒ ƒ WYd d } ~ Xn Xt t j | ƒ ƒ t ƒ d S( u# Dump the current directory as HTML.u# Current Working Directory:
u os.error:N( u printu osu getcwdu erroru htmlu escapeu str( u pwdu msg( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu print_directoryÅ s
/c C s0 t ƒ t d ƒ t ƒ t t j ƒ t ƒ d S( Nu Command Line Arguments:
( u printu sysu argv( ( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu print_argumentsÑ s
c C s t d ƒ d S( u9 Dump a list of environment variables used by CGI as HTML.uØ
These environment variables could have been set:
- AUTH_TYPE
- CONTENT_LENGTH
- CONTENT_TYPE
- DATE_GMT
- DATE_LOCAL
- DOCUMENT_NAME
- DOCUMENT_ROOT
- DOCUMENT_URI
- GATEWAY_INTERFACE
- LAST_MODIFIED
- PATH
- PATH_INFO
- PATH_TRANSLATED
- QUERY_STRING
- REMOTE_ADDR
- REMOTE_HOST
- REMOTE_IDENT
- REMOTE_USER
- REQUEST_METHOD
- SCRIPT_NAME
- SERVER_NAME
- SERVER_PORT
- SERVER_PROTOCOL
- SERVER_ROOT
- SERVER_SOFTWARE
In addition, HTTP headers sent by the server may be passed in the
environment as well. Here are some common variable names:
- HTTP_ACCEPT
- HTTP_CONNECTION
- HTTP_HOST
- HTTP_PRAGMA
- HTTP_REFERER
- HTTP_USER_AGENT
N( u print( ( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu print_environ_usageØ s 'c C sh t d t d d ƒ| j d d ƒ } | j d d ƒ } | j d d ƒ } | rd | j d
d ƒ } n | S( u Deprecated API.u1 cgi.escape is deprecated, use html.escape insteadu
stackleveli u &u &u u >u "u "( u warnu DeprecationWarningu replace( u su quote( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu escape s
c C s: d d l } t | t ƒ r$ d } n d } | j | | ƒ S( Ni s ^[ -~]{0,200}[!-~]$u ^[ -~]{0,200}[!-~]$( u reu
isinstanceu bytesu match( u su _vb_patternu re( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu valid_boundary s
u valid_boundaryu __main__(2 u __doc__u __version__u iou StringIOu BytesIOu
TextIOWrapperu collectionsu Mappingu sysu osu urllib.parseu urllibu email.parseru
FeedParseru
email.messageu Messageu warningsu warnu htmlu localeu tempfileu __all__u logfileu Noneu logfpu initlogu dologu nologu closelogu logu maxlenu environu parseu parse_qsu parse_qslu parse_multipartu _parseparamu parse_headeru MiniFieldStorageu FieldStorageu testu print_exceptionu
print_environu
print_formu print_directoryu print_argumentsu print_environ_usageu escapeu valid_boundaryu __name__( ( ( u( /opt/alt/python33/lib64/python3.3/cgi.pyu s\ # E d ÿ ÿ
' /