PNG  IHDRX cHRMz&u0`:pQ<bKGD pHYsodtIME MeqIDATxw]Wug^Qd˶ 6`!N:!@xI~)%7%@Bh&`lnjVF29gΨ4E$|>cɚ{gk= %,a KX%,a KX%,a KX%,a KX%,a KX%,a KX%, b` ǟzeאfp]<!SJmɤY޲ڿ,%c ~ع9VH.!Ͳz&QynֺTkRR.BLHi٪:l;@(!MԴ=žI,:o&N'Kù\vRmJ雵֫AWic H@" !: Cé||]k-Ha oݜ:y F())u]aG7*JV@J415p=sZH!=!DRʯvɱh~V\}v/GKY$n]"X"}t@ xS76^[bw4dsce)2dU0 CkMa-U5tvLƀ~mlMwfGE/-]7XAƟ`׮g ewxwC4\[~7@O-Q( a*XGƒ{ ՟}$_y3tĐƤatgvێi|K=uVyrŲlLӪuܿzwk$m87k( `múcE)"@rK( z4$D; 2kW=Xb$V[Ru819קR~qloѱDyįݎ*mxw]y5e4K@ЃI0A D@"BDk_)N\8͜9dz"fK0zɿvM /.:2O{ Nb=M=7>??Zuo32 DLD@D| &+֎C #B8ַ`bOb $D#ͮҪtx]%`ES`Ru[=¾!@Od37LJ0!OIR4m]GZRJu$‡c=%~s@6SKy?CeIh:[vR@Lh | (BhAMy=݃  G"'wzn޺~8ԽSh ~T*A:xR[ܹ?X[uKL_=fDȊ؂p0}7=D$Ekq!/t.*2ʼnDbŞ}DijYaȲ(""6HA;:LzxQ‘(SQQ}*PL*fc\s `/d'QXW, e`#kPGZuŞuO{{wm[&NBTiiI0bukcA9<4@SӊH*؎4U/'2U5.(9JuDfrޱtycU%j(:RUbArLֺN)udA':uGQN"-"Is.*+k@ `Ojs@yU/ H:l;@yyTn}_yw!VkRJ4P)~y#)r,D =ě"Q]ci'%HI4ZL0"MJy 8A{ aN<8D"1#IJi >XjX֔#@>-{vN!8tRݻ^)N_╗FJEk]CT՟ YP:_|H1@ CBk]yKYp|og?*dGvzنzӴzjֺNkC~AbZƷ`.H)=!QͷVTT(| u78y֮}|[8-Vjp%2JPk[}ԉaH8Wpqhwr:vWª<}l77_~{s۴V+RCģ%WRZ\AqHifɤL36: #F:p]Bq/z{0CU6ݳEv_^k7'>sq*+kH%a`0ԣisqにtү04gVgW΂iJiS'3w.w}l6MC2uԯ|>JF5`fV5m`Y**Db1FKNttu]4ccsQNnex/87+}xaUW9y>ͯ骵G{䩓Գ3+vU}~jJ.NFRD7<aJDB1#ҳgSb,+CS?/ VG J?|?,2#M9}B)MiE+G`-wo߫V`fio(}S^4e~V4bHOYb"b#E)dda:'?}׮4繏`{7Z"uny-?ǹ;0MKx{:_pÚmFמ:F " .LFQLG)Q8qN q¯¯3wOvxDb\. BKD9_NN &L:4D{mm o^tֽ:q!ƥ}K+<"m78N< ywsard5+вz~mnG)=}lYݧNj'QJS{S :UYS-952?&O-:W}(!6Mk4+>A>j+i|<<|;ر^߉=HE|V#F)Emm#}/"y GII웻Jі94+v뾧xu~5C95~ūH>c@덉pʃ1/4-A2G%7>m;–Y,cyyaln" ?ƻ!ʪ<{~h~i y.zZB̃/,雋SiC/JFMmBH&&FAbϓO^tubbb_hZ{_QZ-sύodFgO(6]TJA˯#`۶ɟ( %$&+V'~hiYy>922 Wp74Zkq+Ovn錄c>8~GqܲcWꂎz@"1A.}T)uiW4="jJ2W7mU/N0gcqܗOO}?9/wìXžΏ0 >֩(V^Rh32!Hj5`;O28؇2#ݕf3 ?sJd8NJ@7O0 b־?lldщ̡&|9C.8RTWwxWy46ah嘦mh٤&l zCy!PY?: CJyв]dm4ǜҐR޻RլhX{FƯanшQI@x' ao(kUUuxW_Ñ줮[w8 FRJ(8˼)_mQ _!RJhm=!cVmm ?sFOnll6Qk}alY}; "baӌ~M0w,Ggw2W:G/k2%R,_=u`WU R.9T"v,<\Ik޽/2110Ӿxc0gyC&Ny޽JҢrV6N ``یeA16"J³+Rj*;BϜkZPJaÍ<Jyw:NP8/D$ 011z֊Ⱳ3ι֘k1V_"h!JPIΣ'ɜ* aEAd:ݺ>y<}Lp&PlRfTb1]o .2EW\ͮ]38؋rTJsǏP@芎sF\> P^+dYJLbJ C-xϐn> ι$nj,;Ǖa FU *择|h ~izť3ᤓ`K'-f tL7JK+vf2)V'-sFuB4i+m+@My=O҈0"|Yxoj,3]:cо3 $#uŘ%Y"y죯LebqtҢVzq¼X)~>4L׶m~[1_k?kxֺQ`\ |ٛY4Ѯr!)N9{56(iNq}O()Em]=F&u?$HypWUeB\k]JɩSع9 Zqg4ZĊo oMcjZBU]B\TUd34ݝ~:7ڶSUsB0Z3srx 7`:5xcx !qZA!;%͚7&P H<WL!džOb5kF)xor^aujƍ7 Ǡ8/p^(L>ὴ-B,{ۇWzֺ^k]3\EE@7>lYBȝR.oHnXO/}sB|.i@ɥDB4tcm,@ӣgdtJ!lH$_vN166L__'Z)y&kH;:,Y7=J 9cG) V\hjiE;gya~%ks_nC~Er er)muuMg2;֫R)Md) ,¶ 2-wr#F7<-BBn~_(o=KO㭇[Xv eN_SMgSҐ BS헃D%g_N:/pe -wkG*9yYSZS.9cREL !k}<4_Xs#FmҶ:7R$i,fi!~' # !6/S6y@kZkZcX)%5V4P]VGYq%H1!;e1MV<!ϐHO021Dp= HMs~~a)ަu7G^];git!Frl]H/L$=AeUvZE4P\.,xi {-~p?2b#amXAHq)MWǾI_r`S Hz&|{ +ʖ_= (YS(_g0a03M`I&'9vl?MM+m~}*xT۲(fY*V4x@29s{DaY"toGNTO+xCAO~4Ϳ;p`Ѫ:>Ҵ7K 3}+0 387x\)a"/E>qpWB=1 ¨"MP(\xp߫́A3+J] n[ʼnӼaTbZUWb={~2ooKױӰp(CS\S筐R*JغV&&"FA}J>G֐p1ٸbk7 ŘH$JoN <8s^yk_[;gy-;߉DV{c B yce% aJhDȶ 2IdйIB/^n0tNtџdcKj4϶v~- CBcgqx9= PJ) dMsjpYB] GD4RDWX +h{y`,3ꊕ$`zj*N^TP4L:Iz9~6s) Ga:?y*J~?OrMwP\](21sZUD ?ܟQ5Q%ggW6QdO+\@ ̪X'GxN @'4=ˋ+*VwN ne_|(/BDfj5(Dq<*tNt1х!MV.C0 32b#?n0pzj#!38}޴o1KovCJ`8ŗ_"]] rDUy޲@ Ȗ-;xџ'^Y`zEd?0„ DAL18IS]VGq\4o !swV7ˣι%4FѮ~}6)OgS[~Q vcYbL!wG3 7띸*E Pql8=jT\꘿I(z<[6OrR8ºC~ډ]=rNl[g|v TMTղb-o}OrP^Q]<98S¤!k)G(Vkwyqyr޽Nv`N/e p/~NAOk \I:G6]4+K;j$R:Mi #*[AȚT,ʰ,;N{HZTGMoּy) ]%dHء9Պ䠬|<45,\=[bƟ8QXeB3- &dҩ^{>/86bXmZ]]yޚN[(WAHL$YAgDKp=5GHjU&99v簪C0vygln*P)9^͞}lMuiH!̍#DoRBn9l@ xA/_v=ȺT{7Yt2N"4!YN`ae >Q<XMydEB`VU}u]嫇.%e^ánE87Mu\t`cP=AD/G)sI"@MP;)]%fH9'FNsj1pVhY&9=0pfuJ&gޤx+k:!r˭wkl03׼Ku C &ѓYt{.O.zҏ z}/tf_wEp2gvX)GN#I ݭ߽v/ .& и(ZF{e"=V!{zW`, ]+LGz"(UJp|j( #V4, 8B 0 9OkRrlɱl94)'VH9=9W|>PS['G(*I1==C<5"Pg+x'K5EMd؞Af8lG ?D FtoB[je?{k3zQ vZ;%Ɠ,]E>KZ+T/ EJxOZ1i #T<@ I}q9/t'zi(EMqw`mYkU6;[t4DPeckeM;H}_g pMww}k6#H㶏+b8雡Sxp)&C $@'b,fPߑt$RbJ'vznuS ~8='72_`{q纶|Q)Xk}cPz9p7O:'|G~8wx(a 0QCko|0ASD>Ip=4Q, d|F8RcU"/KM opKle M3#i0c%<7׿p&pZq[TR"BpqauIp$ 8~Ĩ!8Սx\ւdT>>Z40ks7 z2IQ}ItԀ<-%S⍤};zIb$I 5K}Q͙D8UguWE$Jh )cu4N tZl+[]M4k8֦Zeq֮M7uIqG 1==tLtR,ƜSrHYt&QP윯Lg' I,3@P'}'R˪e/%-Auv·ñ\> vDJzlӾNv5:|K/Jb6KI9)Zh*ZAi`?S {aiVDԲuy5W7pWeQJk֤#5&V<̺@/GH?^τZL|IJNvI:'P=Ϛt"¨=cud S Q.Ki0 !cJy;LJR;G{BJy޺[^8fK6)=yʊ+(k|&xQ2`L?Ȓ2@Mf 0C`6-%pKpm')c$׻K5[J*U[/#hH!6acB JA _|uMvDyk y)6OPYjœ50VT K}cǻP[ $:]4MEA.y)|B)cf-A?(e|lɉ#P9V)[9t.EiQPDѠ3ϴ;E:+Օ t ȥ~|_N2,ZJLt4! %ա]u {+=p.GhNcŞQI?Nd'yeh n7zi1DB)1S | S#ًZs2|Ɛy$F SxeX{7Vl.Src3E℃Q>b6G ўYCmtկ~=K0f(=LrAS GN'ɹ9<\!a`)֕y[uՍ[09` 9 +57ts6}b4{oqd+J5fa/,97J#6yν99mRWxJyѡyu_TJc`~W>l^q#Ts#2"nD1%fS)FU w{ܯ R{ ˎ󅃏џDsZSQS;LV;7 Od1&1n$ N /.q3~eNɪ]E#oM~}v֯FڦwyZ=<<>Xo稯lfMFV6p02|*=tV!c~]fa5Y^Q_WN|Vs 0ҘދU97OI'N2'8N֭fgg-}V%y]U4 峧p*91#9U kCac_AFңĪy뚇Y_AiuYyTTYЗ-(!JFLt›17uTozc. S;7A&&<ԋ5y;Ro+:' *eYJkWR[@F %SHWP 72k4 qLd'J "zB6{AC0ƁA6U.'F3:Ȅ(9ΜL;D]m8ڥ9}dU "v!;*13Rg^fJyShyy5auA?ɩGHRjo^]׽S)Fm\toy 4WQS@mE#%5ʈfFYDX ~D5Ϡ9tE9So_aU4?Ѽm%&c{n>.KW1Tlb}:j uGi(JgcYj0qn+>) %\!4{LaJso d||u//P_y7iRJ߬nHOy) l+@$($VFIQ9%EeKʈU. ia&FY̒mZ=)+qqoQn >L!qCiDB;Y<%} OgBxB!ØuG)WG9y(Ą{_yesuZmZZey'Wg#C~1Cev@0D $a@˲(.._GimA:uyw֬%;@!JkQVM_Ow:P.s\)ot- ˹"`B,e CRtaEUP<0'}r3[>?G8xU~Nqu;Wm8\RIkբ^5@k+5(By'L&'gBJ3ݶ!/㮻w҅ yqPWUg<e"Qy*167΃sJ\oz]T*UQ<\FԎ`HaNmڜ6DysCask8wP8y9``GJ9lF\G g's Nn͵MLN֪u$| /|7=]O)6s !ĴAKh]q_ap $HH'\1jB^s\|- W1:=6lJBqjY^LsPk""`]w)󭃈,(HC ?䔨Y$Sʣ{4Z+0NvQkhol6C.婧/u]FwiVjZka&%6\F*Ny#8O,22+|Db~d ~Çwc N:FuuCe&oZ(l;@ee-+Wn`44AMK➝2BRՈt7g*1gph9N) *"TF*R(#'88pm=}X]u[i7bEc|\~EMn}P瘊J)K.0i1M6=7'_\kaZ(Th{K*GJyytw"IO-PWJk)..axӝ47"89Cc7ĐBiZx 7m!fy|ϿF9CbȩV 9V-՛^pV̌ɄS#Bv4-@]Vxt-Z, &ֺ*diؠ2^VXbs֔Ìl.jQ]Y[47gj=幽ex)A0ip׳ W2[ᎇhuE^~q흙L} #-b۸oFJ_QP3r6jr+"nfzRJTUqoaۍ /$d8Mx'ݓ= OՃ| )$2mcM*cЙj}f };n YG w0Ia!1Q.oYfr]DyISaP}"dIӗթO67jqR ҊƐƈaɤGG|h;t]䗖oSv|iZqX)oalv;۩meEJ\!8=$4QU4Xo&VEĊ YS^E#d,yX_> ۘ-e\ "Wa6uLĜZi`aD9.% w~mB(02G[6y.773a7 /=o7D)$Z 66 $bY^\CuP. (x'"J60׿Y:Oi;F{w佩b+\Yi`TDWa~|VH)8q/=9!g߆2Y)?ND)%?Ǐ`k/sn:;O299yB=a[Ng 3˲N}vLNy;*?x?~L&=xyӴ~}q{qE*IQ^^ͧvü{Huu=R|>JyUlZV, B~/YF!Y\u_ݼF{_C)LD]m {H 0ihhadd nUkf3oٺCvE\)QJi+֥@tDJkB$1!Đr0XQ|q?d2) Ӣ_}qv-< FŊ߫%roppVBwü~JidY4:}L6M7f٬F "?71<2#?Jyy4뷢<_a7_=Q E=S1И/9{+93֮E{ǂw{))?maÆm(uLE#lïZ  ~d];+]h j?!|$F}*"4(v'8s<ŏUkm7^7no1w2ؗ}TrͿEk>p'8OB7d7R(A 9.*Mi^ͳ; eeUwS+C)uO@ =Sy]` }l8^ZzRXj[^iUɺ$tj))<sbDJfg=Pk_{xaKo1:-uyG0M ԃ\0Lvuy'ȱc2Ji AdyVgVh!{]/&}}ċJ#%d !+87<;qN޼Nفl|1N:8ya  8}k¾+-$4FiZYÔXk*I&'@iI99)HSh4+2G:tGhS^繿 Kتm0 вDk}֚+QT4;sC}rՅE,8CX-e~>G&'9xpW,%Fh,Ry56Y–hW-(v_,? ; qrBk4-V7HQ;ˇ^Gv1JVV%,ik;D_W!))+BoS4QsTM;gt+ndS-~:11Sgv!0qRVh!"Ȋ(̦Yl.]PQWgٳE'`%W1{ndΗBk|Ž7ʒR~,lnoa&:ü$ 3<a[CBݮwt"o\ePJ=Hz"_c^Z.#ˆ*x z̝grY]tdkP*:97YľXyBkD4N.C_[;F9`8& !AMO c `@BA& Ost\-\NX+Xp < !bj3C&QL+*&kAQ=04}cC!9~820G'PC9xa!w&bo_1 Sw"ܱ V )Yl3+ס2KoXOx]"`^WOy :3GO0g;%Yv㐫(R/r (s } u B &FeYZh0y> =2<Ϟc/ -u= c&׭,.0"g"7 6T!vl#sc>{u/Oh Bᾈ)۴74]x7 gMӒ"d]U)}" v4co[ ɡs 5Gg=XR14?5A}D "b{0$L .\4y{_fe:kVS\\O]c^W52LSBDM! C3Dhr̦RtArx4&agaN3Cf<Ԉp4~ B'"1@.b_/xQ} _߃҉/gٓ2Qkqp0շpZ2fԫYz< 4L.Cyυι1t@鎫Fe sYfsF}^ V}N<_`p)alٶ "(XEAVZ<)2},:Ir*#m_YӼ R%a||EƼIJ,,+f"96r/}0jE/)s)cjW#w'Sʯ5<66lj$a~3Kʛy 2:cZ:Yh))+a߭K::N,Q F'qB]={.]h85C9cr=}*rk?vwV렵ٸW Rs%}rNAkDv|uFLBkWY YkX מ|)1!$#3%y?pF<@<Rr0}: }\J [5FRxY<9"SQdE(Q*Qʻ)q1E0B_O24[U'],lOb ]~WjHޏTQ5Syu wq)xnw8~)c 쫬gٲߠ H% k5dƝk> kEj,0% b"vi2Wس_CuK)K{n|>t{P1򨾜j>'kEkƗBg*H%'_aY6Bn!TL&ɌOb{c`'d^{t\i^[uɐ[}q0lM˕G:‚4kb祔c^:?bpg… +37stH:0}en6x˟%/<]BL&* 5&fK9Mq)/iyqtA%kUe[ڛKN]Ě^,"`/ s[EQQm?|XJ߅92m]G.E΃ח U*Cn.j_)Tѧj̿30ڇ!A0=͜ar I3$C^-9#|pk!)?7.x9 @OO;WƝZBFU keZ75F6Tc6"ZȚs2y/1 ʵ:u4xa`C>6Rb/Yм)^=+~uRd`/|_8xbB0?Ft||Z\##|K 0>>zxv8۴吅q 8ĥ)"6>~\8:qM}#͚'ĉ#p\׶ l#bA?)|g g9|8jP(cr,BwV (WliVxxᡁ@0Okn;ɥh$_ckCgriv}>=wGzβ KkBɛ[˪ !J)h&k2%07δt}!d<9;I&0wV/ v 0<H}L&8ob%Hi|޶o&h1L|u֦y~󛱢8fٲUsւ)0oiFx2}X[zVYr_;N(w]_4B@OanC?gĦx>мgx>ΛToZoOMp>40>V Oy V9iq!4 LN,ˢu{jsz]|"R޻&'ƚ{53ўFu(<٪9:΋]B;)B>1::8;~)Yt|0(pw2N%&X,URBK)3\zz&}ax4;ǟ(tLNg{N|Ǽ\G#C9g$^\}p?556]/RP.90 k,U8/u776s ʪ_01چ|\N 0VV*3H鴃J7iI!wG_^ypl}r*jɤSR 5QN@ iZ#1ٰy;_\3\BQQ x:WJv츟ٯ$"@6 S#qe딇(/P( Dy~TOϻ<4:-+F`0||;Xl-"uw$Цi󼕝mKʩorz"mϺ$F:~E'ҐvD\y?Rr8_He@ e~O,T.(ފR*cY^m|cVR[8 JҡSm!ΆԨb)RHG{?MpqrmN>߶Y)\p,d#xۆWY*,l6]v0h15M˙MS8+EdI='LBJIH7_9{Caз*Lq,dt >+~ّeʏ?xԕ4bBAŚjﵫ!'\Ը$WNvKO}ӽmSşذqsOy?\[,d@'73'j%kOe`1.g2"e =YIzS2|zŐƄa\U,dP;jhhhaxǶ?КZ՚.q SE+XrbOu%\GتX(H,N^~]JyEZQKceTQ]VGYqnah;y$cQahT&QPZ*iZ8UQQM.qo/T\7X"u?Mttl2Xq(IoW{R^ ux*SYJ! 4S.Jy~ BROS[V|žKNɛP(L6V^|cR7i7nZW1Fd@ Ara{詑|(T*dN]Ko?s=@ |_EvF]׍kR)eBJc" MUUbY6`~V޴dJKß&~'d3i WWWWWW
Current Directory: /usr/lib64/python3.6/xmlrpc/__pycache__
Viewing File: /usr/lib64/python3.6/xmlrpc/__pycache__/server.cpython-36.pyc
3 aiK��@sdZddlmZmZmZmZmZddlmZddl Z ddlZ ddl Z ddl Z ddl Z ddlZddlZddlZddlZy ddlZWnek r�dZYnXd*dd�Zdd �ZGd d �d �ZGd d �d e�ZGdd�de je�ZGdd�de�ZGdd�de�ZGdd�dej�ZGdd�d�ZGdd�de�ZGdd�dee�Z Gdd�dee�Z!e"dk�r�ddl#Z#Gdd �d �Z$ed+��~Z%e%j&e'�e%j&d#d$�d%�e%j(e$�dd&�e%j)�e*d'�e*d(�y e%j+�Wn(e,k �r�e*d)�e j-d�YnXWdQRXdS),a XML-RPC Servers. This module can be used to create simple XML-RPC servers by creating a server and either installing functions, a class instance, or by extending the SimpleXMLRPCServer class. It can also be used to handle XML-RPC requests in a CGI environment using CGIXMLRPCRequestHandler. The Doc* classes can be used to create XML-RPC servers that serve pydoc-style documentation in response to HTTP GET requests. This documentation is dynamically generated based on the functions and methods registered with the server. A list of possible usage patterns follows: 1. Install functions: server = SimpleXMLRPCServer(("localhost", 8000)) server.register_function(pow) server.register_function(lambda x,y: x+y, 'add') server.serve_forever() 2. Install an instance: class MyFuncs: def __init__(self): # make all of the sys functions available through sys.func_name import sys self.sys = sys def _listMethods(self): # implement this method so that system.listMethods # knows to advertise the sys methods return list_public_methods(self) + \ ['sys.' + method for method in list_public_methods(self.sys)] def pow(self, x, y): return pow(x, y) def add(self, x, y) : return x + y server = SimpleXMLRPCServer(("localhost", 8000)) server.register_introspection_functions() server.register_instance(MyFuncs()) server.serve_forever() 3. Install an instance with custom dispatch method: class Math: def _listMethods(self): # this method must be present for system.listMethods # to work return ['add', 'pow'] def _methodHelp(self, method): # this method must be present for system.methodHelp # to work if method == 'add': return "add(2,3) => 5" elif method == 'pow': return "pow(x, y[, z]) => number" else: # By convention, return empty # string if no help is available return "" def _dispatch(self, method, params): if method == 'pow': return pow(*params) elif method == 'add': return params[0] + params[1] else: raise ValueError('bad method') server = SimpleXMLRPCServer(("localhost", 8000)) server.register_introspection_functions() server.register_instance(Math()) server.serve_forever() 4. Subclass SimpleXMLRPCServer: class MathServer(SimpleXMLRPCServer): def _dispatch(self, method, params): try: # We are forcing the 'export_' prefix on methods that are # callable through XML-RPC to prevent potential security # problems func = getattr(self, 'export_' + method) except AttributeError: raise Exception('method "%s" is not supported' % method) else: return func(*params) def export_add(self, x, y): return x + y server = MathServer(("localhost", 8000)) server.serve_forever() 5. CGI script: server = CGIXMLRPCRequestHandler() server.register_function(pow) server.handle_request() �)�Fault�dumps�loads� gzip_encode� gzip_decode)�BaseHTTPRequestHandlerNTcCsJ|r|jd�}n|g}x.|D]&}|jd�r8td|��qt||�}qW|S)aGresolve_dotted_attribute(a, 'b.c.d') => a.b.c.d Resolves a dotted attribute name to an object. Raises an AttributeError if any attribute in the chain starts with a '_'. If the optional allow_dotted_names argument is false, dots are not supported and this function operates similar to getattr(obj, attr). �.�_z(attempt to access private attribute "%s")�split� startswith�AttributeError�getattr)�obj�attr�allow_dotted_namesZattrs�i�r�/usr/lib64/python3.6/server.py�resolve_dotted_attribute{s     rcs�fdd�t��D�S)zkReturns a list of attribute strings, found in the specified object, which represent callable attributescs*g|]"}|jd� rtt�|��r|�qS)r )r �callabler )�.0�member)rrr� <listcomp>�s z'list_public_methods.<locals>.<listcomp>)�dir)rr)rr�list_public_methods�src@speZdZdZddd�Zddd�Zddd �Zd d �Zd d �Zddd�Z dd�Z dd�Z dd�Z dd�Z dd�ZdS)�SimpleXMLRPCDispatchera&Mix-in class that dispatches XML-RPC requests. This class is used to register XML-RPC method handlers and then to dispatch them. This class doesn't need to be instanced directly when used by SimpleXMLRPCServer but it can be instanced when used by the MultiPathXMLRPCServer FNcCs&i|_d|_||_|pd|_||_dS)Nzutf-8)�funcs�instance� allow_none�encoding�use_builtin_types)�selfrrr rrr�__init__�s  zSimpleXMLRPCDispatcher.__init__cCs||_||_dS)aRegisters an instance to respond to XML-RPC requests. Only one instance can be installed at a time. If the registered instance has a _dispatch method then that method will be called with the name of the XML-RPC method and its parameters as a tuple e.g. instance._dispatch('add',(2,3)) If the registered instance does not have a _dispatch method then the instance will be searched to find a matching method and, if found, will be called. Methods beginning with an '_' are considered private and will not be called by SimpleXMLRPCServer. If a registered function matches an XML-RPC request, then it will be called instead of the registered instance. If the optional allow_dotted_names argument is true and the instance does not have a _dispatch method, method names containing dots are supported and resolved, as long as none of the name segments start with an '_'. *** SECURITY WARNING: *** Enabling the allow_dotted_names options allows intruders to access your module's global variables and may allow intruders to execute arbitrary code on your machine. Only use this option on a secure, closed network. N)rr)r!rrrrr�register_instance�s!z(SimpleXMLRPCDispatcher.register_instancecCs|dkr|j}||j|<dS)z�Registers a function to respond to XML-RPC requests. The optional name argument can be used to set a Unicode name for the function. N)�__name__r)r!Zfunction�namerrr�register_function�sz(SimpleXMLRPCDispatcher.register_functioncCs|jj|j|j|jd��dS)z�Registers the XML-RPC introspection methods in the system namespace. see http://xmlrpc.usefulinc.com/doc/reserved.html )zsystem.listMethodszsystem.methodSignaturezsystem.methodHelpN)r�update�system_listMethods�system_methodSignature�system_methodHelp)r!rrr� register_introspection_functions�s z7SimpleXMLRPCDispatcher.register_introspection_functionscCs|jjd|ji�dS)z�Registers the XML-RPC multicall method in the system namespace. see http://www.xmlrpc.com/discuss/msgReader$1208zsystem.multicallN)rr'�system_multicall)r!rrr�register_multicall_functions�sz3SimpleXMLRPCDispatcher.register_multicall_functionsc Cs�yPt||jd�\}}|dk r(|||�}n |j||�}|f}t|d|j|jd�}Wn�tk r�}zt||j|jd�}WYdd}~XnNtj�\}} } z$ttdd|| f�|j|jd�}Wdd}} } XYnX|j |jd�S) a�Dispatches an XML-RPC method from marshalled (XML) data. XML-RPC methods are dispatched from the marshalled (XML) data using the _dispatch method and the result is returned as marshalled data. For backwards compatibility, a dispatch function can be provided as an argument (see comment in SimpleXMLRPCRequestHandler.do_POST) but overriding the existing method through subclassing is the preferred means of changing method dispatch behavior. )r N�)Zmethodresponserr)rrz%s:%s)rr�xmlcharrefreplace) rr � _dispatchrrrr�sys�exc_info�encode) r!�data�dispatch_method�path�params�method�response�fault�exc_type� exc_value�exc_tbrrr�_marshaled_dispatch�s&   z*SimpleXMLRPCDispatcher._marshaled_dispatchcCs^t|jj��}|jdk rVt|jd�r8|t|jj��O}nt|jd�sV|tt|j��O}t|�S)zwsystem.listMethods() => ['add', 'subtract', 'multiple'] Returns a list of the methods supported by the server.N� _listMethodsr0)�setr�keysr�hasattrr?r�sorted)r!�methodsrrrr(s   z)SimpleXMLRPCDispatcher.system_listMethodscCsdS)a#system.methodSignature('add') => [double, int, int] Returns a list describing the signature of the method. In the above example, the add method takes two integers as arguments and returns a double result. This server does NOT support system.methodSignature.zsignatures not supportedr)r!� method_namerrrr))s z-SimpleXMLRPCDispatcher.system_methodSignaturec Cs�d}||jkr|j|}nX|jdk rrt|jd�r<|jj|�St|jd�sryt|j||j�}Wntk rpYnX|dkr~dStj|�SdS)z�system.methodHelp('add') => "Adds two integers together" Returns a string containing documentation for the specified method.N� _methodHelpr0�) rrrBrFrrr �pydoc�getdoc)r!rEr8rrrr*6s"       z(SimpleXMLRPCDispatcher.system_methodHelpc Cs�g}x�|D]�}|d}|d}y|j|j||�g�Wq tk rl}z|j|j|jd��WYdd}~Xq tj�\}}} z|jdd||fd��Wdd}}} XYq Xq W|S)z�system.multicall([{'methodName': 'add', 'params': [2, 2]}, ...]) => [[4], ...] Allows the caller to package multiple XML-RPC calls into a single request. See http://www.xmlrpc.com/discuss/msgReader$1208 Z methodNamer7)� faultCode� faultStringNr.z%s:%s)�appendr0rrJrKr1r2) r!Z call_list�resultsZcallrEr7r:r;r<r=rrrr,Us$  z'SimpleXMLRPCDispatcher.system_multicallcCs�y|j|}Wntk r"YnX|dk r4||�Std|��|jdk r�t|jd�rd|jj||�Syt|j||j�}Wntk r�YnX|dk r�||�Std|��dS)a�Dispatches the XML-RPC method. XML-RPC calls are forwarded to a registered function that matches the called XML-RPC method name. If no such function exists then the call is forwarded to the registered instance, if available. If the registered instance has a _dispatch method then that method will be called with the name of the XML-RPC method and its parameters as a tuple e.g. instance._dispatch('add',(2,3)) If the registered instance does not have a _dispatch method then the instance will be searched to find a matching method and, if found, will be called. Methods beginning with an '_' are considered private and will not be called. Nzmethod "%s" is not supportedr0) r�KeyError� ExceptionrrBr0rrr )r!r8r7�funcrrrr0ys(    z SimpleXMLRPCDispatcher._dispatch)FNF)F)N)NN)r$� __module__� __qualname__�__doc__r"r#r&r+r-r>r(r)r*r,r0rrrrr�s  $   ) $rc@sfeZdZdZdZdZdZdZej dej ej B�Z dd �Z d d �Zd d �Zdd�Zdd�Zddd�ZdS)�SimpleXMLRPCRequestHandlerz�Simple XML-RPC request handler class. Handles all HTTP POST requests and attempts to decode them as XML-RPC requests. �/�/RPC2ixr.Tz� \s* ([^\s;]+) \s* #content-coding (;\s* q \s*=\s* ([0-9\.]+))? #q cCsbi}|jjdd�}xJ|jd�D]<}|jj|�}|r|jd�}|rHt|�nd}|||jd�<qW|S)NzAccept-EncodingrG�,�g�?r.)�headers�getr � aepattern�match�group�float)r!�rZae�er\�vrrr�accept_encodings�s  z+SimpleXMLRPCRequestHandler.accept_encodingscCs|jr|j|jkSdSdS)NT)� rpc_pathsr6)r!rrr�is_rpc_path_valid�s z,SimpleXMLRPCRequestHandler.is_rpc_path_validc Cs�|j�s|j�dSy�d}t|jd�}g}x>|rjt||�}|jj|�}|sNP|j|�|t|d�8}q.Wdj |�}|j |�}|dkr�dS|j j |t |dd�|j�}Wn�tk �r6}zp|jd�t|j d �o�|j j�r|jd t|��tj�} t| jd d �d �} |jd | �|jdd�|j�WYdd}~Xn�X|jd�|jdd�|jdk �r�t|�|jk�r�|j�jdd�} | �r�yt|�}|jdd�Wntk �r�YnX|jdtt|���|j�|jj|�dS)z�Handles the HTTP POST request. Attempts to interpret all HTTP POST requests as XML-RPC calls, which are forwarded to the server's _dispatch method for handling. N� izcontent-lengthr.�r0i��_send_traceback_headerz X-exception�ASCII�backslashreplacez X-tracebackzContent-length�0��z Content-typeztext/xml�gziprzContent-Encodingi(i����) rd� report_404�intrY�minZrfile�readrL�len�join�decode_request_content�serverr>r r6rO� send_responserBrg� send_header�str� traceback� format_excr3� end_headers�encode_thresholdrbrZr�NotImplementedError�wfile�write) r!Zmax_chunk_sizeZsize_remaining�LZ chunk_size�chunkr4r9r`Ztrace�qrrr�do_POST�sX             z"SimpleXMLRPCRequestHandler.do_POSTc Cs�|jjdd�j�}|dkr|S|dkrtyt|�Stk rR|jdd|�Yq�tk rp|jdd�Yq�Xn|jdd|�|jdd �|j�dS) Nzcontent-encodingZidentityrli�zencoding %r not supportedi�zerror decoding gzip contentzContent-lengthrj) rYrZ�lowerrr}rv� ValueErrorrwr{)r!r4rrrrrts z1SimpleXMLRPCRequestHandler.decode_request_contentcCsF|jd�d}|jdd�|jdtt|���|j�|jj|�dS)Ni�s No such pagez Content-typez text/plainzContent-length)rvrwrxrrr{r~r)r!r9rrrrn/s   z%SimpleXMLRPCRequestHandler.report_404�-cCs|jjrtj|||�dS)z$Selectively log an accepted request.N)ru� logRequestsr� log_request)r!�code�sizerrrr�8sz&SimpleXMLRPCRequestHandler.log_requestN)rUrVrm)r�r�)r$rQrRrSrcr|ZwbufsizeZdisable_nagle_algorithm�re�compile�VERBOSE� IGNORECASEr[rbrdr�rtrnr�rrrrrT�s G rTc@s.eZdZdZdZdZedddddfdd�ZdS)�SimpleXMLRPCServeragSimple XML-RPC server. Simple XML-RPC server that allows functions and a single instance to be installed to handle requests. The default implementation attempts to dispatch XML-RPC calls to the functions or instance installed in the server. Override the _dispatch method inherited from SimpleXMLRPCDispatcher to change this behavior. TFNcCs,||_tj||||�tjj||||�dS)N)r�rr"� socketserver� TCPServer)r!�addr�requestHandlerr�rr�bind_and_activater rrrr"QszSimpleXMLRPCServer.__init__)r$rQrRrSZallow_reuse_addressrgrTr"rrrrr�>s  r�c@s@eZdZdZedddddfdd�Zdd�Zd d �Zd d d �ZdS)�MultiPathXMLRPCServera\Multipath XML-RPC Server This specialization of SimpleXMLRPCServer allows the user to create multiple Dispatcher instances and assign them to different HTTP request paths. This makes it possible to run two or more 'virtual XML-RPC servers' at the same port. Make sure that the requestHandler accepts the paths in question. TFNc Cs2tj||||||||�i|_||_|p*d|_dS)Nzutf-8)r�r"� dispatchersrr)r!r�r�r�rrr�r rrrr"bs  zMultiPathXMLRPCServer.__init__cCs||j|<|S)N)r�)r!r6Z dispatcherrrr�add_dispatcherls z$MultiPathXMLRPCServer.add_dispatchercCs |j|S)N)r�)r!r6rrr�get_dispatcherpsz$MultiPathXMLRPCServer.get_dispatchercCs|y|j|j|||�}Wn^tj�dd�\}}z2ttdd||f�|j|jd�}|j|jd�}Wdd}}XYnX|S)N�r.z%s:%s)rrr/) r�r>r1r2rrrrr3)r!r4r5r6r9r;r<rrrr>ss z)MultiPathXMLRPCServer._marshaled_dispatch)NN) r$rQrRrSrTr"r�r�r>rrrrr�Zsr�c@s4eZdZdZd dd�Zdd�Zdd �Zd d d �ZdS)�CGIXMLRPCRequestHandlerz3Simple handler for XML-RPC data passed through CGI.FNcCstj||||�dS)N)rr")r!rrr rrrr"�sz CGIXMLRPCRequestHandler.__init__cCsP|j|�}td�tdt|��t�tjj�tjjj|�tjjj�dS)zHandle a single XML-RPC requestzContent-Type: text/xmlzContent-Length: %dN)r>�printrrr1�stdout�flush�bufferr)r!� request_textr9rrr� handle_xmlrpc�s  z%CGIXMLRPCRequestHandler.handle_xmlrpccCs�d}tj|\}}tjj|||d�}|jd�}td||f�tdtjj�tdt|��t�t j j �t j j j |�t j j j �dS)z�Handle a single HTTP GET request. Default implementation indicates an error because XML-RPC uses the POST method. i�)r��message�explainzutf-8z Status: %d %szContent-Type: %szContent-Length: %dN)rZ responses�httpruZDEFAULT_ERROR_MESSAGEr3r�ZDEFAULT_ERROR_CONTENT_TYPErrr1r�r�r�r)r!r�r�r�r9rrr� handle_get�s   z"CGIXMLRPCRequestHandler.handle_getc Csz|dkr$tjjdd�dkr$|j�nRyttjjdd��}Wnttfk rVd}YnX|dkrltjj |�}|j |�dS)z�Handle a single XML-RPC request passed through a CGI post method. If no XML data is given then it is read from stdin. The resulting XML-RPC response is printed to stdout along with the correct HTTP headers. NZREQUEST_METHODZGETZCONTENT_LENGTHr.rm) �os�environrZr�ror�� TypeErrorr1�stdinrqr�)r!r�Zlengthrrr�handle_request�s   z&CGIXMLRPCRequestHandler.handle_request)FNF)N)r$rQrRrSr"r�r�r�rrrrr��s   r�c@s>eZdZdZdiiifdd�Zdiiidfdd�Zdd�ZdS) � ServerHTMLDocz7Class used to generate pydoc HTML document for a serverNcCs^|p|j}g}d}tjd�}�x|j||�} | s2P| j�\} } |j|||| ���| j�\} } }}}}| r�|| �jdd�}|jd||f�n�|r�dt|�}|jd||| �f�n~|r�dt|�}|jd||| �f�nV|| | d�d k�r|j|j ||||��n(|�r$|jd |�n|j|j ||��| }q W|j|||d ���d j |�S) z�Mark up some plain text, given a context of symbols to look for. Each context dictionary maps object names to anchor names.rzM\b((http|ftp)://\S+[\w/]|RFC[- ]?(\d+)|PEP[- ]?(\d+)|(self\.)?((?:\w|\.)+))\b�"z&quot;z<a href="%s">%s</a>z'http://www.rfc-editor.org/rfc/rfc%d.txtz(http://www.python.org/dev/peps/pep-%04d/r.�(zself.<strong>%s</strong>NrG) �escaper�r��search�spanrL�groups�replaceroZnamelinkrs)r!�textr�r�classesrDrM�here�patternr\�start�end�all�schemeZrfcZpepZselfdotr%Zurlrrr�markup�s8      zServerHTMLDoc.markupcCs$|r |jp dd|}d} d|j|�|j|�f} tj|�rrtj|�} tj| jdd�| j| j| j | j |j d�} n<tj |�r�tj|�} tj| j| j| j| j | j |j d�} nd} t |t�r�|dp�| } |dp�d} n tj|�} | | | o�|jd | �}|j| |j|||�}|�od |}d ||fS) z;Produce HTML documentation for a function or method object.rGr�z$<a name="%s"><strong>%s</strong></a>r.N)� annotations� formatvaluez(...)rz'<font face="helvetica, arial">%s</font>z<dd><tt>%s</tt></dd>z<dl><dt>%s</dt>%s</dl> )r$r��inspectZismethodZgetfullargspecZ formatargspec�argsZvarargsZvarkwZdefaultsr�r�Z isfunction� isinstance�tuplerHrIZgreyr�� preformat)r!�objectr%�modrr�rDZclZanchorZnote�titler�ZargspecZ docstringZdecl�docrrr� docroutine�s<           zServerHTMLDoc.docroutinec Cs�i}x,|j�D] \}}d|||<||||<qW|j|�}d|}|j|dd�}|j||j|�} | old| } |d| }g} t|j��} x&| D]\}}| j|j|||d��q�W||jddd d j | ��}|S) z1Produce HTML documentation for an XML-RPC server.z#-z)<big><big><strong>%s</strong></big></big>z#ffffffz#7799eez <tt>%s</tt>z <p>%s</p> )rZMethodsz#eeaa77rG) �itemsr�Zheadingr�r�rCrLr�Z bigsectionrs) r!� server_nameZpackage_documentationrDZfdict�key�value�head�resultr��contentsZ method_itemsrrr� docserver$s"     zServerHTMLDoc.docserver)r$rQrRrSr�r�r�rrrrr��s ),r�c@s8eZdZdZdd�Zdd�Zdd�Zdd �Zd d �Zd S) �XMLRPCDocGeneratorz�Generates documentation for an XML-RPC server. This class is designed as mix-in and should not be constructed directly. cCsd|_d|_d|_dS)NzXML-RPC Server DocumentationzGThis server exports the following methods through the XML-RPC protocol.)r��server_documentation� server_title)r!rrrr"DszXMLRPCDocGenerator.__init__cCs ||_dS)z8Set the HTML title of the generated server documentationN)r�)r!r�rrr�set_server_titleLsz#XMLRPCDocGenerator.set_server_titlecCs ||_dS)z7Set the name of the generated HTML server documentationN)r�)r!r�rrr�set_server_nameQsz"XMLRPCDocGenerator.set_server_namecCs ||_dS)z3Set the documentation string for the entire server.N)r�)r!r�rrr�set_server_documentationVsz+XMLRPCDocGenerator.set_server_documentationc Cs i}x�|j�D]�}||jkr(|j|}n�|jdk r�ddg}t|jd�rV|jj|�|d<t|jd�rr|jj|�|d<t|�}|dkr�|}q�t|jd�s�yt|j|�}Wq�tk r�|}Yq�Xq�|}n ds�t d��|||<qWt �}|j |j |j |�}|jtj|j�|�S) agenerate_html_documentation() => html documentation for the server Generates HTML documentation for the server using introspection for installed functions and instances that do not implement the _dispatch method. Alternatively, instances can choose to implement the _get_method_argstring(method_name) method to provide the argument string used in the documentation and the _methodHelp(method_name) method to provide the help text used in the documentation.N�_get_method_argstringrrFr.r0zACould not find method in self.functions and no instance installed)NN)r(rrrBr�rFr�rr �AssertionErrorr�r�r�r�Zpage�htmlr�r�)r!rDrEr8Z method_infoZ documenterZ documentationrrr�generate_html_documentation[s:           z.XMLRPCDocGenerator.generate_html_documentationN) r$rQrRrSr"r�r�r�r�rrrrr�=s r�c@seZdZdZdd�ZdS)�DocXMLRPCRequestHandlerz�XML-RPC and documentation request handler class. Handles all HTTP POST requests and attempts to decode them as XML-RPC requests. Handles all HTTP GET requests and interprets them as requests for documentation. cCsf|j�s|j�dS|jj�jd�}|jd�|jdd�|jdtt|���|j �|j j |�dS)z}Handles the HTTP GET request. Interpret all HTTP GET requests as requests for server documentation. Nzutf-8rkz Content-typez text/htmlzContent-length) rdrnrur�r3rvrwrxrrr{r~r)r!r9rrr�do_GET�s  zDocXMLRPCRequestHandler.do_GETN)r$rQrRrSr�rrrrr��sr�c@s&eZdZdZedddddfdd�ZdS)�DocXMLRPCServerz�XML-RPC and HTML documentation server. Adds the ability to serve server documentation to the capabilities of SimpleXMLRPCServer. TFNc Cs&tj||||||||�tj|�dS)N)r�r"r�)r!r�r�r�rrr�r rrrr"�s zDocXMLRPCServer.__init__)r$rQrRrSr�r"rrrrr��sr�c@s eZdZdZdd�Zdd�ZdS)�DocCGIXMLRPCRequestHandlerzJHandler for XML-RPC data and documentation requests passed through CGIcCsT|j�jd�}td�tdt|��t�tjj�tjjj|�tjjj�dS)z}Handles the HTTP GET request. Interpret all HTTP GET requests as requests for server documentation. zutf-8zContent-Type: text/htmlzContent-Length: %dN) r�r3r�rrr1r�r�r�r)r!r9rrrr��s z%DocCGIXMLRPCRequestHandler.handle_getcCstj|�tj|�dS)N)r�r"r�)r!rrrr"�s z#DocCGIXMLRPCRequestHandler.__init__N)r$rQrRrSr�r"rrrrr��sr��__main__c@s"eZdZdd�ZGdd�d�ZdS)�ExampleServicecCsdS)NZ42r)r!rrr�getData�szExampleService.getDatac@seZdZedd��ZdS)zExampleService.currentTimecCs tjj�S)N)�datetimeZnowrrrr�getCurrentTime�sz)ExampleService.currentTime.getCurrentTimeN)r$rQrR� staticmethodr�rrrr� currentTime�sr�N)r$rQrRr�r�rrrrr��sr�� localhost�@cCs||S)Nr)�x�yrrr�<lambda>�sr��add)rz&Serving XML-RPC on localhost port 8000zKIt is advisable to run this example server within a secure, closed network.z& Keyboard interrupt received, exiting.)T)r�r�).rSZ xmlrpc.clientrrrrrZ http.serverrr�r�r�r1r�r�rHr�ryZfcntl� ImportErrorrrrrTr�r�r�r�ZHTMLDocr�r�r�r�r�r$r�r�rur&�powr#r-r�Z serve_forever�KeyboardInterrupt�exitrrrr�<module>fs`    ,ErQ