jdZddlmZmZeZdZdZdZe eeeZ dZ e e Z GddeZ Gd d eZdd d d d Zy )aqThe `with_doc` decorator: override the docstring that introspection tools see for a wrapped callable without mutating the wrapped function itself. Accepts the docstring directly, or a factory that derives it from the wrapped function at decoration time. This is the companion of `with_signature`, which overrides the signature in the same way. Assigning to `__doc__` on an ordinary wrapt wrapper writes through to the wrapped function, because `__doc__` on every proxy delegates to the wrapped object, so a wrapper carrying its own docstring is the only way to change what is reported without touching the wrapped function. )BoundFunctionWrapperFunctionWrappercZ|j}|tur|jjS|SN _self_doc_NO_DOC_OVERRIDE __wrapped____doc__selfdocs S/home/spazio/kingdom_calls/work5/transenv/lib/python3.12/site-packages/wrapt/doc.py_get_docr*s+ ..C ''' JcZ|jtur||j_y||_yrr)r values r_set_docr1s$ ~~))#( rcX|jtur |j`yt|_yrr)r s r_del_docr8s" ~~))    $)rcn|jj}|tur|jjS|Sr) _self_parentrr r r r s r_get_bound_docrFs3    % %C ''' JrceZdZeZy)_BoundDocFunctionWrapperN)__name__ __module__ __qualname___BOUND_DOC_PROPERTYr rrrrPs!Grrc&eZdZeZeZfdZxZS)_DocFunctionWrapperc4t|||||_yr)super__init__r)r wrappedwrapperr __class__s rr%z_DocFunctionWrapper.__init__Ys '*r) rrr _DOC_PROPERTYr r__bound_function_wrapper__r% __classcell__)r(s@rr"r"TsG!9rr"N)rfactorycf  td  tdfd}||S||S)aDOverride the docstring of a wrapped callable. Exactly one of `doc` or `factory` must be supplied: - `doc`: the docstring to report. - `factory`: a callable `factory(wrapped)` invoked at decoration time that returns the docstring to report. The resulting wrapper reports the override as its `__doc__`, and so it is what `help()` and `pydoc` display. The wrapped function is not mutated, and assigning to `__doc__` on the wrapper replaces the override rather than writing through to the wrapped function. Calling behaviour is unchanged. z)with_doc requires one of doc= or factory=z-with_doc accepts only one of doc= or factory=c>d} |}n}t|||S)Nc||i|Srr )r&instanceargskwargss r_wrapperz.with_doc.._decorator.._wrappertsD+F+ +r)r")r&r3resolvedrr,s r _decoratorzwith_doc.._decoratorss. ,  w'HH"7Hh??r) TypeError)r&rr,r5s `` rwith_docr7^sN  {wCDD 7.GHH @ g rr)r __wrapt__rrobjectr rrrpropertyr)rrrr"r7r rrr;sq = 8.*8X6 ~."3"/"T4"r