o

�h	�	@s�dZd
dl
Zd
dlmZ
d
dlmZ
d
dlmZ
dZ		dde
dejejd	ej
d
e
fdd�Z	dde
dejejd	ej
d
efd
d�Zde
d
efdd�ZdS)zf

uritemplate.api
===============

This module contains the very simple API provided by uritemplate.

�N)
�variable)
�
OrderedSet)
�URITemplate)rr�expand�partial�	variables�uri�var_dict�kwargs�returncK�t|�
j
|
f
i|�
�
S)
aqExpand the template with the given parameters.

    :param str uri: The templated URI to expand
    :param dict var_dict: Optional dictionary with variables and values
    :param kwargs: Alternative way to pass arguments
    :returns: str

    Example::

        expand('https://api.github.com{/end}', {'end': 'users'})
        expand('https://api.github.com{/end}', 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``.

    )rr�rr	r
�r�B/usr/local/CyberCP/lib/python3.10/site-packages/uritemplate/api.pyrsrcKr)
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}')

    )rrr
rrrr/src

Cstt
|�
j�
S)
ah
Parse the variables of the template.

    This returns all of the variable names in the URI Template.

    :returns: Set of variable names
    :rtype: set

    Example::

        variables('https://api.github.com{/end})
        # => {'end'}
        variables('https://api.github.com/repos{/username}{/repository}')
        # => {'username', 'repository'}

    )rr�variable_names)
rrrrrFsr)
N)�__doc__�typing�
t�uritemplater�uritemplate.orderedsetr�uritemplate.templater�__all__�str�Optional�VariableValueDict�
VariableValuerrrrrrr�<module>
s6	

�
�
��
��
�
��
�