^hSrSSKrSSKrSSKrSSKrSSKJr \RS:XaSrOSrSSjr Sr SS jr S r S r SS jrSS jrSSjrSSjrg)z~ Utilities for working with strings and text. Inheritance diagram: .. inheritance-diagram:: IPython.utils.text :parts: 3 N) Formatterwin32z %B %d, %Yz %B %-d, %YcbUcgSU-SU--nU(a&[R"S[R5nO%[R"S[R5n[R"XTU5nUR [ R U-5(aUS[U5*$U$)aVIndent 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|unicode : string indented by ntabs and nspaces. N  z^\s*^)recompile MULTILINEsubendswithoslineseplen)instrnspacesntabsflattenindpatoutstrs O/home/james-whalen/.local/lib/python3.13/site-packages/ipython_genutils/text.pyindentrs2 } u*S[ Cjj",,/jjr||, VVCe $F rzz#~&&jCy!! c 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.  ) startswithtextwrapdedentsplitrjoin)textsplitsfirstrests rr r ?su tt$$ZZQ F 6{at$$KE ??4 D 99e] ##rc[R"S[R5n[U5R 5nUR U5SSS2n/n[R"S[R5nUH<nUR U5c[R"Xa5nURU5 M> U$)zWrap multiple paragraphs to fit a specified width. This is equivalent to textwrap.wrap, but with support for multiple paragraphs, as separated by empty lines. Returns ------- list of complete paragraphs, wrapped to fill `ncols` columns. z \n(\s*\n)+Nz\n\s+) r r r r stripr!searchrfillappend)r#ncols paragraph_re paragraphsout_ps indent_reps rwrap_paragraphsr3Zs::mR\\:L $<   D##D)#A#.J F 8R\\2I    A  & a'A a  Mrc2[R"SSU5$)zl Remove ansi escape codes from text. Parameters ---------- source : str Source to remove the ansi from z\033\[(\d|;)+?m)r r )sources r strip_ansir7ts 66$b& 11rc#V# [S[U5U5H nXX!-v M g7f)z'Yield successive n-sized chunks from l.rN)ranger)lnis r_chunksr=s' 1c!fa !#h!s')c [S[U5S-5HKn[[[[ X555n[ U5n[U5nXQUS- --U::dMK O WUS- (a UW- US- - OSWWS.$)z4Calculate optimal info to columnize a list of stringrr)columns_numbersoptimal_separator_width rows_numbers columns_width)r9rlistmapmaxr=sum)rlistseparator_size displaywidthnrowchk sumlengthr-s r _find_optimalrMsaUA&3s75/01H C U1W- - =  ' !&OTVWx|i'?%'&J^_!!  rc,U[U5:aU$X$)z2return list item number, or default if don't exist)r)mylistr<defaults r_get_or_defaultrQsCKyrc [[[[U55/UQ70UD6nUSUSpe[ U5VVs/sH-n[ U5Vs/sHn[ XU-U-US9PM snPM/ snnU4$s snfs snnf)alReturns a nested list, and info to columnize items Parameters ---------- items list of strings to columize empty : (default None) default value to fill list if needed separator_size : int (default=2) How much caracters will be used as a separation between each columns. displaywidth : int (default=80) The width of the area onto wich the columns should enter Returns ------- strings_matrix nested list of string, the outer most list contains as many list as rows, the innermost lists have each as many element as colums. If the total number of elements in `items` does not equal the product of rows*columns, the last element of some lists are filled with `None`. dict_info some info to make columnize easier: columns_numbers number of columns rows_numbers number of rows columns_width list of with of each columns optimal_separator_width best separator width between columns Examples -------- :: In [1]: l = ['aaa','b','cc','d','eeeee','f','g','h','i','j','k','l'] ...: compute_item_matrix(l,displaywidth=12) Out[1]: ([['aaa', 'f', 'k'], ['b', 'g', 'l'], ['cc', 'h', None], ['d', 'i', None], ['eeeee', 'j', None]], {'columns_numbers': 3, 'columns_width': [5, 1, 1], 'optimal_separator_width': 2, 'rows_numbers': 5}) rAr?)rP)rMrCrDrr9rQ) itemsemptyargskwargsinforJncolr<cs rcompute_item_matrixrZsl c#uo. @ @ @Dn%t,='>$_dei_j l_jZ[d U 1ufQh> U_j lnr ss U lsA=A8 +A=8A=c^^U(dg[U[T5US9unmUVs/sHn[SU5PM nnUU4SjnSR[ Xe55S-$s snf)aoTransform a list of strings into a single string with columns. Parameters ---------- items : sequence of strings The strings to process. separator : str, optional [default is two spaces] The string that separates columns. displaywidth : int, optional [default is 80] Width of the display in number of characters. Returns ------- The formatted string. r)rHrINc >TR[UTS5VVs/sHupURUS5PM snn5$s snnf)NrBr)r"zipljust)xywrW separators rcolumnize..s;y~~C4P_K`Da&bDaDA3Da&bc&bsA )rZrfilterr"rD)rSrbrImatrixr_fmatrixsjoinrWs ` @r columnizeris_$ &uS^ZfgLFD(./1vdAG/ cE 99S( )$ ..0sA")rF)P)r(rk)N)z rk)__doc__rr sysrstringrplatform date_formatrr r3r7r=rMrQrZrirrrrsc <<7KK$N$64 2   8tv/r