+ hS RtRt.ROt^RIt]PR,t]PUu.uFq'gK R]!V49gKVNK up]n^RIt]]nRtRt RRlt Rt R t R t R tR t]R 4tR#uupi)a Decorator module by Michele Simionato Copyright Michele Simionato, distributed under the terms of the BSD License (see below). http://www.phyast.pitt.edu/~micheles/python/documentation.html Included in NLTK for its support of a nice memoization decorator. zrestructuredtext enN:NNNnltkc"\V4^RPR4p\V4FSwr#VPR4^8d'V^VP R4P 4W&KAVP 4W&KU RP V4#)z For retrocompatibility reasons, we don't use a standard Signature. Instead, we use the string generated by this method. Basically, from a Signature we create a string and remove the default values. ,=z, )strsplit enumeratecountindexstripjoin) signature listsignaturecounterparams& 1/usr/lib/python3/dist-packages/nltk/decorators.py__legacysignaturers  N1R(..s3M#M2 ;;s a %*1u{{3/?%@%F%F%HM "%*[[]M " 3 99] ##c \P!V4'g\P!V4'gQh\P!V4pVR,wr#p\ V4pV'dVP V4V'dVP V4\P !V4p\V4p\VR4'dVPpVPp MVPpVPp \VPVVVVPVP VP"VP$V VR7 #)a Returns an info dictionary containing: - name (the name of the function : str) - argnames (the names of the arguments : list) - defaults (the values of the default arguments : tuple) - signature (the signature : str) - fullsignature (the full signature : Signature) - doc (the docstring : str) - module (the module name : str) - dict (the function __dict__ : str) >>> def f(self, x=1, y=2, *args, **kw): pass >>> info = getinfo(f) >>> info["name"] 'f' >>> info["argnames"] ['self', 'x', 'y', 'args', 'kw'] >>> info["defaults"] (1, 2) >>> info["signature"] 'self, x, y, *args, **kw' >>> info["fullsignature"] :NN __closure__) nameargnamesr fullsignaturedefaultsdocmoduledictglobalsclosure)inspectismethod isfunctiongetfullargspeclistappendrrhasattrr __globals__ func_closure func_globalsr__name__ __defaults____doc__ __module____dict__) funcargspecregargsvarargs varkwargsrrr_closure_globalss & rgetinfor7,s<   D ! !W%7%7%=%== =$$T*G")"+GiG}H  "%%d+M!-0It]######$$$$  ]]#"" LL ]]  rcT;'g \V4pVR,VnVR,VnVR,VnVPP VR,4VR,VnWnV#)z akin to functools.update_wrapperrrrrr)r7r+r-r.r/updater, undecorated)wrappermodelinfodicts&&&rupdate_wrapperr>lsi))75>H'GuoGO!(+G HV,-#J/G Nrc\V\4'dTpM \V4pRVR,9dQR4hRV,p\V\VR74p\ WAV4#)a) An improvement over functools.update_wrapper. The wrapper is a generic callable object. It works by generating a copy of the wrapper with the right signature and by updating the copy, not the original. Moreovoer, 'model' can be a dictionary with keys 'name', 'doc', 'module', 'dict', 'defaults'. _wrapper_rz("_wrapper_" is a reserved argument name!z.lambda %(signature)s: _wrapper_(%(signature)s))r@) isinstancerr7evalr>)r;r<r=srcfuncopys&& r new_wrapperrExsd%5> 8J/ /212/ :X EC3w/0G '( 33rc(aa\VV3RlS4#)c0<SP!S.VO5/VB#N)call)akr0selfs*,r__call__..styy'?'?Q'?r)rE)rLr0sffr__call__rOs ? FFrc\\V44pRV9d \R4hRV9d \R4h\VnV#)z Take a class with a ``.caller`` method and return a callable decorator object. It works by adding a suitable __call__ method to the class; it raises a TypeError if the class already has a nontrivial __call__ method. rOz=You cannot decorate a class with a nontrivial __call__ methodrIz2You cannot decorate a class without a .call method)setdir TypeErrorrO)clsattrss& rdecorator_factoryrVsK CMEU N  UOPPCL Jrcva\P!S4'd \S4#V3Rlp\VS4#)a General purpose decorator factory: takes a caller function as input and returns a decorator with the same attributes. A caller function is any function like this:: def caller(func, *args, **kw): # do something return func(*args, **kw) Here is an example of usage: >>> @decorator ... def chatty(f, *args, **kw): ... print("Calling %r" % f.__name__) ... return f(*args, **kw) >>> chatty.__name__ 'chatty' >>> @chatty ... def f(): pass ... >>> f() Calling 'f' decorator can also take in input a class with a .caller method; in this case it converts the class into a factory of callable decorator objects. See the documentation for an example. c<\V4pVR,pRV9gRV9dQR4hRV,p\V\VSR74p\W@V4#)r_call__func_z2You cannot use _call_ or _func_ as argument names!z3lambda %(signature)s: _call_(_func_, %(signature)s))rZrY)r7rBrr>)r0r=rrCdec_funccallers& r _decoratordecorator.._decoratorsf4=J'  H$8 @ ? @ DhNTf=>hh77r)r!isclassrVr>)r\r]sf r decoratorr`s3<v (( 8 *f --rcf\W4# \dT!4p\YT4Tu#i;i)z'Similar to .setdefault in dictionaries.)getattrAttributeErrorsetattr)objr default_thunkdefaults&&& rgetattr_rhs7s!! /7#s 00cX\VR\4pW9d W!,#V!V!pW2V&V#) memoize_dic)rhr)r0argsdicresults&* rmemoizerns2 4 -C {y 4[FI Mr)r`rEr7rH)r- __docformat____all__syspath OLD_SYS_PATHrr!rr7r>rErOrVr`rhrn)ps0rrus&  2 xx{ xx >x!1As1v)=AAx >  $=@ 4*G$,.^  M ?s B B B