0x1949 Team - FAZEMRX - MANAGER
Edit File: application.cpython-310.pyc
o R `� � @ s d Z eZg d�ZddlZddlmZ 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� d�Z*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. ) � Application�Link�Method�NoBoundRepresentationError� Parameter�RepresentationDefinition�ResponseDefinition�Resource� ResourceType� WADLError� N)�quote)� urlencode)�URI�merge)� _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}� ��tag_namer r �5/usr/lib/python3/dist-packages/wadllib/application.py�wadl_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)�dicts�final�dictr 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 )�UnsupportedMediaTypeErrorz�A 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 ZdZddd�Z d dd�ZdS ) �HasParametersMixinzAA mixin class for objects that have associated Parameter objects.Nc s\ � du r| j � � du rtd��| jdu rg S | j�td��}|du r$g S � �fdd�|D �S )z6Find subsidiary parameters that have the given styles.Nz&Could not find any particular resource�paramc s& g | ]}|j �d ��v rt� |��qS )�style)�attrib�getr )�.0� param_tag��resource�stylesr r � <listcomp>� s �z-HasParametersMixin.params.<locals>.<listcomp>)r/ � ValueError�tag�findallr )�selfr0 r/ � 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|�dkr�td 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 r1 � � 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_valuer2 �options�len�join� is_required�keys) r5 r7 � param_values�enforce_completeness�kw_param_values�validated_valuesr( r< r> r r r �validate_param_values� sD �� �� � � �z(HasParametersMixin.validate_param_values�N)T)r r! r" r# r7 rG 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 )z�Initialize with a WADL application. :param application: A WADLDefinition. Relative links are assumed to be relative to this object's URL. N)� _definition� application)r5 rK 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. N�No such XML ID: "%s")rJ �_get_definition_urlrK � lookup_xml_id�_definition_factory�KeyError)r5 � object_url�xml_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. ��NotImplementedError�r5 �idr r r rQ � � z,WADLResolvableDefinition._definition_factoryc C rW )zmFind the URL that identifies an external reference. How to do this depends on the subclass. rX �r5 r r r rO � r\ z,WADLResolvableDefinition._get_definition_urlN)r r! r" r# rL rV rQ rO r r r r rI � s " rI c s� e Zd ZdZ d'� fdd� Zedd� �Zedd � �Zed d � �Z d(d d�Z dd� Z d)dd�Z d*dd�Z d*dd�Z edd� �Zd*dd�Zdd � 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|t�r| 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. N�application/jsonz?This resource doesn't define a representation for media type %s)�superr rL �_url� isinstancer rK �get_resource_typer3 �representation�json�loadsr r% � media_type�representation_definition� get_representation_definition)r5 rK �url� resource_typerc rf � representation_needs_processingrg �� __class__r r rL � s2 ��� ��zResource.__init__c C s | j S )z Return the URL to this resource.)r` r] r r r ri , s z Resource.urlc C sb | j du rdS | j j�d�}|dur|S | j j�d�}|dur/t| jj��� }t|�d | S dS )z@Return the URL to the type definition for this resource, if any.N�typer[ �#)r3 r* r+ r rK � markup_url� ensureSlash�str)r5 ri �type_id�baser r r �type_url1 s zResource.type_urlc C s | j jd S )z Return the ID of this resource.r[ )r3 r* r] r r r r[ C � z Resource.idr^ 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 rK ri r3 )r5 rc rf rk rg r r r �bindH s �z Resource.bindc C sD | � d�j}|D ]}|�� j}|j�d�|kr| S qtd| ��)z<Get a description of one of this resource's representations.�GET� mediaTypez4No definition for representation with media type %s.)� get_method�responserV r3 r* r+ r% )r5 rf �default_get_responserc �representation_tagr r r rh ^ s ��z&Resource.get_representation_definitionc C sX | � � D ]%}|j�dd��� }|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. r< � N)�_method_tag_iterr* r+ �lowerr �is_described_by)r5 � http_methodrf � query_params�representation_params� method_tagr< �methodr r r rz 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_definitionr7 �r5 rf 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)r r )r5 r� r r r � method_iter� s � �zResource.method_iterc C sF | � |�}|j}|�td��D ]}|j�d�|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( r< N)r� r3 r4 r r* r+ r )r5 � param_namerf rU r} 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 �|d�dd � � }W Y |S t y` t |��w w |S td | j ��) z�Find 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.r^ �plain�8Don't know how to find value for a parameter of type %s.)�dateTime�datez%Y-%m-%dr � zEPath traversal not implemented for a representation of media type %s.)rc r rf r) rY r< �_dereference_namespacer3 rn �XML_SCHEMA_NS_URIr r2 �datetime�time�strptime)r5 � parameterr9 � namespace_url� data_typer r r �get_parameter_value� sF � �� � �� ��� �z Resource.get_parameter_valuec C sD |durd|v r|� dd�\}}nd}|�t�}|�|d�}||fS )z�Splits 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)r5 r3 r9 � namespace�ns_mapr� r r r r� � s z Resource._dereference_namespacec C � | j j�|�S )z-Given an ID, find a ResourceType for that ID.)rK �resource_typesr+ rZ r r r rQ � � z Resource._definition_factoryc C � | j j�d�S )z�Return 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. rn �r3 r* r+ r] r r r rO � � 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.)rc rg rV rh r )r5 rf rU r r r r� s � ��z(Resource._find_representation_definitionc c s* � | � � j}|�td��D ]}|V q dS )z+Iterate over this resource's <method> tags.r� N)rV r3 r4 r )r5 rU r� r r r r * s � �zResource._method_tag_iter)NNTN)r^ TN)NNNNrH )r r! r" r# rL �propertyri ru r[ rw rh rz r� r� r� r� r� r� rQ rO r� r � __classcell__r r rl r r � s> �4 � � ! 0 #r c @ sn e Zd ZdZdd� Zedd� �Zedd� �Zedd � �Zed d � �Z dd d�Z ddd�Z ddd�Z 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/ rK r3 )r5 r/ r� r r r rL 4 s zMethod.__init__c C s t | | j�td���S )z@Return the definition of a request that invokes the WADL method.�request)�RequestDefinitionr3 �findr r] r r r r� = s zMethod.requestc C s t | j| j�td���S )z9Return the definition of the response to the WADL method.r{ )r r/ r3 r� r r] r r r r{ B s �zMethod.responsec C r� )z)The XML ID of the WADL method definition.r[ r� r] r r r r[ H � z Method.idc C s | j j�d��� S )z�The 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. r< �r3 r* r+ r� r] r r r r< M s z Method.nameNc K s | j j|fi |��S )�4Return the request URL to use to invoke this method.)r� � build_url)r5 rC rE r r r �build_request_urlV � zMethod.build_request_urlc K s | j j||fi |��S )z�Build a representation to be sent when invoking this method. :return: A 2-tuple of (media_type, representation). )r� rc )r5 rf rC rE 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� rh r? rG r� r2 r� �representationsr7 r/ )r5 rf � query_values�representation_valuesrc r� r r r r� c sH �� � � � �zMethod.is_described_byrH �NN)NNN) r r! r" r# rL r� r� r{ r[ r< r� r� r� r r r r r 1 s$ � �r c @ sN e Zd ZdZdd� Zedd� �Zedd� �Zdd d �Zdd d �Z dd d�Z dS )r� zBA wrapper around the description of the request invoking a method.c C s$ || _ | j j| _| jj| _|| _dS )z�Initialize 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/ rK r3 )r5 r� � request_tagr r r rL � s zRequestDefinition.__init__c C s | � dg�S )z,Return the query parameters for this method.�query�r7 r] r r r r� � rv z RequestDefinition.query_paramsc c s. � | j �td��D ] }t| j| j|�V q d S )Nrc )r3 r4 r r rK r/ )r5 rU 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� rf �r5 rf rc r r r rh � s �z/RequestDefinition.get_representation_definitionc K s0 | � |�}|du rtd| ��|j|fi |��S )z�Build 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)rh � TypeErrorrw )r5 rf rC rE rU r r r rc � s �z RequestDefinition.representationc K sX | j | j|fi |��}| jj}t|�dkr*d|v r d}nd}||tt|�� �� 7 }|S )r� r �?�&)rG r� r/ ri r? r �sorted�items)r5 rC rE rF ri �appendr r r r� � s �� zRequestDefinition.build_urlrH r� ) r r! r" r# rL r� r� r� rh rc r� r r r r r� � s r� c @ sB e Zd ZdZddd�Zdd� 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)rK r/ r3 �headers)r5 r/ � response_tagr� r r r rL � s zResponseDefinition.__init__c c s4 � t d�}| j�|�D ] }t| jj| j|�V q dS )z�Get an iterator over the representation definitions. These are the representations returned in response to an invocation of this method. rc N)r r3 r4 r r/ rK )r5 �pathr} r r r �__iter__� s � ��zResponseDefinition.__iter__c C s t | j| j|�S )z�Bind the response to a set of HTTP headers. A WADL response can have associated header parameters, but no other kind. )r r/ r3 )r5 r� r r r rw � s zResponseDefinition.bindc C sH | j �td��D ]}|j�d�|kr!|j�d�dkr!t| |� S qdS )z,Find a header parameter within the response.r( r< r) �headerN)r3 r4 r r* r+ r )r5 r� r- r r r r� � s �z ResponseDefinition.get_parameterc C s8 | j du r td��|jdkrtd|j ��| j �|j�S )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) rY r+ r< )r5 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)r3 rf r� r r r rh s �z0ResponseDefinition.get_representation_definitionrH ) r r! r" r# rL r� rw r� r� rh r r r r r � s r c sz e Zd ZdZ� fdd�Z� fdd�Zdd� Zedd � �Zd d � Z d d � Z ddd�Z dd� Z dd� Z dd� Zdd� Z� ZS )r z2A definition of the structure of a representation.c s t t| ��|� || _|| _d S rH )r_ r rL r/ r3 )r5 rK r/ r} rl r r rL s z!RepresentationDefinition.__init__c s t t| ��ddg|�S )Nr� r� )r_ r r7 �r5 r/ rl r r r7 s �z RepresentationDefinition.paramsc C s dd� | � |�D �S )z#Return the names of all parameters.c S r8 r )r< )r, r( r r r r1 $ r; 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.ry )rV r3 r* r] r r r rf & s z#RepresentationDefinition.media_typec C s� t ttjd ��}d| }t�tj�}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? �repr�sys�maxsize�random� randrange�re�escape�encode�search� MULTILINErr ) r5 � all_parts�_width�_fmt�token�boundary�b�counter�patternr 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 : � N��writer� )r5 �bufr� �keyr9 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� )r5 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|t�s@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|\nN���r� r� z"multipart/form-data; boundary="%s"T)r� )�io�BytesIOr r� ra �bytesr� rn r� r r� r� r� r� �getvaluer� r@ r� ) r5 �parts� encoded_parts� is_binaryr< r9 r� �ctype�cdisp�lines�liner� � 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-data�binaryr^ z Unsupported media type: '%s')rV r7 r/ rG rf r r� r� �objectr+ r< r� rn r� rd �dumpsr2 ) r5 rC rE rU r7 rF rf �docr� �missingr( r9 r r r rw � s2 �� ��� �z RepresentationDefinition.bindc C r� )z9Turn a representation ID into a RepresentationDefinition.)rK �representation_definitionsr+ rZ r r r rQ � 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. �hrefr� r] r r r rO � r� z,RepresentationDefinition._get_definition_url)F)r r! r" r# rL r7 r� r� rf r� r� r� r� rw rQ rO r� r r rl 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)rK �value_containerr3 )r5 r� r3 r r r rL � s zParameter.__init__c C r� )zThe name of this parameter.r< r� r] r r r r< � r� zParameter.namec C r� )z The style of this parameter.r) r� r] r r r r) � r� zParameter.stylec C r� )z The XSD type of this parameter.rn r� r] r r r rn � 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� r] r r r r= � s zParameter.fixed_valuec C s | j j�dd��� dv S )z6Whether or not a value for this parameter is required.�required�false)�1�truer� r] r r r rA � s �zParameter.is_requiredc C s | j �| �S )z�The 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� r] r r r � get_value� s zParameter.get_valuec s � fdd�� j �td��D �S )z7Return the set of acceptable values for this parameter.c s g | ]}t � |��qS r )�Option)r, � option_tagr] r r r1 � s �z%Parameter.options.<locals>.<listcomp>r: )r3 r4 r r] r r] r r> � s �zParameter.optionsc C s& | j �td��}|du rdS t| |�S )z�Get 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)r3 r� r r )r5 �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 r2 �follow)r5 r r r r �linked_resource s zParameter.linked_resourceN)r r! r" r# rL r� r< r) rn r= rA 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� r3 )r5 r� r r r r rL rM zOption.__init__c C r� )Nr9 r� r] r r r r9 r� z Option.valueN)r r! r" r# rL r� r9 r r r r r s r c sH e Zd ZdZ� fdd�Zedd� �Zedd� �Zdd � Zd d � Z � Z S ) r z�A 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)r_ r rL rK r� r3 )r5 r� r rl r r rL , 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 rV r] r r r r 6 s z Link.followc C s$ z| � � }W dS ty Y dS w )z�Can this link be followed within wadllib? wadllib can follow a link if it points to a resource that has a WADL definition. FT)rO r )r5 �definition_urlr r r r ? s ��zLink.can_followc C s t | j| j�� | jj�|�j�S )z,Turn a resource type ID into a ResourceType.)r rK r� r r� r+ r3 rZ r r r rQ L s �zLink._definition_factoryc C s" | j j�d�}|du rtd��|S )z(Find the URL containing the definition .rj NzIParameter is a link, but not to a resource with a known WADL description.)r3 r* r+ r )r5 rn r r r rO R s zLink._get_definition_url) r r! r" r# rL r� r r rQ rO r� r r rl 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)r3 )r5 �resource_type_tagr r r rL ^ s zResourceType.__init__N)r r! r" r# rL 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|d�r| �|�| _n| �|�| _| j�td��| _| jj� d�| _ i | _ i | _ | j� td��D ]}|j� d�}|durKt| d|�}|| j |< q4| j� td��D ]}|jd }t|�| j |< qTdS )z�Parse 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� resourcesrt rc r[ Nrj )rp �hasattr� _from_streamr� � _from_stringr� r r r* r+ � resource_baser� r� r4 r r )r5 rp �markuprc r[ rU rj r r r rL 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. )�start�start-ns�end-nsNr r r )�ET� iterparser� �pop�setr� r � ElementTree)r5 �stream�events�rootr� �event�elemr r r r � s � zApplication._from_streamc C s$ t |t�s |�d�}| �t�|��S )z Turns markup into a document.r� )ra r� r� r r� r� )r5 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.NrN )rP r� r+ rR )r5 �resource_type_urlrT rj r r r rb � s z Application.get_resource_typec C sZ t | j��� }d|_|�d�rt |��� }n|�|�}|j}d|_||kr'|S td| ��)z�A 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. N�httpz,Can't look up definition in another url (%s))r rp � ensureNoSlash�fragment� startswith�resolverY )r5 ri � markup_uri�this_uri�possible_xml_idr r r rP � 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 r1 � s �z4Application.get_resource_by_path.<locals>.<listcomp>r� Nz+More than one resource defined with path %sTr )r r? r r r r )r5 r� �matchingr r+ r �get_resource_by_path� s ��z Application.get_resource_by_pathN) r r! r" r# rL r r rb rP r- r r r r r f s r )6r# rn � __metaclass__�__all__r� � email.utilsr r� rd r� r� r� r� � urllib.parser � ImportError�urllib�xml.etree.cElementTree�etree� cElementTreer �xml.etree.ElementTreer �lazr.urir r �wadllibr r �wadllib.iso_strptimer r� r� r r r � Exceptionr r r% r� r& r' rI r r r� r r r r r r r r r r r �<module> s` � � B= >j9B "]6