:hOSr/SQrSSKrSSKJr SSKrSSKrSSKrSSKrSSK r SSK r SSK J r SSK Js Jr SSKJrJr SSKJr SrS rS rS rS r"S S\5r"SS\5r"SS\5r"SS5r"SS5r "SS\5r!"SS\!5r""SS\5r#"SS\\ 5r$"SS \ 5r%"S!S"\!\ 5r&"S#S$\5r'"S%S&\5r("S'S(\!5r)"S)S*\5r*"S+S,\5r+g)-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/XMLSchemac SU-$)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 >>cS[U5-$)z#Turn a tag name into an XPath path.z./)rrs r wadl_xpathrBs (8$ $$rcH0nUHnUcMURU5 M U$)zrB param_valuesenforce_completenesskw_param_valuesvalidated_valuesr6rGoptionrIs rvalidate_param_values(HasParametersMixin.validate_param_values}sf"$LB E::D  ,((.%2C2CC$(4(:D(-(9(9&;<<&+%6%6 "27--@-||-G@G q T%9$*'9 $*D&++g2F"HII%):):0 !G#'"())#)5); & &-. | q >%{{<+<+<+>?@A A!AsErN)T)r$r%r&r'r(rBrTr)rrrr3r3ksK < 48- rr3c0\rSrSrSrSrSrSrSrSr g) WADLResolvableDefinitionz=A base class for objects whose definitions may be references.cSUlXlg)zInitialize with a WADL application. :param application: A WADLDefinition. Relative links are assumed to be relative to this object's URL. N _definition application)r>r]s r__init__!WADLResolvableDefinition.__init__s  &rcURb UR$UR5nUcXlU$URRU5nUR U5nUc[ SU-5eX0lU$)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")r\_get_definition_urlr] lookup_xml_id_definition_factoryKeyError)r> object_urlxml_id definitions rresolve_definition+WADLResolvableDefinition.resolve_definitions    '## #--/   $ K!!// ;--f5   1J>? ?%rc[5e)zhTransform an XML ID into a wadllib wrapper object. Which kind of object it is depends on the subclass. NotImplementedErrorr>ids rrd,WADLResolvableDefinition._definition_factory "##rc[5e)z]Find the URL that identifies an external reference. How to do this depends on the subclass. rlr>s rrb,WADLResolvableDefinition._get_definition_urlrqrr[N) r$r%r&r'r(r^rirdrbr)rrrrXrXsG' D$$rrXc^\rSrSrSrSU4Sjjr\S5r\S5r\S5r SSjr Sr SS jr SS jr SS jr\S 5rSS jrSrSrSrSrSSjrSrSrU=r$)r z/A resource, possibly bound to a representation.c<>[TU]U5 X l[U[5(a+UR R U5RUlOX0lSUlUbUS:XanU(a`[US5(a*[R"UR55UlO:[R"[ U55UlOX@lO[SU-5eXPlUb+UbXplgUR!UR5Ulgg)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)superr^_url isinstancestrr]get_resource_typer:representationhasattrjsonloadsryr- media_typerepresentation_definitionget_representation_definition) r>r]url resource_typerrrepresentation_needs_processingr __class__s rr^Resource.__init__s* % mS ) )''99-HLLDH%H"  %//2~x88.2jj*113/5+/3jj^9L.M+*8'/$&0122%  %(41J.66tG. &rcUR$)z Return the URL to this resource.)r{rss rr Resource.url$syyrc@URcgURRRS5nUbU$URRRS5nUb>[URR 5R 5n[U5S-U-$g)z@Return the URL to the type definition for this resource, if any.Ntypero#)r:r<r=rr] markup_url ensureSlashr})r>rtype_idbases rtype_urlResource.type_url)s 88 hhoo!!&) ?J((//%%d+  t''223??ADt9s?W, ,rc4URRS$)zReturn the ID of this resource.ro)r:r<rss rro Resource.id;sxxt$$rc ^[URURURXUU5$)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 r]rr:)r>rrrrs rbind Resource.bind@s."(($((DHH&713 3rcURS5RnUH@nUR5RnURR S5U:XdM>Us $ [ SU-5e)zrdefault_get_responserrepresentation_tags rr&Resource.get_representation_definitionVst#u5>>2N!/!B!B!D!H!H !((,,[9ZG%%3()>@J)KL LrcUR5HknURRSS5R5nUbXaR5:XdME[ X5nUR X#U5(dMiUs $ g)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. rGN)_method_tag_iterr<r=lowerris_described_by)r> http_methodr query_paramsrepresentation_params method_tagrGmethods rrResource.get_method`sz0//1J$$((4::rs r parametersResource.parameterss#33 t  %rcBURU5RU5$)aRA list naming this resource's parameters. :param media_type: Media type of the representation definition whose parameters are being named. Must be present unless this resource is bound to a representation. :raise NoBoundRepresentationError: If this resource is not bound to a representation and media_type was not provided. )rparameter_namesrs rrResource.parameter_namess$33 '- .rc#T# UR5Hn[X5v M g7f)z6An iterator over the methods defined on this resource.N)rr)r>rs r method_iterResource.method_iters%//1J* *2s&(cURU5nURnUR[S55H/nURR S5U:XdM$[ X5s $ g)aFind a parameter within a representation definition. :param param_name: Name of the parameter to find. :param media_type: Media type of the representation definition whose parameters are being named. Must be present unless this resource is bound to a representation. :raise NoBoundRepresentationError: If this resource is not bound to a representation and media_type was not provided. r6rGN)rr:r;rr<r=r)r> param_namerrhrrAs r get_parameterResource.get_parametersb99*E '^^+33Jw4GHI##F+z9 11IrcFURc [S5eURS:XaURS:wa[ SUR-5eURUR nUbFUR URUR5up4U[:XaUS;a[U5nU$U$[ S UR-5e![aI [R"[R"US5SS6nU$![a [U5ef=ff=f) zFind the value of a parameter, given the Parameter object. :raise ValueError: If the parameter value can't be converted into its defined type. z,Resource is not bound to any representation.rxplain8Don't know how to find value for a parameter of type %s.)dateTimedatez%Y-%m-%dr zEPath traversal not implemented for a representation of media type %s.)rrrr7rmrG_dereference_namespacer:rXML_SCHEMA_NS_URIrr9datetimetimestrptime)r> parameterrJ namespace_url data_types rget_parameter_valueResource.get_parameter_valuesC    &,>@ @ ??0 0'))!*122'' 7E +/+F+FMM9>>,3( !%66%)== 4 ,U 3L5L!#G$(OO#45 5& 44$,$5$5"&--z"B1Q"G%JEL *4#-U"33 4 4s& C D +DDD cUbSU;aURSS5up2OSnUR[5nURUS5nXR4$)zxSplits a value into namespace URI and value. :param tag: A tag to use as context when mapping namespace names to URIs. N:r)splitr=NS_MAP)r>r:rJ namespacens_maprs rrResource._dereference_namespacesP  ${{32 IuI 9d3 ##rcLURRRU5$)z-Given an ID, find a ResourceType for that ID.)r]resource_typesr=rns rrdResource._definition_factorys..22266rcLURRRS5$)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. rr:r<r=rss rrbResource._get_definition_urlxx""6**rcURb*URR5nUR5$Ub!URU5nUR5$[ S5e)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.)rrrirr)r>rrhs rr(Resource._find_representation_definitionst*    *77JJLJ,,..  #;;JGJ ,,..-,- -rc## UR5RnUR[S55ShvN gN7f)z+Iterate over this resource's tags.rN)rir:r;rr>rhs rrResource._method_tag_iter s2,,.22 %%j&:;;;s8AAA)r{rrrr:)NNTN)rxTN)NNNNrV)r$r%r&r'r(r^propertyrrrorrrrrrrrrrdrbrrr) __classcell__rs@rr r s92615+/5In"%%/A-1'+3,LJN)-B % .++ &-5^ $7+ /D< tag. cRXlURRUlX lg)zQInitialize with a tag. :param method_tag: An ElementTree tag. N)r8r]r:)r>r8rs rr^Method.__init__)s ! ==44rc\[XRR[S555$)z@Return the definition of a request that invokes the WADL method.request)RequestDefinitionr:findrrss rrMethod.request2s!!xx}}Z 5J'KLLrcr[URURR[ S555$)z9Return the definition of the response to the WADL method.r)rr8r:rrrss rrMethod.response7s."$--"&((-- :0F"GI IrcLURRRS5$)z)The XML ID of the WADL method definition.rorrss rro Method.id=sxx""4((rchURRRS5R5$)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. rGr:r<r=rrss rrG Method.nameBs&xx""6*0022rNc <URR"U40UD6$)4Return the request URL to use to invoke this method.)r build_url)r>rOrQs rbuild_request_urlMethod.build_request_urlKs||%%lFoFFrc <URR"X40UD6$)zrBuild a representation to be sent when invoking this method. :return: A 2-tuple of (media_type, representation). )rr)r>rrOrQs rbuild_representationMethod.build_representationOs& ||** 9(79 9rcSnUbURRU5nUcgUb=[U5S:a.URnUcgURURUS5 Ub[U5S:XagUbUR U5$URRH0nURURUR5US5 g g![ a gf=f![ a MRf=f)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. NFr T) rrrKrTrr9rrepresentationsrBr8)r>r query_valuesrepresentation_valuesrrs rrMethod.is_described_byXs$  !!\\GGN%  #L(9A(=llG --((,? " ),-2  %!11%' '"ll::N 44"))$--8)52 ;'  "  s$C&,C' C$#C$' C54C5)r]r8r:rVNN)NNN)r$r%r&r'r(r^rrrrorGrrrr)rrrrr&sMMII ))33G/3*.9=A.25rrc\\rSrSrSrSr\S5r\S5rS Sjr S Sjr S S jr S r g) rizBA wrapper around the description of the request invoking a method.cXlURRUlURRUlX lg)zInitialize with a tag. :param resource: The resource to which this request can be sent. :param request_tag: An ElementTree tag. N)rr8r]r:)r>r request_tags rr^RequestDefinition.__init__s1   ,, ==44rc&URS/5$)z,Return the query parameters for this method.query)rBrss rrRequestDefinition.query_paramss{{G9%%rc## URR[S55H&n[URUR U5v M( g7f)Nr)r:r;rrr]r8rs rr!RequestDefinition.representationssC((**:6F+GHJ*  $--= =IsAANcXURHnUbURU:XdMUs $ g)z1Return the appropriate representation definition.N)rrr>rrs rr/RequestDefinition.get_representation_definitions0"22N!^%>%>*%L%%3rc lURU5nUc[SU-5eUR"U40UD6$)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)r>rrOrQrhs rr RequestDefinition.representationsF 77 C  J()* *|???rc UR"URU40UD6nURRn[ U5S:a2SU;aSnOSnXE[ [ UR555-- nU$)rr ?&)rTrr8rrKrsorteditems)r>rOrQrRrappends rrRequestDefinition.build_urls|55   |@/>@mm  1 $cz If-=-C-C-E&FGG GC r)r]rr8r:rVr) r$r%r&r'r(r^rrrrrrr)rrrrrsBL &&==  @ rrc@\rSrSrSrS SjrSrSrSrSr S r S r g) riz;A wrapper around the description of a response to a method.NcJURUlXlX lX0lg)zWInitialize with a tag. :param response_tag: An ElementTree tag. N)r]r8r:headers)r>r8 response_tagrs rr^ResponseDefinition.__init__s! $//  rc## [S5nURRU5H0n[URR URU5v M2 g7f)zGet an iterator over the representation definitions. These are the representations returned in response to an invocation of this method. rN)rr:r;rr8r])r>pathrs r__iter__ResponseDefinition.__iter__sQ *+"&(("2"24"8 * ))4==:LN N#9sAAcD[URURU5$)zwBind the response to a set of HTTP headers. A WADL response can have associated header parameters, but no other kind. )rr8r:)r>rs rrResponseDefinition.binds "$--7CCrcURR[S55HPnURR S5U:XdM$URR S5S:XdME[ X5s $ g)z,Find a header parameter within the response.r6rGr7headerN)r:r;rr<r=r)r>rrAs rr ResponseDefinition.get_parametersb))*W*=>I  $$V, :!((,,W5A 11?rcURc [S5eURS:wa[SUR-5eURR UR 5$)z:Find the value of a parameter, given the Parameter object.z,Response object is not bound to any headers.r#r)rrr7rmr=rG)r>rs rr&ResponseDefinition.get_parameter_valuesc << ,>@ @ ??h &%&__-. .|| //rcZURcgUHnURU:XdMUs $ g)z8Get one of the possible representations of the response.N)r:rr s rr0ResponseDefinition.get_representation_definitions2 88 "N((J6%%#r)r]rr8r:rV) r$r%r&r'r(r^rrrrrr)rrrrrs%E ND 0rrc|^\rSrSrSrU4SjrU4SjrSr\S5r Sr Sr SS jr S r S rS rS rSrU=r$)ri z2A definition of the structure of a representation.c<>[TU]U5 X lX0lgrV)rzr^r8r:)r>r]r8rrs rr^!RepresentationDefinition.__init__s % %rc(>[TU]SS/U5$)Nrr)rzrB)r>r8rs rrBRepresentationDefinition.paramssw~w0(;;rcbURU5Vs/sHo"RPM sn$s snf)z#Return the names of all parameters.)rBrG)r>r8r6s rr(RepresentationDefinition.parameter_namess'(, H(=>(=u (=>>>s,cPUR5RRS$)z4The media type of the representation described here.r)rir:r<rss rr#RepresentationDefinition.media_types$&&(,,33K@@rc[[[RS- 55nSU-n[R "[R5nSX4--S-nUcU$UnSnS[ R"U5-S-RS5n[ R"X[ RS 9(dU$US -[U5-nUS- nMn) z;Make a random boundary that does not appear in `all_parts`.rz%%0%ddz===============z==r z^--z(--)?$ascii)flags.) rKreprsysmaxsizerandom randrangereescapeencodesearch MULTILINEr}) r> all_parts_width_fmttokenboundarybcounterpatterns r_make_boundary'RepresentationDefinition._make_boundarysT#++/*+&   -.5  O ryy|+h6>>wGG99Wr||D3W-A qLG rcUHgup4URURS55 URS5 URURS55 URS5 Mi URS5 g)z$Write MIME headers to a file object.UTF-8s:  Nwriter=)r>bufrkeyrJs r_write_headers'RepresentationDefinition._write_headers1s^!JC IIcjj) * IIe  IIell7+ , IIg  " 'rcURS5 URURS55 U(aURS5 URS5 g)z,Write a multipart boundary to a file object.s--rKrLNrM)r>rOrDclosings r_write_boundary(RepresentationDefinition._write_boundary:s> % (//'*+  IIe  'rcf/nUGHsup4n[R"5nU(a SnS[U5<S[U5<S3nOSnS[U5-nURUSSU4S U4/5 U(a>[ U[ 5(d[ S [U5-5eURU5 O[ U[5(d[ S [U5-5e[R"S U5n U S SH4n URU RS55 URS5 M6 URU SRS55 URUR55 GMv URSR!U55n [R"5nS[U 5-nURUSSU4/5 UH6n UR#Xk5 URU 5 URS5 M8 UR#XkSS9 XvR54$)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="rFztext/plain; charset="utf-8"zform-data; name="%s")z MIME-Versionz1.0z Content-TypezContent-Dispositionzbytes payload expected: %szstring payload expected: %sz \r\n|\r|\nNrKrLz"multipart/form-data; boundary="%s"T)rT)ioBytesIOr rQr|bytesrrrNr}r;rr=rgetvaluerHrLrU) r>parts encoded_parts is_binaryrGrJrOctypecdisplineslinerD 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 BUR5nURUR5nUR"XA40UD6nURnUS:Xa%[ [ UR555nXg4$US:Xax/n[5n UHPn URU RU 5n XLdM%URU RS:HU RU 45 MR URU5upgXg4$US:Xa[R"U5nXg4$[!SU-5e)zjBind the definition to parameter values, creating a document. :return: A 2-tuple (media_type, document). z!application/x-www-form-urlencodedzmultipart/form-databinaryrxzUnsupported media type: '%s')rirBr8rTrrrrobjectr=rGrrrerdumpsr9) r>rOrQrhrBrRrdocr]missingr6rJs rrRepresentationDefinition.binds) ,,. ""4==155 5$35__ < <F#3#9#9#;<=C0 0EhG(,,UZZA'LL%**"8%**e!LM #;;EBOJ  - -**-.C;jHI IrcLURRRU5$)z9Turn a representation ID into a RepresentationDefinition.)r]representation_definitionsr=rns rrd,RepresentationDefinition._definition_factorys::>>rBBrcLURRRS5$)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. hrefrrss rrb,RepresentationDefinition._get_definition_urlrr)r8r:)F)r$r%r&r'r(r^rBrrrrHrQrUrerrdrbr)rrs@rrr sV<& <?AA$@%D4C++rrc\rSrSrSrSr\S5r\S5r\S5r \S5r \S5r S r \S 5r \S 5r\S 5rS rg)riz5One of the parameters of a representation definition.c>URUlXlX lg)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)r]value_containerr:)r>rvr:s rr^Parameter.__init__s+66.rcLURRRS5$)zThe name of this parameter.rGrrss rrGParameter.namexx""6**rcLURRRS5$)zThe style of this parameter.r7rrss rr7Parameter.stylesxx""7++rcLURRRS5$)zThe XSD type of this parameter.rrrss rrParameter.typerzrcLURRRS5$)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. fixedrrss rrHParameter.fixed_valuesxx""7++rcpURRRSS5R5S;$)z6Whether or not a value for this parameter is required.requiredfalse)1truerrss rrMParameter.is_requireds2##J8>>@ ! "rc8URRU5$)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. )rvrrss r get_valueParameter.get_values##77==rcURR[S55Vs/sHn[X5PM sn$s snf)z7Return the set of acceptable values for this parameter.rS)r:r;rOption)r> option_tags rrIParameter.optionssF#'(("2"2:h3G"HJ"HJt("HJ JJs?chURR[S55nUcg[X5$)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)r:rrr)r>link_tags rrParameter.links/88==F!34  D##rcNURnUc [S5eUR$)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.)rr9follow)r>rs rlinked_resourceParameter.linked_resources(yy <GH H{{r)r]r:rvN)r$r%r&r'r(r^rrGr7rrHrMrrIrrr)rrrrrs? ++,,++,,"" >JJ  $ $  rrc.\rSrSrSrSr\S5rSrg)ri z0One of a set of possible values for a parameter.cXlX lg)zeInitialize the option. :param parameter: A Parameter. :param link_tag: An ElementTree