�
��fa� � � � d Z ddlZddlZddlmZ ddlmZ ej d� � Zdej ej
dej
dej
fd �Z G d
� d � � Z dS ) z�
uritemplate.template
====================
This module contains the essential inner workings of uritemplate.
What treasures await you:
- URITemplate class
You see a treasure chest of knowledge in front of you.
What do you do?
>
� N)�
orderedset)�variablez {([^}]+)}�var_dict� overrides�returnc �` � | r+| � � � }|� |� � |S |S �N)�copy�update)r r �optss �6/usr/lib/python3/dist-packages/uritemplate/template.py�_merger s6 � � � ��}�}���� � � �I� � � �� � �� c �� � e Zd ZdZdefd�Zdefd�Zdefd�Zdede fd�Z
de fd �Z d
e
j d e defd �Z dd
ej e
j de
j defd�Z dd
ej e
j de
j dd fd�Zd
S )� URITemplatea This parses the template and will be used to expand it.
This is the most important object as the center of the API.
Example::
from uritemplate import URITemplate
import requests
t = URITemplate(
'https://api.github.com/users/sigmavirus24/gists{/gist_id}'
)
uri = t.expand(gist_id=123456)
resp = requests.get(uri)
for gist in resp.json():
print(gist['html_url'])
Please note::
str(t)
# 'https://api.github.com/users/sigmavirus24/gists{/gistid}'
repr(t) # is equivalent to
# URITemplate(str(t))
# Where str(t) is interpreted as the URI string.
Also, ``URITemplates`` are hashable so they can be used as keys in
dictionaries.
�uric � � || _ d� t � | j � � D � � | _ t j � � | _ | j D ]&}|j D ] }| j � |� � � �'d S )Nc �f � g | ].}t j |� � � d � � ��/S )r )r � URIVariable�groups)�.0�ms r
�
<listcomp>z(URITemplate.__init__.<locals>.<listcomp>K s? � � 8
� 8
� 8
��
� ������A� � /� /�8
� 8
� 8
r )r � template_re�finditer� variablesr �
OrderedSet�variable_names�add)�selfr �var�names r
�__init__zURITemplate.__init__F s� � ����8
� 8
� �)�)�$�(�3�3�8
� 8
� 8
���
)� 3� 5� 5����>� .� .�C��*�
.�
.���#�'�'��-�-�-�-�
.� .� .r r c � � d| z S )NzURITemplate("%s")� �r s r
�__repr__zURITemplate.__repr__U s
� �"�T�)�)r c � � | j S r )r r& s r
�__str__zURITemplate.__str__X s � ��x�r �otherc �Z � t |t � � st S | j |j k S r )�
isinstancer �NotImplementedr )r r* s r
�__eq__zURITemplate.__eq__[ s) � ��%��-�-� "�!� !��x�5�9�$�$r c �* � t | j � � S r )�hashr r& s r
�__hash__zURITemplate.__hash__` s � ��D�H�~�~� r r �replacec � �� | j s| j S |}i �| j D ]*}�� |� |� � � � �+dddt f�fd� }dddt f�fd� }|r|n|}t
� || j � � S )N�matchz
re.Match[str]r c �` �� �� | � � � d d� � S )Nr � )�getr )r4 �expandeds �r
� replace_allz(URITemplate._expand.<locals>.replace_alln s$ �� ��<�<�� � ���q� 1�2�6�6� 6r c �p �� | � � � d }d|z }�� |� � p|S )Nr z{%s})r r7 )r4 � match_groupr! r8 s �r
�replace_partialz,URITemplate._expand.<locals>.replace_partialq s6 �� � �,�,�.�.��+�K��;�&�C��<�<� �,�,�3�� 3r )r r r �expand�strr �sub) r r r2 � expansion�vr9 r< � replace_funcr8 s @r
�_expandzURITemplate._expandc s� �� � �~� ��8�O� � �%'��� � 1� 1�A� �O�O�A�H�H�Y� /� /� 0� 0� 0� 0� 7�� 7�3� 7� 7� 7� 7� 7� 7� 4�?� 4�s� 4� 4� 4� 4� 4� 4�
+2�B���{� ����|�T�X�6�6�6r N�kwargsc �J � | � t ||� � d� � S )am Expand the template with the given parameters.
:param dict var_dict: Optional dictionary with variables and values
:param kwargs: Alternative way to pass arguments
:returns: str
Example::
t = URITemplate('https://api.github.com{/end}')
t.expand({'end': 'users'})
t.expand(end='gists')
.. note:: Passing values by both parts, may override values in
``var_dict``. For example::
expand('https://{var}', {'var': 'val1'}, var='val2')
``val2`` will be used instead of ``val1``.
F)rC r �r r rD s r
r= zURITemplate.expandz s" � �2 �|�|�F�8�V� 4� 4�e�<�<�<r c �d � t | � t ||� � d� � � � S )a� Partially expand the template with the given parameters.
If all of the parameters for the template are not given, return a
partially expanded template.
:param dict var_dict: Optional dictionary with variables and values
:param kwargs: Alternative way to pass arguments
:returns: :class:`URITemplate`
Example::
t = URITemplate('https://api.github.com{/end}')
t.partial() # => URITemplate('https://api.github.com{/end}')
T)r rC r rF s r
�partialzURITemplate.partial� s* � �( �4�<�<��x��(@�(@�$�G�G�H�H�Hr r )�__name__�
__module__� __qualname__�__doc__r> r# r' r) �object�boolr. �intr1 r �VariableValueDictrC �t�Optional�
VariableValuer= rH r% r r
r r % su � � � � � � � �>
.�C�
.�
.�
.�
.� *�#� *� *� *� *��� � � � �%�F� %�t� %� %� %� %�
�#� � � � �7� �2�7�=A�7� �7� 7� 7� 7�2 <@�=� =��*�X� 7�8�=� �(�=�
� =� =� =� =�: <@�I� I��*�X� 7�8�I� �(�I�
� I� I� I� I� I� Ir r )
rL �re�typingrQ � uritemplater r �compiler rR rP r r r% r r
�<module>rX s� ��� �
� � � � � � � � "� "� "� "� "� "� � � � � � ��b�j��%�%� ���j��3�4���)�� � �� � � �DI� DI� DI� DI� DI� DI� DI� DI� DI� DIr |