'[fN!dZdZgdZddlZejddZdejDe_ddlZee_dZdZddZ d Z d Z d Z d Z d Ze dZdS)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 en) decorator new_wrappergetinfoNc8g|]}|dt|v|S)nltk)str).0ps C/var/www/piapp/venv/lib/python3.11/site-packages/nltk/decorators.py r s- > > >!1 >s1vv)=)=A)=)=)=cpt|ddd}t|D]h\}}|ddkr3|d|d||<Q|||<id|S)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. ,=rz, )rsplit enumeratecountindexstripjoin) signature listsignaturecounterparams r __legacysignaturers  NN1R4(..s33M#M2233 ;;s  a  %*1u{{3/?/?+?%@%F%F%H%HM' " "%*[[]]M' " " 99] # ##r c tj|stj|sJtj|}|dd\}}}t |}|r|||r||tj|}t|}t|dr|j }|j } n|j }|j } t|j||||j|j|j|j| | S)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"] N __closure__) nameargnamesr fullsignaturedefaultsdocmoduledictglobalsclosure)inspectismethod isfunctiongetfullargspeclistappendrrhasattrr __globals__ func_closure func_globalsr'__name__ __defaults____doc__ __module____dict__) funcargspecregargsvarargs varkwargsr"r#r_closure_globalss r rr,s!<  D ! !=W%7%=%====$T**G")"1"+GWiG}}H!   # """%d++M!-00It]##%##$$  ]#" L ]    r c|pt|}|d|_|d|_|d|_|j|d|d|_||_|S)z akin to functools.update_wrapperr!r%r&r'r$)rr4r6r7r8updater5 undecorated)wrappermodelinfodicts r update_wrapperrFlsm)75>>H'GuoGO!(+G HV,---#J/GG Nr ct|tr|}nt|}d|dvs Jdd|z}t|t|}t |||S)aA 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_r"z("_wrapper_" is a reserved argument name!z.lambda %(signature)s: _wrapper_(%(signature)s))rH) isinstancer'revalrF)rCrDrEsrcfuncopys r rrxs%"5>> 8J/ / / /1 0 / / :X EC3w///00G '5( 3 33r c.tfdS)Nc&jg|Ri|SN)call)akr9selfs r z__call__..s#yty'?'?'?'?Q'?'?r )r)rSr9s``r __call__rUs! ????? F FFr ctt|}d|vrtdd|vrtdt|_|S)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. rUz=You cannot decorate a class with a nontrivial __call__ methodrPz2You cannot decorate a class without a .call method)setdir TypeErrorrU)clsattrss r decorator_factoryr\s] CMMEU N   UOPPPCL Jr cttjrtSfd}t|S)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. ct|}|d}d|vsd|vr Jdd|z}t|t|}t|||S)Nr"_call__func_z2You cannot use _call_ or _func_ as argument names!z3lambda %(signature)s: _call_(_func_, %(signature)s))r`r_)rrJr'rF)r9rEr"rKdec_funccallers r _decoratorzdecorator.._decoratorsv4==J'  H$8$8$8 ?%9$8$8ChNTf===>>hh777r )r*isclassr\rF)rbrcs` r rrsP<v) ((( 8 8 8 8 8 *f - --r c~ t||S#t$r |}t||||cYSwxYw)z'Similar to .setdefault in dictionaries.)getattrAttributeErrorsetattr)objr! default_thunkdefaults r getattr_rlsXsD!!! -//T7###s '<<c^t|dt}||vr||S||}|||<|S)N memoize_dic)rlr')r9argsdicresults r memoizerrs? 4 - -C s{{4y T4[FCI Mr rO)r6 __docformat____all__syspath OLD_SYS_PATHr*rrrFrrUr\rrlrrr r rys &  2 1 1 x{ > >sx > > >  $ $ $===@    444*GGG$,.,.,.^  r