Ñò  ©Bc@sdZddklZddkZddkZddkZddkZddkZddkZd(Z d„Z d„Z d„Z d„Z e d„Zd„Zd„Zd„Zd„Zd„Zddd„Zdd„Zd „Zd!d"d#„Zd$„Zd%„Zd&„Zd'„ZdS()såA library of commonly useful functions and classes. This module contains a varied collection of functions and classes that are potentially useful in a wide range of programming tasks. It is safe to "import *" from this module. iÿÿÿÿ(t generatorsNtgreptantigreptstaggered_merget parse_rangetwraptxmlrpc_server_doct center_texttuniqt sh_escapetflattent canLoopOvert isStringLiketisScalartmake_string_filtercCsBh}g}|D]*}||jo||i||ƒqq~S(s-Returns a list of all the elements of the given sequence in their original order, but without duplicates. Unlike the Unix tool of the same name, duplicates are removed even if they aren't adjacent. This function only works if the elements of the input sequence are hashable. (t setdefault(tseqtdt_[1]ti((smoosic/utilities.pyR%scCs!yt|ƒWntSXtSdS(s+Tests whether an object can be looped over.N(titertFalsetTrue(t maybeIterable((smoosic/utilities.pyR 3s cCs+y |dWntj otSXtSdS(s.Tests whether an object behaves like a string.tN(t TypeErrorRR(tobj((smoosic/utilities.pyR :s  cCst|ƒp t|ƒ S(sJTests whether an object is a scalar value. Strings are considered scalar.(R R (R((smoosic/utilities.pyR AsccsJxC|D];}||ƒo |Vqxt||ƒD] }|Vq3WqWdS(sdFlattens a nested sequence. For example, [[1, 2], [3, [4, 5]] becomes [1, 2, 3, 4, 5]. N(R (Rtscalarptitemtsubitem((smoosic/utilities.pyR Fs  cCsPg}t|ƒ}x7|o/|i|ititt|ƒƒƒƒƒqW|S(s‘Returns a shuffled version of the given sequence. (Deprecated) The returned list contains exactly the same elements as the given sequence, but in a random order. This function is much slower than the shuffle function in the random module in the standard library, and it returns a new list instead of shuffling the sequence in place. Using this function is not recommended. (tlisttappendtpoptrandomtchoicetrangetlen(Rtshuffled((smoosic/utilities.pytshuffleSs  0cGs6|pd}td„ttitd|ŒdƒƒS(swMerges multiple sequences, interleaving their elements. (Old version.) This returns a sequence whose elements alternate between the elements of the input sequences. For example, if the input sequences are (1, 2, 3) and (11, 12, 13), then the output will be (1, 11, 2, 12, 3, 13). And if the input sequences are (a, b, c), (v, w, x, y, z), and (q, r, s, t), then the output will be (a, v, q, b, w, r, c, x, s, y, t, z). Beware that this function throws away input elements that are equal to None. This is the price that must be paid in order to merge sequences of different lengths. cSs |dj S(N(tNone(tx((smoosic/utilities.pytvs(((N(N((tfiltertreducetoperatortconcattmapR'(t sequences((smoosic/utilities.pytstaggered_merge_oldcs  cGsŒt|ƒpgSg}|D] }|d o||dqq~}g}|D] }|do||dqQqQ~}|t|ŒSdS(s¶Merges multiple sequences, interleaving their elements. This returns a sequence whose elements alternate between the elements of the input sequences. For example, if the input sequences are (1, 2, 3) and (11, 12, 13), then the output will be (1, 11, 2, 12, 3, 13). And if the input sequences are (a, b, c), (v, w, x, y, z), and (q, r, s, t), then the output will be (a, v, q, b, w, r, c, x, s, y, t, z). Backward compatibility notes: This function does not throw away None values found in the input sequences, although previous versions did. Also, this function always returns a list, while previous versions tended to always return a tuple. iiN(R$R(R/RRtcarst_[2]tcdrs((smoosic/utilities.pyR‰s  44cCsYt|ƒoti|ƒ}n|i}g}|D]}||ƒo ||q4q4~S(s¤Returns a list of the elements of "seq" that match the regular expression represented by "regex", which may be a string or a regular expression object. (R tretcompiletsearch(tregexRR6RR((smoosic/utilities.pyRŸs  cCsYt|ƒoti|ƒ}n|i}g}|D]}||ƒp ||q4q4~S(s«Returns a list of the elements of "seq" that do not match the regular expression represented by "regex", which may be a string or a regular expression object. (R R4R5R6(R7RR6RR((smoosic/utilities.pyRªs  icCs~|p td‚n|diƒp|dd jp|d}n|diƒp|dd jp|d }nti|dƒ}|djoqti|dƒ\}}y2|ot|ƒ}n|ot|ƒ}nWqttj otd|‚qtXnq|djoVyt|ƒ}Wn tj otd|‚nX|ddjo|d}qtntd|‚||fS( s§Changes a string representing a range into the indices of the range. This function converts a string with a form similar to that of the Python array slice notation into into a pair of ints which represent the starting and ending indices of of the slice. If the string contains a pair of colon-separated integers, a 2-tuple of ints with the respective values of those integers will be returned. If the first number in this pair is omitted, then the value of the "start" argument is used. If the second number in this pair is omitted, then the value of the "end" argument is used. If the string contains a single integer, then a pair of ints with the value of that integer and its successor, respectively, will be returned. The exception to this rule is when the successor of the single integer is zero, in which case the value of the second element of the returned pair will be the value of the "end" argument. The string can optionally be bracketed by single non-digit, non-dash characters at the beginning and/or the end. The character at the beginning doesn't have to be the same as the one at the end. If either of these characters exist, they will be stripped away (and ignored) before any of the above-mentioned processing is done. If the string contains anything else, it is considered invalid and a ValueError will be thrown. sInvalid range: empty string.it-t:iiÿÿÿÿs(Invalid range (non-integer value): "%s".s-Invalid range (wrong number of colons): "%s".(R8R9(R8R9(t ValueErrortisdigittstringtcounttsplittint(R#tstarttendt colon_counttatb((smoosic/utilities.pyRµs2 ""   iOcCst|d„|idƒƒS(s™A word-wrap function that preserves existing line breaks and most spaces in the text. Expects that existing line breaks are posix newlines (\n). c SsLd|dt||idƒdƒt|iddƒdƒ|j|fS(s%s%s%ss s ii(R$trfindR>(tlinetwordtwidth((smoosic/utilities.pyR)ôs!t (R+R>(ttextRH((smoosic/utilities.pyRðs cCs7tiddƒ}|i||ƒ}||d„}|S(s…Return a function that takes a string and returns a partial copy of that string consisting only of the characters in 'keep'. RcSs|i||ƒS(N(t translate(tsRCR((smoosic/utilities.pyt string_filters(R<t maketransRK(tkeeptallcharstdelcharsRM((smoosic/utilities.pyRÿsiPR8cCsvt|ƒ|jo||dd d}n|t|ƒdd}|t|ƒd}d||||||fS(s<Returns the given text centered within a line, with padding.iis...is%s %s %s(R$(RJt line_widthtpad_chartpad_lentextra((smoosic/utilities.pyR s cCstidd|ƒS(s•Returns a version of the given text that uses backslashes to make it safe to pass to a Bourne-type shell if you enclose it in double quotes. s([$`\"])s\\\1(R4tsub(RJ((smoosic/utilities.pyR sc Cs°h}x£|iiƒD]’}d||<|ii|ƒ}x<|D]4}||cd|d|di|dƒf7 (%s) is, is(?m)^s (tsystemt listMethodstmethodSignaturetjoint methodHelpR4RV(t server_proxyt method_docstmethodt signaturetsigthelp((smoosic/utilities.pyRs   %#cCsfg}xA|djo3tii|ƒtii|ƒg}|dd+q W|o||dd+n|S(s˜Splits a Unix pathname into a list of its components. If the pathname is absolute, the resulting list will have '/' as its first element. t/Ri(RbR(tostpathtdirnametbasename(Rdtplist((smoosic/utilities.pyt splitpath0s 4cCs|ddjo||d|ds*****(sgrepsantigrepsstaggered_merges parse_rangeswrapsxmlrpc_server_docs center_textsuniqs sh_escapesflattens canLoopOvers isStringLikesisScalarsmake_string_filter(t__doc__t __future__RR4R!R<R,Rctos.patht__all__RR R R R R&R0RRRRRRRR RRhRl(((smoosic/utilities.pyts.H      &  ;