ó øÐLac@`sdZddlmZmZmZddlZejeƒZddl m Z m Z ddl Z ddl mZddlmZddd d d d gZdefd „ƒYZdefd„ƒYZd„Zd efd„ƒYZdddededd„Zdddedd„ZdS(s7 passlib.utils.decor -- helper decorators & properties i(tabsolute_importtdivisiontprint_functionN(twrapstupdate_wrapper(twarn(tPY3t classpropertyt hybrid_methodtmemoize_single_valuetmemoized_propertytdeprecated_functiontdeprecated_methodcB`s/eZdZd„Zd„Zed„ƒZRS(sjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)cC`s ||_dS(N(tim_func(tselftfunc((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyt__init__#scC`s |j|ƒS(N(R (Rtobjtcls((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyt__get__&scC`s|jS(spy3 compatible alias(R (R((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyt__func__)s(t__name__t __module__t__doc__RRtpropertyR(((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR s  cB`s eZdZd„Zd„ZRS(s decorator which invokes function with class if called as class method, and with object if called at instance level. cC`s||_t||ƒdS(N(RR(RR((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR4s cC`sH|dkr|}ntr.tj|j|ƒStj|j||ƒSdS(N(tNoneRttypest MethodTypeR(RRR((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR8s   (RRRRR(((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR.s c`s@i‰tˆƒ‡‡fd†ƒ}‡fd†}||_|S(s decorator for function which takes no args, and memoizes result. exposes a ``.clear_cache`` method to clear the cached value. c`s5y ˆtSWntk rnXˆƒ}ˆt<|S(N(tTruetKeyError(tvalue(tcacheR(sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pytwrapperLs   c`sˆjtdƒdS(N(tpopRR((R(sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyt clear_cacheUs(RR"(RR R"((RRsN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR Ds   cB`sMeZdZd„Zd„Zes6ed„ƒZnd„Zdd„Z RS(sM decorator which invokes method once, then replaces attr with result cC`s%||_|j|_|j|_dS(N(RRR(RR((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR_s  cC`s6|dkr|S|j|ƒ}t||j|ƒ|S(N(RRtsetattrR(RRRR((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyRds  cC`s|jS(s py2 alias(R(R((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR mscC`s|jj|jdƒdS(s€ class-level helper to clear stored value (if any). usage: :samp:`type(self).{attr}.clear_cache(self)` N(t__dict__R!RR(RR((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR"rscC`s|jj|j|ƒS(s€ class-level helper to peek at stored value usage: :samp:`value = type(self).{attr}.clear_cache(self)` (R$tgetR(RRtdefault((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyt peek_cachezsN( RRRRRRRR R"RR'(((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR [s   c`sˆdkrkˆrd‰nd‰ˆr4ˆd7‰nˆrGˆd7‰nˆr^ˆdˆ7‰nˆd7‰n‡‡‡‡‡‡‡fd†}|S( sbdecorator 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``) s5the method %(mod)s.%(klass)s.%(name)s() is deprecateds-the function %(mod)s.%(name)s() is deprecateds as of Passlib %(deprecated)ss,, and will be removed in Passlib %(removed)ss, use %s insteadt.c `s¦ˆotˆtƒ‰ˆr3ˆjdtƒj‰ntdˆpEˆjdˆjdˆdˆƒ‰ˆr‡‡‡‡fd†}nˆˆ‰‡‡fd†}t |ˆƒˆ rˆs¼ˆr|j rd|j krˆpÝd}ˆsìˆ rG|d 7}ˆr|d ˆf7}nˆ r:ˆr)|d 7}n|d ˆ 7}n|d 7}n|j j dƒj dƒst|j d7_ n|j d|f7_ nˆr¢t|ƒ}n|S(Ntmodtnamet deprecatedtremovedc`siˆjƒ}ˆr|dn |dj}|jd|jd|jƒtˆ|tddƒˆ||ŽS(NitklassR)t stackleveli(tcopyt __class__tupdateRRRtDeprecationWarning(targstkwdsttmpR-(Rtis_classmethodtmsgtopts(sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR ºs  c`s tˆtddƒˆ||ŽS(NR.i(RR2(R3R4(Rttext(sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR Âss.. deprecated::ts s!and will be removed in version %ss, suse %s insteadR(t s s .. deprecated:: %s ( t isinstancet classmethodRRttypeRtdictRRRRtstriptendswith(RR ttxt(t _is_methodR+t func_moduleR7R,t replacementtupdoc(RR6R8R9sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pytbuild®s>         N(R(R7R+R,RFRERCRDRG((RCR+RDR7R,RERFsN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR —s     !*cC`st|||||dtƒS(sZdecorator 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``) RC(R R(R7R+R,RFRE((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyR Ús (Rt __future__RRRtloggingt getLoggerRtlogt functoolsRRRtwarningsRtpasslib.utils.compatRt__all__tobjectRRR R RRtFalseR R (((sN/var/www/html/packages/venv/lib/python3.8/site-packages/passlib/utils/decor.pyts,    <  A