+ :hO Rt.R+Ot^R It^R IHt^R It^R It^R It^R It^R I t ^R I t ^R I H t ^R I HuHt^RIHtHt^RIHtRtRtRtRtRt!RR ]4t!RR]4t!RR]4t!RR4t!RR4t !RR]4t!!RR]!4t"!R R]4t#!R!R"]] 4t$!R#R] 4t%!R$R]!] 4t&!R%R]4t'!R&R']4t(!R(R]!4t)!R)R ]4t*!R*R]4t+R #),aNavigate the resources exposed by a web service. The wadllib library helps a web client navigate the resources exposed by a web service. The service defines its resources in a single WADL file. wadllib parses this file and gives access to the resources defined inside. The client code can see the capabilities of a given resource and make the corresponding HTTP requests. If a request returns a representation of the resource, the client can bind the string representation to the wadllib Resource object. ApplicationLinkMethodNoBoundRepresentationError ParameterRepresentationDefinitionResponseDefinitionResource ResourceType WADLErrorN)quote) urlencode)URImerge) iso_strptimez xmlns:mapz http://www.w3.org/2001/XMLSchemacRV,#)z)Scope a tag name with the WADL namespace.z&{http://research.sun.com/wadl/2006/10}tag_names&5/usr/lib/python3/dist-packages/wadllib/application.pywadl_tagr=s 3h >>c&R\V4,#)z#Turn a tag name into an XPath path.z./)rrs&r wadl_xpathrBs (8$ $$rcJ/pVFpVfK VPV4K V#)z%{{<+<+<+>?@A A!AsFrN)T) r"r#r$r%r&r<rNr'__classdictcell__ __classdict__s@rr.r.ksK <- - rr.c<a]tRt^toRtRtRtRtRtRt Vt R#)WADLResolvableDefinitionz=A base class for objects whose definitions may be references.c RVnWnR#)zInitialize with a WADL application. :param application: A WADLDefinition. Relative links are assumed to be relative to this object's URL. N _definition application)r8rYs&&r__init__!WADLResolvableDefinition.__init__s  &rc VPe VP#VP4pVf WnV#VPPV4pVP V4pVf\ RV,4hW0nV#)aReturn the definition of this object, wherever it is. Resource is a good example. A WADL tag may contain a large number of nested tags describing a resource, or it may just contain a 'type' attribute that references a which contains those same tags. Resource.resolve_definition() will return the original Resource object in the first case, and a ResourceType object in the second case. No such XML ID: "%s")rX_get_definition_urlrY lookup_xml_id_definition_factoryKeyError)r8 object_urlxml_id definitions& rresolve_definition+WADLResolvableDefinition.resolve_definitions    '## #--/   $ K!!// ;--f5   1J>? ?%rc \4h)zhTransform an XML ID into a wadllib wrapper object. Which kind of object it is depends on the subclass. NotImplementedErrorr8ids&&rr`,WADLResolvableDefinition._definition_factory "##rc \4h)z]Find the URL that identifies an external reference. How to do this depends on the subclass. rhr8s&rr^,WADLResolvableDefinition._get_definition_urlrmrrWN) r"r#r$r%r&rZrer`r^r'rQrRs@rrUrUs"G' D$$$rrUcaa]tRt^toRtRV3Rllt]R4t]R4t]R4t RRlt Rt RRlt RR lt RR lt]R 4tRR ltR tRtRtRtRRltRtRtVtV;t#)r z/A resource, possibly bound to a representation.c X<\SV`V4W n\V\4'd,VP P V4PVnMW0nRVnVeVR8XdqV'db\VR4'd+\P!VP44VnM>\P!\ V44VnMW@nM\RV,4hWPnVe/Ve WpnR#VP!VP4VnR#R#)a :param application: A WADLApplication. :param url: The URL to this resource. :param resource_type: An ElementTree or tag. :param representation: A string representation. :param media_type: The media type of the representation. :param representation_needs_processing: Set to False if the 'representation' parameter should be used as is. Otherwise, it will be transformed from a string into an appropriate Python data structure, depending on its media type. :param representation_definition: A RepresentationDefinition object describing the structure of this representation. Used in cases when the representation isn't the result of sending a standard GET to the resource. Napplication/jsondecodez?This resource doesn't define a representation for media type %s)superrZ_url isinstancestrrYget_resource_typer4representationhasattrjsonloadsrtr* media_typerepresentation_definitionget_representation_definition) r8rYurl resource_typerzr~representation_needs_processingr __class__s &&&&&&&&rrZResource.__init__s* % mS ) )''99-HLLDH%H"  %//2~x88.2jj*113/5+/3jj^9L.M+*8'/$&0122%  %(41J.66tG. &rc VP#)z Return the URL to this resource.)rvros&rr Resource.url$syyrc ZVPfR#VPPPR4pVeV#VPPPR4pVeG\VPP 4P 4p\V4R,V,#R#)z@Return the URL to the type definition for this resource, if any.Ntyperk#)r4r6r7rrY markup_url ensureSlashrx)r8rtype_idbases& rtype_urlResource.type_url)s 88 hhoo!!&) ?J((//%%d+  t''223??ADt9s?W, ,rc <VPPR,#)zReturn the ID of this resource.rk)r4r6ros&rrk Resource.id;sxxt$$rc  ^\VPVPVPWVV4#)a7Bind the resource to a representation of that resource. :param representation: A string representation :param media_type: The media type of the representation. :param representation_needs_processing: Set to False if the 'representation' parameter should be used as is. :param representation_definition: A RepresentationDefinition object describing the structure of this representation. Used in cases when the representation isn't the result of sending a standard GET to the resource. :return: A Resource bound to a particular representation. )r rYrr4)r8rzr~rrs&&&&&rbind Resource.bind@s."(($((DHH&713 3rc VPR4PpVFApVP4PpVPP R4V8XgK?Vu# \ RV,4h)z>2N!/!B!B!D!H!H !((,,[9ZG%%3()>@J)KL Lrc VP4FnpVPPRR4P4pVeWaP48XgKG\ W4pVP W#V4'gKlVu# R#)aLook up one of this resource's methods by HTTP method. :param http_method: The HTTP method used to invoke the desired method. Case-insensitive and optional. :param media_type: The media type of the representation accepted by the method. Optional. :param query_params: The names and values of any fixed query parameters used to distinguish between two methods that use the same HTTP method. Optional. :param representation_params: The names and values of any fixed representation parameters used to distinguish between two methods that use the same HTTP method and have the same media type. Optional. :return: A MethodDefinition, or None if there's no definition that fits the given constraints. rAN)_method_tag_iterr6r7lowerris_described_by)r8 http_methodr~ query_paramsrepresentation_params method_tagrAmethods&&&&& rrResource.get_method`sz0//1J$$((4::@ @ ??0 0'))!*122'' 7E +/+F+FMM9>>,3( !%66%)== 4 ,U 3L5L!#G$(OO#45 5& 44$,$5$5"&--z"B3"G%JEL *4#-U"33 4 4s4 C D9+0DD55D9c VeRV9dVPR^4wr2MRpVP\4pVPVR4pWR3#)zxSplits a value into namespace URI and value. :param tag: A tag to use as context when mapping namespace names to URIs. N:r)splitr7NS_MAP)r8r4rD namespacens_maprs&&& rrResource._dereference_namespacesP  ${{32 IuI 9d3 ##rc LVPPPV4#)z-Given an ID, find a ResourceType for that ID.)rYresource_typesr7rjs&&rr`Resource._definition_factorys..22266rc LVPPPR4#)zReturn the URL that shows where a resource is 'really' defined. If a resource's capabilities are defined by reference, the tag's 'type' attribute will contain the URL to the that defines them. rr4r6r7ros&rr^Resource._get_definition_urlxx""6**rc VPe+VPP4pVP4#Ve"VPV4pVP4#\ R4h)aGet the most appropriate representation definition. If media_type is provided, the most appropriate definition is the definition of the representation of that media type. If this resource is bound to a representation, the most appropriate definition is the definition of that representation. Otherwise, the most appropriate definition is the definition of the representation served in response to a standard GET. :param media_type: Media type of the definition to find. Must be present unless the resource is bound to a representation. :raise NoBoundRepresentationError: If this resource is not bound to a representation and media_type was not provided. :return: A RepresentationDefinition zSResource is not bound to any representation, and no media media type was specified.)rzrrerr)r8r~rds&& rr(Resource._find_representation_definitionst*    *77JJLJ,,..  #;;JGJ ,,..-,- -rc# "VP4PpVP\R44RjxL R#L5i)z+Iterate over this resource's tags.rN)rer4r5rr8rds& rrResource._method_tag_iter s2,,.22 %%j&:;;;s8AAA)rvr~rzrr4)NNTN)rsTN)NNNNrP)r"r#r$r%r&rZpropertyrrrkrrrrrrrrrr`r^rrr'rQ __classcell__rrSs@@rr r s95In"%%3,LB % .++ &-5^ $7+ /D< tag. c TWnVPPVnW nR#)zQInitialize with a tag. :param method_tag: An ElementTree tag. N)r2rYr4)r8r2rs&&&rrZMethod.__init__)s ! ==44rc \\WPP\R444#)z@Return the definition of a request that invokes the WADL method.request)RequestDefinitionr4findrros&rrMethod.request2s!!xx}}Z 5J'KLLrc r\VPVPP\ R444#)z9Return the definition of the response to the WADL method.r)rr2r4rrros&rrMethod.response7s."$--"&((-- :0F"GI Irc LVPPPR4#)z)The XML ID of the WADL method definition.rkrros&rrk Method.id=sxx""4((rc hVPPPR4P4#)zThe name of the WADL method definition. This is also the name of the HTTP method (GET, POST, etc.) that should be used to invoke the WADL method. rAr4r6r7rros&rrA Method.nameBs&xx""6*0022rNc <VPP!V3/VB#)4Return the request URL to use to invoke this method.)r build_url)r8rIrKs&&,rbuild_request_urlMethod.build_request_urlKs||%%lFoFFrc <VPP!W3/VB#)zrBuild a representation to be sent when invoking this method. :return: A 2-tuple of (media_type, representation). )rrz)r8r~rIrKs&&&,rbuild_representationMethod.build_representationOs& ||** 9(79 9rc RpVe"VPPV4pVfR#VeA\V4^8d1VPpVfR#VPVPVR4Ve\V4^8XdR#VeVP V4#VPPF1pVPVPVP4VR4R# R# \ dR#i;i \ dKWi;i)aReturns true if this method fits the given constraints. :param media_type: The method must accept this media type as a representation. :param query_values: These key-value pairs must be acceptable as values for this method's query parameters. This need not be a complete set of parameters acceptable to the method. :param representation_values: These key-value pairs must be acceptable as values for this method's representation parameters. Again, this need not be a complete set of parameters acceptable to the method. NFT) rrrErNrr3rrepresentationsr<r2)r8r~ query_valuesrepresentation_valuesrzrs&&&& rrMethod.is_described_byXs$  !!\\GGN%  #L(9A(=llG --((,? " ),-2  %!11%' '"ll::N 44"))$--8)52 ;'  "  s$C$1,C6$ C32C36 DD)rYr2r4rPNN)NNN)r"r#r$r%r&rZrrrrkrArrrr'rQrRs@rrr&sxMMII ))33G955rcha]tRtRtoRtRt]R4t]R4tR Rlt R Rlt R R lt R t Vt R#) rizBA wrapper around the description of the request invoking a method.c WnVPPVnVPPVnW nR#)zInitialize with a tag. :param resource: The resource to which this request can be sent. :param request_tag: An ElementTree tag. N)rr2rYr4)r8r request_tags&&&rrZRequestDefinition.__init__s1   ,, ==44rc &VPR.4#)z,Return the query parameters for this method.query)r<ros&rrRequestDefinition.query_paramss{{G9%%rc#"VPP\R44F&p\VPVP V4xK( R#5i)rzN)r4r5rrrYr2rs& rr!RequestDefinition.representationssC((**:6F+GHJ*  $--= =IsAANc ^VPFpVeVPV8XgKVu# R#)z1Return the appropriate representation definition.N)rr~r8r~rzs&& rr/RequestDefinition.get_representation_definitions0"22N!^%>%>*%L%%3rc vVPV4pVf\RV,4hVP!V3/VB#)zpBuild a representation to be sent along with this request. :return: A 2-tuple of (media_type, representation). z,Cannot build representation of media type %s)r TypeErrorr)r8r~rIrKrds&&&, rrz RequestDefinition.representationsF 77 C  J()* *|???rc VP!VPV3/VBpVPPp\ V4^8d<RV9dRpMRpWE\ \ VP444,, pV#)r?&)rNrr2rrEr sorteditems)r8rIrKrLrappends&&, rrRequestDefinition.build_urls|55   |@/>@mm  1 $cz If-=-C-C-E&FGG GC r)rYrr2r4rPr)r"r#r$r%r&rZrrrrrzrr'rQrRs@rrrsJL &&==  @  rrcLa]tRtRtoRtR RltRtRtRtRt R t R t Vt R#) riz;A wrapper around the description of a response to a method.Nc LVPVnWnW nW0nR#)zWInitialize with a tag. :param response_tag: An ElementTree tag. N)rYr2r4headers)r8r2 response_tagrs&&&&rrZResponseDefinition.__init__s! $//  rc# "\R4pVPPV4F0p\VPP VPV4xK2 R#5i)zGet an iterator over the representation definitions. These are the representations returned in response to an invocation of this method. rzN)rr4r5rr2rY)r8pathrs& r__iter__ResponseDefinition.__iter__sQ *+"&(("2"24"8 * ))4==:LN N#9sAAc D\VPVPV4#)zwBind the response to a set of HTTP headers. A WADL response can have associated header parameters, but no other kind. )rr2r4)r8rs&&rrResponseDefinition.binds "$--7CCrc VPP\R44FRpVPP R4V8XgK%VPP R4R8XgKG\ W4u# R#)z,Find a header parameter within the response.r0rAr1headerN)r4r5rr6r7r)r8rr;s&& rr ResponseDefinition.get_parametersb))*W*=>I  $$V, :!((,,W5A 11?rc VPf \R4hVPR8wd\RVP,4hVPP VP 4#)z:Find the value of a parameter, given the Parameter object.z,Response object is not bound to any headers.rr)rrr1rir7rA)r8rs&&rr&ResponseDefinition.get_parameter_valuesc << ,>@ @ ??h &%&__-. .|| //rc bVPfR#VFpVPV8XgKVu# R#)z8Get one of the possible representations of the response.N)r4r~rs&& rr0ResponseDefinition.get_representation_definitions2 88 "N((J6%%#r)rYrr2r4rP) r"r#r$r%r&rZrrrrrr'rQrRs@rrrs-E ND 0rcaa]tRtRtoRtV3RltV3RltRt]R4t Rt Rt RR lt R t R tR tR tRtVtV;t#)ri z2A definition of the structure of a representation.c><\SV`V4W nW0nR#rP)rurZr2r4)r8rYr2rrs&&&&rrZ!RepresentationDefinition.__init__s % %rc(<\SV`RR.V4#)rr)rur<)r8r2rs&&rr<RepresentationDefinition.paramssw~w0(;;rc `VPV4Uu.uFq"PNK up#uupi)z#Return the names of all parameters.)r<rA)r8r2r0s&& rr(RepresentationDefinition.parameter_namess'(, H(=>(=u (=>>>s+c XVP4PPR,#)z4The media type of the representation described here.r)rer4r6ros&rr~#RepresentationDefinition.media_types$&&(,,33K@@rc \\\P^, 44pRV,p\P !\P4pRW4,,R,pVfV#Tp^pR\ P!V4,R,PR4p\ P!W\ PR7'gV#VR,\V4,pV^, pK) z;Make a random boundary that does not appear in `all_parts`.z%%0%ddz==z^--z(--)?$ascii)flags.z===============) rEreprsysmaxsizerandom randrangereescapeencodesearch MULTILINErx) r8 all_parts_width_fmttokenboundarybcounterpatterns && r_make_boundary'RepresentationDefinition._make_boundarysT#++/*+&   -.5  O ryy|+h6>>wGG99Wr||DD3W-A qLGrc VFgwr4VPVPR44VPR4VPVPR44VPR4Ki VPR4R#)z$Write MIME headers to a file object.UTF-8s:  Nwriter8)r8bufrkeyrDs&&& r_write_headers'RepresentationDefinition._write_headers1s^!JC IIcjj) * IIe  IIell7+ , IIg  " 'rc VPR4VPVPR44V'dVPR4VPR4R#)z,Write a multipart boundary to a file object.s--rFrGNrH)r8rJr?closings&&&&r_write_boundary(RepresentationDefinition._write_boundary:s> % (//'*+  IIe  'rc .pVEFwr4p\P!4pV'd!RpR\V4: R\V4: R2pMRpR\V4,pVPVRRV3RV3.4V'dD\ V\ 4'g\ R \V4,4hVPV4M\ V\4'g\ R \V4,4h\P!R V4p V R RF4p VPV PR 44VPR4K6 VPV R,PR 44VPVP44EK VPRP!V44p \P!4pR\V 4,pVPVRRV3.4VF6p VP#Wk4VPV 4VPR4K8 VP#WkRR7WvP43#)a Generate a multipart/form-data message. This is very loosely based on the email module in the Python standard library. However, that module doesn't really support directly embedding binary data in a form: various versions of Python have mangled line separators in different ways, and none of them get it quite right. Since we only need a tiny subset of MIME here, it's easier to implement it ourselves. :return: a tuple of two elements: the Content-Type of the message, and the entire encoded message as a byte string. zapplication/octet-streamzform-data; name="z "; filename="r@ztext/plain; charset="utf-8"zform-data; name="%s"z Content-TypezContent-Dispositionzbytes payload expected: %szstring payload expected: %sz \r\n|\r|\nNrFrGz"multipart/form-data; boundary="%s"T)rO)z MIME-Versionz1.0)ioBytesIOr rLrwbytesr rrIrxr6rr8rgetvaluerCrFrP) r8parts encoded_parts is_binaryrArDrJctypecdisplinesliner? encoded_parts && r_generate_multipart_form1RepresentationDefinition._generate_multipart_formBs &+ "IU**,C2 $Kt.6.t<   ''&.&  !%//#$@4;$NOO % !%--#5U CEE6!#2JDIIdkk'23IIg&' %)**734   0?',D&&w||M'BCjjl4uXF C # U #" *L   / IIl # IIg * SD9lln$$rc RVP4pVPVP4pVP!WA3/VBpVPpVR8Xd&\ \ VP444pWg3#VR8Xdz.p\4p VFQp VPV PV 4p WJgK&VPV PR8HV PV 34KS VPV4wrgWg3#VR8Xd\P!V4pWg3#\!RV,4h)zjBind the definition to parameter values, creating a document. :return: A 2-tuple (media_type, document). z!application/x-www-form-urlencodedzmultipart/form-databinaryrszUnsupported media type: '%s')rer<r2rNr~r rrobjectr7rArrr`r|dumpsr3) r8rIrKrdr<rLr~docrXmissingr0rDs &&, rrRepresentationDefinition.binds) ,,. ""4==155 5$35__ < <F#3#9#9#;<=C0 0EhG(,,UZZA'LL%**"8%**e!LM #;;EBOJ  - -**-.C;jHI Irc LVPPPV4#)z9Turn a representation ID into a RepresentationDefinition.)rYrepresentation_definitionsr7rjs&&rr`,RepresentationDefinition._definition_factorys::>>rBBrc LVPPPR4#)zFind the URL containing the representation's 'real' definition. If a representation's structure is defined by reference, the tag's 'href' attribute will contain the URL to the that defines the structure. hrefrros&rr^,RepresentationDefinition._get_definition_urlrr)r2r4)F)r"r#r$r%r&rZr<rrr~rCrLrPr`rr`r^r'rQrrs@@rrr sX<& <?AA$@%D4C++rca]tRtRtoRtRt]R4t]R4t]R4t ]R4t ]R4t R t ]R 4t ]R 4t]R 4tR tVtR#)riz5One of the parameters of a representation definition.c @VPVnWnW nR#)aInitialize with respect to a value container. :param value_container: Usually the resource whose representation has this parameter. If the resource is bound to a representation, you'll be able to find the value of this parameter in the representation. This may also be a server response whose headers define a value for this parameter. :tag: The ElementTree tag for this parameter. N)rYvalue_containerr4)r8rqr4s&&&rrZParameter.__init__s+66.rc LVPPPR4#)zThe name of this parameter.rArros&rrAParameter.namexx""6**rc LVPPPR4#)zThe style of this parameter.r1rros&rr1Parameter.stylesxx""7++rc LVPPPR4#)zThe XSD type of this parameter.rrros&rrParameter.typerurc LVPPPR4#)aThe value to which this parameter is fixed, if any. A fixed parameter must be present in invocations of a WADL method, and it must have a particular value. This is commonly used to designate one parameter as containing the name of the server-side operation to be invoked. fixedrros&rrBParameter.fixed_valuesxx""7++rc pVPPPRR4P4R9#)z6Whether or not a value for this parameter is required.requiredfalse)1truerros&rrGParameter.is_requireds2##J8>>@ ! "rc 8VPPV4#)zThe value of this parameter in the bound representation/headers. :raise NoBoundRepresentationError: If this parameter's value container is not bound to a representation or a set of headers. )rqrros&r get_valueParameter.get_values##77==rc VPP\R44Uu.uFp\W4NK up#uupi)z7Return the set of acceptable values for this parameter.rM)r4r5rOption)r8 option_tags& rrCParameter.optionssF#'(("2"2:h3G"HJ"HJt("HJ JJs>c lVPP\R44pVfR#\W4#)zGet the link to another resource. The link may be examined and, if its type is of a known WADL description, it may be followed. :return: A Link object, or None. linkN)r4rrr)r8link_tags& rrParameter.links/88==F!34  D##rc PVPpVf \R4hVP#)zFollow a link from this parameter to a new resource. This only works for parameters whose WADL definition includes a tag that points to a known WADL description. :return: A Resource object for the resource at the other end of the link. z(This parameter isn't a link to anything.)rr3follow)r8rs& rlinked_resourceParameter.linked_resources(yy <GH H{{r)rYr4rqN)r"r#r$r%r&rZrrAr1rrBrGrrCrrr'rQrRs@rrrs? ++,,++,,"" >JJ  $ $  rc:a]tRtRtoRtRt]R4tRtVt R#)ri z0One of a set of possible values for a parameter.c WnW nR#)zeInitialize the option. :param parameter: A Parameter. :param link_tag: An ElementTree