MhdI dZddlZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZmZejdkrddlmZnddl mZGdd eZGd d eZdd(e ed)ed*edee efd+Z)d,e ed*ed-ed.ede eeff d/Z*ed0Z+d1e e+d2ed3e+de+fd4Z, d?d7e ed8ed9ed:edef d;Z-dS)@z~ Utilities for working with strings and text. Inheritance diagram: .. inheritance-diagram:: IPython.utils.text :parts: 3 N) Formatter)Path) ListDictTupleOptionalcastSequenceMappingAnyUnionCallableIteratorTypeVar) )SelfceZdZUdZeeed<eed<eeed<deefdZe exZ Z defdZ e e xZ ZdefdZe exZZdeefd Ze exZZd S) LSStringa`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__pathsreturnct |jS#t$r$|d|_|jcYSwxYwN )rAttributeErrorsplitselfs R/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/IPython/utils/text.pyget_listzLSString.get_list<sK ;    **T**DK;      +77cv |jS#t$r%|dd|_|jcYSwxYw)Nr )rrreplacers r! get_spstrzLSString.get_spstrEsM <    <<S11DL<    s  ,88c|SNrs r! get_nlstrzLSString.get_nlstrN c |jS#t$r.d|dD|_|jcYSwxYw)Ncjg|]0}tj|!t|1Sr*ospathexistsr.0ps r! z&LSString.get_paths..Ws2SSSPQARARSDGGSSSr-r)rrrrs r! get_pathszLSString.get_pathsSsY <    SSTZZ-=-=SSSDL<    s 5AAN)__name__ __module__ __qualname____doc__rstr__annotations__rr"propertyllistr'sspstrrr+nnlstrr8r6pathsr*r-r!rr(s M M I LLL $Z$s)x!!!A 3    ###A4###A 4:    ###Ar-rc eZdZUdZeed<eed<eeed<defdZ e e xZ Z defdZ e e xZZdefdZe exZZdeefd Ze exZZ dd eeeegejed zffd edeedefdZdeedeeefdZ ddeeededefdZ d S)SListaList 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__pathsrc|Sr)r*rs r!r"zSList.get_listzr,r-ct |jS#t$r$d||_|jcYSwxYw)Nr%)rIrjoinrs r!r'zSList.get_spstrsI <    88D>>DL<    r#ct |jS#t$r$d||_|jcYSwxYwr)rJrrNrs r!r+zSList.get_nlstrsI <    99T??DL<    r#cb |jS#t$rd|D|_|jcYSwxYw)Ncjg|]0}tj|!t|1Sr*r0r4s r!r7z#SList.get_paths..s1GGGRW^^A5F5FGDGGGGGr-)rKrrs r!r8zSList.get_pathssM <    GGTGGGDL<    s  "..FNpatternprunefieldcdtdtffd ttrfdn|s%t|fd|DSt|fd|DS)aReturn 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) rBrcl|S|} |}|S#t$rYdSwxYw)N)r IndexError)rBpartstgtrTs r! match_targetz SList.grep..match_targetsO}GGIIE El    rr s % 33cDtj|tjSr))research IGNORECASE)xrRs r!zSList.grep..sbiBMBBr-c<g|]}||Sr*r*r5elr[preds r!r7zSList.grep..s2KKKbDDb9I9I4J4JKrKKKr-c<g|]}||Sr*r*rcs r!r7zSList.grep..s2OOOb\\"=M=M8N8NOrOOOr-)r= isinstancetype)r rRrSrTr[res ` `@@r!grepz SList.greps* C C       gs # # BBBBDDD Q4::KKKKKDKKKLL L4::OOOOODOOOPP Pr-fieldsc8t|dkr d|DSt}d|DD]_}g}|D].} |||#t$rY+wxYw|r(|d|`|S)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. rc6g|]}|Sr*r)r5rds r!r7z SList.fields..s ...2BHHJJ...r-c6g|]}|Sr*rm)r5fs r!r7z SList.fields..s +++17799+++r-r%)lenrHappendrXrN)r rjresrd linepartsfds r!rjz SList.fieldss& v;;!  ..... .gg++d+++ 0 0BI  $$RV,,,,!D 0 388I../// sA A,+A,numscfd|D}n d|D}|rxtt|D][}dd||dD} t|}n#t$rd}YnwxYw|||d<\|t |d|DS)zsort by specified fields (see fields()) Example:: a.sort(1, nums = True) Sorts a by second field, in numerical order (so that 21 > 3) NcZg|]'}t|g|g(Sr*)rHrj)r5linerTs r!r7zSList.sort..s4IIIDE4&MM((//$7IIIr-cg|]}||gSr*r*)r5rxs r!r7zSList.sort..s222TD4=222r-rWc:g|]}||Sr*)isdigit)r5chs r!r7zSList.sort..s%!I!I!IBJJLL!I"!I!I!Ir-rcg|] }|d S)r*)r5ts r!r7zSList.sort..s---A1Q4---r-)rangerprNint ValueErrorsortrh)r rTrudsuinumstrrDs ` r!rz SList.sorts  IIIIDIIICC22T222C  3s88__  !I!Is1vay!I!I!IJJF AA!AAAAq   tDzz-----...s+A;; B  B )FN)NF)!r9r:r;r<r=r>rrrr"r?r@rAr'rBrCr+rDrEr8r6rFr rr r]Matchboolrrrirjrr*r-r!rHrHis  LLL LLL $Z$x!!!A 3    ###A 3    ###A 4:    ###A # &Q&QsHcUBHSMD,@%@AAB&Q&Q} &Q  &Q&Q&Q&QP"d3i"DcO""""L&*//S "//  //////r-rHFinstrnspacesntabsflattenrc>d|zd|zz}|r tjdtj}ntjdtj}tj|||}|t j|zr|dt| S|S)aIndent 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)r]compile MULTILINEsubendswithr1lineseprp)rrrrindpatoutstrs r!indentrs. ,w &C-j",//jr|,, VCe $ $F rz#~&&jCyj!! r-argc6t|tr|gS|S)aAlways 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'] )rgr=)rs r! list_stringsr+s"$#su  r-rWN*txtwidthmarkc|s ||zd|S|t|z dz t|zdz}|dkrd}||z}|d|d|S)aReturn 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%rp)rrrnmarkmarkss r!marqueerCsp" $U FUF## 3s88^A D )1 ,E qyy% JEsss55 ))r-strngcptjdtj}|d|}|S)zTFormat a string for screen printing. This removes some latex-type format codes.z\\$rW)r]rrr)rpar_res r! format_screenr\s/ Zr| , ,F JJr% E Lr-textc.|drtj|S|dd}t |dkrtj|S|\}}tj|}d||gS)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~) startswithtextwrapdedentrrprN)rsplitsfirstrests r!rrfs t%t$$$ZZQ  F 6{{at$$$KE4 ?4 D 99eT] # ##r-c|}dt|D]F}tt|dkrn#|d}|tjvs|dkrdz Fdfd|D}|S)aNStrip 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~>rc$g|] }|d Sr)r*)r5ln strip_lens r!r7z&strip_email_quotes..s!555bn555r-) splitlinesziprpsetstring whitespacerN)rlines characters prefix_charrs @r!strip_email_quotesrs@ OO  EI5k   s:  ! # # E m &+ + +{c/A/A NII  995555u555 6 6D Kr-c :eZdZdZdedededeeeffdZdS) EvalFormatteraiA 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*t||}||fSr))eval)r rrrvs r! get_fieldzEvalFormatter.get_fields v  $wr-N)r9r:r;r<r=r rrr*r-r!rrsV*cceCHor-rcFeZdZdZdedeedeeefdefdZdS)FullEvalFormatteraiA 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_stringrrrcg}||D]\}}}}|r|||u|rd||g}t|t |} || |} ||| dd|S)N:rW)parserqrNrdict convert_field format_field) r rrrresult literal_text field_name format_spec conversionobjs r!vformatzFullEvalFormatter.vformatsAE B B  : : =L*k: , l+++%E!$:{*C!D!DJ:tF||44((j99 d//R88999wwvr-N) r9r:r;r<r=r r r rr*r-r!rrs_0   (0  ?FsCx?P        r-rc neZdZdZejdZdedee e e e e ffdZ defdZ dS)DollarFormatteraFormatter 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#\Ktj||D]\}}}}d}d}|j|D]Z}|dd\} } | dr || | zz }n || z| ddfVd}|}[|||dz|||fVdS)NrrWr~r$)rr#_dollar_pattern_ignore_single_quotefinditergrouprend) r r literal_txtrrr continue_fromrmnew_txt new_fields r!rzDollarFormatter.parse%s@I *A A  [ [ >>>C ! ]^^44j+zZ Z Z Z Z# [ [r-cdS)Nzr*rs r!__repr__zDollarFormatter.__repr__9s""r-N) r9r:r;r<r]rrr=rrr rrr*r-r!rr s&+5"*7++'[[sCc7I1J(K[[[[(########r-rr@max_rows row_firstc#BK|rit|zt|zdkz}t|D].}fdt|t|DV/dStdt|D]}|||zVdS)z5Yield successive max_rows-sized column chunks from l.rc g|] }| Sr*r*)r5jr@s r!r7z_col_chunks..Hs999A1Q4999r-N)rpr)r@rrncolsrs` r! _col_chunksrAs&Q8#A(9A(=>u : :A9999q#a&&%!8!8999 9 9 9 9 : :q#a&&(++ & &AAq8|$% % % % % & &r-rlistseparator_size displaywidthc 6tdt|dzD]b}tttt |||}t |}t|}|||dz zz|krnc||dz r ||z |dz znd||dS)z4Calculate optimal info to columnize a list of stringr~r) num_columnsoptimal_separator_widthr column_widths)rrprAmapmaxrsum)rrrrr col_widths sumlengthrs r! _find_optimalrNs!SZZ!^,,#c;uh #J#JKKLL  OO J ~3 3| C C E D UZ]^U^'f y(@eai'P'Pef '  r-Tmylistrdefaultc<|t|kr|S||S)z2return list item number, or default if don't existr)rrrs r!_get_or_defaultrbs"CKKayr- and , list_last_sepsepwrap_item_withct|dkrdSrfd|D}t|dkr|dS|d|ddD||dS)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' rrWc g|] }| Sr*r*)r5itemr s r!r7z!get_text_list..s6   ,^TT>>B   r-r~c3K|]}|VdSr)r*)r5rs r! z get_text_list..s"''q''''''r-N)rprN)rrrr s `r! get_text_listrjs. 5zzQr         5zzQQx ''E#2#J''''''%)) r-)rrF)rWrr)F)rrrW).r<r1r]rsysrwarningsrpathlibrtypingrrrrr r r r r rrr version_infotyping_extensionsrr=rrArHrrrrrrrrrrrrrrrrr*r-r!rsF                             g&&&&&&&2$2$2$2$2$s2$2$2$B\/\/\/\/\/D\/\/\/~  #   $ SV    FeCcN+S 0***#*#*****2$$$$$$6/S/S////dI<99999 999x-#-#-#-#-#'-#-#-#j49 & & Cy & &,0 & d3i & & & & 9!%7:JM #s(^" GCLLDGaAWY   9  # 47 PS       r-