ruạṛ
a [��f�) � @ s� d Z ddlZddlZddlZddlZddlZddlmZ dZejj Z ejj Z G dd� de �Z dd� Z d d � Zd d � Zd dd�Zd dd�Zdd� Zdd� Zdd� Zdd� Zd d d �ZdS )!z�Miscellaneous utilities. This module provides misc. utility functions for apps and the Falcon framework itself. These functions are hoisted into the front-door `falcon` module for convenience:: import falcon now = falcon.http_now() � N)� status_codes)� deprecated�http_now� dt_to_http�http_date_to_dt� to_query_str�get_bound_method� get_argnames�get_http_statusc @ s e Zd ZdS )�DeprecatedWarningN)�__name__� __module__� __qualname__� r r �t/sparta/input/_build_configuration/image_build+validate/lib/bmcenv/lib64/python3.9/site-packages/falcon/util/misc.pyr 9 s r c s � fdd�}|S )a] Flags a method as deprecated. This function returns a decorator which can be used to mark deprecated functions. Applying this decorator will result in a warning being emitted when the function is used. Args: instructions (str): Specific guidance for the developer, e.g.: 'Please migrate to add_proxy(...)'' c s t �� �� �fdd��}|S )Nc sB d� � j��}t�� j}tj|tt�|j �|j d� � | i |��S )Nz)Call to deprecated function {0}(...). {1})�category�filename�lineno) �formatr �inspect� currentframe�f_back�warnings� warn_explicitr �getfile�f_code�f_lineno)�args�kwargs�message�frame)�func� instructionsr r �wrapperJ s � �z.deprecated.<locals>.decorator.<locals>.wrapper)� functools�wraps)r! r# �r" )r! r � decoratorI s z deprecated.<locals>.decoratorr )r" r' r r& r r = s r c C s t t� �S )z�Returns the current UTC time as an IMF-fixdate. Returns: str: The current UTC time as an IMF-fixdate, e.g., 'Tue, 15 Nov 1994 12:45:26 GMT'. )r �utcnowr r r r r ^ s r c C s | � d�S )z�Converts a ``datetime`` instance to an HTTP date string. Args: dt (datetime): A ``datetime`` instance to convert, assumed to be UTC. Returns: str: An RFC 1123 date string, e.g.: "Tue, 15 Nov 1994 12:45:26 GMT". z%a, %d %b %Y %H:%M:%S GMT)�strftime)�dtr r r r i s r Fc C sT |st | d�S d}|D ],}zt | |�W S ty@ Y qY q0 qtd| ��dS )a Converts an HTTP date string to a datetime instance. Args: http_date (str): An RFC 1123 date string, e.g.: "Tue, 15 Nov 1994 12:45:26 GMT". Keyword Arguments: obs_date (bool): Support obs-date formats according to RFC 7231, e.g.: "Sunday, 06-Nov-94 08:49:37 GMT" (default ``False``). Returns: datetime: A UTC datetime instance corresponding to the given HTTP date. Raises: ValueError: http_date doesn't match any of the available time formats �%a, %d %b %Y %H:%M:%S %Z)r+ z%a, %d-%b-%Y %H:%M:%S %Zz%A, %d-%b-%y %H:%M:%S %Zz%a %b %d %H:%M:%S %Yz)time data %r does not match known formatsN)�strptime� ValueError)� http_date�obs_date� time_formats� time_formatr r r r x s r Tc C s� | sdS |rdnd}| � � D ]�\}}|du r2d}n||du r@d}nnt|t�r�|r`d�tt|��}q�|D ]<}|du rvd}n|du r�d}nt|�}||d | d 7 }qdq nt|�}||d | d 7 }q |d d � S ) a" Converts a dictionary of parameters to a query string. Args: params (dict): A dictionary of parameters, where each key is a parameter name, and each value is either a ``str`` or something that can be converted into a ``str``, or a list of such values. If a ``list``, the value will be converted to a comma-delimited string of values (e.g., 'thing=1,2,3'). comma_delimited_lists (bool): Set to ``False`` to encode list values by specifying multiple instances of the parameter (e.g., 'thing=1&thing=2&thing=3'). Otherwise, parameters will be encoded as comma-separated values (e.g., 'thing=1,2,3'). Defaults to ``True``. prefix (bool): Set to ``False`` to exclude the '?' prefix in the result string (default ``True``). Returns: str: A URI query string, including the '?' prefix (unless `prefix` is ``False``), or an empty string if no params are given (the ``dict`` is empty). � �?T�trueF�false�,�=�&N���)�items� isinstance�list�join�map�str)�params�comma_delimited_lists�prefix� query_str�k�v� list_valuer r r r � s, r c C s8 t | |d�}|dur4t�|�du r4d�|�}t|��|S )a� Get a bound method of the given object by name. Args: obj: Object on which to look up the method. method_name: Name of the method to retrieve. Returns: Bound method, or ``None`` if the method does not exist on the object. Raises: AttributeError: The method exists, but it isn't bound (most likely a class was passed, rather than an instance of that class). Nz{0} must be a bound method)�getattr�six�get_method_selfr �AttributeError)�obj� method_name�method�msgr r r r � s r c C s& t | tj�r| jS t�| �r | S | jS )z0Returns the function object of a given callable.)r; r$ �partialr! r � isroutine�__call__)�callabler r r �_get_func_if_nested� s rS c C s4 t �| �r| j} t �| j�\}}}t �|||| j�S )ao Returns an inspect.ArgSpec instance given a function object. We prefer this implementation rather than the inspect module's getargspec since the latter has a strict check that the passed function is an instance of FunctionType. Cython functions do not pass this check, but they do implement the `func_code` and `func_defaults` attributes that we need to produce an Argspec. This implementation re-uses much of inspect.getargspec but removes the strict check allowing interface failures to be raised as AttributeError. (See also: https://github.com/python/cpython/blob/2.7/Lib/inspect.py) )r �ismethod�im_func�getargs� func_code�ArgSpec� func_defaults)r! r �varargs�varkwr r r � _get_argspec s r\ c C sX t jr t| �}t|�}|j}n t�| �}dd� |j�� D �}|d dkrT|dd� }|S )z�Introspecs the arguments of a callable. Args: func: The callable to introspect Returns: A list of argument names, excluding *arg and **kwargs arguments. c S s( g | ] }|j tjjtjjfvr|j�qS r )�kindr � Parameter�VAR_POSITIONAL� VAR_KEYWORD�name)�.0�paramr r r � <listcomp>3 s �z get_argnames.<locals>.<listcomp>r �self� N) rH �PY2rS r\ r r � signature� parameters�values)r! � func_object�specr �sigr r r r s � r �Unknownc C sz z t | �}t|�}|dk r t�W n ty< td| ��Y n0 zttdt|� �W S tyt t|�d | Y S 0 dS )a� Gets both the http status code and description from just a code Args: status_code: integer or string that can be converted to an integer default_reason: default text to be appended to the status_code if the lookup does not find a result Returns: str: status code e.g. "404 Not Found" Raises: ValueError: the value entered could not be converted to an integer �d z7get_http_status failed: "%s" is not a valid status code�HTTP_� N)�float�intr- rG r r? rJ )� status_code�default_reason�coder r r r C s � r )F)TT)rn )�__doc__�datetimer$ r r rH �falconr �__all__r, r( � UserWarningr r r r r r r rS r\ r r r r r r �<module> s( ! . : $
cải xoăn