gSrSSKJrJrJr SSKr\R "\5rSSK J r J r SSK r SSK Jr SSKJr /SQr"SS \5r"S S \5rS r"S S\5rSSjrSSjrg)z7 passlib.utils.decor -- helper decorators & properties )absolute_importdivisionprint_functionN)wrapsupdate_wrapper)warn)PY3) classproperty hybrid_methodmemoize_single_valuememoized_propertydeprecated_functiondeprecated_methodc4\rSrSrSrSrSr\S5rSr g)r zjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)cXlgNim_funcselffuncs L/home/matz/Project1/venv/lib/python3.13/site-packages/passlib/utils/decor.py__init__classproperty.__init__#s c$URU5$rrrobjclss r__get__classproperty.__get__&s||C  rcUR$)zpy3 compatible aliasrrs r__func__classproperty.__func__)s||rrN) __name__ __module__ __qualname____firstlineno____doc__rr!propertyr%__static_attributes__rrr r s#t!rr c$\rSrSrSrSrSrSrg)r .zu decorator which invokes function with class if called as class method, and with object if called at instance level. c&Xl[X5 gr)rrrs rrhybrid_method.__init__4s t"rcUcUn[(a![R"URU5$[R"URX5$r)r types MethodTyperrs rr!hybrid_method.__get__8s? ;C 3##DIIs3 3##DIIs8 8r)rN)r'r(r)r*r+rr!r-r.rrr r .s #9rr cP^^0m[T5UU4Sj5nU4SjnX!lU$)z decorator for function which takes no args, and memoizes result. exposes a ``.clear_cache`` method to clear the cached value. cL>TS$![a Of=fT"5=nTS'U$NT)KeyError)valuecachers rwrapper%memoize_single_value..wrapperLs9 ;    "f$d  s  c*>TRSS5 gr9)pop)r<sr clear_cache)memoize_single_value..clear_cacheUs $r)rrA)rr=rAr<s` @rr r Ds0 E 4[% NrcR\rSrSrSrSrSr\(d\S5r Sr S Sjr S r g) r [zE decorator which invokes method once, then replaces attr with result cTXlURUlURUlgr)r%r'r+rs rrmemoized_property.__init___s   || rc^UcU$URU5n[XRU5 U$r)r%setattrr')rrr r;s rr!memoized_property.__get__ds- ;K c"]]E* rcUR$)z py2 alias)r%r$s rrmemoized_property.im_funcms== rcPURRURS5 g)zh class-level helper to clear stored value (if any). usage: :samp:`type(self).{attr}.clear_cache(self)` N)__dict__r@r')rrs rrAmemoized_property.clear_cachers -rNcNURRURU5$)zh class-level helper to peek at stored value usage: :samp:`value = type(self).{attr}.clear_cache(self)` )rMgetr')rrdefaults r peek_cachememoized_property.peek_cachezs || w77r)r+r%r'r) r'r(r)r*r+rr!r r,rrArRr-r.rrr r [s2$    !  !.8rr c^^^^^^^Tc8T(aSmOSmT(aTS- mT(aTS- mT(aTST-- mTS- mUUUUUUU4SjnU$)aJdecorator 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.c>^^^^T=(a [T[5mT(a TRS[5Rm[ T=(d TR TRTT S9mT(a UUU U4SjnO T T-mUU4Sjn[UT5 T (aT(dT (aUR(aSUR;aT=(d SnT (dT (a5US- nT (a UST <3- nT (aT (aUS- nUS T -- nUS - nURRS 5RS 5(dU=RS - sl U=RS U<S 3- sl T(a [U5nU$)N)modname deprecatedremovedc>TR5nT(aUSOUSRnURURURS9 [ TU-[ SS9 T"U0UD6$)Nr)klassrW stacklevel)copy __class__updater'r(rDeprecationWarning)argskwdstmpr\ris_classmethodmsgoptss rr=3deprecated_function..build..wrappers`iik#1QtAw7H7H U5E5E FS3Y 2qAT*T**rc2>[T[SS9 T"U0UD6$)Nr]r^)rrc)rdrertexts rr=rjs T-!<T*T**rz.. deprecated::z zand will be removed in version z, zuse %s insteadrU  z .. deprecated:: ) isinstance classmethodr!typer%dictr(r'rr+stripendswith) rr=txtrgrirl _is_methodrY func_modulerhrZ replacementupdocs ` @@@rbuild"deprecated_function..builds6#E 4(E <<d+44D.t!   + +:D + w% jG??'8'O"C+x'KKCt +k99Cs ??((-66t<<4' OO3@ @O !'*Grr.)rhrYrZrzryrwrxr{s``````` rrrsa { ICAC  2 2C  A AC  % 3 3C s ))T Lrc [XX#USS9$)aBdecorator 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)rw)r)rhrYrZrzrys rrrs s *. 00r)NNNTNFN)NNNTN)r+ __future__rrrlogging getLoggerr'log functoolsrrr4warningsrpasslib.utils.compatr __all__objectr r r r rrr.rrrsA@ !+ %  F 9F9,.%8%8xHL5:$(AFFJ"& 0r