EidrSSKJr SSKJr SSKJr SSKJr SSKJ r J r J r J r J r JrJrJrJrJr SSKJrJrJrJrJr SSKJrJr SS KJr \ (a SS KJrJ r J!r! "S S \5r"\\\"\\"\\#\$44\\"\#\#44r%\"5"S S\ 55r&"SS5r'"SS5r(\)S:XGaSSK*Jr SSK+J,r, SSK-J.r. Sr/\.R`"S5r1\"5r\ReS5 \RgS5 \RgS5 \Rg\,"\/SSS95 \Rg5 \RgS5 \4"\Rk\155r6\Rg\65 \Rg5 \RgS 5 \Rg\15 \RgS!5 g"g")#)IntEnum) lru_cache) filterfalse) attrgetter) TYPE_CHECKINGDictIterableList NamedTupleOptionalSequenceTupleTypeUnion)_is_single_cell_widthscached_cell_lencell_lenget_character_cell_size set_cell_size)Result rich_repr)Style)ConsoleConsoleOptions RenderResultcX\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrg) ControlType zDNon-printable control codes which typically translate to ANSI codes.r N)__name__ __module__ __qualname____firstlineno____doc__BELLCARRIAGE_RETURNHOMECLEAR SHOW_CURSOR HIDE_CURSORENABLE_ALT_SCREENDISABLE_ALT_SCREEN CURSOR_UP CURSOR_DOWNCURSOR_FORWARDCURSOR_BACKWARDCURSOR_MOVE_TO_COLUMNCURSOR_MOVE_TO ERASE_IN_LINESET_WINDOW_TITLE__static_attributes__r/I/home/mande/repo/quber/.venv/lib/python3.13/site-packages/rich/segment.pyrr sYN DO D EKKIKNONMrFrc\rSrSr%Sr\\S'Sr\\ \S'Sr \\ \ \S'\ S\4Sj5rS\4S jrS\4S jr\ S\4S j5r\\"S 5S SS\S\S4Sj55rS\S\S4Sjr\S2Sj5r\S3S\SS\\ S\\ S\S4Sjj5r\S4S\SS\S\S4Sjj5r\S\SS\\S4Sj5r\S\SS\\\S\44Sj5r \S5S\SS\S\\ S\S\S\\S4 Sjj5r!\S6S\SS\S\\ S\S\S4 Sjj5r"\S\SS\4S j5r#\S!\\SS\\\44S"j5r$\S7S!\\SS#\S$\\S\\ S%\S\\S4 S&jj5r%\S4S'\&SS!\\SS#\S$\S\ S%\S\\S4S(jj5r'\S4S'\&SS!\\SS#\S$\S\ S%\S\\S4S)jj5r(\S4S'\&SS!\\SS#\S$\S\ S%\S\\S4S*jj5r)\S\SS\S4S+j5r*\S\SS\S4S,j5r+\S\SS\S4S-j5r,\S\SS\S4S.j5r-\S\SS/\\S\\S4S0j5r.S1r/g)8Segment<aA piece of text with associated style. Segments are produced by the Console render process and are ultimately converted in to strings to be written to the terminal. Args: text (str): A piece of text. style (:class:`~rich.style.Style`, optional): An optional style to apply to the text. control (Tuple[ControlCode], optional): Optional sequence of control codes. Attributes: cell_length (int): The cell length of this Segment. textNstylecontrolreturnc4UupnU(aS$[U5$)zbThe number of terminal cells required to display self.text. Returns: int: A number of cells. r)r)selfrK_stylerMs rG cell_lengthSegment.cell_lengthNs!%gq/$/rFc## URv URcURbURv ggURv URv g7fN)rKrMrLrPs rG __rich_repr__Segment.__rich_repr__XsGii << zz%jj &** ,, AAc,[UR5$)z#Check if the segment contains text.)boolrKrVs rG__bool__Segment.__bool__asDIIrFcURSL$)z,Check if the segment contains control codes.N)rMrVs rG is_controlSegment.is_controles||4''rFi@segmentcut)rIrIcUup4n[nURnX':a X"SXE54$[n[X'- [ U5-5n USU n [ U 5n X- n U (dU"XU5U"X9SXE54$U S:Xa.U"X95S:Xa U"USU S-XE5U"SX9S-S-XE54$U S:Xa1U"X9S- 5S:Xa U"USU S- S-XE5U"SX9S-XE54$X:aU S- n OU S-n M)aSplit a segment in to two at a given cell position. Note that splitting a double-width character, may result in that character turning into two spaces. Args: segment (Segment): A segment to split. cut (int): A cell position to cut on. Returns: A tuple of two segments. Nr  r)rIrRrintlenr) clsrarbrKrLrM_SegmentrR cell_sizeposbeforecell_posout_bys rG _split_cellsSegment._split_cellsjsQ 'W))  HR88 8+ 3$D 12$3ZF'H^FVG4T$Z8| $) 4 9T$3Z#-u>S4a ?2EC| $Qw- 8A =T)C!G_s2ECS4:-u>~qq-rFcUup#nUS:de[U5(a:U[U5:aU[SX454$[USUX45[X!SX454$URX5$)a@Split segment in to two segments at the specified column. If the cut point falls in the middle of a 2-cell wide character then it is replaced by two spaces, to preserve the display width of the parent segment. Args: cut (int): Offset within the segment to cut. Returns: Tuple[Segment, Segment]: Two segments. rrdN)rrhrIrp)rPrbrKrLrMs rG split_cellsSegment.split_cellss} $Waxx !$ ' 'c$iWR888Tc E3T E3    ++rFcU"S5$)zMake a new line segment. r/)ris rGline Segment.lines4yrFsegments post_stylecx^^^UnU(aURmUU4SjU5nT(a UU4SjU5nU$)aApply style(s) to an iterable of segments. Returns an iterable of segments where the style is replaced by ``style + segment.style + post_style``. Args: segments (Iterable[Segment]): Segments to process. style (Style, optional): Base style. Defaults to None. post_style (Style, optional): Style to apply on top of segment style. Defaults to None. Returns: Iterable[Segments]: A new iterable of segments (possibly the same iterable). c3Z># UH upnT"X(aSOT"U5U5v M" g7frUr/).0rKrQrMapplyris rG &Segment.apply_style..s1-<)D'D'$uV}gFF-# UH'upnT"UU(aSO U(aUT-OTU5v M) g7frUr/)r}rKrQrMrirzs rGrrsG .=)D'#5;fz1.=s/2)__add__)riryrLrzresult_segmentsr~s` ` @rG apply_styleSegment.apply_stylesC&# MME-<O  .= OrFr_cdU(a[[S5U5$[[S5U5$)aFilter segments by ``is_control`` attribute. Args: segments (Iterable[Segment]): An iterable of Segment instances. is_control (bool, optional): is_control flag to match in search. Returns: Iterable[Segment]: And iterable of Segment instances. rM)filterrr)riryr_s rGfilter_controlSegment.filter_controls+ *Y/: :z)4h? ?rFc#Z# /nURnUHnSUR;alUR(d[UupVnU(aMURS5upnU(aU"U"X55 U (aUv /nURnU(aMKM}MU"U5 M U(aUv gg7f)zSplit a sequence of segments in to a list of lines. Args: segments (Iterable[Segment]): Segments potentially containing line feeds. Yields: Iterable[List[Segment]]: Iterable of segment lists, one per line. rvNappendrKrM partition riryrwrrarKrL__textnew_lines rG split_linesSegment.split_liness!Gw||#GOO!(Q,0NN4,@)ETs501" !!%dw  J s B B+B+c#b# /nURnUHnSUR;anUR(d]UupVnU(aOURS5upnU(aU"U"X55 U (aUS4v /nURnU(aMMMMU"U5 M U(aUS4v gg7f)a Split a sequence of segments in to a list of lines and a boolean to indicate if there was a new line. Args: segments (Iterable[Segment]): Segments potentially containing line feeds. Yields: Iterable[List[Segment]]: Iterable of segment lists, one per line. rvTFNrrs rGsplit_lines_terminatorSegment.split_lines_terminators!Gw||#GOO!(Q,0NN4,@)ETs501#Tl*!!%dw  -  s B B/B/lengthpadinclude_new_linesc## /nURnURnU"S5n UHn SU R;aU R(d|U upn U (anU R S5upn U(aU"U"X55 U(a3U"XbX4S9nU(aURU 5 Uv UR 5 U (aMlMMU"U 5 M U(a U"XbX4S9v gg7f)aSplit segments in to lines, and crop lines greater than a given length. Args: segments (Iterable[Segment]): An iterable of segments, probably generated from console.render. length (int): Desired line length. style (Style, optional): Style to use for any padding. pad (bool): Enable padding of lines that are less than `length`. Returns: Iterable[List[Segment]]: An iterable of lines of segments. rv)rLrN)radjust_line_lengthrKrMrclear)riryrrLrrrwrrnew_line_segmentrarK segment_stylerrr cropped_lines rGsplit_and_crop_linesSegment.split_and_crop_lines2s*! 33t9Gw||#GOO)0&Q,0NN4,@)ETs589'9 ( -(//0@A** dw! " $TH H s B?C%"C%rwcn[SU55nXR:a"U(aX"SX%- -U5/-nU$USSnU$XR:aq/nURnSnUHXnURn XY-U:dUR(aU"U5 XY- nM6Uupn [ XU- 5n U"U"X55 U$ U$USSnU$)aAdjust a line to a given width (cropping or padding as required). Args: segments (Iterable[Segment]): A list of segments in a single line. length (int): The desired width of the line. style (Style, optional): The style of padding if used (space on the end). Defaults to None. pad (bool, optional): Pad lines with spaces if they are shorter than `length`. Defaults to True. Returns: List[Segment]: A line of segments with the desired length. c38# UHoRv M g7frU)rR)r}ras rGr-Segment.adjust_line_length..tsBT'--TsrfNr)sumrrRrMr) rirwrrLr line_lengthrrrasegment_lengthrKrrs rGrSegment.adjust_line_lengthas&BTBB   3sf.B'CU#K"LL&# 7"! !H__FK!(!4!4/&8GOO7O1K-4*D( /CDD3t34 AwHrFc:^[m[U4SjU55$)zGet the length of list of segments. Args: line (List[Segment]): A line encoded as a list of Segments (assumes no '\\n' characters), Returns: int: The length of the line. c3J># UHupo3(aMT"U5v M g7frUr/)r}rKrLrM _cell_lens rGr*Segment.get_line_length..s St';tG7?9T??ts ##)rr)rirwrs @rGget_line_lengthSegment.get_line_lengths StSSSrFlinescr^URmU(a[U4SjU55OSnU[U54$)zGet the shape (enclosing rectangle) of a list of lines. Args: lines (List[List[Segment]]): A list of lines (no '\\n' characters). Returns: Tuple[int, int]: Width and height in characters. c34># UH nT"U5v M g7frUr/)r}rwrs rGr$Segment.get_shape..s@%$--%sr)rmaxrh)rir max_widthrs @rG get_shapeSegment.get_shapes3--DIC@%@@q 3u:&&rFwidthheight new_linesc 6U=(d [U5nU(aU"SU-S-U5/O U"SU-U5/nURnUSUn UV s/sH o"XUS9PM sn U SS&[U 5U:a!U RU/U[U 5- -5 U $s sn f)aSet the shape of a list of lines (enclosing rectangle). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style, optional): Style of any padding added. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. rfrvN)rL)rhrextend) rirrrrLr_heightblankr shaped_linesrws rG set_shapeSegment.set_shapes*&CJ1:Sut#U + ,C%KQV@W?X !33Xg EJ EJT t% 8U Q | w &   7S5F+F G H  sBricU[U5- nU(dUSS$USUnU(aU"SU-S-U5O U"SU-U5nX//U--nU$)aAligns lines to top (adds extra lines to bottom as required). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style): Style of any padding added. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. NrfrvrhrirrrrLr extra_linesrs rG align_topSegment.align_topsd*s5z) 8Ogv2;C%K$&.S5[RWAX K// rFcU[U5- nU(dUSS$USUnU(aU"SU-S-U5O U"SU-U5nU//U-U-nU$)aAligns render to bottom (adds extra lines above as required). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style): Style of any padding added. Defaults to None. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. Nrfrvrrs rG align_bottomSegment.align_bottomsf*s5z) 8Ogv2;C%K$&.S5[RWAX K'%/ rFcU[U5- nU(dUSS$USUnU(aU"SU-S-U5O U"SU-U5nUS-nXh- n U//U-U-U//U --nU$)aAligns lines to middle (adds extra lines to above and below as required). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style): Style of any padding added. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. Nrfrvr r) rirrrrLrrr top_lines bottom_liness rG align_middleSegment.align_middles*s5z) 8Ogv2;C%K$&.S5[RWAX1$ ".  I%-% L0HH rFc#:# [U5n[U5n[nUH`nURUR:Xa=UR (d,U"UR UR -UR5nMZUv UnMb Uv g![a gf=f7f)aSimplify an iterable of segments by combining contiguous segments with the same style. Args: segments (Iterable[Segment]): An iterable of segments. Returns: Iterable[Segment]: A possibly smaller iterable of segments that will render the same way. N)iternext StopIterationrIrLrMrK)riry iter_segments last_segmentrjras rGsimplifySegment.simplify&sX   .L$G!!W]]27??' %% 4l6H6H  #"& %   s( B B A1B BBBBc## UHNnUR(d URcUv M'Uup4nU"X4(aURS5OS5v MP g7f)zRemove all links from an iterable of styles. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with link removed. N)rMrL update_link)riryrarKrL_controls rG strip_linksSegment.strip_linksAsL G'--"7 (/%X$5 1 1$ 7dKK  rYc#<# UHup#nU"USU5v M g7f)zRemove all styles from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with styles replace with None Nr/)riryrKrQrMs rG strip_stylesSegment.strip_stylesRs%&. !D'dD'* *&.sc## 0nUHJup4nU(a1URU5nUcURnXbU'U"X6U5v M>U"USU5v ML g7f)zRemove all color from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with colorless style. N)get without_color)rirycacherKrLrMcolorless_styles rG remove_colorSegment.remove_color_s`%'$, D"'))E"2"*&+&9&9O#2%L$99$g..%-sAAcutsc## /nURn[U5n[US5nUS:XagUS:waO/v M SnURnURn [ n UHn U upnU (dMU(aUO Xz"U 5-nX:a U"U 5 UnM5X:Xa@U"U 5 U "5v U"5 Un[US5nUS:XaU(a U "5v gMzU R Xg- 5unn U upnU"U5 U "5v U"5 Un[US5nUS:XaU(a U "5v gU (aMM U "5v g7f)zDivides an iterable of segments in to portions. Args: cuts (Iterable[int]): Cell positions where to divide. Yields: [Iterable[List[Segment]]]: An iterable of Segments in List. reNr)rrrrcopyrrs)riryrsplit_segments add_segment iter_cutsrbrlsegments_clear segments_copyrrarKrQrMend_posrms rGdivideSegment.divideusd+-$++ J y"%CbyaxH '--&++ # G$+ !D'$!(#cIdO.C=(!C>('/)"$!Cy"-Cby)"//1'.&9&9#)&DOFG,3)D'''/)"$C9b)"9%+o-C$ JosA*E 0C E ;E r/)rNrI)NNF)NTT)NT)NNF)0r0r1r2r3r4str__annotations__rLr rrMr ControlCodepropertyrgrRrrWr[r\r_ classmethodrrrprsrwr rrr rrrrrrrrrrrrrrrrrEr/rFrGrIrI<s  I!E8E?!/3GXh{+ ,3 0S00v$(D((y-9-3-5AU;V--^,s,u-A'B,4"&&* &9%&&UO & )  &&P?D@ *@8<@ ) @@$8I#68DO;T8  * %Y-. /  < "&"& ,I9%,I,I ,I  ,I  ,I $y/ ",I,I\ "& *9o** *  * i **X T4 ? Ts T T 'd4 ?3 'c3h ' ' !%!% !DO$!! !  !  ! d9o !!F  )_DO$      d9o 8  )_DO$      d9o 8  )_DO$      d9o < 38K4L8I#6L8I;NLL  +HY$7 +HY><<>D==  )}} $ $sAAAA)rryrrrrrrNr) r0r1r2r3r4r rIr[rrrEr/rFrGrrsD#'!2#t#PT# %  %+; %  %rFrcP\rSrSrS S\\\S\SS4SjjrS Sjr Sr g) SegmentLinesirrrNNc0[U5UlX lg)aA simple renderable containing a number of lines of segments. May be used as an intermediate in rendering process. Args: lines (Iterable[List[Segment]]): Lists of segments forming lines. new_lines (bool, optional): Insert new lines after each line. Defaults to False. N)rrr)rPrrs rGrSegmentLines.__init__s%[ "rFc## UR(a6[R5nURHnUShvN Uv M gURH nUShvN M gN+N 7frU)rrIrwr)rPrrrrws rGrSegmentLines.__rich_console__sT >>||~H # #  s!:A,A(!A,A* A,*A,)rrrr) r0r1r2r3r r rIr[rrrEr/rFrGrrsC #htG}5 #$ #SW #     +;    rFr__main__)r)Syntax)Textzfrom rich.console import Console console = Console() text = Text.from_markup("Hello, [bold magenta]World[/]!") console.print(text)zHello, [bold magenta]World[/]!z rich.Segmentz]A Segment is the last step in the Rich render process before generating text with ANSI codes.z Consider the following code: pythonT) line_numberszRWhen you call [b]print()[/b], Rich [i]renders[/i] the object in to the following: zAThe Segments are then processed to produce the following output: zS You will only need to know this if you are implementing your own Rich renderables.N)7enumr functoolsr itertoolsroperatorrtypingrrr r r r r rrrcellsrrrrrreprrrrLrrrrrrrgrrrIrrr0 rich.console rich.syntaxr  rich.textr code from_markuprKruleprintrrender fragmentsr/rFrGrs!   $>>'* + +uS#X &' +sC  "  { j{  { |%%2  2 z$" D   < =DiG LL  MMg MM45 MM&xd;< MMO MM]W^^D)*I MM) MMO MMVW MM$ MM^;rF