\h>@%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSK J r J r "SS\ 5r SSjrSS jrS r\"\R$"S 5S -5S -r\"\R*SS5r/qS\S'SqSrSrSrSSjrSSjrSrSr SSjr!Sr"S Sjr#g)!z;Miscellaneous stuff that does not really fit anywhere else.) annotationsN)filldedentc\rSrSrSrg) Undecidable N)__name__ __module__ __qualname____firstlineno____static_attributes__r L/var/www/auris/envauris/lib/python3.13/site-packages/sympy/utilities/misc.pyrr s rrc fS[[[U55RS54SU0UD6-$)a Strips leading and trailing empty lines from a copy of ``s``, then dedents, fills and returns it. Empty line stripping serves to deal with docstrings like this one that start with a newline after the initial triple quote, inserting an empty line at the beginning of the string. Additional keyword arguments will be passed to ``textwrap.fill()``. See Also ======== strlines, rawlines  width)rrstrstrip)swkwargss r filldedentrs1 $vc!f~++D1EEfE EErFc[U[5(d [S5eSU;a [U5$[ U5R S5(aSOSnU4S-nSU;aSU-nSU-nUS -nOS U-nS U-nUS-n/nU(a!UR US U5 XS nU(aM!U(a'[U5S :XaXFS-R5S $XERU5-$)aReturn a cut-and-pastable string that, when printed, is equivalent to the input. The lines will be surrounded by parentheses and no line will be longer than c (default 64) characters. If the line contains newlines characters, the `rawlines` result will be returned. If ``short`` is True (default is False) then if there is one line it will be returned without bounding parentheses. Examples ======== >>> from sympy.utilities.misc import strlines >>> q = 'this is a long string that should be broken into shorter lines' >>> print(strlines(q, 40)) ( 'this is a long string that should be b' 'roken into shorter lines' ) >>> q == ( ... 'this is a long string that should be b' ... 'roken into shorter lines' ... ) True See Also ======== filldedent, rawlines zexpecting string inputr"'\z ( r%s%%s%s )z%s r%sz ( %s%%s%s )z%s %sNr) isinstancer ValueErrorrawlinesrepr startswithappendlen splitlinesjoin)rcshortqmjouts rstrlinesr0&s: a  122 qy{Aw!!#&&CA QA qy q  M Q a  qL Q C  1Ra5 B% ! SQF &&(++ vvc{?rc2URS5n[U5S:Xa[US5$SU;SU;/n[SU55(dSU;d[ U5(a/nUR S5n[U5S- n[ U5HJupgXe:wdU(aUR[US-55 M0UR[U55 ML SS RU5-$S RU5nUS(aS U-$S U-$) aReturn a cut-and-pastable string that, when printed, is equivalent to the input. Use this when there is more than one line in the string. The string returned is formatted so it can be indented nicely within tests; in some cases it is wrapped in the dedent function which has to be imported from textwrap. Examples ======== Note: because there are characters in the examples below that need to be escaped because they are themselves within a triple quoted docstring, expressions below look more complicated than they would be if they were printed in an interpreter window. >>> from sympy.utilities.misc import rawlines >>> from sympy import TableForm >>> s = str(TableForm([[1, 10]], headings=(None, ['a', 'bee']))) >>> print(rawlines(s)) ( 'a bee\n' '-----\n' '1 10 ' ) >>> print(rawlines('''this ... that''')) dedent('''\ this that''') >>> print(rawlines('''this ... that ... ''')) dedent('''\ this that ''') >>> s = """this ... is a triple ''' ... """ >>> print(rawlines(s)) dedent("""\ this is a triple ''' """) >>> print(rawlines('''this ... that ... ''')) ( 'this\n' 'that\n' ' ' ) See Also ======== filldedent, strlines rr rz'''z"""c3B# UHoRS5v M g7f) N)endswith).0lis r rawlines..s ,e;;s  esrz ( %s )z zdedent("""\ %s""")zdedent('''\ %s''')) splitr'r$anyallr4 enumerater&r))rlinestriplervtrailinglastir6s rr#r#Zsx GGDME 5zQE!H~qj%1* %F ,e ,,, S[[ ::d#5zA~u%EAyH $rDy/* $r(# &  b 111 ]]5 ! !9-2 2-2 2rPz-bithash_randomizationz list[str] _debug_tmpc<^^SSKJn U(dT$SmUU4SjnU$)zIf SYMPY_DEBUG is True, it will print a nice execution tree with arguments and results of all decorated functions, else do nothing. r SYMPY_DEBUGc[n/q[S- qSnU"U0UD6n[S-qUR<U<SU<S3n[/:waXd"[5- nUq[RU5 [S:Xa[ [S5 /qU$)Nr cSSjn[U5S:Xag/nUSSHnURU"U55 M URU"USS55 SRU5$)NcURS5nSUS-nUSSH#nUS:XaM US:Xa USU-- nMUSU-- nM% U$)Nrz+-%s rr z| %s z %s )r9)rvariantxras rindent?debug_decorator..maketree..tree..indents`GGDMqtO12ABw !|X\)X\) rrrMr)r )r'r&r))subtreesrRfrQs rtree/debug_decorator..maketree..treesb 8}!Acr]## HHVHRL!, -771: rz = rr)rF _debug_iterr r&print)rVargskwoldtmprWrPrs rmaketree!debug_decorator..maketrees q  6 tNrNq ZZq 1   j! !A ! !  *Q- Jrc>T"T/UQ70UD6$Nr )r[rfuncr^s r decorated"debug_decorator..decorateds.t.v..r)sympyrI)rbrIrcr^s` @rdebug_decoratorrfs#"  ,\/ rcRSSKJn U(a[US[R06 gg)z: Print ``*args`` if SYMPY_DEBUG is True, else do nothing. rrHfileNrerIrZsysstderr)r[rIs rdebugrls " t%#**%rcTSSKJn U(a[X-[RS9 gg)z} Print ``string%args`` if SYMPY_DEBUG is True, else do nothing. This is intended for debug messages using formatted strings. rrH)rhNri)stringr[rIs rdebugfros " fk +rc4SSKJn U"SSSS9 Uc[RSnUR [R 5nS /n[R S :Xa.[RRU5upVU(dUS -nO[RS :Xau[RS R5R [R 5n[RRU5upVUR5U;aUnUHnX-n[RRU5(aUs $UHLn [RRX5n [RRU 5(dMHU s s $ M g)zTry to find 'executable' in the directories listed in 'path' (a string listing directories separated by 'os.pathsep'; defaults to os.environ['PATH']). Returns the complete filename or None if not found r )sympy_deprecation_warningz sympy.utilities.misc.find_executable() is deprecated. Use the standard library shutil.which() function instead. z1.7zdeprecated-find-executable)deprecated_since_versionactive_deprecations_targetNPATHrMos2z.exewin32PATHEXT) exceptionsrqosenvironr9pathsepnamepathsplitextrjplatformlowerisfiler)) executabler}rqpathsextlistbaseextpathextexecnameprVs rfind_executablers: 6 "'#?  |zz&! JJrzz "EdG ww%gg&&z2 #f,J  **Y'--/55bjjAgg&&z2  99;g %G# 77>>( # #OGGLL-77>>!$$H  rcSSSSSSS.n[U5n[U5RS5(a0[U5RS 5S RS 5S nON[U5RS 5(a/[U5RS 5S RS 5S n[ [ US U5SU5nSU;aURS5SnU(aUR XD5nU$)aReturn function name of `x` (if defined) else the `type(x)`. If short is True and there is a shorter alias for the result, return the alias. Examples ======== >>> from sympy.utilities.misc import func_name >>> from sympy import Matrix >>> from sympy.abc import x >>> func_name(Matrix.eye(3)) 'MutableDenseMatrix' >>> func_name(x < 1) 'StrictLessThan' >>> func_name(x < 1, short=True) 'Lt' GeGtLeLtEqNe) GreaterThanStrictGreaterThanLessThanStrictLessThanEquality Unequalityz>> from sympy.utilities.misc import _replace >>> f = _replace(dict(foo='bar', d='t')) >>> f('food') 'bart' >>> f = _replace({}) >>> f('food') 'food' cU$rar )rOs r_replace..gsrc,>TURS5$)Nr)group)matchrepss rrrhsd5;;q>*r|c(>TRTU5$ra)sub)rnDpatterns rrrks'++a0r)_recompiler)itemsescape MULTILINE)rkvrrs` @@r_replacerWsa *Akk#((#'::<0<41A<0236==BG 00 1s"Bc[U5S:Xa,USn[U[5(aUnOUR"U6$[U5n[ U5"U5$)aReturn ``string`` with all keys in ``reps`` replaced with their corresponding values, longer strings first, irrespective of the order they are given. ``reps`` may be passed as tuples or a single mapping. Examples ======== >>> from sympy.utilities.misc import replace >>> replace('foo', {'oo': 'ar', 'f': 'b'}) 'bar' >>> replace("spamham sha", ("spam", "eggs"), ("sha","md5")) 'eggsham md5' There is no guarantee that a unique answer will be obtained if keys in a mapping overlap (i.e. are the same length and have some identical sequence at the beginning/end): >>> reps = [ ... ('ab', 'x'), ... ('bc', 'y')] >>> replace('abc', *reps) in ('xc', 'ay') True References ========== .. [1] https://stackoverflow.com/questions/6116978/how-to-replace-multiple-substrings-of-a-string r r)r'r!dictreplacer)rnrkvs rrrnsQ> 4yA~ !W b$  D>>2& &Dz D>& !!rc0nUcUb[SU-5eUcU$UnS=pO[U[5(a0n[UR 55H:n[ U5S:XdM[ X5S:XdM'UR U5XV'M< UnUnU(aB[[UR565Vs/sHnSRU5PM snupO'S=pO#[ U5[ U5:wa [S5eU(a([RSSU5nURU5n[X5n[RX5n URU 5$s snf)adReturn ``s`` where characters have been replaced or deleted. SYNTAX ====== translate(s, None, deletechars): all characters in ``deletechars`` are deleted translate(s, map [,deletechars]): all characters in ``deletechars`` (if provided) are deleted then the replacements defined by map are made; if the keys of map are strings then the longer ones are handled first. Multicharacter deletions should have a value of ''. translate(s, oldchars, newchars, deletechars) all characters in ``deletechars`` are deleted then each character in ``oldchars`` is replaced with the corresponding character in ``newchars`` Examples ======== >>> from sympy.utilities.misc import translate >>> abc = 'abc' >>> translate(abc, None, 'a') 'bc' >>> translate(abc, {'a': 'x'}, 'c') 'xb' >>> translate(abc, {'abc': 'x', 'a': 'y'}) 'x' >>> translate('abcd', 'ac', 'AC', 'd') 'AbC' There is no guarantee that a unique answer will be obtained if keys in a mapping overlap are the same length and have some identical sequences at the beginning/end: >>> translate(abc, {'ab': 'x', 'bc': 'y'}) in ('xc', 'ay') True z6c should be None when a=None is passed, instead got %srMr z,oldchars and newchars have different lengths)r"r!rlistkeysr'popziprr)r maketrans translater) rrQbr*mrr+rrBvalns rrrs>T By =UXYYZ Z 9H  A a  E!&&(^q6Q;3qt9> uuQxEH$BA,0ekkm1D,EF,Eq ,EF1 A Vs1v KL LmmBA& KK A aA ;;q>Gs<E$c[U5n[U5S-nSUs=::aS::aO OSnO&US-S:XaSnOUS-S:XaS nOUS-S :XaS nOSn[U5U-$) z=Return ordinal number string of num, e.g. 1 becomes 1st. d rth r strndrrd)as_intabsr)numrrsuffixs rordinalrsm s A A A Q}"} R1 R1 R1 q6F?rc4U(a2[U[5(a[e[R"U5$[ U5nX- (a[ U<S35eU$![a [ U<S35ef=f![a [ U<S35ef=f)a Convert the argument to a builtin integer. The return value is guaranteed to be equal to the input. ValueError is raised if the input has a non-integral value. When ``strict`` is True, this uses `__index__ `_ and when it is False it uses ``int``. Examples ======== >>> from sympy.utilities.misc import as_int >>> from sympy import sqrt, S The function is primarily concerned with sanitizing input for functions that need to work with builtin integers, so anything that is unambiguously an integer should be returned as an int: >>> as_int(S(3)) 3 Floats, being of limited precision, are not assumed to be exact and will raise an error unless the ``strict`` flag is False. This precision issue becomes apparent for large floating point numbers: >>> big = 1e23 >>> type(big) is float True >>> big == int(big) True >>> as_int(big) Traceback (most recent call last): ... ValueError: ... is not an integer >>> as_int(big, strict=False) 99999999999999991611392 Input that might be a complex representation of an integer value is also rejected by default: >>> one = sqrt(3 + 2*sqrt(2)) - sqrt(2) >>> int(one) == 1 True >>> as_int(one) Traceback (most recent call last): ... ValueError: ... is not an integer z is not an integer)r!bool TypeErroroperatorindexr"int)rstrictresults rrrsd <!T"">>!$ $ <VF :q:; ;  <q:; ; <  <q:; ; rsA"  ! * F&1hP3d 6??3 ! #$v-SYY(