Current File : //usr/lib/python3.9/site-packages/passlib/utils/__pycache__/decor.cpython-39.pyc
a
f�Wc� � @ s� d Z ddlmZmZmZ ddlZe�e�Zddl m
Z
m Z ddl Z ddl
mZ ddlmZ g d�ZG dd � d e�ZG d
d � d e�Zd d
� ZG dd� de�Zddd�Zddd�ZdS )z7
passlib.utils.decor -- helper decorators & properties
� )�absolute_import�division�print_functionN)�wraps�update_wrapper)�warn)�PY3)�
classproperty�
hybrid_method�memoize_single_value�memoized_property�deprecated_function�deprecated_methodc @ s, e Zd ZdZdd� Zdd� Zedd� �ZdS ) r zjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)c C s
|| _ d S �N��im_func��self�func� r �7/usr/lib/python3.9/site-packages/passlib/utils/decor.py�__init__# s zclassproperty.__init__c C s
| � |�S r r �r �obj�clsr r r �__get__& s zclassproperty.__get__c C s | j S )zpy3 compatible aliasr �r r r r �__func__) s zclassproperty.__func__N)�__name__�
__module__� __qualname__�__doc__r r �propertyr r r r r r s
r c @ s e Zd ZdZdd� Zdd� ZdS )r
z�
decorator which invokes function with class if called as class method,
and with object if called at instance level.
c C s || _ t| |� d S r )r r r r r r r 4 s zhybrid_method.__init__c C s2 |d u r |}t r t�| j|�S t�| j||�S d S r )r �types�
MethodTyper r r r r r 8 s
zhybrid_method.__get__N)r r r r! r r r r r r r
. s r
c s0 i � t ��� �fdd��}� fdd�}||_|S )z�
decorator for function which takes no args,
and memoizes result. exposes a ``.clear_cache`` method
to clear the cached value.
c s0 z
� d W S t y Y n0 �� } � d< | S �NT)�KeyError)�value��cacher r r �wrapperL s
z%memoize_single_value.<locals>.wrapperc s � � dd � d S r% )�popr )r) r r � clear_cacheU s z)memoize_single_value.<locals>.clear_cache)r r, )r r* r, r r( r r D s r c @ sB e Zd ZdZdd� Zdd� Zes,edd� �Zdd � Z d
d d �Z
d
S )r zM
decorator which invokes method once, then replaces attr with result
c C s || _ |j| _|j| _d S r )r r r! r r r r r _ s zmemoized_property.__init__c C s( |d u r | S | � |�}t|| j|� |S r )r �setattrr )r r r r' r r r r d s
zmemoized_property.__get__c C s | j S )z py2 alias)r r r r r r m s zmemoized_property.im_funcc C s |j �| jd� dS )z�
class-level helper to clear stored value (if any).
usage: :samp:`type(self).{attr}.clear_cache(self)`
N)�__dict__r+ r )r r r r r r, r s z memoized_property.clear_cacheNc C s |j �| j|�S )z�
class-level helper to peek at stored value
usage: :samp:`value = type(self).{attr}.clear_cache(self)`
)r. �getr )r r �defaultr r r �
peek_cachez s z memoized_property.peek_cache)N) r r r r! r r r r" r r, r1 r r r r r [ s
r TFc sb �du rF� rd�nd��r"�d7 ��r.�d7 ��r>�d� 7 ��d7 �� ������fdd �}|S )
ab decorator to deprecate a function.
:arg msg: optional msg, default chosen if omitted
:kwd deprecated: version when function was first deprecated
:kwd removed: version when function will be removed
:kwd replacement: alternate name / instructions for replacing this function.
:kwd updoc: add notice to docstring (default ``True``)
Nz5the method %(mod)s.%(klass)s.%(name)s() is deprecatedz-the function %(mod)s.%(name)s() is deprecatedz as of Passlib %(deprecated)sz,, and will be removed in Passlib %(removed)sz, use %s instead�.c s* �o t � t���r � �d t�j� t�p*� j� j��d���rP� ���fdd�}n�� �� �fdd�}t|� � �
�r�s���r|j �rd|j v�r�p�d}�s�� r�|d7 }�r�|d�f 7 }� rڈr�|d 7 }|d
� 7 }|d 7 }|j �
d �� d
��s| j d
7 _ | j d|f 7 _ ��r&t|�}|S )N)�mod�name�
deprecated�removedc sP �� � }�r| d n| d j}|j|j|jd� t�| tdd� � | i |��S )Nr )�klassr3 � ��
stacklevel)�copy� __class__�updater r r �DeprecationWarning)�args�kwds�tmpr7 )r �is_classmethod�msg�optsr r r* � s
z3deprecated_function.<locals>.build.<locals>.wrapperc s t �tdd� � | i |��S )Nr8 r9 )r r> )r? r@ )r �textr r r* � s z.. deprecated::� z
z!and will be removed in version %sz, zuse %s insteadr2 � �
z
.. deprecated:: %s
) �
isinstance� classmethodr �typer �dictr r r r! �strip�endswith)r r* Ztxt��
_is_methodr5 � func_modulerC r6 � replacement�updoc)r rB rD rE r �build� sF �
�� z"deprecated_function.<locals>.buildr )rC r5 r6 rS rR rP rQ rT r rO r r
� s *r
c C s t | ||||dd�S )aZ decorator to deprecate a method.
:arg msg: optional msg, default chosen if omitted
:kwd deprecated: version when method was first deprecated
:kwd removed: version when method will be removed
:kwd replacement: alternate name / instructions for replacing this method.
:kwd updoc: add notice to docstring (default ``True``)
T)rP )r
)rC r5 r6 rS rR r r r r � s
�r )NNNTNFN)NNNTN)r! Z
__future__r r r ZloggingZ getLoggerr �log� functoolsr r r# �warningsr Zpasslib.utils.compatr �__all__�objectr r
r r r
r r r r r �<module> s&
< �
C �
Mini Shell