(ph*`SrSSKJrJrJr SSKJrJr SSKr/SQr \"S\S\ 4S9r "S S \5r SS \ S \\ \ 4S-S \ 4SjjrS\ S \ 4SjrS\ S\ S \ 4SjrS\ S\ S \ 4SjrS\\ S \4SjrSS \\ \ 4S\S \ 4SjjrS \\ \ 4S \\ \ 44SjrS \ S \ 4SjrS\ S\ S\ S \ 4Sjrg) zkUtilities to allow inserting docstring fragments for common parameters into function and method docstrings.)CallableIterableMapping)ProtocolTypeVarN) docformatinherit_docstring_fromindentcount_linesfilldoc unindent_dictunindent_stringextend_notes_in_docstringreplace_notes_in_docstring doc_replace_F.)boundc*\rSrSrSrS\S\4SjrSrg) DecoratorzA decorator of a function.funcreturncgN)selfrs D/var/www/html/venv/lib/python3.13/site-packages/scipy/_lib/doccer.py__call__Decorator.__call__s3rN)__name__ __module__ __qualname____firstlineno____doc__rr__static_attributes__rrrrrs$.R.r.rr docstringdocdictrcU(dU$Uc0nU(dU$UR5R5n[U5S:aSnO[USS5nSU-n0nUR 5H\upgUR5R5nUS/nUSSHn UR XI-5 M SR U5XV'M^ X-$![a XuU'Muf=f)aFill a function docstring from variables in dictionary. Adapt the indent of the inserted docs Parameters ---------- docstring : str A docstring from a function, possibly with dict formatting strings. docdict : dict[str, str], optional A dictionary with keys that match the dict formatting strings and values that are docstring fragments to be inserted. The indentation of the inserted docstrings is set to match the minimum indentation of the ``docstring`` by adding this indentation to all lines of the inserted string, except the first. Returns ------- docstring : str string with requested ``docdict`` strings inserted. Examples -------- >>> docformat(' Test string with %(value)s', {'value':'inserted value'}) ' Test string with inserted value' >>> docstring = 'First line\n Second line\n %(value)s' >>> inserted_string = "indented\nstring" >>> docdict = {'value': inserted_string} >>> docformat(docstring, docdict) 'First line\n Second line\n indented\n string' Nr  ) expandtabs splitlineslenr itemsappendjoin IndexError) r&r'linesicountindentindentednamedstrnewlineslines rrrs@    " - - /E 5zA~"59- 6\FHmmo !,,. "azHab  ."!YYx0HN &   "!TN "s8CC#"C#clsc0^S[S[4U4SjjnU$)a+This decorator modifies the decorated function's docstring by replacing occurrences of '%(super)s' with the docstring of the method of the same name from the class `cls`. If the decorated method has no docstring, it is simply given the docstring of `cls`s method. Parameters ---------- cls : type or object A class with a method with the same name as the decorated method. The docstring of the method in this class replaces '%(super)s' in the docstring of the decorated method. Returns ------- decfunc : function The decorator function that modifies the __doc__ attribute of its argument. Examples -------- In the following, the docstring for Bar.func created using the docstring of `Foo.func`. >>> class Foo: ... def func(self): ... '''Do something useful.''' ... return ... >>> class Bar(Foo): ... @inherit_docstring_from(Foo) ... def func(self): ... '''%(super)s ... Do it fast. ... ''' ... return ... >>> b = Bar() >>> b.func.__doc__ 'Do something useful. Do it fast. ' rrc>[TUR5RnURnUcXlU$U[US9-nX0lU$)N)super)getattrr r$dict)r cls_docstringfunc_docstring new_docstringr<s r_doc$inherit_docstring_from.._docsOT]]3;;   !(L +T -FFM(L rr)r<rEs` rr r XsX2" Krnotesc4^^S[S[4UU4SjjnU$)aaThis decorator replaces the decorated function's docstring with the docstring from corresponding method in `cls`. It extends the 'Notes' section of that docstring to include the given `notes`. Parameters ---------- cls : type or object A class with a method with the same name as the decorated method. The docstring of the method in this class replaces the docstring of the decorated method. notes : str Additional notes to append to the 'Notes' section of the docstring. Returns ------- decfunc : function The decorator function that modifies the __doc__ attribute of its argument. rrc>[TUR5RnUcU$URS5nUS:Xa"URS5nUS:Xa [ U5nUSUT-XS-UlU$)N References  Examples r@r r$findr/)rrB end_of_notesr<rHs rrE'extend_notes_in_docstring.._docsT]]3;;   K$))*@A 2 (--.BCLr!"=1 -< (5 0=3O O  rrGr<rHrEs`` rrrs",2" Krc4^^S[S[4UU4SjjnU$)aPThis decorator replaces the decorated function's docstring with the docstring from corresponding method in `cls`. It replaces the 'Notes' section of that docstring with the given `notes`. Parameters ---------- cls : type or object A class with a method with the same name as the decorated method. The docstring of the method in this class replaces the docstring of the decorated method. notes : str The notes to replace the existing 'Notes' section with. Returns ------- decfunc : function The decorator function that modifies the __doc__ attribute of its argument. rrc&>[TUR5RnSnUcU$URU5nURS5nUS:Xa"URS5nUS:Xa [ U5nUSU[ U5-T-XS-UlU$)Nz Notes ----- rKrLrMrN)rrB notes_headerstart_of_notesrPr<rHs rrE(replace_notes_in_docstring.._docsT]]3;; 7   K&++L9$))*@A 2 (--.BCLr!"=1 >NS->> ? M* +  rrGrRs`` rrrs",2"( Krr4c[RnUH=nUR5nU(dM[U[ U5[ U5- 5nM? U[R:XagU$)aMinimum indent for all lines in line list Parameters ---------- lines : Iterable[str] The lines to find the minimum indent of. Returns ------- indent : int The minimum indent. Examples -------- >>> lines = [' one', ' two', ' three'] >>> indentcount_lines(lines) 1 >>> lines = [] >>> indentcount_lines(lines) 0 >>> lines = [' one'] >>> indentcount_lines(lines) 1 >>> indentcount_lines([' ']) 0 r)sysmaxsizelstripminr/)r4indentnor;strippeds rr r sV8{{H;;= 88SYX%>?H3;; Orunindent_paramscT^U(a [T5mS[S[4U4SjjnU$)aReturn docstring decorator using docdict variable dictionary. Parameters ---------- docdict : dict[str, str] A dictionary containing name, docstring fragment pairs. unindent_params : bool, optional If True, strip common indentation from all parameters in docdict. Default is False. Returns ------- decfunc : function The decorator function that applies dictionary to its argument's __doc__ attribute. rrcT>UR=(d Sn[UT5UlU$)N)r$r)rdocr's rdecoratefilldoc..decorate!s$ll b g.  r)r r)r'r_rds` rr r s,"(rb OrcV0nUR5Hup#[U5X'M U$)zUnindent all strings in a docdict. Parameters ---------- docdict : dict[str, str] A dictionary with string values to unindent. Returns ------- docdict : dict[str, str] The `docdict` dictionary but each of its string values are unindented. )r0r )r'can_dictr8r9s rr r *s, "Hmmo (.& OrcUR5R5n[U5nUS:XaU$SRUVs/sHo3USPM sn5$s snf)a5Set docstring to minimum indent for all lines, including first. Parameters ---------- docstring : str The input docstring to unindent. Returns ------- docstring : str The unindented docstring. Examples -------- >>> unindent_string(' two') 'two' >>> unindent_string(' two\n three') 'two\n three' rr,N)r-r.r r2)r&r4r5r;s rr r =sW(  " - - /E u %F { 99667m6 776sAobjoldvalnewvalcx^UR=(d SRX5mS[S[4U4SjjnU$)a:Decorator to take the docstring from obj, with oldval replaced by newval Equivalent to ``func.__doc__ = obj.__doc__.replace(oldval, newval)`` Parameters ---------- obj : object A class or object whose docstring will be used as the basis for the replacement operation. oldval : str The string to search for in the docstring. newval : str The string to replace `oldval` with in the docstring. Returns ------- decfunc : function A decorator function that replaces occurrences of `oldval` with `newval` in the docstring of the decorated function. rbrrc>TUlU$r)r$)rrcs rinnerdoc_replace..innerps  r)r$replacer)rirjrkrnrcs @rrrXs8, ;; " % %f 5CB2 Lrr)T)r$collections.abcrrrtypingrrrY__all__objectrrstrrr rrintr boolr rAr r rrrrrxsH387$   T#v+./// 8 8 wsCx'84'?8 38 v6696r&6&#&)&R*F*3*9*Z#Xc]#s#LWS#X&:738,c3h&8s8s86VS#)r