hdZddlmZmZmZddlZej eZddl m Z m Z ddl Z ddl mZddlmZgdZGdd eZGd d eZd ZGd deZ ddZ ddZy)z7 passlib.utils.decor -- helper decorators & properties )absolute_importdivisionprint_functionN)wrapsupdate_wrapper)warn)PY3) classproperty hybrid_methodmemoize_single_valuememoized_propertydeprecated_functiondeprecated_methodc,eZdZdZdZdZedZy)r zjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)c||_yNim_funcselffuncs U/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/passlib/utils/decor.py__init__zclassproperty.__init__#s  c$|j|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 s#t!rr ceZdZdZdZdZy)r z decorator which invokes function with class if called as class method, and with object if called at instance level. c*||_t||yr)rrrs rrzhybrid_method.__init__4s tT"rc||}tr tj|j|Stj|j||Sr)r types MethodTyperrs rrzhybrid_method.__get__8s? ;C ##DIIs3 3##DIIsC8 8rN)r#r$r%r&rrr(rrr r .s #9rr cNitfd}fd}||_|S)z decorator for function which takes no args, and memoizes result. exposes a ``.clear_cache`` method to clear the cached value. cJ dS#t$rYnwxYwx}d<|SNT)KeyError)valuecachers rwrapperz%memoize_single_value..wrapperLs9 ;    "f$d  s  c*jddyr0)pop)r3sr clear_cachez)memoize_single_value..clear_cacheUs $r)rr7)rr4r7r3s` @rr r Ds2 E 4[%G Nrc>eZdZdZdZdZesedZdZ ddZ y) r zM decorator which invokes method once, then replaces attr with result cV||_|j|_|j|_yr)r"r#r&rs rrzmemoized_property.__init___s   || rc^||S|j|}t||j||Sr)r"setattrr#)rrrr2s rrzmemoized_property.__get__ds/ ;K c"T]]E* rc|jS)z py2 alias)r"r!s rrzmemoized_property.im_funcms== rcP|jj|jdy)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 -rNcN|jj|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 || w77rr) r#r$r%r&rrr r'rr7rBr(rrr r [s2$    !  !.8rr cv$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``) z5the 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.cvxrttr jdtjt xs j j r  fd}n zfd}t| rs r|jrd|jvrxsd} s r%|dz } r|d z } r r|dz }|d zz }|d z }|jjd jd s|xjd z c_ |xjd |d z c_ r t|}|S)N)modname deprecatedremovedcj}r|dn|dj}|j|j|jt |zt d|i|S)Nr)klassrF stacklevel)copy __class__updater#r$rDeprecationWarning)argskwdstmprKris_classmethodmsgoptss rr4z3deprecated_function..build..wrappers`iik#1QtAw7H7H U5E5E FS3Y 2qAT*T**rc8ttd|i|S)NrLrM)rrR)rSrTrtexts rr4z3deprecated_function..build..wrappers T-!<T*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..builds3#E 4(E <<d+44D.t!   + +:D + w% jG??'8'O"C+x'KKCt +k99Cs ??((-66t<4' OO3@ @O !'*Grr()rWrHrIrhrgrerfris``````` rrrsa { ICAC  2 2C  A AC  % 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 *. 00r)NNNTNFN)NNNTN)r& __future__rrrlogging getLoggerr#log functoolsrrr,warningsrpasslib.utils.compatr __all__objectr r r r rrr(rrrtsA@g!+ %  F 9F9,.%8%8xHL5:$(AFFJ"& 0r