a
    õ£BeyC  ã                   @  s:  d Z ddlmZ ddlZddlmZmZmZ ddlm	Z	 ddl
mZ erXddlmZmZ G d	d
„ d
eƒZG dd„ dƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd„ deƒZG dd „ d eƒZG d!d"„ d"eƒZG d#d$„ d$eƒZdS )%z=Process URI templates per http://tools.ietf.org/html/rfc6570.é    )ÚannotationsN)ÚAnyÚTYPE_CHECKINGÚcasté   )ÚCharset©ÚVariable)ÚIterableÚMappingc                   @  s8   e Zd ZU dZded< dddœdd„Zddœd	d
„ZdS )ÚExpansionFailedErrorz&Exception thrown when expansions fail.ÚstrÚvariableÚNone)r   Úreturnc                 C  s
   || _ d S ©N©r   )Úselfr   © r   úZ/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/uri_template/expansions.pyÚ__init__   s    zExpansionFailedError.__init__©r   c                 C  s
   d| j  S )úConvert to string.zBad expansion: r   ©r   r   r   r   Ú__str__   s    zExpansionFailedError.__str__N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú__annotations__r   r   r   r   r   r   r      s   
r   c                
   @  s  e Zd ZdZddœdd„Zeddœdd„ƒZed	dœd
d„ƒZdddddœdd„Zdddœdd„Z	dddœdd„Z
dddddœdd„Zddddddddœdd„Zdddd ddddd!d"œ	d#d$„Zddd%d ddddd!d&œ	d'd(„Zd7ddd ddddd!d-œd.d/„Zd0d!d1œd2d3„Zd0dd1œd4d5„Zd6S )8Ú	Expansionz`
    Base class for template expansions.

    https://tools.ietf.org/html/rfc6570#section-3
    r   r   c                 C  s   d S r   r   r   r   r   r   r   #   s    zExpansion.__init__úIterable[Variable]c                 C  s   g S )z$Get all variables in this expansion.r   r   r   r   r   Ú	variables&   s    zExpansion.variablesúIterable[str]c                 C  s   g S )z1Get the names of all variables in this expansion.r   r   r   r   r   Úvariable_names+   s    zExpansion.variable_namesr   Úbool)ÚvalueÚlegalÚpct_encodedr   c           	      C  sÖ   d}d}|t |ƒk rÒ|| }||v r.||7 }nš|rŒd|krŒ|d t |ƒk rŒ||d  tjv rŒ||d  tjv rŒ||||d … 7 }|d7 }n<| d¡}|D ],}|dtjt|d ƒ  tj|d   7 }qš|d7 }q|S )	z"Encode a string into legal values.Ú r   ú%é   r   é   Úutf8é   )Úlenr   Z	HEX_DIGITÚencodeÚint)	r   r&   r'   r(   ÚoutputÚindexÚ	codepointr-   Úbyter   r   r   Ú_encode0   s(    
ÿþý

*
zExpansion._encode©r&   r   c                 C  s   |   |tjd¡S )ú!Encode a value into uri encoding.F)r6   r   Ú
UNRESERVED©r   r&   r   r   r   Ú_uri_encode_valueE   s    zExpansion._uri_encode_valuez	str | int)Únamer   c                 C  s"   |r|   t|ƒtjtj d¡S dS )z)Encode a variable name into uri encoding.Tr)   )r6   r   r   r9   ÚRESERVED)r   r<   r   r   r   Ú_uri_encode_nameI   s    zExpansion._uri_encode_name)ÚprefixÚjoinerr&   r   c                 C  s   |r|| | S |S )zJoin a prefix to a value.r   )r   r?   r@   r&   r   r   r   Ú_joinM   s    zExpansion._joinr	   ©r   r<   r&   r?   r@   Úfirstr   c              	   C  sH   |j r4|stt|ƒƒ‚|  |||  |d|j … ¡¡S |  |||  |¡¡S )z%Encode a string value for a variable.N)Ú
max_lengthr   r   rA   r;   ©r   r   r<   r&   r?   r@   rC   r   r   r   Ú_encode_strS   s
    zExpansion._encode_strú	int | strr   ú
str | None©	r   r<   ÚkeyÚitemÚdelimr?   r@   rC   r   c	           	   	   C  sj   |j r
dnd}|jr<|  |¡}|r6|s6|d | d n|}n|  |d|  |¡¡}|  |t|ƒ||||d¡S )ú"Encode a dict item for a variable.ú=ú,ú[ú]Ú.F)ÚexplodeÚarrayr>   rA   Ú_encode_varr   ©	r   r   r<   rJ   rK   rL   r?   r@   rC   r   r   r   Ú_encode_dict_item[   s    
zExpansion._encode_dict_itemr1   ©	r   r<   r3   rK   rL   r?   r@   rC   r   c	           	   	   C  sN   |j r8|r|d t|ƒ d nd}|  |d||||d¡S |  |||||dd¡S )ú"Encode a list item for a variable.rP   rQ   r)   FrR   )rT   r   rU   ©	r   r   r<   r3   rK   rL   r?   r@   rC   r   r   r   Ú_encode_list_itemf   s    zExpansion._encode_list_itemrO   r)   rN   T)r   r<   r&   rL   r?   r@   rC   r   c           	        s  t ˆtƒrˆ ˆˆˆˆˆˆ¡S t ˆtjjƒrptˆƒrl‡ ‡‡‡‡‡‡‡fdd„ˆ ¡ D ƒ}ˆ  dd„ |D ƒ¡S dS t ˆtjj	ƒrÀtˆƒr¼‡ ‡‡‡‡‡‡fdd„t
ˆƒD ƒ}ˆ  dd„ |D ƒ¡S dS t ˆtƒræˆ ˆˆtˆƒ ¡ ˆˆˆ¡S ˆ ˆˆtˆƒˆˆˆ¡S dS )zEncode a variable.c                   s(   g | ] }ˆ  ˆˆ|ˆ| ˆ ˆˆˆ¡‘qS r   )rW   )Ú.0rJ   ©rL   rC   r@   r<   r?   r   r&   r   r   r   Ú
<listcomp>u   s   ÿz)Expansion._encode_var.<locals>.<listcomp>c                 S  s   g | ]}|d ur|‘qS r   r   ©r\   rK   r   r   r   r^   w   ó    Nc                   s(   g | ] \}}ˆ  ˆˆ||ˆ ˆˆˆ¡‘qS r   )r[   )r\   r3   rK   )rL   rC   r@   r<   r?   r   r   r   r   r^   {   s   ÿc                 S  s   g | ]}|d ur|‘qS r   r   r_   r   r   r   r^   }   r`   )Ú
isinstancer   rF   ÚcollectionsÚabcr   r/   ÚkeysÚjoinÚSequenceÚ	enumerater%   Úlower)	r   r   r<   r&   rL   r?   r@   rC   Zencoded_itemsr   r]   r   rU   n   s&    
ÿÿ
zExpansion._encode_varúMapping[str, Any]©Úvaluesr   c                 C  s   dS )zExpand values.Nr   ©r   rk   r   r   r   Úexpand„   s    zExpansion.expandc                 C  s   dS )zPerform partial expansion.r)   r   rl   r   r   r   Úpartialˆ   s    zExpansion.partialN)rO   r)   rN   T)r   r   r   r   r   Úpropertyr"   r$   r6   r;   r>   rA   rF   rW   r[   rU   rm   rn   r   r   r   r   r       s"   	 ÿr    c                      sP   e Zd ZU dZded< dddœ‡ fdd„Zdd	d
œdd„Zddœdd„Z‡  ZS )ÚLiteralzS
    A literal expansion.

    https://tools.ietf.org/html/rfc6570#section-3.1
    r   r&   r   r7   c                   s   t ƒ  ¡  || _d S r   )Úsuperr   r&   r:   ©Ú	__class__r   r   r   –   s    
zLiteral.__init__ri   rH   rj   c                 C  s   |   | jtjtj d¡S )zPerform exansion.T)r6   r&   r   r9   r=   rl   r   r   r   rm   š   s    zLiteral.expandr   c                 C  s   | j S )r   )r&   r   r   r   r   r   ž   s    zLiteral.__str__)	r   r   r   r   r   r   rm   r   Ú__classcell__r   r   rr   r   rp   �   s
   
rp   c                      s¶   e Zd ZU dZdZdZdZdZdZde	d< dZ
de	d< ddd	œ‡ fd
d„Zeddœdd„ƒZeddœdd„ƒZddddœdd„Zdddœdd„Zdddœdd„Zddœdd „Z‡  ZS )!ÚExpressionExpansionzd
    Base class for expression expansions.

    https://tools.ietf.org/html/rfc6570#section-3.2
    r)   rO   úlist[Variable]Úvarsr   Útrailing_joinerr   ©r"   r   c                   sJ   t ƒ  ¡  |r0|d dv r0|d | _|d d… }dd„ | d¡D ƒ| _d S )Néÿÿÿÿ)rO   rR   ú/ú;ú&c                 S  s   g | ]}t |ƒ‘qS r   r   ©r\   Úvarr   r   r   r^   ¸   r`   z0ExpressionExpansion.__init__.<locals>.<listcomp>rO   )rq   r   rx   Úsplitrw   ©r   r"   rr   r   r   r   ³   s
    

zExpressionExpansion.__init__r!   r   c                 C  s
   t | jƒS )zGet all variables.)Úlistrw   r   r   r   r   r"   º   s    zExpressionExpansion.variablesr#   c                 C  s   dd„ | j D ƒS )zGet names of all variables.c                 S  s   g | ]
}|j ‘qS r   )r<   r~   r   r   r   r^   Â   r`   z6ExpressionExpansion.variable_names.<locals>.<listcomp>)rw   r   r   r   r   r$   ¿   s    z"ExpressionExpansion.variable_namesr	   r   rH   ©r   r&   r   c                 C  s   |   ||  |j¡|¡S )úExpand a single variable.)rU   r>   r<   ©r   r   r&   r   r   r   Ú_expand_varÄ   s    zExpressionExpansion._expand_varri   rj   c                 C  sp   g }| j D ]:}| |j|j¡}|dur
|  ||¡}|dur
| |¡ q
|rl| jsV| jnd| j 	|¡ | j S dS )z*Expand all variables, skip missing values.Nr)   )
rw   ÚgetrJ   Údefaultr†   Úappendrx   Úoutput_prefixÚ
var_joinerre   )r   rk   Úexpanded_varsr   r&   Úexpanded_varr   r   r   rm   È   s    
ÿzExpressionExpansion.expandc              	   C  s|  g }g }g }| j D ]r}| |j|j¡}|durd|  ||¡}|dur„|rX| d|f¡ g }| |¡ q|rz| |df¡ g }| |¡ q|r˜| |df¡ |rª| d|f¡ d}d}	t|ƒD ]¼\}
\}}|
t|ƒd k}|�r||	rî| jsî| j	nd| j
 |¡ | j 7 }nj||	�r|�s| j	n|�s(| j
ndd |	�r:| jn| j d dd„ td	|ƒD ƒ¡ |�sf| jnd d
 7 }d}	qº|S )z=Expand all variables, replace missing values with expansions.Nr)   Tr   Ú{rO   c                 S  s   g | ]}t |ƒ‘qS r   ©r   r~   r   r   r   r^   ø   r`   z/ExpressionExpansion.partial.<locals>.<listcomp>rv   Ú}F)rw   r‡   r<   rˆ   r†   r‰   rg   r/   rx   rŠ   r‹   re   ÚoperatorÚpartial_operatorr   Úpartial_joiner)r   rk   rŒ   Zmissing_varsÚresultr   r&   r�   r2   rC   r3   ÚexpandedÚmissingÚlastr   r   r   rn   Ö   sV    

ÿÿ"ÿÿþýýzExpressionExpansion.partialc                 C  s*   d| j  d dd„ | jD ƒ¡ | j d S )r   rŽ   rO   c                 S  s   g | ]}t |ƒ‘qS r   r�   r~   r   r   r   r^   ÿ   r`   z/ExpressionExpansion.__str__.<locals>.<listcomp>r�   )r‘   re   rw   rx   r   r   r   r   r   ý   s    zExpressionExpansion.__str__)r   r   r   r   r‘   r’   rŠ   r‹   r“   r   rx   r   ro   r"   r$   r†   rm   rn   r   rt   r   r   rr   r   ru   £   s"   
'ru   c                      s(   e Zd ZdZdddœ‡ fdd„Z‡  ZS )ÚSimpleExpansionz`
    Simple String expansion {var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.2

    r   r   ry   c                   s   t ƒ  |¡ d S r   ©rq   r   r�   rr   r   r   r   
  s    zSimpleExpansion.__init__)r   r   r   r   r   rt   r   r   rr   r   r˜     s   r˜   c                      s@   e Zd ZdZdZdZdddœ‡ fdd„Zddd	œd
d„Z‡  ZS )ÚReservedExpansionz[
    Reserved Expansion {+var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.3
    ú+ú,+r   r   ry   c                   s   t ƒ  |dd … ¡ d S ©Nr   r™   r�   rr   r   r   r     s    zReservedExpansion.__init__r7   c                 C  s   |   |tjtj d¡S )r8   T)r6   r   r9   r=   r:   r   r   r   r;     s    z#ReservedExpansion._uri_encode_value)	r   r   r   r   r‘   r’   r   r;   rt   r   r   rr   r   rš     s
   rš   c                      s0   e Zd ZdZdZdZdddœ‡ fdd„Z‡  ZS )ÚFragmentExpansionz[
    Fragment Expansion {#var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.4
    ú#r   r   ry   c                   s   t ƒ  |¡ d S r   r™   r�   rr   r   r   r   *  s    zFragmentExpansion.__init__©r   r   r   r   r‘   rŠ   r   rt   r   r   rr   r   rž      s   rž   c                      sN   e Zd ZdZdZdZdZdZdZdddœ‡ fdd„Z	dd	d
dœdd„Z
‡  ZS )ÚLabelExpansionzh
    Label Expansion with Dot-Prefix {.var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.5
    rR   r   r   ry   c                   s   t ƒ  |dd … ¡ d S r�   r™   r�   rr   r   r   r   ;  s    zLabelExpansion.__init__r	   r   rH   rƒ   c                 C  s$   | j ||  |j¡||jrdndd�S ©r„   rR   rO   ©rL   ©rU   r>   r<   rS   r…   r   r   r   r†   >  s    ÿzLabelExpansion._expand_var©r   r   r   r   r‘   r’   rŠ   r‹   r“   r   r†   rt   r   r   rr   r   r¡   .  s   r¡   c                      sN   e Zd ZdZdZdZdZdZdZdddœ‡ fdd„Z	dd	d
dœdd„Z
‡  ZS )ÚPathExpansionz_
    Path Segment Expansion {/var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.6
    r{   r   r   ry   c                   s   t ƒ  |dd … ¡ d S r�   r™   r�   rr   r   r   r   Q  s    zPathExpansion.__init__r	   r   rH   rƒ   c                 C  s$   | j ||  |j¡||jrdndd�S )r„   r{   rO   r£   r¤   r…   r   r   r   r†   T  s    ÿzPathExpansion._expand_varr¥   r   r   rr   r   r¦   D  s   r¦   c                
      s¨   e Zd ZdZdZdZdZdZdZdddœ‡ fdd„Z	ddd	ddd
ddœ‡ fdd„Z
dddd	dddd
ddœ	dd„Zdddd	dddd
ddœ	dd„Zdd	ddœdd„Z‡  ZS )ÚPathStyleExpansionzg
    Path-Style Parameter Expansion {;var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.7
    r|   r   r   ry   c                   s   t ƒ  |dd … ¡ d S r�   r™   r�   rr   r   r   r   g  s    zPathStyleExpansion.__init__r	   r   r%   rB   c                   sN   |j r$|r8|r|d | d n|}n|jr8|  |d|¡}tƒ  ||||||¡S )zEncode a string for a variable.rP   rQ   rR   )rT   rS   rA   rq   rF   rE   rr   r   r   rF   j  s    zPathStyleExpansion._encode_strrG   rH   rI   c	           	   	   C  sª   |j rN|r"|r|d | d n|}|rB|sB|d |  |¡ d }q„|  |¡}n6|jrl|sf|  |d|¡nd}n|  |d|  |¡¡}d}|  ||j sš|  |¡nd||||d¡S )rM   rP   rQ   rR   r)   rO   F)rT   r>   rS   rA   rU   rV   r   r   r   rW   s  s    ÿz$PathStyleExpansion._encode_dict_itemr1   rX   c	           	   	   C  s\   |j r<|r"|r|d | d n|}|  |t|ƒ||||d¡S |  ||||||jrTdndd¡S )rY   rP   rQ   FrN   rR   )rT   rU   r   rS   rZ   r   r   r   r[   …  s
    z$PathStyleExpansion._encode_list_itemrƒ   c                 C  sX   |j r | j||  |j¡|dd�S | j||  |j¡|dd�}|rR|  |j¡d | S |jS )r„   r|   r£   rO   rN   ©rS   rU   r>   r<   r…   r   r   r   r†   Ž  s    zPathStyleExpansion._expand_var)r   r   r   r   r‘   r’   rŠ   r‹   r“   r   rF   rW   r[   r†   rt   r   r   rr   r   r§   Z  s   		r§   c                      sN   e Zd ZdZdZdZdZdZdZdddœ‡ fdd„Z	d	d
ddœdd„Z
‡  ZS )ÚFormStyleQueryExpansionzc
    Form-Style Query Expansion {?var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.8
    ú?r}   r   r   ry   c                   s   t ƒ  |¡ d S r   r™   r�   rr   r   r   r   £  s    z FormStyleQueryExpansion.__init__r	   r   rH   rƒ   c                 C  sZ   |j r | j||  |j¡|dd�S | j||  |j¡|dd�}|durV|  |j¡d | S dS )r„   r}   r£   rO   NrN   r¨   r…   r   r   r   r†   ¦  s    z#FormStyleQueryExpansion._expand_varr¥   r   r   rr   r   r©   –  s   r©   c                      s0   e Zd ZdZdZdZdddœ‡ fdd„Z‡  ZS )ÚFormStyleQueryContinuationzf
    Form-Style Query Continuation {&var}.

    https://tools.ietf.org/html/rfc6570#section-3.2.9
    r}   r   r   ry   c                   s   t ƒ  |¡ d S r   r™   r�   rr   r   r   r   ¸  s    z#FormStyleQueryContinuation.__init__r    r   r   rr   r   r«   ®  s   r«   c                      sB   e Zd ZdZdZdZdddœ‡ fdd„Zdd	d
dœdd„Z‡  ZS )ÚCommaExpansionzn
    Label Expansion with Comma-Prefix {,var}.

    Non-standard extension to support partial expansions.
    rO   r   r   ry   c                   s   t ƒ  |dd … ¡ d S r�   r™   r�   rr   r   r   r   È  s    zCommaExpansion.__init__r	   r   rH   rƒ   c                 C  s$   | j ||  |j¡||jrdndd�S r¢   r¤   r…   r   r   r   r†   Ë  s    ÿzCommaExpansion._expand_var©	r   r   r   r   r‘   rŠ   r   r†   rt   r   r   rr   r   r¬   ¾  s
   r¬   c                      sB   e Zd ZdZdZdZdddœ‡ fdd„Zd	d
ddœdd„Z‡  ZS )ÚReservedCommaExpansionzr
    Reserved Expansion with comma prefix {,+var}.

    Non-standard extension to support partial expansions.
    rœ   rO   r   r   ry   c                   s   t ƒ  |dd … ¡ d S r�   r™   r�   rr   r   r   r   Û  s    zReservedCommaExpansion.__init__r	   r   rH   rƒ   c                 C  s$   | j ||  |j¡||jrdndd�S r¢   r¤   r…   r   r   r   r†   Þ  s    ÿz"ReservedCommaExpansion._expand_varr­   r   r   rr   r   r®   Ñ  s
   r®   )r   Ú
__future__r   rb   Útypingr   r   r   Úcharsetr   r   r	   Úcollections.abcr
   r   Ú	Exceptionr   r    rp   ru   r˜   rš   rž   r¡   r¦   r§   r©   r«   r¬   r®   r   r   r   r   Ú<module>   s*   q_<