Google
Edit File: 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 �