o _6d@sdZddlmZmZmZddlZeeZddl m Z m Z ddl Z ddl mZddlmZgdZGdd d eZGd d d eZd d ZGdddeZ   dddZ  dddZdS)z7 passlib.utils.decor -- helper decorators & properties )absolute_importdivisionprint_functionN)wrapsupdate_wrapper)warn)PY3) classproperty hybrid_methodmemoize_single_valuememoized_propertydeprecated_functiondeprecated_methodc@s,eZdZdZddZddZeddZdS) r zjFunction decorator which acts like a combination of classmethod+property (limited to read-only properties)cCs ||_dSNim_funcselffuncrjC:\Users\jesus\OneDrive\Desktop\erpjis_fastapi\backend\jisbackend\Lib\site-packages\passlib/utils/decor.py__init__# zclassproperty.__init__cCs ||Srrrobjclsrrr__get__&rzclassproperty.__get__cC|jS)zpy3 compatible aliasrrrrr__func__)zclassproperty.__func__N)__name__ __module__ __qualname____doc__rrpropertyrrrrrr s r c@s eZdZdZddZddZdS)r z decorator which invokes function with class if called as class method, and with object if called at instance level. cCs||_t||dSr)rrrrrrr4szhybrid_method.__init__cCs.|dur|}trt|j|St|j||Sr)rtypes MethodTyperrrrrr8s zhybrid_method.__get__N)r!r"r#r$rrrrrrr .s r cs0itfdd}fdd}||_|S)z decorator for function which takes no args, and memoizes result. exposes a ``.clear_cache`` method to clear the cached value. cs0zdWStyYnw}d<|SNT)KeyError)valuecacherrrwrapperLs  z%memoize_single_value..wrappercsdddSr()popr)r,rr clear_cacheUsz)memoize_single_value..clear_cache)rr/)rr-r/rr+rr Ds  r c@sBeZdZdZddZddZeseddZdd Z d d d Z d S)r zM decorator which invokes method once, then replaces attr with result cCs||_|j|_|j|_dSr)rr!r$rrrrr_s zmemoized_property.__init__cCs(|dur|S||}t||j||Sr)rsetattrr!)rrrr*rrrrds  zmemoized_property.__get__cCr)z py2 alias)rrrrrrmr zmemoized_property.im_funccCs|j|jddS)z class-level helper to clear stored value (if any). usage: :samp:`type(self).{attr}.clear_cache(self)` N)__dict__r.r!)rrrrrr/rszmemoized_property.clear_cacheNcCs|j|j|S)z class-level helper to peek at stored value usage: :samp:`value = type(self).{attr}.clear_cache(self)` )r1getr!)rrdefaultrrr peek_cachezszmemoized_property.peek_cacher) r!r"r#r$rrrr%rr/r4rrrrr [s r TFcsbdur#r dndrd7rd7rd7d7fdd }|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.csottrdtjtpjjdr(fdd}n fdd}t| rs>r|j rd|j vrpId}sN rm|d7}r[|df7} rirc|d 7}|d 7}|d 7}|j d  d s}|j d 7_ |j d|f7_ rt|}|S)N)modname deprecatedremovedcsP}r |dn|dj}|j|j|jdt|tdd|i|S)Nr)klassr6 stacklevel)copy __class__updater!r"rDeprecationWarning)argskwdstmpr:)ris_classmethodmsgoptsrrr-s z3deprecated_function..build..wrappercsttdd|i|S)Nr;r<)rrA)rBrC)rtextrrr-sz.. deprecated::z z!and will be removed in version %sz, zuse %s insteadr5  z .. deprecated:: %s ) isinstance classmethodrtyperdictr"r!rr$stripendswith)rr-txt _is_methodr8 func_modulerFr9 replacementupdoc)rrErGrHrbuildsD    z"deprecated_function..buildr)rFr8r9rWrVrTrUrXrrSrr s  *r cCst|||||ddS)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)rT)r )rFr8r9rWrVrrrrs r)NNNTNFN)NNNTN)r$ __future__rrrlogging getLoggerr!log functoolsrrr&warningsrZpasslib.utils.compatr__all__objectr r r r r rrrrrs(   < C