+ THisRt^RIt^RIHtHt^RIHt.R Ot!RR4t!RR4t R t !R R4t RR lt RR lt R#)z7 passlib.utils.decor -- helper decorators & properties N)update_wrapperwraps)warn classproperty hybrid_methodmemoized_propertyc0a]tRt^toRtRtRtRtVtR#)rzjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)cWnR#N__func__selffuncs&&5/usr/lib/python3/dist-packages/passlib/utils/decor.py__init__classproperty.__init__s c$VPV4#r r robjclss&&&r__get__classproperty.__get__s}}S!!rr N __name__ __module__ __qualname____firstlineno____doc__rr__static_attributes____classdictcell__ __classdict__s@rrrst""rc0a]tRt^toRtRtRtRtVtR#)rzu decorator which invokes function with class if called as class method, and with object if called at instance level. c(Wn\W4R#r )rrr s&&rrhybrid_method.__init__$s t"rcPVfTp\P!VPV4#r )types MethodTyperrs&&&rrhybrid_method.__get__)s# ;C 3//r)rNrr"s@rrrs # 00rcPaa/o\S4VV3Rl4pV3RlpW!nV#)z decorator for function which takes no args, and memoizes result. exposes a ``.clear_cache`` method to clear the cached value. cV<SR,# \dMi;iS!4;pSR&T#)T)KeyError)valuecachers rwrapper%memoize_single_value..wrapper7s9 ;    "f$d  s  c,<SPRR4R#)TN)pop)r/sr clear_cache)memoize_single_value..clear_cache@s $r)rr4)rr0r4r/sf @rmemoize_single_valuer6/s2 E 4[& Nrc@a]tRt^HtoRtRtRtRtRRltRt Vt R#) rzE decorator which invokes method once, then replaces attr with result cVWnVPVnVPVnR#r )r rrr s&&rrmemoized_property.__init__Ms   || rc`VfV#VPV4p\WPV4V#r )r setattrr)rrrr.s&&& rrmemoized_property.__get__Rs- ;K c"]]E* rc RVPPVPR4R#)zh class-level helper to clear stored value (if any). usage: :samp:`type(self).{attr}.clear_cache(self)` N)__dict__r3r)rrs&&rr4memoized_property.clear_cacheYs -rNc NVPPVPV4#)zh class-level helper to peek at stored value usage: :samp:`value = type(self).{attr}.clear_cache(self)` )r>getr)rrdefaults&&&r peek_cachememoized_property.peek_cacheas || w77r)rr rr ) rrrrrrrr4rCr r!r"s@rrrHs#$ .88rcaaaaaaaSfNS'dRoMRoS'd SR, oS'd SR, oS'dSRS R2, oSR, oVVVVVVV3RlpV#) 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  instead.c\<aaaaS;'d\S\4oS'd SPo\S;'g SPSP SS R7oS'd VVV V3RlpMS S,oVV3Rlp\ VS4S 'EdS'g S 'dVP'dRVP9dS;'gRpS 'g S 'dMVR, pS 'd VRS 2, pS 'dS 'd VR, pVRS R 2, pVR , pVPPR 4PR 4'gV;PR , unV;PR V R 2, unS'd \V4pV#))modname deprecatedremovedc<SP4pS'd V^,MV^,PpVPVPVPR7\ SV,\ ^R7S!V/VB#))klassrI stacklevel)copy __class__updaterrrDeprecationWarning)argskwdstmprOris_classmethodmsgoptss*, rr03deprecated_function..build..wrappers`iik#1QtAw7H7H U5E5E FS3Y 2qAT*T**rc8<\S\^R7S!V/VB#)rP)rrU)rVrWrtexts*,rr0r\s T-!<T*T**rz.. deprecated::z zand will be removed in version z, zuse rFrG  z .. deprecated:: ) isinstance classmethodr dictrrrrstripendswith) rr0txtrYr[r_ _is_methodrK func_modulerZrL replacementupdocs f @@@rbuild"deprecated_function..buildsF#EE 4(E ==D..t!    + +:D + w% Ew!8""C+xrvsL + ""00"288jOd r