lgdZddlmZmZmZddlZejeZddl m Z m Z ddl Z ddl mZddlmZgdZGdd eZGd d eZd ZGd deZ ddZ ddZdS)z7 passlib.utils.decor -- helper decorators & properties )absolute_importdivisionprint_functionN)wrapsupdate_wrapper)warn)PY3) classproperty hybrid_methodmemoize_single_valuememoized_propertydeprecated_functiondeprecated_methodc4eZdZdZdZdZedZdS)r zjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)c||_dSNim_funcselffuncs N/var/www/html/nourish/venv/lib/python3.11/site-packages/passlib/utils/decor.py__init__zclassproperty.__init__#s  c,||Srrrobjclss r__get__zclassproperty.__get__&s||C   rc|jS)zpy3 compatible aliasrrs r__func__zclassproperty.__func__)s |rN)__name__ __module__ __qualname____doc__rrpropertyr"rrr r sStt!!!Xrr ceZdZdZdZdZdS)r z decorator which invokes function with class if called as class method, and with object if called at instance level. c4||_t||dSr)rrrs rrzhybrid_method.__init__4s tT"""""rc||}trtj|j|Stj|j||Sr)r types MethodTyperrs rrzhybrid_method.__get__8s@ ;C  9#DIs33 3#DIsC88 8rN)r#r$r%r&rrr(rrr r .s< ###99999rr c\itfd}fd}||_|S)z decorator for function which takes no args, and memoizes result. exposes a ``.clear_cache`` method to clear the cached value. cX dS#t$rYnwxYwx}d<|SNT)KeyError)valuecachers rwrapperz%memoize_single_value..wrapperLsK ;     D "dff$d  s  c4dddSr0)pop)r3sr clear_cachez)memoize_single_value..clear_cacheUs $r)rr7)rr4r7r3s` @rr r Ds_ E 4[[[%G NrcFeZdZdZdZdZes edZdZ ddZ dS) r zM decorator which invokes method once, then replaces attr with result cD||_|j|_|j|_dSr)r"r#r&rs rrzmemoized_property.__init___s   | rcd||S||}t||j||Sr)r"setattrr#)rrrr2s rrzmemoized_property.__get__ds6 ;K c""T]E*** rc|jS)z py2 alias)r"r!s rrzmemoized_property.im_funcms = rcF|j|jddS)z class-level helper to clear stored value (if any). usage: :samp:`type(self).{attr}.clear_cache(self)` N)__dict__r6r#)rrs rr7zmemoized_property.clear_cachers$ -----rNcB|j|j|S)z class-level helper to peek at stored value usage: :samp:`value = type(self).{attr}.clear_cache(self)` )r>getr#)rrdefaults r peek_cachezmemoized_property.peek_cachezs | w777rr) r#r$r%r&rrr r'rr7rBr(rrr r [s$$$  !  ! !  !...888888rr TFcv$rdndrdz rdz rdzz dz fd}|S) abdecorator 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.cVottr dtjt pjj r  fd}n zfd}t| rs r|j rd|j vr~pd} s r%|dz } r|d z } r r|dz }|d zz }|d z }|j d  d s|xj d z c_ |xj d |d z c_ rt|}|S)N)modname deprecatedremovedc}r|dn |dj}||j|jt |zt d|i|S)Nr)klassrF stacklevel)copy __class__updater#r$rDeprecationWarning)argskwdstmprKris_classmethodmsgoptss rr4z3deprecated_function..build..wrapperssiikk#1HQtAw7H U5E FFFS3Y 2qAAAAtT*T***rcBttd|i|S)NrLrM)rrR)rSrTrtexts rr4z3deprecated_function..build..wrappers.T-!<<<<tT*T***rz.. deprecated::z zand will be removed in version z, zuse %s insteadrD  z .. deprecated:: ) isinstance classmethodrtyper"dictr$r#rr&stripendswith) rr4txtrVrXrZ _is_methodrH func_modulerWrI replacementupdocs ` @@@rbuildz"deprecated_function..builds#E 4(E(E  5<<d++4D.t!   + + + + + + + + + +:D + + + + + + w%%%  Aj AG A? A'8'O'O"C + xLC''KKC:$t +k99Cs ?((--66t<< (4' OOO333@ @OO  +!'**Grr()rWrHrIrhrgrerfris``````` rrrs {  BICCAC  3 2 2C  B A AC  4 % 3 3C s )))))))))))T Lrc,t|||||dS)aZdecorator 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)re)r)rWrHrIrhrgs rrrs( sJ *. 0 0 00r)NNNTNFN)NNNTN)r& __future__rrrlogging getLoggerr#log functoolsrrr,warningsrpasslib.utils.compatr __all__objectr r r r rrr(rrrtsA@@@@@@@@@g!!++++++++ %$$$$$        F   99999F999,.%8%8%8%8%8%8%8%8xHL5:$(AAAAFFJ"& 0 0 0 0 0 0r