z fc @ s d Z d Z d d l m Z d d l Z d d l Z d d l Z d d l Z d d l m Z m
Z
m Z e
I e j r e d d e
e d d e
n d d l Z d d l Z Wd QXy d d l m Z Wn! e k
r d d l m Z n Xd
d d d
d d d d d d d d d d d d d d g Z d Z e a d Z d Z d Z e a d a e e j d d e d! Z d d e d" Z d d e e d# Z d$ Z d% Z! d& Z" d
f d' YZ# d f d( YZ$ d e j f d) YZ% d
e% f d* YZ& d e& f d+ YZ' d e% f d, YZ( e j d- Z) e e e e d. Z* e j d/ Z+ d0 Z, d1 Z- d2 Z. d3 Z/ e d4 Z0 d5 d6 Z1 e2 d7 k re) n d S(8 s Support module for CGI (Common Gateway Interface) scripts.
This module defines a number of utilities for use by CGI scripts
written in Python.
s 2.6i( t
attrgetterN( t filterwarningst catch_warningst warnt ignores .*mimetools has been removeds .*rfc822 has been removed( t StringIOt MiniFieldStoraget FieldStoraget FormContentDictt SvFormContentDictt InterpFormContentDictt FormContentt parset parse_qst parse_qslt parse_multipartt parse_headert print_exceptiont
print_environt
print_formt print_directoryt print_argumentst print_environ_usaget escapet c G sZ t r7 t r7 y t t d a Wq7 t k
r3 q7 Xn t sF t a n t a t | d S( s 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).
t aN( t logfilet logfpt opent IOErrort nologt logt dolog( t allargs( ( s /usr/lib64/python2.7/cgi.pyt initlogG s
c G s t j | | d d S( s= Write a log message to the log file. See initlog() for docs.s
N( R t write( t fmtt args( ( s /usr/lib64/python2.7/cgi.pyR j s c G s d S( s9 Dummy function, assigned to log when logging is disabled.N( ( R! ( ( s /usr/lib64/python2.7/cgi.pyR n s i c C s | d k r t j } n d | k r1 d | d R9 R: R- ( ( s /usr/lib64/python2.7/cgi.pyR
s
c C s, t d t d t j | | | | d | S( s) Parse a query given as a string argument.s; cgi.parse_qsl is deprecated, use urlparse.parse_qsl insteadi R- ( R R? R6 R ( R> R9 R: t max_num_fieldsR- ( ( s /usr/lib64/python2.7/cgi.pyR s
c C s d } d | k r | d } n t | s> t d | f n d | } d | d } i } d } x'| | k rd } d } | rt j | } | j d }
|
r y t |
} Wq t k
r q Xn | d k r
t r | t k r t d n | j | } qd } n g } xb | j } | s8| } Pn | d d k rm| j
} | | | f k rmPqmn | j | q W| d k rqe n | d k r| r| d } | d
d k r| d
} n | d d k r| d } n | | d t cdispR< R; t clen( ( s /usr/lib64/python2.7/cgi.pyRh s !
c C s d | j | j | j f S( s" Return a printable representation.s FieldStorage(%r, %r, %r)( RB Rm Rf ( Rg ( ( s /usr/lib64/python2.7/cgi.pyRi s c C s t | j S( N( t itert keys( Rg ( ( s /usr/lib64/python2.7/cgi.pyt __iter__ s c C sx | d k r t | n | j rS | j j d | j j } | j j d n! | j d k rn | j } n d } | S( NRf i ( t AttributeErrorRp t seekR4 Rn R. ( Rg RB Rf ( ( s /usr/lib64/python2.7/cgi.pyt __getattr__ s c C s | j d k r t d n g } x0 | j D]% } | j | k r+ | j | q+ q+ W| sf t | n t | d k r | d S| Sd S( s Dictionary style indexing.s
not indexablei i N( Rn R. t TypeErrorRB RI t KeyErrorRZ ( Rg RT t foundt item( ( s /usr/lib64/python2.7/cgi.pyt __getitem__ s c C sS | | k rK | | } t | t g k rA t t d | S| j Sn | Sd S( s8 Dictionary style get() method, including 'value' lookup.Rf N( Ro t mapR Rf ( Rg RT t defaultRf ( ( s /usr/lib64/python2.7/cgi.pyt getvalue, s
c C sK | | k rC | | } t | t g k r9 | d j S| j Sn | Sd S( s! Return the first value received.i N( Ro Rf ( Rg RT R Rf ( ( s /usr/lib64/python2.7/cgi.pyt getfirst7 s
c C sV | | k rN | | } t | t g k rA t t d | S| j g Sn g Sd S( s Return list of received values.Rf N( Ro R R Rf ( Rg RT Rf ( ( s /usr/lib64/python2.7/cgi.pyt getlistB s
c C s8 | j d k r t d n t t d | j D S( s Dictionary style keys() method.s
not indexablec s s | ] } | j Vq d S( N( RB ( t .0R ( ( s /usr/lib64/python2.7/cgi.pys Q s N( Rn R. R t set( Rg ( ( s /usr/lib64/python2.7/cgi.pyR M s c s8 | j d k r t d n t f d | j D S( s" Dictionary style has_key() method.s
not indexablec 3 s | ] } | j k Vq d S( N( RB ( R R ( RT ( s /usr/lib64/python2.7/cgi.pys W s N( Rn R. R t any( Rg RT ( ( RT s /usr/lib64/python2.7/cgi.pyt has_keyS s c s8 | j d k r t d n t f d | j D S( s% Dictionary style __contains__ method.s
not indexablec 3 s | ] } | j k Vq d S( N( RB ( R R ( RT ( s /usr/lib64/python2.7/cgi.pys ] s N( Rn R. R R ( Rg RT ( ( RT s /usr/lib64/python2.7/cgi.pyt __contains__Y s c C s t | j S( s Dictionary style len(x) support.( RZ R ( Rg ( ( s /usr/lib64/python2.7/cgi.pyt __len___ s c C s
t | j S( N( t boolRn ( Rg ( ( s /usr/lib64/python2.7/cgi.pyt __nonzero__c s c C s | j j | j } | j r2 | d | j 7} n t j | | j | j | j | j } g | D] \ } } t
| | ^ q` | _ | j d S( s+ Internal: read data in query string format.R, N(
R7 R4 Ry Rv R6 R R9 R: R@ R- R Rn t
skip_lines( Rg R> t queryRT Rf ( ( s /usr/lib64/python2.7/cgi.pyR{ f s +c
C s | j } t | s( t d | f n g | _ | j r t j | j | j | j | j | j
} | j j d | D d } n | j } | d k r | t
| j 8} n | j p | j } | | j i | | | | | } x | j st j | j }
| | j |
| | | | | d | j
} | d k r| d 8} | j rb| t
| j 8} n | d k rt d qn | j j | q W| j d S( s/ Internal: read a part that is itself multipart.s& Invalid boundary in multipart form: %rc s s$ | ] \ } } t | | Vq d S( N( R ( R RT Rf ( ( s /usr/lib64/python2.7/cgi.pys s R- i i s Max number of fields exceededN( Rx RC R3 Rn Rv R6 R R9 R: R@ R- t extendR. RZ t FieldStorageClasst __class__R7 Rz t rfc822RE RI R ( Rg R8 R9 R: t ibR R R@ t klasst partRQ ( ( s /usr/lib64/python2.7/cgi.pyR| s sD
c C sD | j d k r& | j | j n
| j | j j d d S( s Internal: read an atomic part.i N( Ry t read_binaryR t
read_linesRp R ( Rg ( ( s /usr/lib64/python2.7/cgi.pyR} s
i i c C s | j d | _ | j } | d k r xd | d k r | j j t | | j } | sg d | _ Pn | j j | | t | } q* Wn d S( s Internal: read binary data.t bi iN(
t make_fileRp Ry R7 R4 t mint bufsizeRz R# RZ ( Rg t todoRP ( ( s /usr/lib64/python2.7/cgi.pyR s c C s7 t | _ | _ | j r) | j n
| j d S( s0 Internal: read lines until EOF or outerboundary.N( R Rp t _FieldStorage__fileRw t read_lines_to_outerboundaryt read_lines_to_eof( Rg ( ( s /usr/lib64/python2.7/cgi.pyR s
c C s| | j d k rh | j j t | d k rh | j d | _ | j j | j j d | _ qh n | j j | d S( Ni R ( R R. t tellRZ R Rp R# R ( Rg RS ( ( s /usr/lib64/python2.7/cgi.pyt __write s c C s= x6 | j j d } | s( d | _ Pn | j | q Wd S( s Internal: read lines until EOF.i i iNi ( R7 RG Rz t _FieldStorage__write( Rg RS ( ( s /usr/lib64/python2.7/cgi.pyR s c C s^ d | j } | d } d } t } x4| j j d } | sK d | _ Pn | d k rj | | } d } n | d d k r | r | j } | | k r Pn | | k r d | _ Pq n | } | d d k r d } | d } t } n^ | d d
k rd
} | d } t } n5 | d d k r9d } | d } t } n d } t } | j | | q& Wd S(
s) Internal: read lines until outerboundary.s --R i i is
i is
s
Ni ( Rw t TrueR7 RG Rz RH t FalseR ( Rg R` t lastt delimt last_line_lfendRS t strippedlinet odelim( ( s /usr/lib64/python2.7/cgi.pyR sF
c C s | j s | j r d Sd | j } | d } t } x | j j d } | s\ d | _ Pn | d d k r | r | j } | | k r Pn | | k r d | _ Pq n | j d } q7 Wd S( s5 Internal: skip lines until outer boundary if defined.Ns --i i ii s
i ( Rw Rz R R7 RG RH t endswith( Rg R` R R RS R ( ( s /usr/lib64/python2.7/cgi.pyR s$
c C s d d l } | j d S( s 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 'binary' argument is unused -- the file is always opened
in binary mode.
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.
iNs w+b( t tempfilet
TemporaryFile( Rg t binaryR ( ( s /usr/lib64/python2.7/cgi.pyR s Ni ( Rj Rk Rl R. t osR8 Rh Ri R R R R R R R R R R R R{ R R| R} R R R R R R R R ( ( ( s /usr/lib64/python2.7/cgi.pyR d s8 ) x
,
) c B s& e Z d Z e j d d d d Z RS( sx Form content as dictionary with a list of values per field.
form = FormContentDict()
form[key] -> [value, value, ...]
key in form -> Boolean
form.keys() -> [key, key, ...]
form.values() -> [[val, val, ...], [val, val, ...], ...]
form.items() -> [(key, [val, val, ...]), (key, [val, val, ...]), ...]
form.dict == {key: [val, val, ...], ...}
i c C s< t d | d | d | d | | _ | _ | d | _ d S( NR8 R9 R: R- R+ ( R t dictRP t query_string( Rg R8 R9 R: R- ( ( s /usr/lib64/python2.7/cgi.pyRh ; s
N( Rj Rk Rl R R8 R. Rh ( ( ( s /usr/lib64/python2.7/cgi.pyR . s c B s2 e Z d Z d Z d Z d Z d Z RS( s Form content as dictionary expecting a single value per field.
If you only expect a single value for each field, then form[key]
will return that single value. It will raise an IndexError if
that expectation is not true. If you expect a field to have
possible multiple values, than you can use form.getlist(key) to
get all of the values. values() and items() are a compromise:
they return single strings where there is a single value, and
lists of strings otherwise.
c C s4 t | j | d k r% t d n | j | d S( Ni s expecting a single valuei ( RZ R t
IndexError( Rg RT ( ( s /usr/lib64/python2.7/cgi.pyR O s c C s | j | S( N( R ( Rg RT ( ( s /usr/lib64/python2.7/cgi.pyR S s c C sW g } xJ | j j D]9 } t | d k rB | j | d q | j | q W| S( Ni i ( R t valuesRZ RI ( Rg t resultRf ( ( s /usr/lib64/python2.7/cgi.pyR U s c C si g } x\ | j j D]K \ } } t | d k rN | j | | d f q | j | | f q W| S( Ni i ( R t itemsRZ RI ( Rg R RT Rf ( ( s /usr/lib64/python2.7/cgi.pyR \ s ( Rj Rk Rl R R R R ( ( ( s /usr/lib64/python2.7/cgi.pyR C s
c B s) e Z d Z d Z d Z d Z RS( s7 This class is present for backwards compatibility only.c C ss t j | | } | d d k ri y t | SWqi t k
re y t | SWqf t k
ra qf Xqi Xn | j S( Ni s
0123456789+-.( R R R1 R3 t floatRH ( Rg RT t v( ( s /usr/lib64/python2.7/cgi.pyR g s
c C s^ g } xQ | j D]C } y | j | | Wq t k
rU | j | j | q Xq W| S( N( R RI R R ( Rg R RT ( ( s /usr/lib64/python2.7/cgi.pyR o s
c C sj g } x] | j D]O } y | j | | | f Wq t k
ra | j | | j | f q Xq W| S( N( R RI R R ( Rg R RT ( ( s /usr/lib64/python2.7/cgi.pyR w s
"( Rj Rk Rl R R R ( ( ( s /usr/lib64/python2.7/cgi.pyR
e s c B sD e Z d Z d Z d Z d Z d Z d Z d Z RS( s7 This class is present for backwards compatibility only.c C s" | | j k r | j | Sd Sd S( N( R R. ( Rg RT ( ( s /usr/lib64/python2.7/cgi.pyR s c C sF | | j k r> t | j | | k r7 | j | | Sd Sn d Sd S( N( R RZ R. ( Rg RT t location( ( s /usr/lib64/python2.7/cgi.pyt
indexed_value s
c C s& | | j k r | j | d Sd Sd S( Ni ( R R. ( Rg RT ( ( s /usr/lib64/python2.7/cgi.pyRf s c C s t | j | S( N( RZ R ( Rg RT ( ( s /usr/lib64/python2.7/cgi.pyRy s c C s, | | j k r$ | j | d j Sd Sd S( Ni ( R RH R. ( Rg RT ( ( s /usr/lib64/python2.7/cgi.pyt stripped s c C s | j S( N( R ( Rg ( ( s /usr/lib64/python2.7/cgi.pyt pars s ( Rj Rk Rl R R Rf Ry R R ( ( ( s /usr/lib64/python2.7/cgi.pyR s c C s d GHHt j t _ yW t } t t t | t | t d } | d } d GH| Wn t n Xd GHd a
y/ t } t t t | t | Wn t n Xd S( s Robust test CGI script, usable as main program.
Write minimal HTTP headers and dump all information provided to
the script in HTML form.
s Content-type: text/htmlc R s d d Ud S( Ns, testing print_exception() -- italics?( ( ( ( s /usr/lib64/python2.7/cgi.pyR] s c S s | d S( N( ( R] ( ( s /usr/lib64/python2.7/cgi.pyt g s s9 What follows is a test, not an actual exception:
s* Second try with a small maxlen...
i2 N( R/ t stdoutt stderrR R R R R R R R2 ( R8 t formR] R ( ( s /usr/lib64/python2.7/cgi.pyt test s4
c C s | d k r$ t j \ } } } n d d l } Hd GH| j | | | j | | } d t d j | d t | d f GH~ d S( Nis+ Traceback (most recent call last):
s %s%s
R ( R. R/ t exc_infot tracebackt format_tbt format_exception_onlyR RJ ( Ro Rf t tbt limitR Rn ( ( s /usr/lib64/python2.7/cgi.pyR s c C s] | j } | j Hd GHd GHx/ | D]' } d Gt | Gd Gt | | GHq( Wd GHHd S( s# Dump the shell environment as HTML.s Shell Environment:
s s - s
- s
N( R t sortR ( R8 R RT ( ( s /usr/lib64/python2.7/cgi.pyR s
%c C s | j } | j Hd GH| s* d GHn d GHx^ | D]V } d t | d G| | } d t t t | d GHd t t | GHq6 Wd GHHd
S( s$ Dump the contents of a form as HTML.s Form Contents:
s No form fields.s
s - t :s s s
- s
N( R R R t reprRo ( R R RT Rf ( ( s /usr/lib64/python2.7/cgi.pyR s
c C sT Hd GHy t j } Wn+ t j k
rC } d Gt t | GHn Xt | GHHd S( s# Dump the current directory as HTML.s# Current Working Directory:
s os.error:N( R t getcwdt errorR t str( t pwdt msg( ( s /usr/lib64/python2.7/cgi.pyR s c C s Hd GHHt j GHHd S( Ns Command Line Arguments:
( R/ R5 ( ( ( s /usr/lib64/python2.7/cgi.pyR s
c C s d GHd S( s9 Dump a list of environment variables used by CGI as HTML.s
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( ( ( ( s /usr/lib64/python2.7/cgi.pyR s )c C sU | j d d } | j d d } | j d d } | rQ | j d d } n | S( s Replace special characters "&", "<" and ">" to HTML-safe sequences.
If the optional flag quote is true, the quotation mark character (")
is also translated.R, s &t s >RW s "( Rb ( R[ t quote( ( s /usr/lib64/python2.7/cgi.pyR / s s ^[ -~]{0,200}[!-~]$c C s d d l } | j | | S( Ni( t ret match( R[ t _vb_patternR ( ( s /usr/lib64/python2.7/cgi.pyRC : s t __main__(3 Rl t __version__t operatorR R/ R t UserDictR6 t warningsR R R t py3kwarningt DeprecationWarningRD R t cStringIOR t ImportErrort __all__R R. R R" R R R R2 R8 R R
R R R^ R R R R R R
R R R R R R R R R RC Rj ( ( ( s /usr/lib64/python2.7/cgi.pyt sr
# : a " ' /