⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.133
Server IP:
185.119.109.197
Server:
Linux managedhosting.chostar.me 5.15.0-160-generic #170-Ubuntu SMP Wed Oct 1 10:06:56 UTC 2025 x86_64
Server Software:
Apache
PHP Version:
8.1.33
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
lib
/
python3
/
dist-packages
/
wadllib
/
__pycache__
/
View File Name :
application.cpython-310.pyc
o R ` @ s d Z eZg dZddlZddlmZ ddlZddlZddl Z ddl Z ddl Z ddl Z zddl mZ W n eyA ddlmZ Y nw z ddlm mZ W n ey_ ddlm mZ Y nw ddlmZmZ ddlmZm Z ddl m Z d Z d Z d d Z!d d Z"dd Z#G dd de$Z%G dd de%Z&G dd de%Z'G dd de(Z)G dd dZ*G dd d e)Z+G d d d e+Z,G d d d e)Z-G d!d" d"e)e*Z.G d#d$ d$e*Z/G d%d& d&e+e*Z0G d'd( d(e)Z1G d)d* d*e)Z2G d+d, d,e+Z3G d-d. d.e)Z4G d/d0 d0e)Z5dS )1a Navigate 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 WADLError N)quote) urlencode)URImerge) _make_unicode _string_types) iso_strptimez xmlns:mapz http://www.w3.org/2001/XMLSchemac C s d| S )z)Scope a tag name with the WADL namespace.z&{http://research.sun.com/wadl/2006/10} Ztag_namer r 5/usr/lib/python3/dist-packages/wadllib/application.pywadl_tagH s r c C s dt | S )z#Turn a tag name into an XPath path.z./)r r r r r wadl_xpathM s r c G s$ i }| D ] }|dur| | q|S )z<Merge any number of dictionaries, some of which may be None.N)update)Zdictsfinaldictr r r _merge_dictsR s r c @ e Zd ZdZdS )r zAAn exception having to do with the state of the WADL application.N__name__ __module__ __qualname____doc__r r r r r [ s r c @ r )r aA An unbound resource was used where wadllib expected a bound resource. To obtain the value of a resource's parameter, you first must bind the resource to a representation. Otherwise the resource has no idea what the value is and doesn't even know if you've given it a parameter name that makes sense. Nr r r r r r ` r c @ r )UnsupportedMediaTypeErrorzA media type was given that's not supported in this context. A resource can only be bound to media types it has representations of. Nr r r r r r# j r" r# c @ r )WADLBasez?A base class for objects that contain WADL-derived information.Nr r r r r r$ r r" r$ c @ s& e Zd ZdZdddZ d ddZdS ) HasParametersMixinzAA mixin class for objects that have associated Parameter objects.Nc s\ du r| j du rtd| jdu rg S | jtd}|du r$g S fdd|D S )z6Find subsidiary parameters that have the given styles.Nz&Could not find any particular resourceparamc s& g | ]}|j d v rt |qS )style)attribgetr ).0 param_tagresourcestylesr r <listcomp> s z-HasParametersMixin.params.<locals>.<listcomp>)r- ValueErrortagfindallr )selfr. r- Z param_tagsr r, r paramsy s zHasParametersMixin.paramsTc K s t ||}i }|D ]h}|j}|jdur/||v r*|| |jkr*td|| ||jf |j||< dd |jD }t|dkrU||v rU|| |vrUtd|| |d|f |rd|jrd||vrdtd| ||v rq|| ||< ||= q t|dkrtd d | |S ) a Make sure the given valueset is valid. A valueset might be invalid because it contradicts a fixed value or (if enforce_completeness is True) because it lacks a required value. :param params: A list of Parameter objects. :param param_values: A dictionary of parameter values. May include paramters whose names are not valid Python identifiers. :param enforce_completeness: If True, this method will raise an exception when the given value set lacks a value for a required parameter. :param kw_param_values: A dictionary of parameter values. :return: A dictionary of validated parameter values. Nz=Value '%s' for parameter '%s' conflicts with fixed value '%s'c S g | ]}|j qS r )value)r* optionr r r r/ z<HasParametersMixin.validate_param_values.<locals>.<listcomp>r z=Invalid value '%s' for parameter '%s': valid values are: "%s"z", "z$No value for required parameter '%s'z Unrecognized parameter(s): '%s'z', ') r name fixed_valuer0 optionslenjoin is_requiredkeys) r3 r4 param_valuesZenforce_completenesskw_param_valuesvalidated_valuesr& r9 r; r r r validate_param_values sJ z(HasParametersMixin.validate_param_valuesN)T)r r r r! r4 rC r r r r r% v s r% c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd S ) WADLResolvableDefinitionz=A base class for objects whose definitions may be references.c C s d| _ || _dS )zInitialize with a WADL application. :param application: A WADLDefinition. Relative links are assumed to be relative to this object's URL. N) _definition application)r3 rG r r r __init__ z!WADLResolvableDefinition.__init__c C s^ | j dur| j S | }|du r| | _ | S | j|}| |}|du r*td| || _ |S )a Return the definition of this object, wherever it is. Resource is a good example. A WADL <resource> tag may contain a large number of nested tags describing a resource, or it may just contain a 'type' attribute that references a <resource_type> 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. NNo such XML ID: "%s")rF _get_definition_urlrG lookup_xml_id_definition_factoryKeyError)r3 Z object_urlxml_id definitionr r r resolve_definition s z+WADLResolvableDefinition.resolve_definitionc C t )zxTransform an XML ID into a wadllib wrapper object. Which kind of object it is depends on the subclass. NotImplementedErrorr3 idr r r rM z,WADLResolvableDefinition._definition_factoryc C rR )zmFind the URL that identifies an external reference. How to do this depends on the subclass. rS r3 r r r rK rW z,WADLResolvableDefinition._get_definition_urlN)r r r r! rH rQ rM rK r r r r rE s " rE c s e Zd ZdZ d' fdd Zedd Zedd Zed d Z d(d dZ dd Z d)ddZ d*ddZ d*ddZ edd Zd*ddZdd Zd d Zd d Zd!d" Zd*d#d$Zd%d& Z ZS )+r z/A resource, possibly bound to a representation.NTc s t t| | || _t|tr| j|j| _n|| _d| _ |dur<|dkr6|r2t t || _ n || _ nt d| || _|durU|durL|| _dS | | j| _dS dS )a[ :param application: A WADLApplication. :param url: The URL to this resource. :param resource_type: An ElementTree <resource> or <resource_type> 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/jsonz?This resource doesn't define a representation for media type %s)superr rH _url isinstancer rG get_resource_typer1 representationjsonloadsr r# media_typerepresentation_definition get_representation_definition)r3 rG url resource_typer^ ra representation_needs_processingrb __class__r r rH s2 zResource.__init__c C s | j S )z Return the URL to this resource.)r[ rX r r r rd , s z Resource.urlc C sb | j du rdS | j jd}|dur|S | j jd}|dur/t| jj }t|d | S dS )z@Return the URL to the type definition for this resource, if any.NtyperV #)r1 r( r) r rG markup_urlZ ensureSlashstr)r3 rd Ztype_idbaser r r type_url1 s zResource.type_urlc C s | j jd S )z Return the ID of this resource.rV )r1 r( rX r r r rV C z Resource.idrY c C s t | j| j| j||||S )a Bind 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 rG rd r1 )r3 r^ ra rf rb r r r bindH s z Resource.bindc C sD | dj}|D ]}| j}|jd|kr| S qtd| )z<Get a description of one of this resource's representations.ZGET mediaTypez4No definition for representation with media type %s.) get_methodresponserQ r1 r( r) r# )r3 ra Zdefault_get_responser^ representation_tagr r r rc ^ s z&Resource.get_representation_definitionc C sX | D ]%}|jdd }|du s|| kr)t| |}||||r)| S qdS )a Look 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. r9 N)_method_tag_iterr( r) lowerr is_described_by)r3 Z http_methodra query_paramsZrepresentation_params method_tagr9 methodr r r rr h s zResource.get_methodc C | || S )a~ A list of 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. ) _find_representation_definitionr4 r3 ra r r r parameters zResource.parametersc C r| )a A 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. )r} parameter_namesr~ r r r r r zResource.parameter_namesc c s | D ]}t| |V qdS )z6An iterator over the methods defined on this resource.N)rv r )r3 rz r r r method_iter s zResource.method_iterc C sF | |}|j}|tdD ]}|jd|kr t| | S qdS )a Find 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. r& r9 N)r} r1 r2 r r( r) r )r3 param_namera rP rt r+ r r r get_parameter s zResource.get_parameterc C s | j du r td| jdkrd|jdkrtd|j | j |j }|durb| |j|j\}}|t krb|dv rbzt |}W |S t ya zt j t |ddd }W Y |S t y` t |w w |S td | j ) zFind the value of a parameter, given the Parameter object. :raise ValueError: If the parameter value can't be converted into its defined type. Nz,Resource is not bound to any representation.rY plain8Don't know how to find value for a parameter of type %s.)ZdateTimedatez%Y-%m-%dr zEPath traversal not implemented for a representation of media type %s.)r^ r ra r' rT r9 _dereference_namespacer1 ri XML_SCHEMA_NS_URIr r0 datetimetimestrptime)r3 parameterr6 namespace_urlZ data_typer r r get_parameter_value sH z Resource.get_parameter_valuec C sD |durd|v r| dd\}}nd}|t}||d}||fS )zSplits a value into namespace URI and value. :param tag: A tag to use as context when mapping namespace names to URIs. N: ru )splitr) NS_MAP)r3 r1 r6 namespacens_mapr r r r r s z Resource._dereference_namespacec C | j j|S )z-Given an ID, find a ResourceType for that ID.)rG resource_typesr) rU r r r rM z Resource._definition_factoryc C | j jdS )zReturn the URL that shows where a resource is 'really' defined. If a resource's capabilities are defined by reference, the <resource> tag's 'type' attribute will contain the URL to the <resource_type> that defines them. ri r1 r( r) rX r r r rK z Resource._get_definition_urlc C s> | j dur| j }| S |dur| |}| S td)a3 Get 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 NzSResource is not bound to any representation, and no media media type was specified.)r^ rb rQ rc r )r3 ra rP r r r r} s z(Resource._find_representation_definitionc c s* | j}|tdD ]}|V q dS )z+Iterate over this resource's <method> tags.r{ N)rQ r1 r2 r )r3 rP rz r r r rv * s zResource._method_tag_iter)NNTN)rY TN)NNNNrD )r r r r! rH propertyrd rn rV rp rc rr r r r r r r rM rK r} rv __classcell__r r rg r r s> 4 ! 0 #r c @ sn e Zd ZdZdd Zedd Zedd Zedd Zed d Z dd dZ dddZ dddZ d S )r z*A wrapper around an XML <method> tag. c C s || _ | j j| _|| _dS )zaInitialize with a <method> tag. :param method_tag: An ElementTree <method> tag. N)r- rG r1 )r3 r- rz r r r rH 4 s zMethod.__init__c C s t | | jtdS )z@Return the definition of a request that invokes the WADL method.request)RequestDefinitionr1 findr rX r r r r = s zMethod.requestc C s t | j| jtdS )z9Return the definition of the response to the WADL method.rs )r r- r1 r r rX r r r rs B s zMethod.responsec C r )z)The XML ID of the WADL method definition.rV r rX r r r rV H z Method.idc C s | j jd S )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. r9 r1 r( r) rw rX r r r r9 M s z Method.nameNc K s | j j|fi |S )4Return the request URL to use to invoke this method.)r build_url)r3 r@ rA r r r build_request_urlV zMethod.build_request_urlc K s | j j||fi |S )zBuild a representation to be sent when invoking this method. :return: A 2-tuple of (media_type, representation). )r r^ )r3 ra r@ rA r r r build_representationZ s zMethod.build_representationc C s d}|dur| j |}|du rdS |dur:t|dkr:| j }|du r%dS z ||j|d W n ty9 Y dS w |du sDt|dkrFdS |durO||S | j jD ]}z||| j |d W dS tym Y qSw dS )a Returns 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) r rc r< rC ry r0 rx representationsr4 r- )r3 ra Z query_valuesZrepresentation_valuesr^ r r r r rx c sJ zMethod.is_described_byrD NN)NNN) r r r r! rH r r rs rV r9 r r rx r r r r r 1 s$ r c @ sN e Zd ZdZdd Zedd Zedd Zdd d Zdd d Z dd dZ dS )r zBA wrapper around the description of the request invoking a method.c C s$ || _ | j j| _| jj| _|| _dS )zInitialize with a <request> tag. :param resource: The resource to which this request can be sent. :param request_tag: An ElementTree <request> tag. N)r{ r- rG r1 )r3 r{ Z request_tagr r r rH s zRequestDefinition.__init__c C s | dgS )z,Return the query parameters for this method.queryr4 rX r r r ry ro z RequestDefinition.query_paramsc c s. | j tdD ] }t| j| j|V q d S )Nr^ )r1 r2 r r rG r- )r3 rP r r r r s z!RequestDefinition.representationsNc C s* | j D ]}|du s|j|kr| S qdS )z1Return the appropriate representation definition.N)r ra r3 ra r^ r r r rc s z/RequestDefinition.get_representation_definitionc K s0 | |}|du rtd| |j|fi |S )zBuild a representation to be sent along with this request. :return: A 2-tuple of (media_type, representation). Nz,Cannot build representation of media type %s)rc TypeErrorrp )r3 ra r@ rA rP r r r r^ s z RequestDefinition.representationc K sX | j | j|fi |}| jj}t|dkr*d|v r d}nd}||tt| 7 }|S )r r ?&)rC ry r- rd r< r sorteditems)r3 r@ rA rB rd appendr r r r s zRequestDefinition.build_urlrD r ) r r r r! rH r ry r rc r^ r r r r r r s r c @ sB e Zd ZdZdddZdd Zdd Zd d Zd d Zd d Z dS )r z;A wrapper around the description of a response to a method.Nc C s |j | _ || _|| _|| _dS )zgInitialize with a <response> tag. :param response_tag: An ElementTree <response> tag. N)rG r- r1 headers)r3 r- Z response_tagr r r r rH s zResponseDefinition.__init__c c s4 t d}| j|D ] }t| jj| j|V q dS )zGet an iterator over the representation definitions. These are the representations returned in response to an invocation of this method. r^ N)r r1 r2 r r- rG )r3 pathrt r r r __iter__ s zResponseDefinition.__iter__c C s t | j| j|S )zBind the response to a set of HTTP headers. A WADL response can have associated header parameters, but no other kind. )r r- r1 )r3 r r r r rp s zResponseDefinition.bindc C sH | j tdD ]}|jd|kr!|jddkr!t| | S qdS )z,Find a header parameter within the response.r& r9 r' headerN)r1 r2 r r( r) r )r3 r r+ r r r r s z ResponseDefinition.get_parameterc C s8 | j du r td|jdkrtd|j | j |jS )z:Find the value of a parameter, given the Parameter object.Nz,Response object is not bound to any headers.r r )r r r' rT r) r9 )r3 r r r r r s z&ResponseDefinition.get_parameter_valuec C s. | j du rdS | D ] }|j|kr| S q dS )z8Get one of the possible representations of the response.N)r1 ra r r r r rc s z0ResponseDefinition.get_representation_definitionrD ) r r r r! rH r rp r r rc r r r r r s r c sz e Zd ZdZ fddZ fddZdd Zedd Zd d Z d d Z dddZ dd Z dd Z dd Zdd Z ZS )r z2A definition of the structure of a representation.c s t t| | || _|| _d S rD )rZ r rH r- r1 )r3 rG r- rt rg r r rH s z!RepresentationDefinition.__init__c s t t| ddg|S )Nr r )rZ r r4 r3 r- rg r r r4 s z RepresentationDefinition.paramsc C s dd | |D S )z#Return the names of all parameters.c S r5 r )r9 )r* r& r r r r/ $ r8 z<RepresentationDefinition.parameter_names.<locals>.<listcomp>r r r r r r " r z(RepresentationDefinition.parameter_namesc C s | jjd S )z4The media type of the representation described here.rq )rQ r1 r( rX r r r ra & s z#RepresentationDefinition.media_typec C s t ttjd }d| }ttj}d|| d }|du r!|S |}d} dt| d d }tj ||tj d s> |S |d t | }|d7 }q&) z;Make a random boundary that does not appear in `all_parts`.r z%%0%ddz===============z==Nr Tz^--z(--)?$ascii)flags.) r< reprsysmaxsizerandomZ randrangereescapeencodesearch MULTILINErl ) r3 Z all_parts_widthZ_fmttokenboundarybZcounterpatternr r r _make_boundary+ s z'RepresentationDefinition._make_boundaryc C sP |D ] \}}| |d | d | |d | d q| d dS )z$Write MIME headers to a file object.UTF-8s : Nwriter )r3 bufr keyr6 r r r _write_headers= s z'RepresentationDefinition._write_headersFc C s6 | d | |d |r| d | d dS )z,Write a multipart boundary to a file object.s --r r Nr )r3 r r closingr r r _write_boundaryF s z(RepresentationDefinition._write_boundaryc C s g }|D ]|\}}}t }|r d}dt|t|f }nd}dt| }| |dd|fd|fg |rFt|ts@tdt| || n3t|t sStd t| t d |} | d d D ]} || d |d q_|| d d | | q| d|} t }dt| }| |dd|fg |D ]} | || || |d q| j|| dd || fS )aV 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-streamz#form-data; name="%s"; filename="%s"ztext/plain; charset="utf-8"zform-data; name="%s")z MIME-Versionz1.0z Content-TypezContent-Dispositionzbytes payload expected: %szstring payload expected: %sz \r\n|\r|\nNr r z"multipart/form-data; boundary="%s"T)r )ioBytesIOr r r\ bytesr ri r r r r r r getvaluer r= r ) r3 partsZ encoded_partsZ is_binaryr9 r6 r ZctypeZcdisplinesliner Z encoded_partr r r _generate_multipart_formN sT z1RepresentationDefinition._generate_multipart_formc K s | }|| j}| j||fi |}| j}|dkr'tt| }||fS |dkrWg }t } |D ]} | | j | } | | urK| | j dk| j | f q2| |\}}||fS |dkrdt|}||fS td| )zzBind the definition to parameter values, creating a document. :return: A 2-tuple (media_type, document). z!application/x-www-form-urlencodedzmultipart/form-databinaryrY z Unsupported media type: '%s')rQ r4 r- rC ra r r r objectr) r9 r ri r r_ dumpsr0 ) r3 r@ rA rP r4 rB ra docr missingr& r6 r r r rp s2 z RepresentationDefinition.bindc C r )z9Turn a representation ID into a RepresentationDefinition.)rG representation_definitionsr) rU r r r rM r z,RepresentationDefinition._definition_factoryc C r )a Find the URL containing the representation's 'real' definition. If a representation's structure is defined by reference, the <representation> tag's 'href' attribute will contain the URL to the <representation> that defines the structure. Zhrefr rX r r r rK r z,RepresentationDefinition._get_definition_url)F)r r r r! rH r4 r r ra r r r r rp rM rK r r r rg r r s Ar c @ s e Zd ZdZdd Zedd Zedd Zedd Zed d Z ed d Z dd Z edd Z edd Z edd ZdS )r z5One of the parameters of a representation definition.c C s |j | _ || _|| _dS )a Initialize 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 <param> tag for this parameter. N)rG value_containerr1 )r3 r r1 r r r rH s zParameter.__init__c C r )zThe name of this parameter.r9 r rX r r r r9 r zParameter.namec C r )z The style of this parameter.r' r rX r r r r' r zParameter.stylec C r )z The XSD type of this parameter.ri r rX r r r ri r zParameter.typec C r )a9 The 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. fixedr rX r r r r: s zParameter.fixed_valuec C s | j jdd dv S )z6Whether or not a value for this parameter is required.requiredZfalse)1truer rX r r r r> s zParameter.is_requiredc C s | j | S )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. )r r rX r r r get_value s zParameter.get_valuec s fdd j tdD S )z7Return the set of acceptable values for this parameter.c s g | ]}t |qS r )Option)r* option_tagrX r r r/ s z%Parameter.options.<locals>.<listcomp>r7 )r1 r2 r rX r rX r r; s zParameter.optionsc C s& | j td}|du rdS t| |S )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)r1 r r r )r3 link_tagr r r r s zParameter.linkc C s | j }|du r td|jS )a Follow a link from this parameter to a new resource. This only works for parameters whose WADL definition includes a <link> tag that points to a known WADL description. :return: A Resource object for the resource at the other end of the link. Nz(This parameter isn't a link to anything.)r r0 follow)r3 r r r r linked_resource s zParameter.linked_resourceN)r r r r! rH r r9 r' ri r: r> r r; r r r r r r r s( r c @ s$ e Zd ZdZdd Zedd ZdS )r z0One of a set of possible values for a parameter.c C s || _ || _dS )z}Initialize the option. :param parameter: A Parameter. :param link_tag: An ElementTree <option> tag. N)r r1 )r3 r r r r r rH rI zOption.__init__c C r )Nr6 r rX r r r r6 r z Option.valueN)r r r r! rH r r6 r r r r r s r c sH e Zd ZdZ fddZedd Zedd Zdd Zd d Z Z S ) r zA link from one resource to another. Calling resolve_definition() on a Link will give you a Resource for the type of resource linked to. An alias for this is 'follow'. c s" t t| |j || _|| _dS )zyInitialize the link. :param parameter: A Parameter. :param link_tag: An ElementTree <link> tag. N)rZ r rH rG r r1 )r3 r r rg r r rH , s z Link.__init__c C s | j std| S )z$Follow the link to another Resource.zfCannot follow a link when the target has no WADL description. Try using a general HTTP client instead.) can_followr rQ rX r r r r 6 s z Link.followc C s$ z| }W dS ty Y dS w )zCan this link be followed within wadllib? wadllib can follow a link if it points to a resource that has a WADL definition. FT)rK r )r3 Zdefinition_urlr r r r ? s zLink.can_followc C s t | j| j | jj|jS )z,Turn a resource type ID into a ResourceType.)r rG r r r r) r1 rU r r r rM L s zLink._definition_factoryc C s" | j jd}|du rtd|S )z(Find the URL containing the definition .re NzIParameter is a link, but not to a resource with a known WADL description.)r1 r( r) r )r3 ri r r r rK R s zLink._get_definition_url) r r r r! rH r r r rM rK r r r rg r r % s r c @ s e Zd ZdZdd ZdS )r z,A wrapper around an XML <resource_type> tag.c C s || _ dS )zvInitialize with a <resource_type> tag. :param resource_type_tag: An ElementTree <resource_type> tag. N)r1 )r3 Zresource_type_tagr r r rH ^ s zResourceType.__init__N)r r r r! rH r r r r r [ s r c @ s@ e Zd ZdZdd Zdd Zdd Zdd Zd d Zd d Z dS )r z1A WADL document made programmatically accessible.c C s || _ t|dr| || _n| || _| jtd| _| jj d| _ i | _ i | _ | j tdD ]}|j d}|durKt| d|}|| j |< q4| j tdD ]}|jd }t|| j |< qTdS )zParse WADL and find the most important parts of the document. :param markup_url: The URL from which this document was obtained. :param markup: The WADL markup itself, or an open filehandle to it. read resourcesrm r^ rV Nre )rk hasattr _from_streamr _from_stringr r r r( r) resource_baser r r2 r r )r3 rk markupr^ rV rP re r r r rH i s( zApplication.__init__c C sv d}d}g }t ||D ])\}}|dkr|| q |dkr#| q |dkr5|du r-|}|tt| q t |S )zrTurns markup into a document. Just a wrapper around ElementTree which keeps track of namespaces. )startstart-nsend-nsNr r r )ETZ iterparser popsetr r ElementTree)r3 streamZeventsrootr Zeventelemr r r r s zApplication._from_streamc C s$ t |ts |d}| t|S )z Turns markup into a document.r )r\ r r r r r )r3 r r r r r s zApplication._from_stringc C s. | |}| j|}|du rtd| |S )z7Retrieve a resource type by the URL of its description.NrJ )rL r r) rN )r3 Zresource_type_urlrO re r r r r] s z Application.get_resource_typec C sZ t | j }d|_|drt | }n||}|j}d|_||kr'|S td| )zA helper method for locating a part of a WADL document. :param url: The URL (with anchor) of the desired part of the WADL document. :return: The XML ID corresponding to the anchor. NZhttpz,Can't look up definition in another url (%s))r rk Z ensureNoSlashZfragment startswithZresolverT )r3 rd Z markup_uriZthis_uriZpossible_xml_idr r r rL s zApplication.lookup_xml_idc sV fdd| j D }t|dk rdS t|dkr td t| t| j d|d S )zpLocate one of the resources described by this document. :param path: The path to the resource. c s g | ] }|j d kr|qS r )r( )r* r- r r r r/ s z4Application.get_resource_by_path.<locals>.<listcomp>r Nz+More than one resource defined with path %sTr )r r< r r r r )r3 r Zmatchingr r r get_resource_by_path s z Application.get_resource_by_pathN) r r r r! rH r r r] rL r r r r r r f s r )6r! ri Z __metaclass____all__r Z email.utilsr r r_ r r r r Z urllib.parser ImportErrorZurllibZxml.etree.cElementTreeZetreeZ cElementTreer Zxml.etree.ElementTreer Zlazr.urir r Zwadllibr r Zwadllib.iso_strptimer r r r r r Exceptionr r r# r r$ r% rE r r r r r r r r r r r r r r <module> s` B= >j9B "]6