>cU$Nr s r" get_nlstrLSString.get_nlstrN c UR$![ak URS5Vs/sH4n[RR U5(dM)[ U5PM6 Os snfsnUlURs$f=fr)rrrospathexistsrr!ps r" get_pathsLSString.get_pathsSsa <<  -1ZZ-=S-=PQARGDG-=SDL<<  s B(A'A'&BB)__list__paths__spstrN)__name__ __module__ __qualname____firstlineno____doc__rstr__annotations__rr#propertyllistr)sspstrrr.nnlstrr8r7paths__static_attributes__r-r1r"rr(s M I L $Z$s)!!A 3 ##A4##A 4: ##Ar1rc x\rSrSr%Sr\\S'\\S'\\\S'S\ 4Sjr \ "\ 5=r r S\4Sjr\ "\5=rrS\4S jr\ "\5=rrS\\4S jr\ "\5=rrSS \\\\/\R6\S -44S \S\\S\ 4SjjrS\\S\\\4Sjr SS\\\S\S\ 4Sjjr!Sr"g )SListiaList derivative with a special access attributes. These are normal lists, but with the special attributes: * .l (or .list) : value as list (the list itself). * .n (or .nlstr): value as a string, joined on newlines. * .s (or .spstr): value as a string, joined on spaces. * .p (or .paths): list of path objects (requires path.py package) Any values which require transformations are computed only once and cached. _SList__spstr _SList__nlstr _SList__pathsrcU$r,r-r s r"r#SList.get_listzr0r1cUR$![a% SRU5UlURs$f=f)Nr')rPrjoinr s r"r)SList.get_spstrs9 <<  88D>DL<<  r%cUR$![a% SRU5UlURs$f=fr)rQrrVr s r"r.SList.get_nlstrs9 <<  99T?DL<<  r%cUR$![a\ UVs/sH4n[RR U5(dM)[ U5PM6 Os snfsnUlURs$f=fr,)rRrr3r4r5rr6s r"r8SList.get_pathssU <<  -1GTRWW^^A5FGDGTGDL<<  s A4(AAA43A4Npatternprunefieldc d^^S[S[4U4Sjjn[T[5(aU4SjnOTnU(d6[U5"UVs/sHoe"U"U55(dMUPM sn5$[U5"UVs/sHoe"U"U55(aMUPM sn5$s snfs snf)aaReturn all strings matching 'pattern' (a regex or callable) This is case-insensitive. If prune is true, return all items NOT matching the pattern. If field is specified, the match must occur in the specified whitespace-separated field. Examples:: a.grep( lambda x: x.startswith('C') ) a.grep('Cha.*log', prune=1) a.grep('chm', field=-1) rGrc^>TcU$UR5nUTnU$![a gf=f)N)r IndexError)rGpartstgtr^s r" match_target SList.grep..match_targets=}GGIE El   s  ,,cP>[R"TU[R5$r,)research IGNORECASE)xr\s r"SList.grep..sbiiBMMBr1)rB isinstancetype)r!r\r]r^repredels ` ` r"grep SList.greps* C C  gs # #BDD:DKDbDb9I4JrDKL L:DODb\"=M8NrDOP PLOs B(%B(B-B-fieldsc[U5S:Xa UVs/sHo"R5PM sn$[5nUVs/sHoDR5PM snHKn/nUHnURX&5 M U(dM+URSR U55 MM U$s snfs snf![a Maf=f)a#Collect whitespace-separated fields from string list Allows quick awk-like usage of string lists. Example data (in var a, created by 'a = !ls -l'):: -rwxrwxrwx 1 ville None 18 Dec 14 2006 ChangeLog drwxrwxrwx+ 6 ville None 0 Oct 24 18:05 IPython * ``a.fields(0)`` is ``['-rwxrwxrwx', 'drwxrwxrwx+']`` * ``a.fields(1,0)`` is ``['1 -rwxrwxrwx', '6 drwxrwxrwx+']`` (note the joining by space). * ``a.fields(-1)`` is ``['ChangeLog', 'IPython']`` IndexErrors are ignored. Without args, fields() just split()'s the strings. rr')lenrrNappendrbrV)r!rtrqresf linepartsfds r"rt SList.fieldss& v;! )-.2HHJ. .g&*+d779d+BI$$RV, y 388I./, /, "sB+B0%B55 CCnumsc"Ub.UVs/sH n[U/5RU5U/PM" nnOUVs/sHo3U/PM nnU(ak[[U55HSnSR XESVs/sHofR 5(dMUPM sn5n[ U5nXUS'MU UR5 [U5"UV s/sHoSPM sn 5$s snfs snfs snf![a SnN\f=fs sn f)zsort by specified fields (see fields()) Example:: a.sort(1, nums = True) Sorts a by second field, in numerical order (so that 21 > 3) rar) rNrtrangervrVisdigitint ValueErrorsortro) r!r^r}linedsuichnumstrrIts r"r SList.sorts  DHIDDE4&M((/$7DCIC-12TT4=TC2 3s8_svay!IyJJL"y!IJF AAq %  Dz-AQ4-..J2"J"A .s.'C+ C07C5 C5 ! C:D : D D )__nlstrr;r<)FN)NF)#r=r>r?r@rArBrCrrrr#rDrErFr)rGrHr.rIrJr8r7rKr rr rhMatchboolrrrrrtrrLr-r1r"rNrNisL L L $Z$!!A 3 ##A 3 ##A 4: ##A # &QsHcUBHHSMD,@%@AAB&Q&Q} &Q  &QP"d3i"DcO"L&*/S "//  //r1rNinstrnspacesntabsflattenrcZSU-SU--nU(a&[R"S[R5nO%[R"S[R5n[R"XTU5nUR [ R U-5(aUS[U5*$U$)aNIndent a string a given number of spaces or tabstops. indent(str, nspaces=4, ntabs=0) -> indent str by ntabs+nspaces. Parameters ---------- instr : basestring The string to be indented. nspaces : int (default: 4) The number of spaces to be indented. ntabs : int (default: 0) The number of tabs to be indented. flatten : bool (default: False) Whether to scrub existing indentation. If True, all lines will be aligned to the same indentation. If False, existing indentation will be strictly increased. Returns ------- str : string indented by ntabs and nspaces.  r'z^\s*^N)rhcompile MULTILINEsubendswithr3lineseprv)rrrrindpatoutstrs r"indentrs. ,w &Cjj",,/jjr||, VVCe $F rzz#~&&jCy!! r1argc6[U[5(aU/$U$)auAlways return a list of strings, given a string or list of strings as input. Examples -------- :: In [7]: list_strings('A single string') Out[7]: ['A single string'] In [8]: list_strings(['A single string in a list']) Out[8]: ['A single string in a list'] In [9]: list_strings(['A','list','of','strings']) Out[9]: ['A', 'list', 'of', 'strings'] )rnrB)rs r" list_stringsr+s$#su  r1txtwidthmarkcU(dX!-SU$U[U5- S- [U5-S-nUS:aSnX#-nU<SU<SU<3$)aaReturn the input string centered in a 'marquee'. Examples -------- :: In [16]: marquee('A test',40) Out[16]: '**************** A test ****************' In [17]: marquee('A test',40,'-') Out[17]: '---------------- A test ----------------' In [18]: marquee('A test',40,' ') Out[18]: ' A test ' Nrr'rv)rrrnmarkmarkss r"marqueerCsU"  FU## 3s8^A D )1 ,E qy% JEs5 ))r1strngct[R"S[R5nURSU5nU$)zPFormat a string for screen printing. This removes some latex-type format codes.z\\$ra)rhrrr)rpar_res r" format_screenr\s- ZZr|| ,F JJr% E Lr1textc URS5(a[R"U5$URSS5n[ U5S:Xa[R"U5$Uup#[R"U5nSR X#/5$)zEquivalent of textwrap.dedent that ignores unindented first line. This means it will still dedent strings like: '''foo is a bar ''' For use in wrap_paragraphs. rr) startswithtextwrapdedentrrvrV)rsplitsfirstrests r"rrfsu tt$$ZZQ F 6{at$$KE ??4 D 99e] ##r1cUR5nSn[U6HCn[[U55S:a O*USnU[R ;dUS:XaUS- nMC O SR UVs/sHoUUSPM sn5nU$s snf)aStrip leading email quotation characters ('>'). Removes any combination of leading '>' interspersed with whitespace that appears *identically* in all lines of the input text. Parameters ---------- text : str Examples -------- Simple uses:: In [2]: strip_email_quotes('> > text') Out[2]: 'text' In [3]: strip_email_quotes('> > text\n> > more') Out[3]: 'text\nmore' Note how only the common prefix that appears in all lines is stripped:: In [4]: strip_email_quotes('> > text\n> > more\n> more...') Out[4]: '> text\n> more\nmore...' So if any line has no quote marks ('>'), then none are stripped from any of them :: In [5]: strip_email_quotes('> > text\n> > more\nlast different') Out[5]: '> > text\n> > more\nlast different' rr>rN) splitlinesziprvsetstring whitespacerV)rlines strip_len characters prefix_charlns r"strip_email_quotesrs@ OO EI5k s: ! #  m &++ +{c/A NI " 99u5unu5 6D K6s1Bc <\rSrSrSrS\S\S\S\\\44SjrSr g ) EvalFormatteria1A String Formatter that allows evaluation of simple expressions. Note that this version interprets a `:` as specifying a format string (as per standard string formatting), so if slicing is required, you must explicitly create a slice. This is to be used in templating cases, such as the parallel batch script templates, where simple arithmetic on arguments is useful. Examples -------- :: In [1]: f = EvalFormatter() In [2]: f.format('{n//4}', n=8) Out[2]: '2' In [3]: f.format("{greeting[slice(2,4)]}", greeting="Hello") Out[3]: 'll' nameargskwargsrc[X5nXA4$r,)eval)r!rrrvs r" get_fieldEvalFormatter.get_fields  wr1r-N) r=r>r?r@rArBr rrrLr-r1r"rrs0*cceCHor1rcB\rSrSrSrS\S\\S\\\4S\4Sjr Sr g ) FullEvalFormatteria!A String Formatter that allows evaluation of simple expressions. Any time a format key is not found in the kwargs, it will be tried as an expression in the kwargs namespace. Note that this version allows slicing using [1:2], so you cannot specify a format string. Use :class:`EvalFormatter` to permit format strings. Examples -------- :: In [1]: f = FullEvalFormatter() In [2]: f.format('{n//4}', n=8) Out[2]: '2' In [3]: f.format('{list(range(5))[2:4]}') Out[3]: '[2, 3]' In [4]: f.format('{3*2}') Out[4]: '6' format_stringrrrcX/nURU5HupVpxU(aURU5 UcM#U(aSRXg/5n[U[ U55n UR X5n URUR U S55 M SRU5$)N:ra)parserwrVrdict convert_field format_field) r!rrrresult literal_text field_name format_spec conversionobjs r"vformatFullEvalFormatter.vformatsAE B =Lk l+%!$:*C!DJ:tF|4((9 d//R893B 6wwvr1r-N) r=r>r?r@rArBr r r rrLr-r1r"rrs90   (0  ?FsCx?P   r1rc p\rSrSrSr\R "S5rS\S\ \ \ \ \ \ 44Sjr S\4Sjr Srg ) DollarFormatteri aFormatter allowing Itpl style $foo replacement, for names and attribute access only. Standard {foo} replacement also works, and allows full evaluation of its arguments. Examples -------- :: In [1]: f = DollarFormatter() In [2]: f.format('{n//4}', n=8) Out[2]: '2' In [3]: f.format('23 * 76 is $result', result=23*76) Out[3]: '23 * 76 is 1748' In [4]: f.format('$a or {b}', a=1, b=2) Out[4]: '1 or 2' z,(.*?)\$(\$?[\w\.]+)(?=([^']*'[^']*')*[^']*$) fmt_stringrc#L# [R"X5Hup#pESnSnURRU5HQnUR SS5upU R S5(aXyU -- nO Xy-U SS4v SnUR 5nMS XrUS-X4U4v M g7f)Nrrarr$)rr#_dollar_pattern_ignore_single_quotefinditergrouprend) r!r literal_txtrrr continue_fromrmnew_txt new_fields r"rDollarFormatter.parse%s@I A >C ! T]^44jzZ Z#A sB"B$cg)Nzr-r s r"__repr__DollarFormatter.__repr__9s"r1r-N)r=r>r?r@rArhrrrBrrr rrrLr-r1r"rr sP&+-**7+'[[sCc7I1J(K[(###r1rrEmax_rows row_firstc#*# U(a^[U5U-[U5U-S:-n[U5H.n[U[U5U5Vs/sHoPUPM snv M0 g[S[U5U5H nXXA-v M gs snf7f)z5Yield successive max_rows-sized column chunks from l.rN)rvr)rErrncolsrjs r" _col_chunksrAsQ8#A(9A(=>uA!&q#a&%!89!8AQ4!89 9q#a&(+Aq|% %,:sABB5Brlistseparator_size displaywidthc  [S[U5S-5HLn[[[[ XU555n[ U5n[U5nXbUS- --U::dML O WUS- (a UW- US- -OSWWS.$)z4Calculate optimal info to columnize a list of stringrr) num_columnsoptimal_separator_widthr column_widths)rrvrFmapmaxrsum)rrrrr col_widths sumlengthrs r" _find_optimalrNs!SZ!^,#c;u #JKL  O J 3 3| C  - !UZ]^U^ y(@eai'Pef ' r1Tmylistrdefaultc,U[U5:aU$X$)z2return list item number, or default if don't existr)rrrs r"_get_or_defaultrbsCKyr1list_last_sepsepwrap_item_withc[U5S:XagU(aUVs/sHnU<U<U<3PM nn[U5S:XaUS$URSUSS55<U<US<3$s snf)a Return a string with a natural enumeration of items >>> get_text_list(['a', 'b', 'c', 'd']) 'a, b, c and d' >>> get_text_list(['a', 'b', 'c'], ' or ') 'a, b or c' >>> get_text_list(['a', 'b', 'c'], ', ') 'a, b, c' >>> get_text_list(['a', 'b'], ' or ') 'a or b' >>> get_text_list(['a']) 'a' >>> get_text_list([]) '' >>> get_text_list(['a', 'b'], wrap_item_with="`") '`a` and `b`' >>> get_text_list(['a', 'b', 'c', 'd'], " = ", sep=" + ") 'a + b + c = d' rrarc3$# UHov M g7fr,r-).0rs r" get_text_list..s'JqJsN)rvrV)r r r r items r" get_text_listrjs. 5zQ ,T>B   5zQQx 'E#2J''%)   sA.)rF)raN*)F)z and z, ra).rAr3rhrsysrwarningsrpathlibrtypingrrrrr r r r r rrr version_infotyping_extensionsrrBrrFrNrrrrrrrrrrrrrrrrr-r1r"rs     g&2$s2$B\/D\/~ #   $ SV FeCcN+S 0**#*#**2$$$6/S/S/dI<9 9x-#'-#j49 & Cy & &,0 & d3i & 9!%7:JM #s(^" CLDGaAWY  9  # 47 PS  r1