Lc @ s d Z d d k l Z d d k Z d d k Z d d k l Z d d k l Z d d k Z e i i
i z. e o e i d d e
n d d k Z Wd QXy d d k l Z Wn# e j
o d d k l Z n Xd d
d d d
d d d d d d d d d d d d g Z d Z d Z d Z d Z d Z d Z d Z d! Z d" Z d# Z d$ Z d% Z d& Z d' Z d( Z! d) Z" d* Z# d+ Z$ d, Z% d- Z& d. Z' d/ Z( d0 Z) d1 Z* d2 Z+ d3 Z, d4 Z- d5 Z. d6 Z/ d7 Z0 d8 Z1 d9 Z2 d: Z3 d; Z4 d< Z5 d= Z6 d> Z7 d? Z8 d@ Z9 dA Z: dB Z; dC Z< dD Z= dE Z> dF Z? dG Z@ dH ZA dI ZB dJ ZC dK ZD dL ZE dM ZF dN ZG dO ZH dP ZI h) dQ d 6dR d! 6dS d# 6dT d$ 6dU d% 6dV d& 6dW d' 6dX d( 6dY d) 6dZ d, 6d[ d- 6d\ d. 6d] d/ 6d^ d0 6d_ d1 6d` da 6db d2 6dc d3 6dd d4 6de d5 6df d6 6dg d7 6dh d8 6di d9 6dj d: 6dk d; 6dl d< 6dm d= 6dn d> 6do d? 6dp d@ 6dq dA 6dr dB 6ds dC 6dt dD 6du dI 6dv dJ 6dw dK 6dx dL 6dy dM 6dz dN 6ZJ d{ ZK d| ZL d ZM e iN d} iO ZP e iN d~ iQ ZR d e iS f d YZT d
f d YZU d f d YZV d f d YZW y d d kX ZX Wn e j
o nD Xd eV f d YZY e iZ d d eW f d YZ[ d Z\ d e] f d YZ^ d
e^ f d YZ_ d e^ f d YZ` d e^ f d YZa d e^ f d YZb d e^ f d YZc d e^ f d YZd d e^ f d YZe d ee f d YZf d ee f d YZg d ee f d YZh d e^ f d YZi d e^ f d YZj e^ Zk d f d YZl d Zm en d j o em n d S( s HTTP/1.1 client library
HTTPConnection goes through a number of "states", which define when a client
may legally make another request or fetch the response for a particular
request. This diagram details these state transitions:
(null)
|
| HTTPConnection()
v
Idle
|
| putrequest()
v
Request-started
|
| ( putheader() )* endheaders()
v
Request-sent
|
| response = getresponse()
v
Unread-response [Response-headers-read]
|\____________________
| |
| response.read() | putrequest()
v v
Idle Req-started-unread-response
______/|
/ |
response.read() | | ( putheader() )* endheaders()
v v
Request-started Req-sent-unread-response
|
| response.read()
v
Request-sent
This diagram presents the following rules:
-- a second request may not be started until {response-headers-read}
-- a response [object] cannot be retrieved until {request-sent}
-- there is no differentiation between an unread response body and a
partially read response body
Note: this enforcement is applied by the HTTPConnection class. The
HTTPResponse class does not enforce this state machine, which
implies sophisticated clients may accelerate the request/response
pipeline. Caution should be taken, though: accelerating the states
beyond the above pattern may imply knowledge of the server's
connection-close behavior for certain requests. For example, it
is impossible to tell whether the server will close the connection
UNTIL the response headers have been read; this means that further
requests cannot be placed into the pipeline until it is known that
the server will NOT be closing the connection.
Logical State __state __response
------------- ------- ----------
Idle _CS_IDLE None
Request-started _CS_REQ_STARTED None
Request-sent _CS_REQ_SENT None
Unread-response _CS_IDLE
Req-started-unread-response _CS_REQ_STARTED
Req-sent-unread-response _CS_REQ_SENT
i( t arrayN( t py3kwarning( t urlsplitt ignores .*mimetools has been removed( t StringIOt HTTPt HTTPResponset HTTPConnectiont
HTTPExceptiont NotConnectedt UnknownProtocolt UnknownTransferEncodingt UnimplementedFileModet IncompleteReadt
InvalidURLt ImproperConnectionStatet CannotSendRequestt CannotSendHeadert ResponseNotReadyt
BadStatusLinet errort responsesiP i t UNKNOWNt Idles Request-starteds Request-sentid ie if i i i i i i i i i i, i- i. i/ i0 i1 i3 i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i t Continues Switching Protocolst OKt Createdt Accepteds Non-Authoritative Informations
No Contents
Reset Contents Partial Contents Multiple Choicess Moved Permanentlyt Founds See Others Not Modifieds Use Proxys (Unused)i2 s Temporary Redirects Bad Requestt Unauthorizeds Payment Requiredt Forbiddens Not Founds Method Not Alloweds Not Acceptables Proxy Authentication Requireds Request Timeoutt Conflictt Gones Length Requireds Precondition Faileds Request Entity Too Larges Request-URI Too Longs Unsupported Media Types Requested Range Not Satisfiables Expectation Faileds Internal Server Errors Not Implementeds Bad Gateways Service Unavailables Gateway Timeouts HTTP Version Not Supportedi i s \A[^:\s][^:\r\n]*\Zs \n(?![ \t])|\r(?![ \t\n])t HTTPMessagec B s# e Z d Z d Z d Z RS( c C sV | i i | } | d j o | | i | RP t closet LineAndFileWrappert int( R& RI RT R2 RU ( ( s /usr/lib64/python2.6/httplib.pyt _read_status s8
c C s9 | i d j o d Sx t o | i \ } } } | t j o Pn xz t or | i i t d } t | t j o t d n | i
} | p Pn | i d j o
d G| GHqI qI Wq W| | _ | i
| _
| d j o
d | _ nD | i d o
d | _ n' | d j o
d
| _ n
t | | i d
j o2 d | _ d | _ d | _ t t | _ d St | i d | _ | i d j o# x | i i D] } d G| GqWn d | i _ | i i d } | o) | i d j o d | _ d | _ n
d | _ | i | _ | i i d
} | o^ | i oS y t | | _ Wn t j
o d | _ qX| i d j o
d | _ qn
d | _ | t j p; | t j p. d | j o
d j n p | i d j o
d | _ n | i o( | i o | i d j o
d | _ n d S( Ni s header linei s header:s HTTP/1.0i
s HTTP/1.i s HTTP/0.9i s transfer-encodingRV s content-lengthid i t HEAD( RR R$ R7 Rc t CONTINUER4 R; R< R8 R= R@ RO R2 RU RT R> R
RX RV RY R! R R1 t getheadert lowerRW t _check_closeRb R_ t
NO_CONTENTt NOT_MODIFIEDRQ ( R& RT R2 RU t skipt hdrt tr_encRX ( ( s /usr/lib64/python2.6/httplib.pyt begin sz
c C s | i i d } | i d j o6 | i i d } | o d | i j o t St S| i i d o t S| o d | i j o t S| i i d } | o d | i j o t St S( Nt
connectioni R` s
keep-alives proxy-connection( RR Rf RT Rg R7 t False( R& t connt pconn( ( s /usr/lib64/python2.6/httplib.pyRh s c C s( | i o | i i d | _ n d S( N( R4 R` R$ ( R& ( ( s /usr/lib64/python2.6/httplib.pyR` s
c C s
| i d j S( N( R4 R$ ( R& ( ( s /usr/lib64/python2.6/httplib.pyt isclosed# s c C s. | i d j o d S| i d j o | i d S| i o | i | S| d j oM | i d j o | i i } n | i | i } d | _ | i | S| i d j o! | | i j o
| i } q n | i i | } | i d j o1 | i t | 8_ | i p | i q*n | S( NR. Rd i (
R4 R$ RQ R` RV t
_read_chunkedRX t readt
_safe_readR8 ( R& t amtt s( ( s /usr/lib64/python2.6/httplib.pyRu . s.
c C s_ | i t j p t | i } g } xt o| d j o | i i t d } t | t j o t
d n | i d } | d j o | | } n y t | d } Wn2 t
j
o& | i t d i | n X| d j o Pq n | d j o | i | i | n | | j o1 | i | i | | | | _ d i | S| | j o: | i | i | | i d d | _ d i | S| i | i | | | 8} | i d d } q) Wxc t o[ | i i t d } t | t j o t
d n | p Pn | d j o PqqW| i d i | S(
Ni s
chunk sizet ;i i R. i s trailer lines
( RV RS t AssertionErrorRW R7 R$ R4 R; R< R8 R= t findRb R_ R` R
R% R? Rv ( R& Rw RW R( RI t i( ( s /usr/lib64/python2.6/httplib.pyRt R sZ
c C s g } xm | d j o_ | i i t | t } | p t d i | | n | i | | t | 8} q Wd i | S( sV Read the number of bytes requested, compensating for partial reads.
Normally, we have a blocking socket, but a read() can be interrupted
by a signal (resulting in a partial read).
Note that we cannot distinguish between EOF and an interrupt when zero
bytes have been read. IncompleteRead() will be raised in this
situation.
This function should be used when bytes "should" be present for
reading. If the bytes are truly not available (due to EOF), then the
IncompleteRead exception can be used to detect the problem.
i R. ( R4 Ru t mint MAXAMOUNTR
R% R? R8 ( R& Rw Rx t chunk( ( s /usr/lib64/python2.6/httplib.pyRv s
c C s0 | i d j o
t n | i i | | S( N( RR R$ R Rf ( R& t namet default( ( s /usr/lib64/python2.6/httplib.pyRf s
c C s* | i d j o
t n | i i S( s& Return list of (header, value) tuples.N( RR R$ R t items( R& ( ( s /usr/lib64/python2.6/httplib.pyt
getheaders s
N( RK RL R$ R\ Rc Rn Rh R` Rs Ru Rt Rv Rf R ( ( ( s /usr/lib64/python2.6/httplib.pyR g s
' V $ : c B s e Z d Z d Z e Z e Z d Z d Z d Z
d d e i
d Z d d d Z d Z d Z d Z d Z d
Z d Z d Z d
Z d d d Z d Z d Z d h d Z d Z d Z RS( i s HTTP/1.1i i c C s | | _ d | _ g | _ d | _ t | _ d | _ d | _ d | _ h | _
| i | | | d j o
| | _ n d S( N(
t timeoutR$ RZ t _buffert _HTTPConnection__responset _CS_IDLEt _HTTPConnection__stateRQ t _tunnel_hostt _tunnel_portt _tunnel_headerst
_set_hostportRP ( R& t hostt portRP R ( ( s /usr/lib64/python2.6/httplib.pyR\ s
c C s7 | | _ | | _ | o
| | _ n | i i d S( s Sets up the host and the port for the HTTP CONNECT Tunnelling.
The headers argument should be a mapping of extra HTTP headers
to send with the CONNECT request.
N( R R R t clear( R& R R R1 ( ( s /usr/lib64/python2.6/httplib.pyt _set_tunnel s
c C s | d j o | i d } | i d } | | j oT y t | | d } Wn+ t j
o t d | | d n X| | } n
| i } | o3 | d d j o" | d d j o | d d !} q n | | _ | | _ d S( Nt :t ]i s nonnumeric port: '%s'i t [i( R$ t rfindRb R_ R t default_portR R ( R& R R R| t j( ( s /usr/lib64/python2.6/httplib.pyR s
) c C s
| | _ d S( N( RO ( R& t level( ( s /usr/lib64/python2.6/httplib.pyt set_debuglevel s c C sH | i | i | i | i d | i | i f x4 | i i D]# \ } } | i d | | f qC W| i d | i | i d | i
d | i } | i \ } } } | d j o- | i
t i d | | i f n xW t oO | i i t d } t | t j o t d n | d j o Pq q Wd S(
Ns CONNECT %s:%d HTTP/1.0
s %s: %s
s
RP R[ i s Tunnel connection failed: %d %si s header line( R R R t sendR R R t iteritemst response_classRZ RP RQ Rc R` t socketR R@ R7 R4 R; R< R8 R= ( R& t headerR( t responseRT t codet messageRI ( ( s /usr/lib64/python2.6/httplib.pyt _tunnel s(
c C s@ t i | i | i f | i | _ | i o | i n d S( s3 Connect to the host and port specified in __init__.N( R t create_connectionR R R RZ R R ( R& ( ( s /usr/lib64/python2.6/httplib.pyt connect s
c C sU | i o | i i d | _ n | i o | i i d | _ n t | _ d S( s( Close the connection to the HTTP server.N( RZ R` R$ R R R ( R& ( ( s /usr/lib64/python2.6/httplib.pyR` s
c C s1 | i d j o% | i o | i q5 t n | i d j o d Gt | GHn y d } t | d ok t | t oZ | i d j o d GHn | i
| } x? | o# | i i | | i
| } q Wn | i i | Wn= t i
j
o. } | i d d j o | i n n Xd S( s Send `str' to the server.i s send:i Ru s sendIng a read()ablei N( RZ R$ t auto_openR R RO R] R3 t
isinstanceR Ru t sendallR R t argsR` ( R& t strt blocksizet datat v( ( s /usr/lib64/python2.6/httplib.pyR s*
! c C s | i i | d S( su Add a line of output to the current request buffer.
Assumes that the line does *not* end with \r\n.
N( R R? ( R& Rx ( ( s /usr/lib64/python2.6/httplib.pyt _output0 s c C s: | i i d d i | i } | i 2| i | d S( sp Send the currently buffered request and clear the buffer.
Appends an extra \r\n to the buffer.
R. s
N( R. R. ( R t extendR% R ( R& RR ( ( s /usr/lib64/python2.6/httplib.pyt _send_output7 s c
C s | i o | i i o
d | _ n | i t j o
t | _ n
t | | _ | p
d } n d | | | i f } | i | | i
d j o4| pd } | i d o t | \ } } } } } n | oL y | i
d } Wn" t j
o | i
d } n X| i d | qy | i i
d } Wn% t j
o | i i
d } n X| i | i j o | i d | q| i d d | | i f n | p | i d
d qn d S(
s` Send a request to the server.
`method' specifies an HTTP request method, e.g. 'GET'.
`url' specifies the object being requested, e.g. '/index.html'.
`skip_host' if True does not add automatically a 'Host:' header
`skip_accept_encoding' if True does not add automatically an
'Accept-Encoding:' header
t /s %s %s %si R. t httpt asciit idnat Hosts %s:%ss Accept-Encodingt identityN( R Rs R$ R R t _CS_REQ_STARTEDR RQ t
_http_vsn_strR t _http_vsnR> R t encodet UnicodeEncodeErrort putheaderR R R (
R& R[ t urlt skip_hostt skip_accept_encodingR t netloct nilt
netloc_enct host_enc( ( s /usr/lib64/python2.6/httplib.pyt
putrequestA s>
!
c C s | i t j o
t n d | } t | p t d | f n d | } t | o t d | f n d | | f } | i | d S( sk Send a request header line to the server.
For example: h.putheader('Accept', 'text/html')
s %ss Invalid header name %rs Invalid header value %rs %s: %sN( R R R t _is_legal_header_nameR_ t _is_illegal_header_valueR ( R& R R( R ( ( s /usr/lib64/python2.6/httplib.pyR s
c C s4 | i t j o
t | _ n
t | i d S( s? Indicate that the last header line has been sent to the server.N( R R t _CS_REQ_SENTR R ( R& ( ( s /usr/lib64/python2.6/httplib.pyt
endheaders s
c C su y | i | | | | WnT t i j
oE } | i d d j p | i o n | i | | | | n Xd S( s& Send a complete request to the server.i i N( t
_send_requestR R R R ( R& R[ R t bodyR1 R ( ( s /usr/lib64/python2.6/httplib.pyt request s c
C s t i g } | D] } | | i q ~ } h } d | j o d | d | i d j o d | i } n d } d t | i | f S( Ns , %i more expectedR. s IncompleteRead(%i bytes read%s)( R R$ R8 R ( R& R ( ( s /usr/lib64/python2.6/httplib.pyt __repr__ s c C s
t | S( N( R] ( R& ( ( s /usr/lib64/python2.6/httplib.pyt __str__ s N( RK RL R$ R\ R R ( ( ( s /usr/lib64/python2.6/httplib.pyR
s c B s e Z RS( ( RK RL ( ( ( s /usr/lib64/python2.6/httplib.pyR s c B s e Z RS( ( RK RL ( ( ( s /usr/lib64/python2.6/httplib.pyR s c B s e Z RS( ( RK RL ( ( ( s /usr/lib64/python2.6/httplib.pyR s c B s e Z RS( ( RK RL ( ( ( s /usr/lib64/python2.6/httplib.pyR s c B s e Z d Z RS( c C s | f | _ | | _ d S( N( R RI ( R& RI ( ( s /usr/lib64/python2.6/httplib.pyR\ s ( RK RL R\ ( ( ( s /usr/lib64/python2.6/httplib.pyR s R= c B s e Z d Z RS( c C s t i | d t | f d S( Ns& got more than %d bytes when reading %s( R R\ R< ( R& t line_type( ( s /usr/lib64/python2.6/httplib.pyR\ s ( RK RL R\ ( ( ( s /usr/lib64/python2.6/httplib.pyR= s Ra c B sJ e Z d Z d Z d Z d Z d d Z d Z d d Z RS( s2 A limited file-like object for HTTP/0.9 responses.c C s7 | | _ | | _ d | _ d | _ t | | _ d S( Ni ( t _linet _filet _line_consumedt _line_offsetR8 t
_line_left( R& RI R ( ( s /usr/lib64/python2.6/httplib.pyR\ s
c C s t | i | S( N( t getattrR ( R& t attr( ( s /usr/lib64/python2.6/httplib.pyt __getattr__ s c C s: d | _ | i i | _ | i i | _ | i i | _ d S( Ni ( R R Ru R; t readlines( R& ( ( s /usr/lib64/python2.6/httplib.pyt _done s c C s | i o | i i | S| i p t | d j p | | i j o[ | i | i } | i | d j o | | i i S| | i i | t | Snu | | i j p t | i } | | } | i | | !} | | _ | i | 8_ | i d j o | i n | Sd S( Ni (
R R Ru R Rz R$ R R R R8 ( R& Rw Rx R| R ( ( s /usr/lib64/python2.6/httplib.pyRu s$
"
c C sG | i o | i i S| i p t | i | i } | i | S( N( R R R; R Rz R R R ( R& Rx ( ( s /usr/lib64/python2.6/httplib.pyR; + s
c C s | i o | i i | S| i p t | i | i g } | i | d j o | | i i S| | i i | Sd S( N( R R R R Rz R R R R$ ( R& t sizet L( ( s /usr/lib64/python2.6/httplib.pyR 3 s
N(
RK RL R R\ R R R$ Ru R; R ( ( ( s /usr/lib64/python2.6/httplib.pyRa s c C s d d k } d d k } | i | i d d \ } } d } x/ | D]' \ } } | d j o | d } qD qD Wd } d } | d o | d } n | d o | d } n t } | i | | i | | i d | | i | i \ }
} } d
G|
GHd G| GHd Gt | i
i GHH| o# x | i D] }
|
i
GHq>Wn Hd
t f d Y} | d } | i d d | i | i | i y d d k } Wn t j
o n Xx d D] \ } } d | | f GHt } | i | | i | | i d | | i | i \ }
} } d
G|
GHd G| GHd Gt | i
i GHH| o# x | i D] }
|
i
GHqWn HqWd S( s Test this module.
A hodge podge of tests collected here, because they have too many
external dependencies for the regular test suite.
iNi t di s -ds www.python.orgR t GETs status =s reason =Ru t HTTP11c B s e Z d Z d Z RS( i s HTTP/1.1( RK RL R R ( ( ( s /usr/lib64/python2.6/httplib.pyR ^ s s http://www.python.org/~jeremy/s sourceforge.nets /projects/pythons https://%s%s( s sourceforge.nets /projects/python( ( s sourceforge.nets /projects/python( t syst getoptt argvR R R R R R R8 R Ru R1 R@ R` R t ImportErrorR ( R R t optsR t dlt ot aR t selectort hR2 RU R1 R R R t hs( ( s /usr/lib64/python2.6/httplib.pyt test> sr
t __main__(o R R t reR R R t urlparseR R t catch_warningst __exit__t __enter__t filterwarningsR t mimetoolst cStringIOR R t __all__R R RS R R R Re t SWITCHING_PROTOCOLSt
PROCESSINGR t CREATEDt ACCEPTEDt NON_AUTHORITATIVE_INFORMATIONRi t
RESET_CONTENTt PARTIAL_CONTENTt MULTI_STATUSt IM_USEDt MULTIPLE_CHOICESt MOVED_PERMANENTLYt FOUNDt SEE_OTHERRj t USE_PROXYt TEMPORARY_REDIRECTt BAD_REQUESTt UNAUTHORIZEDt PAYMENT_REQUIREDt FORBIDDENt NOT_FOUNDt METHOD_NOT_ALLOWEDt NOT_ACCEPTABLEt PROXY_AUTHENTICATION_REQUIREDt REQUEST_TIMEOUTt CONFLICTt GONEt LENGTH_REQUIREDt PRECONDITION_FAILEDt REQUEST_ENTITY_TOO_LARGEt REQUEST_URI_TOO_LONGt UNSUPPORTED_MEDIA_TYPEt REQUESTED_RANGE_NOT_SATISFIABLEt EXPECTATION_FAILEDt UNPROCESSABLE_ENTITYt LOCKEDt FAILED_DEPENDENCYt UPGRADE_REQUIREDt INTERNAL_SERVER_ERRORt NOT_IMPLEMENTEDt BAD_GATEWAYt SERVICE_UNAVAILABLEt GATEWAY_TIMEOUTt HTTP_VERSION_NOT_SUPPORTEDt INSUFFICIENT_STORAGEt NOT_EXTENDEDR R~ R< R9 t compilet matchR t searchR t MessageR! R R R R R R? R R t ExceptionR R R R
R R R
R R R R R R= R Ra R RK ( ( ( s /usr/lib64/python2.6/httplib.pyt C s6
m I yY
D A