]jI hSrSSKrSSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r J r J r JrJrJrJrJr SSKJrJrJrJr SSK Jr "SS \5r"S S \\5rS5S \S \S\S\S\4 SjjrS\\\ \4S\ \4Sjr S6S\S\S\S\4Sjjr!S\S\4Sjr"S\S\4Sjr#S\S\4Sjr$"SS\5r%"SS \5r&"S!S"\&5r'S7S#\ \S$\S%\S\\ \4S&jjr(S'\ \S%\S(\S)\S\ \\44 S*jr)\"S+5r*S,\ \*S-\S.\*S\*4S/jr+S8S0\ \S1\S2\S3\S\4 S4jjr,g)9z~ Utilities for working with strings and text. Inheritance diagram: .. inheritance-diagram:: IPython.utils.text :parts: 3 N) Formatter)Path)ListDictTupleOptionalcastAnyUnionTypeVar)SequenceMappingCallableIterator)Selfc\rSrSr%Sr\\\S'\\S'\\\S'S\\4Sjr \ "\ 5=r r S\4Sjr \ "\ 5=rrS\4S jr\ "\5=rrS\\4S jr\ "\5=rrS rg ) LSString"a<String derivative with a special access attributes. These are normal strings, but with the special attributes: .l (or .list) : value as list (split on newlines). .n (or .nlstr): original value (the string itself). .s (or .spstr): value as whitespace-separated string. .p (or .paths): list of path objects (requires path.py package) Any values which require transformations are computed only once and cached. Such strings are very useful to efficiently interact with the shell, which typically only understands whitespace-separated options for commands._LSString__list_LSString__spstr_LSString__pathsreturncUR$![a% URS5UlURs$f=fN )rAttributeErrorsplitselfs O/home/mande/repo/quber/.venv/lib/python3.13/site-packages/IPython/utils/text.pyget_listLSString.get_list6s: ;;  **T*DK;;   ,==cUR$![a& URSS5UlURs$f=f)Nr )rrreplacers r get_spstrLSString.get_spstr?s< <<  <<S1DL<<  s ->>cU$Nrs r get_nlstrLSString.get_nlstrH c UR$![ak URS5Vs/sH4n[RR U5(dM)[ U5PM6 Os snfsnUlURs$f=fr)rrrospathexistsrrps r get_pathsLSString.get_pathsMsa <<  -1ZZ-=S-=PQARGDG-=SDL<<  s B(A'A'&BB)__list__paths__spstrN)__name__ __module__ __qualname____firstlineno____doc__rstr__annotations__rr!propertyllistr'sspstrrr,nnlstrr6r5paths__static_attributes__r+r/r rr"s M I L $Z$s)!!A 3 ##A4##A 4: ##Ar/rc 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 )SListcaList 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+rs r r!SList.get_listtr.r/cUR$![a% SRU5UlURs$f=f)Nr%)rNrjoinrs r r'SList.get_spstrys9 <<  88D>DL<<  r#cUR$![a% SRU5UlURs$f=fr)rOrrTrs r r,SList.get_nlstrs9 <<  99T?DL<<  r#cUR$![a\ UVs/sH4n[RR U5(dM)[ U5PM6 Os snfsnUlURs$f=fr*)rPrr1r2r3rr4s r r6SList.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) rErc^>TcU$UR5nUTnU$![a gf=f)N)r IndexError)rEpartstgtr\s r match_target SList.grep..match_targets=}GGIE El   s  ,,cP>[R"TU[R5$r*)research IGNORECASE)xrZs r SList.grep..sbiiBMMBr/)r@ isinstancetype)rrZr[r\rcpredels ` ` 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%)lenrrLappendr`rT)rrrroresf linepartsfds r rr 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) r_r) rLrrrangertrTisdigitint ValueErrorsortrm) rr\r{linedsuichnumstrrGts 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 )__nlstrr9r:)FN)NF)#r;r<r=r>r?r@rArrrr!rBrCrDr'rErFr,rGrHr6r5rIr rr rfMatchboolrrrprrrrJr+r/r rLrLcsL L L $Z$!!A 3 ##A 3 ##A 4: ##A # &QsHcUBHHSMD,@%@AAB&Q&Q} &Q  &QP"d3i"DcO"L&*/S "//  //r/rLinstrnspacesntabsflattenrcZSU-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)rfcompile MULTILINEsubendswithr1lineseprt)rrrrindpatoutstrs r indentrs. ,w &Cjj",,/jjr||, VVCe $F rzz#~&&jCy!! r/argc6[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'] )rlr@)rs r list_stringsr%s$#su  r/txtwidthmarkcU(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%rt)rrrnmarkmarkss r marqueer=sU"  FU## 3s8^A D )1 ,E qy% JEs5 ))r/strngct[R"S[R5nURSU5nU$)zPFormat a string for screen printing. This removes some latex-type format codes.z\\$r_)rfrrr)rpar_res r format_screenrVs- ZZr|| ,F JJr% E Lr/textc 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}) startswithtextwrapdedentrrtrT)rsplitsfirstrests r rr`su tt$$ZZQ F 6{at$$KE ??4 D 99e] ##r/cUR5nSn[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) splitlinesziprtsetstring whitespacerT)rlines strip_len characters prefix_charlns r strip_email_quotesr{s@ OO EI5k s: ! #  m &++ +{c/A NI " 99u5unu5 6D K6s1Bc <\rSrSrSrS\S\S\S\\\44SjrSr g ) EvalFormatteriaA 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. Note that on Python 3.14+ this version interprets `[]` as indexing operator so you need to use generators instead of list comprehensions, for example: `list(i for i in range(10))`. 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 [XU5nXA4$r*)eval)rrrrvs r get_fieldEvalFormatter.get_fields v &wr/r+N) r;r<r=r>r?r@r rrrJr+r/r rrs02cceCHor/rcB\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:r_)parserurTrdict convert_field format_field) rrrrresult literal_text field_name format_spec conversionobjs r vformatFullEvalFormatter.vformatsAE B =Lk l+%!$:*C!DJ:tF|4((9 d//R893B 6wwvr/r+N) r;r<r=r>r?r@r r rrrJr+r/r rrs90   (0  ?FsCx?P   r/rc 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)Nrr_r}r$)rr#_dollar_pattern_ignore_single_quotefinditergrouprend) rr literal_txtrrr continue_fromrmnew_txt new_fields r rDollarFormatter.parse#s@I A >C ! T]^44jzZ Z#A sB"B$cg)Nzr+rs r __repr__DollarFormatter.__repr__7s"r/r+N)r;r<r=r>r?rfrrr@rrr rrrJr+r/r rr sP&+-**7+'[[sCc7I1J(K[(###r/rrCmax_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)rtr~)rCrrncolsrjs r _col_chunksr?sQ8#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 stringr}r) num_columnsoptimal_separator_widthr column_widths)r~rtrDmapmaxrsum)rrrrr col_widths sumlengthrs r _find_optimalrLs!SZ!^,#c;u #JKL  O J 3 3| C  - !UZ]^U^ y(@eai'Pef ' r/Tmylistrdefaultc,U[U5:aU$X$)z2return list item number, or default if don't existr)rrrs r _get_or_defaultr`sCKyr/list_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' rr_r}c3$# UHov M g7fr*r+).0rs r get_text_list..s'JqJsN)rtrT)rrr r items r get_text_listrhs. 5zQ ,T>B   5zQQx 'E#2J''%)   sA.)rF)r_N*)F)z and z, r_)-r?r1rfrsysrwarningsrpathlibrtypingrrrrr r r r collections.abcr rrrrr@rrDrLrrrrrrrrrrrrrrrrr+r/r rs    BA2$s2$B\/DI\/~ #   $ SV FeCcN+S 0**#*#**2$$$6/S/S/dID9 9x-#'-#j49 & Cy & &,0 & d3i & 9!%7:JM #s(^" CLDGaAWY  9  # 47 PS  r/