=Pc@sdZddlZddljZddlmZddlTddlmZmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlmZddlm Z ddl!m!Z!ddl"m#Z#ddl$m%Z%e%e&Z'de(fdYZ)dd&dYZdd'dYZ*dd(dYZ+dd)dYZ,d d*d!YZ-d"d+d#YZ.d$e.fd%YZ/dS(,sX The I{2nd generation} service proxy provides access to web services. See I{README.txt} iN(t CookieJar(t*(tTransportErrortRequest(tHttpAuthenticated(t FileCache(tServiceDefinition(t sudsobject(tFactory(tObject(t PathResolver(tBuilder(t Definitions(tDocument(tParser(tOptions(tUnskin(turlparse(tdeepcopy(t getLoggertClientcBseZdZedZedZedZdZdZdZ dZ dZ d Z d Z d ZRS( s A lightweight web services client. I{(2nd generation)} API. @ivar wsdl: The WSDL object. @type wsdl:L{Definitions} @ivar service: The service proxy used to invoke operations. @type service: L{Service} @ivar factory: The factory used to create objects. @type factory: L{Factory} @ivar sd: The service definition @type sd: L{ServiceDefinition} @ivar messages: The last sent/received messages. @type messages: str[2] cCs tj|S(s Extract the I{items} from a suds object much like the items() method works on I{dict}. @param sobject: A suds object @type sobject: L{Object} @return: A list of items contained in I{sobject}. @rtype: [(key, value),...] (Rtitems(tclstsobject((s#suds-0.3.7-py2.6.egg/suds/client.pyR>s cCs tj|S(s Convert a sudsobject into a dictionary. @param sobject: A suds object @type sobject: L{Object} @return: A python dictionary containing the items contained in I{sobject}. @rtype: dict (Rtasdict(RR((s#suds-0.3.7-py2.6.egg/suds/client.pytdictJs cCs|jS(s Extract the metadata from a suds object. @param sobject: A suds object @type sobject: L{Object} @return: The object's metadata @rtype: L{sudsobject.Metadata} (t __metadata__(RR((s#suds-0.3.7-py2.6.egg/suds/client.pytmetadataVs cKst}t|_||_tdd|_|j|t|||_t |j|_ t ||jj |_ g|_x6|jj D](}t|j|}|jj|qWtdddd|_dS(s @param url: The URL for the WSDL. @type url: str @param kwargs: keyword arguments. @see: L{Options} tdaysittxtrxN(RRt transporttoptionsRtcachet set_optionsR twsdlRtfactorytServiceSelectortservicestservicetsdRtappendRtNonetmessages(tselfturltkwargsR tsR(((s#suds-0.3.7-py2.6.egg/suds/client.pyt__init__as     cKs t|j}|j|dS(sa Set options. @param kwargs: keyword arguments. @see: L{Options} N(RR tupdate(R,R.tp((s#suds-0.3.7-py2.6.egg/suds/client.pyR"vscCsk|jj}|j|d}|dkr>|j||dS|d|krgtd||fndS(s Add I{static} mapping of an XML namespace prefix to a namespace. This is useful for cases when a wsdl and referenced schemas make heavy use of namespaces and those namespaces are subject to changed. @param prefix: An XML namespace prefix. @type prefix: str @param uri: An XML namespace URI. @type uri: str @raise Exception: when prefix is already mapped. Nis"%s" already mapped as "%s"(R#troott resolvePrefixR*t addPrefixt Exception(R,tprefixturiR3tmapped((s#suds-0.3.7-py2.6.egg/suds/client.pyt add_prefixs  cCs|jjdS(s| Get last sent I{soap} message. @return: The last sent I{soap} message. @rtype: L{Document} R(R+tget(R,((s#suds-0.3.7-py2.6.egg/suds/client.pyt last_sentscCs|jjdS(s Get last received I{soap} message. @return: The last received I{soap} message. @rtype: L{Document} R(R+R;(R,((s#suds-0.3.7-py2.6.egg/suds/client.pyt last_receivedscCsdtfdY}|}t|_t|j}t|j}|jt||j|_|j|_t||jj |_ |j |_ |S(s Get a shallow clone of this object. @note: THIS METHOD NOT YET WORKING CORRECTLY OR SUPPORTED !! @return: A shallow clone. @rtype: L{Client} t UninitializedcBseZdZRS(cSsdS(N((R,((s#suds-0.3.7-py2.6.egg/suds/client.pyR0s(t__name__t __module__R0(((s#suds-0.3.7-py2.6.egg/suds/client.pyR>s( RRR RR1RR#R$R%R&R'R((R,R>tclonetcptmp((s#suds-0.3.7-py2.6.egg/suds/client.pyRAs     cCs t|S(N(tunicode(R,((s#suds-0.3.7-py2.6.egg/suds/client.pyt__str__scCsdg}tjj}|jd|jdtj|jd|d|dfx(|jD]}|jdt|qbWdj|S( Ns s'Suds ( https://fedorahosted.org/suds/ )s version: %ss %s build: %siis %st(tsudst __build__tsplitR)t __version__R(RDtjoin(R,R/tbuildR(((s#suds-0.3.7-py2.6.egg/suds/client.pyt __unicode__s  (R?R@t__doc__t classmethodRRRR0R"R:R<R=RARERM(((s#suds-0.3.7-py2.6.egg/suds/client.pyR/s        RcBs)eZdZdZdZdZRS(s A factory for instantiating types defined in the wsdl @ivar resolver: A schema type resolver. @type resolver: L{PathResolver} @ivar builder: A schema object builder. @type builder: L{Builder} cCs.||_t||_t|j|_dS(sW @param wsdl: A schema object. @type wsdl: L{wsdl.Definitions} N(R#R tresolverR tbuilder(R,R#((s#suds-0.3.7-py2.6.egg/suds/client.pyR0s cCs tj}|j|jj|}|dkrCt|n|jrtj |}x|j D]"\}}t ||j |j qkWnQy|j j|}Wn8tk r}tjd|dtt||nX|jtjjd|||S(s create a WSDL type by name @param name: The name of a type defined in the WSDL. @type name: str @return: The requested object. @rtype: L{Object} screate '%s' failedtexc_infos%s created: %sN(tmetricstTimertstartRPtfindR*t TypeNotFoundtenumt InstFactorytobjecttchildrentsetattrtnameRQRLR6tlogterrortTruet BuildErrortstoptdebug(R,R]ttimerttypetresultteta((s#suds-0.3.7-py2.6.egg/suds/client.pytcreates"     cCst|j||_dS(sk Set the path separator. @param ps: The new path separator. @type ps: char N(R R#RP(R,tps((s#suds-0.3.7-py2.6.egg/suds/client.pyt separators(R?R@RNR0RiRk(((s#suds-0.3.7-py2.6.egg/suds/client.pyRs R%cBs;eZdZdZdZdZdZdZRS(s The B{service} selector is used to select a web service. In most cases, the wsdl only defines (1) service in which access by subscript is passed through to a L{PortSelector}. This is also the behavior when a I{default} service has been specified. In cases where multiple services have been defined and no default has been specified, the service is found by name (or index) and a L{PortSelector} for the service is returned. In all cases, attribute access is forwarded to the L{PortSelector} for either the I{first} service or the I{default} service (when specified). @ivar __client: A suds client. @type __client: L{Client} @ivar __services: A list of I{wsdl} services. @type __services: list cCs||_||_dS(s @param client: A suds client. @type client: L{Client} @param services: A list of I{wsdl} services. @type services: list N(t_ServiceSelector__clientt_ServiceSelector__services(R,tclientR&((s#suds-0.3.7-py2.6.egg/suds/client.pyR0 s cCs=|j}|dkr*|jd}n|}t||S(s9 Request to access an attribute is forwarded to the L{PortSelector} for either the I{first} service or the I{default} service (when specified). @param name: The name of a method. @type name: str @return: A L{PortSelector}. @rtype: L{PortSelector}. iN(t_ServiceSelector__dsR*t_ServiceSelector__findtgetattr(R,R]tdefaulttport((s#suds-0.3.7-py2.6.egg/suds/client.pyt __getattr__s  cCs_t|jdkr,|jd}||S|j}|dk rR|}||S|j|S(s Provides selection of the I{service} by name (string) or index (integer). In cases where only (1) service is defined or a I{default} has been specified, the request is forwarded to the L{PortSelector}. @param name: The name (or index) of a service. @type name: (int|str) @return: A L{PortSelector} for the specified service. @rtype: L{PortSelector}. iiN(tlenRmRpRoR*(R,R]RsRr((s#suds-0.3.7-py2.6.egg/suds/client.pyt __getitem__&s   cCsd}t|js!tdnt|trny|j|}|j}Wqtk rjtd|qXn-x*|jD]}||jkrx|}PqxqxW|dkrt|nt |j |j |S(s Find a I{service} by name (string) or index (integer). @param name: The name (or index) of a service. @type name: (int|str) @return: A L{PortSelector} for the found service. @rtype: L{PortSelector}. sNo services definedsat [%d]N( R*RuRmR6t isinstancetintR]t IndexErrortServiceNotFoundt PortSelectorRltports(R,R]R'R/((s#suds-0.3.7-py2.6.egg/suds/client.pyt__find:s       cCs0|jjj}|dkrdS|j|SdS(s Get the I{default} service if defined in the I{options}. @return: A L{PortSelector} for the I{default} service. @rtype: L{PortSelector}. N(RlR R'R*Rp(R,tds((s#suds-0.3.7-py2.6.egg/suds/client.pyt__dsTs (R?R@RNR0RtRvRpRo(((s#suds-0.3.7-py2.6.egg/suds/client.pyR%s    R{cBs;eZdZdZdZdZdZdZRS(sv The B{port} selector is used to select a I{web service} B{port}. In cases where multiple ports have been defined and no default has been specified, the port is found by name (or index) and a L{MethodSelector} for the port is returned. In all cases, attribute access is forwarded to the L{MethodSelector} for either the I{first} port or the I{default} port (when specified). @ivar __client: A suds client. @type __client: L{Client} @ivar __ports: A list of I{service} ports. @type __ports: list @ivar __qn: The I{qualified} name of the port (used for logging). @type __qn: str cCs||_||_||_dS(s @param client: A suds client. @type client: L{Client} @param ports: A list of I{service} ports. @type ports: list @param qn: The name of the service. @type qn: str N(t_PortSelector__clientt_PortSelector__portst_PortSelector__qn(R,RnR|tqn((s#suds-0.3.7-py2.6.egg/suds/client.pyR0ps  cCs=|j}|dkr*|jd}n|}t||S(s9 Request to access an attribute is forwarded to the L{MethodSelector} for either the I{first} port or the I{default} port (when specified). @param name: The name of a method. @type name: str @return: A L{MethodSelector}. @rtype: L{MethodSelector}. iN(t_PortSelector__dpR*t_PortSelector__findRq(R,R]Rrtm((s#suds-0.3.7-py2.6.egg/suds/client.pyRt}s  cCs-|j}|dkr%|j|S|SdS(s Provides selection of the I{port} by name (string) or index (integer). In cases where only (1) port is defined or a I{default} has been specified, the request is forwarded to the L{MethodSelector}. @param name: The name (or index) of a port. @type name: (int|str) @return: A L{MethodSelector} for the specified port. @rtype: L{MethodSelector}. N(RR*R(R,R]Rr((s#suds-0.3.7-py2.6.egg/suds/client.pyRvs   cCs d}t|js(td|jnt|tr{d|j|f}y|j|}Wqtk rwt|qXnEdj |j|f}x*|jD]}||j kr|}PqqW|dkrt|ndj |j|j f}t |j |j |S(s Find a I{port} by name (string) or index (integer). @param name: The name (or index) of a port. @type name: (int|str) @return: A L{MethodSelector} for the found port. @rtype: L{MethodSelector}. sNo ports defined: %ss%s[%d]t.N(R*RuRR6RRwRxRyt PortNotFoundRKR]tMethodSelectorRtmethods(R,R]RsRR2((s#suds-0.3.7-py2.6.egg/suds/client.pyR}s$   cCs0|jjj}|dkrdS|j|SdS(s Get the I{default} port if defined in the I{options}. @return: A L{MethodSelector} for the I{default} port. @rtype: L{MethodSelector}. N(RR RsR*R(R,tdp((s#suds-0.3.7-py2.6.egg/suds/client.pyt__dps (R?R@RNR0RtRvRR(((s#suds-0.3.7-py2.6.egg/suds/client.pyR{as    RcBs)eZdZdZdZdZRS(s, The B{method} selector is used to select a B{method} by name. @ivar __client: A suds client. @type __client: L{Client} @ivar __methods: A dictionary of methods. @type __methods: dict @ivar __qn: The I{qualified} name of the method (used for logging). @type __qn: str cCs||_||_||_dS(s @param client: A suds client. @type client: L{Client} @param methods: A dictionary of methods. @type methods: dict @param qn: The I{qualified} name of the port. @type qn: str N(t_MethodSelector__clientt_MethodSelector__methodst_MethodSelector__qn(R,RnRR((s#suds-0.3.7-py2.6.egg/suds/client.pyR0s  cCs||S(s Get a method by name and return it in an I{execution wrapper}. @param name: The name of a method. @type name: str @return: An I{execution wrapper} for the specified method name. @rtype: L{Method} ((R,R]((s#suds-0.3.7-py2.6.egg/suds/client.pyRtscCsR|jj|}|dkrBdj|j|f}t|nt|j|S(s Get a method by name and return it in an I{execution wrapper}. @param name: The name of a method. @type name: str @return: An I{execution wrapper} for the specified method name. @rtype: L{Method} RN(RR;R*RKRtMethodNotFoundtMethodR(R,R]RR((s#suds-0.3.7-py2.6.egg/suds/client.pyRvs   (R?R@RNR0RtRv(((s#suds-0.3.7-py2.6.egg/suds/client.pyRs  RcBs2eZdZdZdZdZdZRS(s The I{method} (namespace) object. @ivar client: A client object. @type client: L{Client} @ivar method: A I{wsdl} method. @type I{wsdl} Method. cCs||_||_dS(s @param client: A client object. @type client: L{Client} @param method: A I{raw} method. @type I{raw} Method. N(Rntmethod(R,RnR((s#suds-0.3.7-py2.6.egg/suds/client.pyR0s cOsx|j|}||j|j}|jsdy|j||SWqttk r`}d|fSXn|j||SdS(s$ Invoke the method. iN(t clientclassRnRtfaultstinvoketWebFault(R,targsR.RRnRg((s#suds-0.3.7-py2.6.egg/suds/client.pyt__call__ s cCs |jjjS(s get faults option (RnR R(R,((s#suds-0.3.7-py2.6.egg/suds/client.pyRscCstj|rtStSdS(s get soap client class N(t SimClientt simulationt SoapClient(R,R.((s#suds-0.3.7-py2.6.egg/suds/client.pyRs(R?R@RNR0RRR(((s#suds-0.3.7-py2.6.egg/suds/client.pyRs   RcBseeZdZdZdZdZdZdZdZdZ d dZ d d Z RS( sb A lightweight soap based web client B{**not intended for external use} @ivar service: The target method. @type service: L{Service} @ivar method: A target method. @type method: L{Method} @ivar options: A dictonary of options. @type options: dict @ivar cookiejar: A cookie jar. @type cookiejar: libcookie.CookieJar cCs.||_||_|j|_t|_dS(s @param client: A suds client. @type client: L{Client} @param method: A target method. @type method: L{Method} N(RnRR Rt cookiejar(R,RnR((s#suds-0.3.7-py2.6.egg/suds/client.pyR02s   cCstj}|jd}|jjj}|j|_|j|j||}|j tj j d|jj ||j|j |}|j tj j d|jj ||S(sm Send the required soap message to invoke the specified method @param args: A list of args for the method invoked. @type args: list @param kwargs: Named (keyword) args for the method invoked. @type kwargs: dict @return: The result of the method invocation. @rtype: I{builtin}|I{subclass of} L{Object} smessage for '%s' created: %ssmethod '%s' invoked: %sN(RSRTRUR*RtbindingtinputR t get_messageRbR^RcR]tsend(R,RR.RdRfRtmsg((s#suds-0.3.7-py2.6.egg/suds/client.pyR>s"        c Csd}|j}|jjj}|jj}|jj}tj d||yq|j t |t |t |}|j|_|j|}|r|j}n|j||j}WnPtk r} | jdkrd}qtj|j |j|| }nX|S(s Send soap message. @param msg: A soap message to send. @type msg: basestring @return: The reply to the sent message. @rtype: I{builtin} or I{subclass of} L{Object} ssending to (%s) message: %siiN(ii(R*tlocationRRRR RtretxmlR^RcR<R RtstrtheadersRtmessaget succeededRthttpcodeR_tfailed( R,RRfRRRRtrequesttreplyRg((s#suds-0.3.7-py2.6.egg/suds/client.pyRZs(     cCsL|jjj}idd6|d6}t||jj}tjd||S(s Get http headers or the http/https request. @return: A dictionary of header/values. @rtype: dict stext/xmls Content-Typet SOAPActions headers = %s(RtsoaptactionRR RR^Rc(R,RtstockRf((s#suds-0.3.7-py2.6.egg/suds/client.pyRys cCstjd|t|dkrg|j|j|\}}|j||jjrZ|Sd|fSn|jjrwdSdSdS(s Request succeeded, process the reply @param binding: The binding to be used to process the reply. @type binding: L{bindings.binding.Binding} @return: The method result. @rtype: I{builtin}, L{Object} @raise WebFault: On server. shttp succeeded: %siiN(iN( R^RcRut get_replyRR=R RR*(R,RRtrR2((s#suds-0.3.7-py2.6.egg/suds/client.pyRs     cCs|jt|}}|jj}tjd||dkrt|dkr|j|\}}|j|||fS|dfSn|j j rt ||fn |dfSdS(s Request failed, process reply based on reason @param binding: The binding to be used to process the reply. @type binding: L{suds.bindings.binding.Binding} @param error: The http error message @type error: L{transport.TransportError} shttp failed: %siiN( RttostrtfptreadR^RcRut get_faultR=R*R RR6(R,RR_tstatustreasonRRR2((s#suds-0.3.7-py2.6.egg/suds/client.pyRs     cCs%t|j}|jd|jjS(NR(RR R;RR(R,R2((s#suds-0.3.7-py2.6.egg/suds/client.pyRscCs9d}|jj}|dkr+|j|S|||eZdZdZedZdZdZdZRS(s< Loopback client used for message/reply simulation. t__injectcCs|jtjS(s; get whether loopback has been specified in the I{kwargs}. (thas_keyRtinjkey(RR.((s#suds-0.3.7-py2.6.egg/suds/client.pyRscCs||j}|jd}|jd}|jd}|dkr|dk re|j|||S|dk r~|j|Stdntjd|}|j|S(sp Send the required soap message to invoke the specified method @param args: A list of args for the method invoked. @type args: list @param kwargs: Named (keyword) args for the method invoked. @type kwargs: dict @return: The result of the method invocation. @rtype: I{builtin} or I{subclass of} L{Object} RRtfaults$(reply|fault) expected when msg=NonetstringN( RR;R*t_SimClient__replyt_SimClient__faultR6RtparseR(R,RR.RRRR((s#suds-0.3.7-py2.6.egg/suds/client.pyRs     cCsn|jjj}|j|_|j|j||}tjd||jjj}|j|_|j||S(s simulate the reply s#inject (simulated) send message: %s( RRRR RR^RctoutputR(R,RRR.RR((s#suds-0.3.7-py2.6.egg/suds/client.pyt__replys  cCs[|jjj}|j|_|jjrS|j|\}}|j|d|fSdSdS(s simulate the (fault) reply iN(iN(RRRR RRR=R*(R,RRRR2((s#suds-0.3.7-py2.6.egg/suds/client.pyt__faults    ( R?R@RNRRORRRR(((s#suds-0.3.7-py2.6.egg/suds/client.pyRs   (((((((0RNRGt suds.metricsRSt cookielibRtsuds.transportRRtsuds.transport.httpsRtsuds.transport.cacheRtsuds.servicedefinitionRRRRYR t suds.resolverR t suds.builderR t suds.wsdlR tsuds.sax.documentR tsuds.sax.parserRt suds.optionsRtsuds.propertiesRRtcopyRtloggingRR?R^RZRR%R{RRRR(((s#suds-0.3.7-py2.6.egg/suds/client.pyts<   6fg0-