+ NV-jd^RIHt^RIHt^RIHt^RIHt^RIH t H t H t H t H t HtHtHtHtHt^RIHtHtHtHtHt^RIHtHt^RIHt] 'd ^R IHtH t H!t!!R R ]4t"]]]",]]"]]#]$3,3,]]"]#]#3,3,t%]!4!R R ] 44t&!RR4t'!RR4t(])R8XEd ^RI*Ht^RI+H,t,^RI-H.t.Rt/].P`!R4t1]!4t]PeR4]PgR4]PgR4]Pg],!]/RRR74]Pg4]PgR4]4!]Pk]144t6]Pg]64]Pg4]PgR4]Pg]14]PgR 4R!#R!#)")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 RenderResultcZ]tRt^ tRt^t^t^t^t^t ^t ^t ^t ^ t ^ t^ t^ t^ t^t^t^tRtR#) ControlTypezDNon-printable control codes which typically translate to ANSI codes.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]/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/rich/segment.pyrr sYN DO D EKKIKNONMr5rca]tRt^r?s"r6r@rAXsvr5c#"VPxVPf!VPeVPxR#R#VPxVPxR#5iN)rDrFstylerCs&r6 __rich_repr__Segment.__rich_repr__XsGii << zz%jj &** ,, sAAc <V^8dQhRS[/#r:bool)r>r?s"r6r@rAas$r5c ,\VP4#)z#Check if the segment contains text.)rRrDrMs&r6__bool__Segment.__bool__asDIIr5c <V^8dQhRS[/#r:rQ)r>r?s"r6r@rAfs((D(r5c VPRJ#)z,Check if the segment contains control codes.N)rFrMs&r6 is_controlSegment.is_controles||4''r5c8<V^8dQhRRRS[RS[R,/#)r;segmentr8cutr<r8r8r=r)r>r?s"r6r@rAls(--9-3-5AU;V-r5c fVwr4p\pVPpW'8d W!RWE43#\p\W', \ V4,4p VRV p \ V 4p W, p V 'gV!WV4V!W9RWE43#V R8Xd@V!W9,4^8Xd-V!VRV R,WE4V!RW9^,R,WE43#V ^8XdGV!W9^, ,4^8Xd-V!VRV ^, R,WE4V!RW9R,WE43#W8d V ^, p KV ^,p K)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. N )r8rGrr=lenr) clsr[r\rDrLrF_SegmentrG cell_sizeposbeforecell_posout_bys &&& r6 _split_cellsSegment._split_cellsjsL 'W))  HR88 8+ 3$D 12$3ZF'H^FVG4T$Z8| $) 4 9T$3Z#-u>S4a ?2EC| $Qw- 8A =T)C!G_s2ECS4:-u>~qqr5c4<V^8dQhRS[RS[R,/#)r;r\r<r]r^)r>r?s"r6r@rAs!,,s,u-A'B,r5c Vwr#pV^8gQh\V4'd<V\V48dV\RW443#\VRVW44\W!RW443#VPW4#)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. r`N)rrcr8rk)rCr\rDrLrFs&& r6 split_cellsSegment.split_cellss} $Waxx !$ ' 'c$iWR888Tc E3T E3    ++r5c<V^8dQhRR/#)r;r<r8r)r>r?s"r6r@rAsYr5c V!R4#)zMake a new line segment. r)rds&r6line Segment.lines4yr5c n<V^8dQhRS[R,RS[S[,RS[S[,RS[R,/#)r;segmentsr8rL post_styler<)r r r)r>r?s"r6r@rAsE&&9%&&UO & )  &r5c |aaaTpV'dVPoVV3RlV4pS'dVV3RlV4pV#)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). c3\<"TF!wrpS!Y'dRMS!V4V4xK# R#5irKr).0rDrErFapplyrds& r6 &Segment.apply_style..s1-<)D'D'$uV}gFF-r?s"r6r@rAs4@@ *@8<@ ) @r5c fV'd\\R4V4#\\R4V4#)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. rF)filterrr)rdrwrXs&&&r6filter_controlSegment.filter_controls+ *Y/: :z)4h? ?r5cR<V^8dQhRS[R,RS[S[R,,/#r;rwr8r<)r r )r>r?s"r6r@rAs)8I#68DO;Tr5c# \".pVPpVFpRVP9djVP'gXVwrVpV'dIVPR4wrpV'dV!V!W44V 'gK<Vx.pVPpKPK}V!V4K V'dVxR#R#5i)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. rsNappendrDrF partition rdrwrtrr[rDrL__textnew_lines && r6 split_linesSegment.split_liness!Gw||#GOOO!(Q,0NN4,@)ETs501x" !!%w  J s6B, B,/B,:)B,$B,ch<V^8dQhRS[R,RS[S[S[R,S[3,,/#r)r rr rR)r>r?s"r6r@rAs5   * %Y-. / r5c# d".pVPpVFpRVP9dlVP'gZVwrVpV'dKVPR4wrpV'dV!V!W44V 'gK<VR3x.pVPpKRKV!V4K V'd VR3xR#R#5i)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. rsTFNrrs && r6split_lines_terminatorSegment.split_lines_terminators!Gw||#GOOO!(Q,0NN4,@)ETs501x#Tl*!!%w  -  s6B0 B0/B0:+B0& B0cz<V^8dQhRS[R,RS[RS[S[,RS[RS[RS[S[R,,/#)r;rwr8lengthrLpadinclude_new_linesr<)r r=r rrRr )r>r?s"r6r@rA3sa,I,I9%,I,I ,I  ,I  ,I $y/ ",Ir5c# ".pVPpVPpV!R4p VFp RV P9dV P'g}V wrp V 'dnV P R4wrp V'dV!V!W44V'gK<V!WbW4R7pV'dVPV 4VxVP 4KuKV!V 4K V'dV!WbW4R7xR#R#5i)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. rs)rLrN)radjust_line_lengthrDrFrclear)rdrwrrLrrrtrrnew_line_segmentr[rD segment_stylerrr cropped_lines&&&&&& r6split_and_crop_linesSegment.split_and_crop_lines2s*! 33t9Gw||#GOOO)0&Q,0NN4,@)ETs589x'9 ( -(//0@A** w! " $TH H sA C- C-/C-AC-C-c d<V^8dQhRS[R,RS[RS[S[,RS[RS[R,/#)r;rtr8rrLrr<r r=r rrR)r>r?s"r6r@rAbsI**9o** *  * i *r5c \RV44pWR8d4V'd W!RW%, ,V4.,pV#VR,pV#WR8d.pVPp^pVFfpVPp WY,V8gVP'dV!V4WY, pK@Vwrp \ WV, 4p V!V!W44V# V#VR,pV#)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"TFqPxK R#5irK)rG)r{r[s& r6r}-Segment.adjust_line_length..tsBT'--TsraNNN)sumrrGrFr) rdrtrrLr line_lengthrrr[segment_lengthrDrrs &&&&& r6rSegment.adjust_line_lengthas&BTBB   3sf.B'CU#K"LL&# 7"! !H__FK!(!4!4/&8GOOO7O1K-4*D( /CDD3t34 AwHr5c4<V^8dQhRS[R,RS[/#)r;rtr8r<)r r=)r>r?s"r6r@rAs# T T4 ? Ts Tr5c :a\o\V3RlV44#)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. c3L<"TFwrq3'dKS!V4xK R#5irKr)r{rDrLrF _cell_lens& r6r}*Segment.get_line_length..s St';tG7?9T??ts $$)rr)rdrtrs&&@r6get_line_lengthSegment.get_line_lengths StSSSr5cZ<V^8dQhRS[S[R,,RS[S[S[3,/#)r;linesr8r<)r rr=)r>r?s"r6r@rAs, ' 'd4 ?3 'c3h 'r5c taVPoV'd\V3RlV44M^pV\V43#)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<"TF pS!V4xK R#5irKr)r{rtrs& r6r}$Segment.get_shape..s@%$--%s)rmaxrc)rdr max_widthrs&& @r6 get_shapeSegment.get_shapes3--DIC@%@@q 3u:&&r5c<V^8dQhRS[S[R,,RS[RS[S[,RS[S[,RS[RS[S[R,,/#)r;rr8widthheightrL new_linesr<r)r>r?s"r6r@rAsa!!DO$!! !  !  ! d9o !r5c  hT;'g \V4pV'dV!RV,R,V4.MV!RV,V4.pVPpVRVp VU u.uF q!WVR7NK up V R&\V 4V8d*V PV.V\V 4, ,4V #uup i)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. rarsN)rLr)rcrextend) rdrrrrLr_heightblankr shaped_linesrts &&&&&& r6 set_shapeSegment.set_shapes*&&CJ1:Sut#U + ,C%KQV@W?X !33Xg EJ EJT t% 8U Q | w &   7S5F+F G H  sB/c<V^8dQhRS[R,RS[S[R,,RS[RS[RS[RS[RS[S[R,,/# r;rdr8rrrrLrr<rr r=rrR)r>r?s"r6r@rAe )_DO$      d9o r5c V\V4, pV'g VR,#VRVpV'dV!RV,R,V4MV!RV,V4pW..V,,pV#)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. rNrarsrcrdrrrrLr extra_linesrs&&&&&& r6 align_topSegment.align_topsd*s5z) 8Ogv2;C%K$&.S5[RWAX K// r5c<V^8dQhRS[R,RS[S[R,,RS[RS[RS[RS[RS[S[R,,/#rr)r>r?s"r6r@rArr5c V\V4, pV'g VR,#VRVpV'dV!RV,R,V4MV!RV,V4pV..V,V,pV#)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. rNrarsrrs&&&&&& r6 align_bottomSegment.align_bottomsf*s5z) 8Ogv2;C%K$&.S5[RWAX K'%/ r5c<V^8dQhRS[R,RS[S[R,,RS[RS[RS[RS[RS[S[R,,/#rr)r>r?s"r6r@rAse )_DO$      d9o r5c V\V4, pV'g VR,#VRVpV'dV!RV,R,V4MV!RV,V4pV^,pWh, p V..V,V,V..V ,,pV#)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. rNrarsr) rdrrrrLrrr top_lines bottom_liness &&&&&& r6 align_middleSegment.align_middles*s5z) 8Ogv2;C%K$&.S5[RWAX1$ ".  I%-% L0HH r5cB<V^8dQhRS[R,RS[R,/#rr )r>r?s"r6r@rA's% 38Kr5c# L"\V4p\V4p\pTFfpTPTP8XdCTP 'g1T!TP TP ,TP4pK`TxTpKh TxR# \dR#i;i5i)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 StopIterationr8rLrFrD)rdrw iter_segments last_segmentrer[s&& r6simplifySegment.simplify&sX   .L$G!!W]]27???' %% 4l6H6H  #"& %   s. B$ B7B$AB$ B!B$ B!!B$cB<V^8dQhRS[R,RS[R,/#rr)r>r?s"r6r@rABs)LL8I#6L8I;NLr5c# "VFQpVP'gVPfVxK)Vwr4pT!Y4'dVPR4MR4xKS R#5i)zRemove all links from an iterable of styles. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with link removed. N)rFrL update_link)rdrwr[rDrL_controls&& r6 strip_linksSegment.strip_linksAsN G'--"7 (/%X$5 1 1$ 7dKK  sAAcB<V^8dQhRS[R,RS[R,/#rr)r>r?s"r6r@rASs% + +HY$7 +HY"VFwr#pV!VRV4xK R#5i)zRemove all styles from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with styles replace with None Nr)rdrwrDrErFs&& r6 strip_stylesSegment.strip_stylesRs%&. !D'dD'* *&.scB<V^8dQhRS[R,RS[R,/#rr)r>r?s"r6r@rA`s%//HY$7/HYr?s"r6r@rAvs<BB *B2:3-B $y/ "Br5c# ".pVPp\V4p\VR4pVR8XdR#V^8wdM.xK$^pVPpVPp \ p VFp V wrpV 'gKV'dTM Wz!V 4,pW8d V!V 4TpK<W8XdDV!V 4V !4xV!4Tp\VR4pVR8XdV'd V !4xR#KV P Wg, 4wpp V wrpV!V4V !4xV!4Tp\VR4pVR8XgKV'd V !4xR# V !4xR#5i)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. Nrb)rrrrcopyrro)rdrwrsplit_segments add_segment iter_cutsr\rgsegments_clear segments_copyrr[rDrErFend_posrhs&&& r6divideSegment.divideusV+-$++ J y"%CbyaxH'--&++ # G$+ !D'$!(#cIdO.C=(!C>('/)"$!Cy"-Cby)"//1'.&9&9#)&DOFG,3)D'''/)"$C9b)"9%+o-G Jos&A-E4Er?s"r6r@rA<s9 I E?! h{+ ,3!r5ri@)NNF)NTT)NT)NNF)%rr r!r"r#rLrFpropertyrGrNrTrX classmethodrrkrortrrrrrrrrrrrrrrrrr__annotate_func__r4__classdictcell__r?s@r6r8r8<s$ "E/3G 00((y--^,,4&&&P@@@$8  <,I,I,I\***X T T ' '!!!F88<4LL  + +//*BBur5r8cLa]tRtRtoRtR V3RlRlltV3RlRltRtVtR#) Segmentsia)A simple renderable to render an iterable of segments. This class may be useful if you want to print segments outside of a __rich_console__ method. Args: segments (Iterable[Segment]): An iterable of segments. new_lines (bool, optional): Add new lines between segments. Defaults to False. c:<V^8dQhRS[S[,RS[RR/#)r;rwrr<N)r r8rR)r>r?s"r6r@Segments.__annotate__s(##'!2#t#PT#r5c2\V4VnW nR#rK)listrwr)rCrwrs&&&r6__init__Segments.__init__sX "r5c&<V^8dQhRRRRRR/#r;consoleroptionsrr<rr)r>r?s"r6r@rs% % %  %+; %  %r5c#"VP'd2\P4pVPF pVxVxK R#VPRjxL R#L5irK)rr8rtrw)rCrrrtr[s&&& r6__rich_console__Segments.__rich_console__sB >>><<>D==  )}} $ $sAAAA)rrwNr ) rr r!r"r#rrr4r rs@r6rrs## % %r5rcHa]tRtRtoRV3RlRlltV3RlRltRtVtR#) SegmentLinesicJ<V^8dQhRS[S[S[,,RS[RR/#)r;rrr<N)r r r8rR)r>r?s"r6r@SegmentLines.__annotate__s, # #htG}5 #$ #SW #r5c 2\V4VnW nR#)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)rCrrs&&&r6rSegmentLines.__init__s%[ "r5c&<V^8dQhRRRRRR/#rr)r>r?s"r6r@r!s%      +;    r5c#"VP'd8\P4pVPFpTRjxL VxK R#VPF pTRjxL K R#L-L 5irK)rr8rtr)rCrrrrts&&& r6rSegmentLines.__rich_console__sV >>>||~H # #  s!;A/A+"A/ A-! A/-A/)rrNr )rr r!r"rrr4r rs@r6rrs # #   r5r__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 rrrcellsrrrrrreprrrrLrrrrrrr=rrr8rrr rich.console rich.syntaxr( rich.textr)code from_markuprDruleprintrrender fragmentsrr5r6r<s!   $>>'* + +uS#X &' +sC  "  { j{  { |%%2  2 z$" D   < =DiG LL  MMg MM45 MM&xd;< MMO MM]W^^D)*I MM) MMO MMVW MM$ MM^;r5