From ce9b596c04626c734993106acf4ccebd517a71d8 Mon Sep 17 00:00:00 2001 From: Senthil Kumaran Date: Sun, 19 Jun 2011 16:56:49 -0700 Subject: Fix closes Issue12315 - Updates to http.client documentation. --- Doc/library/http.client.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index 704585b..d16b808 100644 --- a/Doc/library/http.client.rst +++ b/Doc/library/http.client.rst @@ -543,6 +543,9 @@ statement. A debugging hook. If :attr:`debuglevel` is greater than zero, messages will be printed to stdout as the response is read and parsed. +.. attribute:: HTTPResponse.closed + + Is True if the stream is closed. Examples -------- @@ -555,7 +558,15 @@ Here is an example session that uses the ``GET`` method:: >>> r1 = conn.getresponse() >>> print(r1.status, r1.reason) 200 OK - >>> data1 = r1.read() + >>> data1 = r1.read() # This will return entire content. + >>> # The following example demonstrates reading data in chunks. + >>> conn.request("GET", "/index.html") + >>> r1 = conn.getresponse() + >>> while not r1.closed: + ... print(r1.read(200)) # 200 bytes + b'>> # Example of an invalid request >>> conn.request("GET", "/parrot.spam") >>> r2 = conn.getresponse() >>> print(r2.status, r2.reason) -- cgit v0.12 Y[lS m&l_u#ۡDY]ƗlUk{>M;_xfloo=->҂HHUj $KG}ww%l w44zS qWA@w=*>t ۀ-CF J z}ulո. }]/W}g;U78h^}6kmU:/穆>1h AҀr'{^:>5Z(-恦y==Xkmuu{ ԗ^P" ^Kc}u{]'}R+K!k*:̮Ym U@{mF.7Ϧg] >|w^!"ѵ7b׾zb뻹|>go Mh@ M144IF=4F%2B ! Fi=Sja4zF@c@bba442MIMOCD&žIhҏ1iOM2O)b5$24&ͨ!%D"bOSħMGMz6SPhM44i2 z544ɈeR{BShz4R" d4ɦUO1!MSz'A驣F|o-dsTKEm/byԯ 7vJIμ$O{OGS?ط}А=~ !*&J3&*"`EQT òa8}__P~2 @̕=smWyҝj9bK5+jU$bɷ%ne沇.rjjv΄!!! jb4 SQM P "4D f9p "T! rⴲ(8C. *>YC~ wӐJPBت.ѓ@+텵v;@>Xjۖ7(> !ITIP=_,k{WK“^UAzؕm䂦θ_)E+oەfm7jrm|z @ODbQ,fLO)xk k.u/]BHOowfo(% jD I8nΛʚx;x$h/4CA~ )Gs'-DžA 3^D.ZGDv)lAp'g>Z>H{^ O7?~WŒ]⛗;㛲P1v6 ޠ`IY;PR(~.`^̮^{ 5s I>4UZLlru`uXi,(!/k ^zx9WWxbSȋQ'o?Oou\d?#NT* ssTHBAxoR\rb[QDC[qaP^u~٧r?ωD=8E}"QpLt97py!Bg 'K'/gGvYM/k)~/ڔuo!WSΝ&[NXzOkˡǢ?{uÙEy0Dxɠ)O%2gd -w<#U >YѣtCC}T{~Wrmr)7cC(bHo=$^ˉd| ׎xvzc!29Z25?}OItI!=^\܁pyib& r@b  &4iT AiXA;f q>lH7 ǖ<٥}x? OvpR2cl{Ɖ8zfY`eT{&ckɓpē4!@SɭE窤mp;F!\<}/6s BE?/.^v:(r$J)k25{_G%XRIU 0A}=흶C1ö!gMr^" U_D[8Òp4L \ ޷KBx珑(h_ryh!ރ7w'PH3TVxitco_!w=>5հ~Cwr?uk]Ty _GL!$UE+E2 _}뗓~/EHVܪQ6}^V4uR9&hG}ЏfAГ&q(r47TQU1$VZ*u_1QK>$3Xd|drcJo.\ H'2 \޵# $"/9=`AJ) F8O(Cg>X&&2FN6bR/94CɁ%r: =`P^t7CF92dH`w|v;ێ/ #m(4/Μ# AS!IhxI (?sO^/3?=?D!B% =W_5~ {Wtx߇9{ӾB[8ZDo@4A?3V#֌r.{H|=\U]d~gH8qm%I2#?^6YJV!O``[I|RL9]g{(Uܶ4> d5*ItᤆD$!$_|}yI6\?E(:HtzQrjn!_'e|s} ޢޜ#gTs٨N~/R?:;̐o|%==V/wNMIc?[qk$j\~,E}K_o7/GԵz~c;m$:OHw tNS=vګd~1 ٛʘ?|vy|'9ﯷ/#uޟ>:(u^+VZP3ZwuT>?"L`_NMh87O8?<>Ο?{a2+/x,>, l3l;|1:s*DպLə).ͮi{S8Kqk=W;^b%,&/⎬ GVǷ9=%FkZU!)9̩}ۃ޴4f9.,gue *a"<>gͻr[.apOt!5[ z0=ةH%r#b)%<+Bs~DպW<fZC$MMM:G ׏x8Ɛ΄!C3Nv =3oz v'N#̽t bKaOÌDkaL1y)tNJ-ZZaΘZM3tfn7_+SŇ:zӠ&o|\w6ZYp).31:JprLgCxF҄IQфL`6!a;*#ʎZ 4$K\5n%͹ѷ$~!MOx=F>⽂m#BINmY!c`cYՌX_A)zy|ZQ 3:Áuxo;[Swk׋Za2)&=<8":91X6-.w[v.o.幊d[Z=iEI$:faym[MbۊR֏s ])yFF;6aDIði\.n880<}vlވwl]FSܾN΍C/k%Npky+B:9&J2Hi<+g::#g(y|2"J @7Aϣn"txq!S"~*sՖ<|<}r-^/[ ,ٮrvw iT$tcp_,4ɺy#Û  !`үˉL{֟mzYt>iطb"KǶl={D۳ǧǎ۠:4^^c|0 8 lW'P^PdYKffxy>!q/ p<{ܟ=ηnCdǜq8nұwU}}%&<ЗdzޯԱǝ=Wͫ7lXX':q)y prrۻ7|=#|~- 6Fh\Mo{Z 4ƔtȣI${n<WNgƽ p!7Ɉ&mq.iPyw9#"h0fxs&?jaar "v@$ yi3oy{PZǗɐ3~y6}ڎ0 ۾D$|-{Մ6*(Iݤwv~O5u뻕p39|ϣViJQ-1~2ͭ\l"u (JB hRJjZ »yݎ19v{! @S8|wc&|r );J^VoG, o9\k4ŻpbjZj׻%Uۺ.aʨdU6WS*<+ʮu>7u[ϊRΪu2Bm))ʹD xwQqxYћ|Ոl_Oy.(.?d]=Y׆d):5zg"L$\5?8 ԸV]&&H166*, ;Ya{{`k{mʠbVUĶm[TIsZ핥,KR%\E(WD'8[vmrfz(f8}cNuDÿ ctX+tС{aYD6Sl_sE˻y(GC$Wh'[NjϧqiuWzwKP4 -)Dac:-F~f⿛:"_|a |W;r1URD=m֛s .9n3ƝSɳiZV6҅uwtUhmq[syزSCkiHJ25l{u}ﰴ~%n?i[TTa fp>߄MsQ_P %ZqQ8=Trb֎*2(sD~q(]w_;dxOZQ P~/K~S|;ש{`UJL9s6zgJ$[_ \)Ye}$)&񓑕d<#pmJ^'m z00R(DƧ>9>_W)v?a a H:2wIL+Ke{břtvQ"10 I ,7g)tx~6IztB0yKKwN$t?0bGM0њT9JN~c=-U* Qa|pDs'ǫ^SjM7rM'VOî"?%^()æE:7r *N C3X]Ꞽ|f3 ?s1%X`k'߭)G]bCX@,~o^n_T8uo%> >s^#sdidyg/C5:NNU7*b3aC >HpI)U"4Ԕr<82F^C%<=zĿMӵ 4mdkH "4)@HsD| -S PPIX̵㚟ld*"$N\:bMmɞv={`eC"#* ^Dx]fg;8r'Zf Ex2mm4~&O}^1όVI%=;K޴rl1 7 |DO;:(!\*O_]m,Z7T+)ywa[}rz_g*}$3|Bzk3쥲Υ3_9dI9ħQOb?BeP udvJ_Jt'_W0Oq^>|r'JSM 5Rf-Pq|\eWڙ]ᅤ%4Lt&`R i<1DnyB2z0{-~MEA]i仞̓mٰ?cH|0|^~oǣ R)O?WiJd9RTBPU%'1*Lݿo{3z$75ؘ~~s,|WYݯC2I+?Օ|/p5e0a-.SI`IHIDm7r)Fbco}'zfRCZ'b+6*mx\009a_Gz 6\[ImnCҁҎ!-қz3u$/i|~(-ޱ9FgG·ui| F|i<]*&]ī[8U*Ы B"v24^lγw v}z󔰀t:{^\x;kVCu+9f^|f h֤ImhYOGFôa|o3\EM*S'K ,"7伊c'1כMbo8gG8e3e)]Ex䥍<. t'eZAU[S3[M#^_ΟKrxO>jM?mrO4Ra]E's)8# iq~8M:Ҧ56fJs}֕s(0%7+\ryN%V# ৔o{FXUM5^\7Rtg\`tq/w8NIբoO h߫ ТއhYqϏ>zޝP" y_ t]S]5`(YJhIkcFCxZq8@ͻ ;ywX%K ٜ|}o2䜂F@U"hRBFTQvE`n9rE,.UP:l7f@ O&$sO$df7 @#xEvwWr~Oʇiz3%X-9uqs'p&c5}==ats)ñマ>~~;@T*0QE\"sUvi:}9/L=sy_WҒ0:_`05#@4`;]?nu(7=Q'*;>oOW0䞮#)$:flb=3Aڝ6۟6Zg'IS>d0drnv=g΢t/vogṕ,;nuYf1lâمZ1(8nG= \L0j &ffܘb}&jS3e;vөz$!RNi{z?gP8Ã$iKd0K,n3Lq|7qj&(ׇahbib1!0d:uyh0^(8 6}5ƣ0 A$hpȊɯA݃4Qua*333LBD/ꋴ"j GaA )F7 0dRIhTR@%B>`Ŕ\ Ud %(Ҋ! ;HJAߵ" ʤ '`:T+^a 83Pό9#H`-[};Ɇ~2B"I` D5y!rZi&b*C:i) J$dbh} X( PT=~oIx*Bdzxɓ _ԏ,"H4S BA}ߧ3C;G $(朅*e$(bbb"hF"V h+`@LRh4Nɚ )*/ibDSAHSFIH " jf!"Xʉ&&&"&%f*I"XNJ!634PC#PT,4PAC0LB EM'pIyu**X)hh"*aH $& )7Y(e_(H$" )Yh"P>H$*D)$TR$MRDJ PIh(`ei(" *J"f"j X**""" &( I "hET)$@rA|R\vK M@rf`?`O:iCDfSLDÙ)L!I/8qGIM(gyݰMCuCbS@<;$C'qJ' J&|y@np7v ^X\ъ)̶U(OS#@%`W͗7ɠ;#>(]D"*b&ć_Vm;JJ@'yq}};k*3 ܗrO-# z'%'Yچ{cy}N&D?ԑcLIi~V??VS%ڊC;.1ࠎ;NFrQ]QurwI!?2P[SlWme.J$>eZF$6g9f'{cW:%`*4*JLA.ӯ˺