ruạṛ
a [��f3u � @ s` d Z ddlZddlZddlZddlmZ ddlmZ dZe� d�Z e� d�Z G dd � d e �Z G d d � d e �ZG d d � d e�ZG dd� de �ZG dd� de �ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de �ZG d d � d e �ZG d d � d e �ZG d d!� d!e �ZG d"d#� d#e �ZG d$d%� d%e �ZG d&d'� d'e �Z G d(d)� d)e �Z dS )*zDefault routing engine.� N)�UserDict�� convertersz zR{((?P<fname>[^}:]*)((?P<cname_sep>:(?P<cname>[^}\(]*))(\((?P<argstr>[^}]*)\))?)?)}z[A-Za-z_][A-Za-z0-9_]*$c @ sr e Zd ZdZdZdd� Zedd� �Zedd� �Zd d � Z dd d �Z dd� Z ddd�Z dd� Z dd� Zd dd�Zd S ) �CompiledRoutera Fast URI router which compiles its routing logic to Python code. Generally you do not need to use this router class directly, as an instance is created by default when the falcon.API class is initialized. The router treats URI paths as a tree of URI segments and searches by checking the URI one segment at a time. Instead of interpreting the route tree for each look-up, it generates inlined, bespoke Python code to perform the search, then compiles that code. This makes the route processing quite fast. ) �_ast�_converter_map� _converters�_find� _finder_src�_options� _patterns�_return_values�_rootsc C sF d | _ d | _d | _t� | _| jjj| _d | _d | _ g | _ | � � | _ d S �N) r r r �CompiledRouterOptionsr r �datar r r r �_compiler ��self� r �{/sparta/input/_build_configuration/image_build+validate/lib/bmcenv/lib64/python3.9/site-packages/falcon/routing/compiled.py�__init__A s zCompiledRouter.__init__c C s | j S r )r r r r r �optionsT s zCompiledRouter.optionsc C s | j S r )r r r r r � finder_srcX s zCompiledRouter.finder_srcc sv t �dt�d���r td����d��d��t� }�D ]}| �||� q6d � ����fdd� � � | j � | � � | _ dS ) a} Adds a route between a URI path template and a resource. Args: uri_template (str): A URI template to use for the route method_map (dict): A mapping of HTTP methods (e.g., 'GET', 'POST') to methods of a resource object. resource (object): The resource instance to associate with the URI template. z\sz{FIELD}z)URI templates may not include whitespace.�/r c s� | D ]x}�| }|� |�rT|d7 }|t��krB�|_�|_�|_n � |j|� d S |�|�rt�d�� � � dd�}t |��qt �| �}| � |� |t��d kr��|_�|_�|_n� |j|d � d S )N� a� The URI template for this route is inconsistent or conflicts with another route's template. This is usually caused by configuring a field converter differently for the same field in two different routes, or by using different field names at the same level in the path (e.g., '/parents/{id}' and '/parents/{parent_id}/children') � � )�matches�len� method_map�resource� uri_template�children�conflicts_with�textwrap�dedent�strip�replace� ValueError�CompiledRouterNode�append)�nodes� path_index�node�segment�msg�new_node��insertr �pathr! r" r r r3 r s, � z(CompiledRouter.add_route.<locals>.insertN)r ) �re�search�_FIELD_PATTERN�subr) r' �split�set�_validate_template_segmentr r r )r r" r r! � used_namesr/ r r2 r � add_route\ s % zCompiledRouter.add_routeNc C sN |� d��d�}i }| �|| j| j| j|�}|durF|j|j||jfS dS dS )aY Search for a route that matches the given partial URI. Args: uri(str): The requested path to route. Keyword Args: req(Request): The Request object that will be passed to the routed responder. Currently the value of this argument is ignored by :class:`~.CompiledRouter`. Routing is based solely on the path. Returns: tuple: A 4-member tuple composed of (resource, method_map, params, uri_template), or ``None`` if no route matches the requested path. r N) �lstripr9 r r r r r! r r" )r �uri�reqr4 �paramsr. r r r �find� s �zCompiledRouter.findc C s� t �|�D ]�}|�d�}t�|�}|r0|tjv rFd}|�|�}t|��||v rdd}|�|�}t|��|� |� |�d�dkr�d�|�}t|��|�d�}|r || j vr d�|�}t|��q d S ) aH Validates a single path segment of a URI template. 1. Ensure field names are valid Python identifiers, since they will be passed as kwargs to responders. 2. Check that there are no duplicate names, since that causes (at least) the following problems: a. For simple nodes, values from deeper nodes overwrite values from more shallow nodes. b. For complex nodes, re.compile() raises a nasty error 3. Check that when the converter syntax is used, the named converter exists. �fnamez:Field names must be valid identifiers ("{0}" is not valid)zAField names may not be duplicated ("{0}" was used more than once)� cname_sep�:z!Missing converter for field "{0}"�cnamezUnknown converter: "{0}"N) r7 �finditer�group�_IDENTIFIER_PATTERN�match�keyword�kwlist�formatr) �addr )r r/ r< �field�name� is_identifier� msg_templater0 r r r r; � s& z)CompiledRouter._validate_template_segmentr Tc C s\ |sdS t d|�}|�|� |}d}t|dd� d�}|r`t|�dkr`dd � |D �} t| �} | }|D �]�} | j�r�| jr�t|�} |�| j� t || | jj �} |�| � | }| j r�|�t � � | � || �}n |�t� � n�| j �r\t| j �dks�J �|�t|�� | j}| j d \}}}| j| }| �||�}t| j�}| j�|� t||�} |�| � | }n|�t| j|�� td d � |D ��dk�s�J �d }nt|| j�} |�| � | }| jdu�r�t|�}|�| � | �| j||||d |� | jdu �r|�r:|�t� � n8t d |d �} | �t |�� |�| � |�r:|�t� � |}qd|�sX|�rX|�t� � dS )z&Generates a coarse AST for the router.N�>Fc S s | j | j o| j S r ��is_var� is_complex)r. r r r �<lambda>� s �z.CompiledRouter._generate_ast.<locals>.<lambda>)�keyr c S s g | ]}|j r|�qS r )rU )�.0r. r r r � <listcomp>� � z0CompiledRouter._generate_ast.<locals>.<listcomp>r c S s g | ]}|j r|js|�qS r rT )rY �_noder r r rZ > s �Tz==) �_CxIfPathLength� append_child�sortedr �boolrU rV r+ � var_pattern�_CxIfPathSegmentPattern�pattern�var_converter_map�!_CxPrefetchGroupsFromPatternMatch�_generate_conversion_ast� _CxSetParamsFromPatternMatch�_CxSetFragmentFromPath�var_namer �_instantiate_converterr �_CxIfConverterField� _CxSetParam�_CxIfPathSegmentLiteral� raw_segmentr! � _generate_astr# � _CxReturnNone�_CxReturnValue)r r, �parent� return_values�patterns�level� fast_return� outer_parent� found_simple� var_nodes�found_var_nodesr. � pattern_idx� construct� field_name�__�converter_name�converter_argstr�converter_class� converter_obj� converter_idx� resource_idxr r r ro � s� � � � � � � z CompiledRouter._generate_astc C s� |j D ]\\}}}| j| }| �||�}t| j�}| j�|� |�t|�� t||�} |�| � | }q|j t|j �kr�|�t � � |S r ) rd r rj r r r+ r^ �_CxSetFragmentFromFieldrk � num_fields�&_CxSetParamsFromPatternMatchPrefetched) r rr r. r} r r� r� r� r� r| r r r rf j s$ � � z'CompiledRouter._generate_conversion_astc C s� dt d g}g | _g | _g | _t� | _| �| j| j| j| j� |�| j� d�� |�t d � d� |�| _ i }t t | j dd�|� |d S ) z�Generates Python code for the entire routing tree. The generated code is compiled and the resulting Python method is returned. z<def find(path, return_values, patterns, converters, params):zpath_len = len(path)r z return Noner z<string>�execrB )�_TAB_STRr r r � _CxParentr ro r r+ �src�joinr r� �compile)r � src_lines�scoper r r r � s* ��� zCompiledRouter._compilec C s, |d u r|� S d� |j|�}t||j|i�S )Nz{0}({1}))rM �__name__�eval)r �klass�argstrr� r r r rj � s z%CompiledRouter._instantiate_converter)N)r T)N)r� � __module__� __qualname__�__doc__� __slots__r �propertyr r r= rB r; ro rf r rj r r r r r ( s > * &r c @ s* e Zd ZdZd dd�Zdd� Zdd� ZdS ) r* z)Represents a single URI segment in a URI.Nc C s8 g | _ || _|| _|| _|| _d| _d| _d| _d | _d | _ g | _ t t � |��}|s\d| _n�d| _t|�| _|D ]2}|�d�rp| j �|�d�|�d�|�d�f� qp|d �� dt|�fkr�t|�dks�J �d| _|d }|�d�| _n8t�dd |�}t �d |�}d | d }d| _t�|�| _ | j�r4| j�s4J �d S ) NFr TrF rC r� r z[\.\(\)\[\]\?\$\*\+\^\|]z\\\g<0>z (?P<\2>.+)�^�$)r# rn r r! r" rU rV r� ri ra rd �listr7 rG r rH r+ �spanr5 r8 r� ) r rn r r! r" r rO �escaped_segment� pattern_textr r r r � sH �� zCompiledRouterNode.__init__c C s || j kS )z@Returns True if this node matches the supplied template segment.)rn )r r/ r r r r s zCompiledRouterNode.matchesc C sX | � |�rJ �t|�}| jrT| jrF|jrBt�d| j�t�d|�kS dS |joR|j S dS )zBReturns True if this node conflicts with a given template segment.�vF)r r* rU rV r7 r8 rn )r r/ �otherr r r r$ s �z!CompiledRouterNode.conflicts_with)NNN)r� r� r� r� r r r$ r r r r r* � s � Wr* c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � ConverterDictz/A dict-like class for storing field converters.c C sZ z |� � }W n( ty4 t|�}dd� |D �}Y n0 |D ]}| �|� q:t�| |� d S )Nc S s g | ] \}}|�qS r r )rY �nr~ r r r rZ \ r[ z(ConverterDict.update.<locals>.<listcomp>)�keys�AttributeErrorr� � _validater �update)r r� �namesr� r r r r� Q s zConverterDict.updatec C s | � |� t�| ||� d S r )r� r � __setitem__)r rP � converterr r r r� c s zConverterDict.__setitem__c C s t �|�std��d S )Nz�Invalid converter name. Names may not be blank, and may only use ASCII letters, digits, and underscores. Namesmust begin with a letter or underscore.)rI rJ r) )r rP r r r r� g s �zConverterDict._validateN)r� r� r� r� r� r� r� r r r r r� N s r� c @ s e Zd ZdZdZdd� ZdS )r a� Defines a set of configurable router options. An instance of this class is exposed via :any:`API.router_options` for configuring certain :py:class:`~.CompiledRouter` behaviors. Attributes: converters: Represents the collection of named converters that may be referenced in URI template field expressions. Adding additional converters is simply a matter of mapping an identifier to a converter class:: api.router_options.converters['mc'] = MyConverter The identifier can then be used to employ the converter within a URI template:: api.add_route('/{some_field:mc}', some_resource) Converter names may only contain ASCII letters, digits, and underscores, and must start with either a letter or an underscore. Warning: Converter instances are shared between requests. Therefore, in threaded deployments, care must be taken to implement custom converters in a thread-safe manner. (See also: :ref:`Field Converters <routing_field_converters>`) r c C s t dd� tjD ��| _d S )Nc s s | ]\}}||fV qd S r r )rY rP r� r r r � <genexpr>� s z1CompiledRouterOptions.__init__.<locals>.<genexpr>)r� r �BUILTINr r r r r � s �z CompiledRouterOptions.__init__N)r� r� r� r� r� r r r r r r p s r c @ s, e Zd Zdd� Zdd� Zdd� Zdd� Zd S ) r� c C s g | _ d S r )� _childrenr r r r r � s z_CxParent.__init__c C s | j �|� d S r )r� r+ )r r| r r r r^ � s z_CxParent.append_childc C s | � |d �S )Nr )� _children_src�r � indentationr r r r� � s z _CxParent.srcc s � fdd�| j D �}d�|�S )Nc s g | ]}|� � ��qS r )r� )rY �child�r� r r rZ � s �z+_CxParent._children_src.<locals>.<listcomp>r )r� r� )r r� r� r r� r r� � s �z_CxParent._children_srcN)r� r� r� r r^ r� r� r r r r r� � s r� c s$ e Zd Z� fdd�Zdd� Z� ZS )r] c s t t| ��� || _|| _d S r )�superr] r � _comparison�_length)r � comparison�length�� __class__r r r � s z_CxIfPathLength.__init__c C s& d}|� t| | j| j| �|d ��S )Nz{0}if path_len {1} {2}: {3}r )rM r� r� r� r� �r r� �templater r r r� � s �z_CxIfPathLength.src�r� r� r� r r� � __classcell__r r r� r r] � s r] c s$ e Zd Z� fdd�Zdd� Z� ZS )rm c s t t| ��� || _|| _d S r )r� rm r � _segment_idx�_literal)r � segment_idx�literalr� r r r � s z _CxIfPathSegmentLiteral.__init__c C s& d}|� t| | j| j| �|d ��S )Nz {0}if path[{1}] == '{2}': {3}r )rM r� r� r� r� r� r r r r� � s �z_CxIfPathSegmentLiteral.srcr� r r r� r rm � s rm c s$ e Zd Z� fdd�Zdd� Z� ZS )rb c s$ t t| ��� || _|| _|| _d S r )r� rb r r� � _pattern_idx� _pattern_text)r r� r{ r� r� r r r � s z _CxIfPathSegmentPattern.__init__c C s> d� t| | j| j| j�d� t| �| �|d �g}d�|�S )Nz0{0}match = patterns[{1}].match(path[{2}]) # {3}z{0}if match is not None:r r )rM r� r� r� r� r� r� �r r� �linesr r r r� � s � � z_CxIfPathSegmentPattern.srcr� r r r� r rb � s rb c s$ e Zd Z� fdd�Zdd� Z� ZS )rk c s t t| ��� || _|| _d S r )r� rk r � _field_name�_converter_idx)r r} r� r� r r r � s z _CxIfConverterField.__init__c C sJ d� t| | j�d� t| �d� t|d | j�| �|d �g}d�|�S )Nz2{0}field_value = converters[{1}].convert(fragment)z {0}if field_value is not None:z {0}params['{1}'] = field_valuer r )rM r� r� r� r� r� r� r r r r� � s � � � z_CxIfConverterField.srcr� r r r� r rk � s rk c @ s e Zd Zdd� Zdd� ZdS )r� c C s || _ d S r )r� )r r} r r r r s z _CxSetFragmentFromField.__init__c C s d� t| | j�S )Nz {0}fragment = groups.pop('{1}'))rM r� r� r� r r r r� s �z_CxSetFragmentFromField.srcN�r� r� r� r r� r r r r r� s r� c @ s e Zd Zdd� Zdd� ZdS )rh c C s || _ d S r )r� )r r� r r r r s z _CxSetFragmentFromPath.__init__c C s d� t| | j�S )Nz{0}fragment = path[{1}])rM r� r� r� r r r r� s �z_CxSetFragmentFromPath.srcNr� r r r r rh s rh c @ s e Zd Zdd� ZdS )rg c C s d� t| �S )Nz#{0}params.update(match.groupdict())�rM r� r� r r r r� s �z _CxSetParamsFromPatternMatch.srcN�r� r� r� r� r r r r rg s rg c @ s e Zd Zdd� ZdS )r� c C s d� t| �S )Nz{0}params.update(groups)r� r� r r r r� $ s �z*_CxSetParamsFromPatternMatchPrefetched.srcNr� r r r r r� # s r� c @ s e Zd Zdd� ZdS )re c C s d� t| �S )Nz {0}groups = match.groupdict()r� r� r r r r� + s �z%_CxPrefetchGroupsFromPatternMatch.srcNr� r r r r re * s re c @ s e Zd Zdd� ZdS )rp c C s d� t| �S )Nz{0}return Noner� r� r r r r� 2 s z_CxReturnNone.srcNr� r r r r rp 1 s rp c @ s e Zd Zdd� Zdd� ZdS )rq c C s || _ d S r )� _value_idx)r � value_idxr r r r 7 s z_CxReturnValue.__init__c C s d� t| | j�S )Nz {0}return return_values[{1}])rM r� r� r� r r r r� : s �z_CxReturnValue.srcNr� r r r r rq 6 s rq c @ s e Zd Zdd� Zdd� ZdS )rl c C s || _ || _d S r )� _param_namer� )r � param_namer� r r r r B s z_CxSetParam.__init__c C s d� t| | j| j�S )Nz {0}params['{1}'] = path[{2}])rM r� r� r� r� r r r r� F s �z_CxSetParam.srcNr� r r r r rl A s rl ) r� rK r5 r% � six.movesr �falcon.routingr r� r� r7 rI �objectr r* r� r r� r] rm rb rk r� rh rg r� re rp rq rl r r r r �<module> s> � "6
cải xoăn