gS dZdZgdZddlZejddZejDcgc]}|sde|vs|c}e_ddlZee_dZdZ ddZ d Z d Z d Z d Zd ZedZycc}w)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_wrappergetinfoNnltkct|ddjd}t|D]R\}}|jddkDr&|d|j dj ||<@|j ||<Tdj |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, )strsplit enumeratecountindexstripjoin) signature listsignaturecounterparams D/var/www/openai/venv/lib/python3.12/site-packages/nltk/decorators.py__legacysignaturers  N1R(..s3M#M2 ;;s a %*1u{{3/?%@%F%F%HM' "%*[[]M' " 3 99] ##c @tj|stj|sJtj|}|dd\}}}t |}|r|j ||r|j |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 varkwargsrrr_closure_globalss rrr,s<   D !W%7%7%== =$$T*G")"1+GWiG}H  "%%d+M!-0It]#####$$$$  ]]#"" LL ]]  rc|xs t|}|d|_|d|_|d|_|jj |d|d|_||_|S)z akin to functools.update_wrapperrr!r"r#r )rr0r2r3r4updater1 undecorated)wrappermodelinfodicts rupdate_wrapperrBlsh)75>H'GuoGO!(+G HV,-#J/GG Nrct|tr|}n t|}d|dvsJdd|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_rz("_wrapper_" is a reserved argument name!z.lambda %(signature)s: _wrapper_(%(signature)s))rD) isinstancer#revalrB)r?r@rAsrcfuncopys rrrxsc%5> 8J/ /212 / :X EC3w/0G '5( 33rc&tfdS)Nc0jg|i|SN)call)akr5selfs rz__call__..sytyy'?'?Q'?r)r)rOr5s``r__call__rQs ? FFrctt|}d|vr tdd|vr tdt|_|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. rQz=You cannot decorate a class with a nontrivial __call__ methodrLz2You cannot decorate a class without a .call method)setdir TypeErrorrQ)clsattrss rdecorator_factoryrXsK CMEU N  UOPPCL Jrcftjr tSfd}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|vrJdd|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[)rrFr#rB)r5rArrGdec_funccallers r _decoratorzdecorator.._decoratorsh4=J'  H$8 @ ? @ DhNTf=>hh77r)r&isclassrXrB)r^r_s` rrrs0<v (( 8 *f --rcf t||S#t$r|}t||||cYSwxYw)z'Similar to .setdefault in dictionaries.)getattrAttributeErrorsetattr)objr default_thunkdefaults rgetattr_rhs;sD!! /T7#s 00cNt|dt}||vr||S||}|||<|S)N memoize_dic)rhr#)r5argsdicresults rmemoizerns8 4 -C s{4y 4[FCI MrrK)r2 __docformat____all__syspath OLD_SYS_PATHr r&rrrBrrQrXrrhrn)ps0rrus&  2 xx{ xx >x!1s1v)=Ax >  $=@ 4*G$,.^  M ?sA6 A6A6