Cj %SrSSKJr SSKrSSKJrJr SSKJr SSK J r J r J r J r Jr SSKrSSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SS KJr SSK J!r!J"r" SSK#J$r$ SSK%J&r& SSK'J(r( SSK)J*r* SSK+J,r, SSK-J.r.J/r/ SSK0J1r1 SSK2J3r3 SS K4Jr SSK5J6r6J7r7J8r8 /SQr9\S\:4r;S\\"5r?\R"S 5rA/S!QrBS"\>* ++cV\rSrSr%SrS\S'S\S'S\S'S SjrSS jrSS jrS r g )r$Rz0A style applied to a range of character offsets.intstartend Style | strstylec#d# URv URv SUR4v g7f)Nr>)r;r<r>selfs r5 __rich_repr__Span.__rich_repr__Zs'jjhhtzz!!s.0c<U(aUup#n[X#U-U5$U$)zExtend the span by the given number of cells. Args: cells (int): Additional space to add to end of span. Returns: Span: A span. r$)rAcellsr;r<r>s r5extend Span.extend_s'  $ EU{E2 2 r7czUS:a Uup#n[X!-=nS:aUOSX1-U5$Uup#n[X!-X1-U5$)zShift a span a given distance. Note that the start offset is clamped to 0. The end offset is not clamped, as it is assumed this has already been checked by the caller. Args: distance: Number of characters to move. Returns: New Span. rrE)rAdistancer;r<r>offsets r5_shift Span._shiftms] a< $ E%*%556:3>SX !% E(#.%@ @r7Nreturnzrich.repr.Result)rFr:rP'Span')rJr:rPrQ) __name__ __module__ __qualname____firstlineno____doc____annotations__rBrGrL__static_attributes__rNr7r5r$r$Rs%: J H " Ar7r$c \rSrSrSr/SQrSSSS.rSSSTS jjrSUS jr\ SVS j5r \ SUSj5r \ SWSj5r\ SXSYSjj5r\ SZSj5r\ S[S\Sjj5r\ S]S^Sjj5r\ S[S_Sjj5r\ SS S.S`Sjj5rSWSjrSaSjrSbSjrSbSjrScSjrSdSjrSeSjrSfSjrSSS S!S"S S S \R<4 SgS#jjrShS$jr SiS%jr!SVS&jr"SiS'jr#SjS(jr$\ SkS)j5r%\ SiS*j5r&\ SUS+j5r'\ SWS,j5r(\ SWS-j5r)SlS.jr*SmS/jr+SnS0jr,\ SoS1j5r-SpS2jr.SqSrS3jjr/SsS4jr0SSS5.StS6jjr1SuS7jr2SvS8jr3S S S9.SwS:jjr4SxSyS;jjr5SxSyS<jjr6SxSyS=jjr7SxSzS>jjr8S{S|S?jjr9S{S|S@jjr:S}S~SAjjr;SSSBjjr<SSSCjjr=\R|"5SDS 4SSEjjr?\R|"5S4SSFjjr@SGrASSHjrBSSIjrCSS S SJ.SSKjjjrDS[SSLjjrESSMjrFSSNjrGSSSOjjrHS SP.SSQjjrISRrJg )r#zText content with marked up spans. This object can be considered immutable, although it might update its internal state in a way that is consistent with immutability. )_text_spans _cell_lengthleftrightfull)r;r<justifyNTcU(aU(a [U5OUUlUc/OUUlX0lSUlSUlSUlSUlSUl[UR5S:*Ul g)z Initialize a Content object. Args: text: text content. spans: Optional list of spans. cell_length: Cell length of text if known, otherwise `None`. strip_control_codes: Strip control codes that may break output? N)Nr) r6r[r\r]_optimal_width_cache_minimal_width_cache _height_cache _divide_cache _split_cachelen _simplified)rAr3spans cell_lengthstrip_control_codess r5__init__Content.__init__sy$+>$  &D ). "5 '04!04!GP    t{{+q0r7cUR$Nr[r@s r5__str__Content.__str__s zzr7cbURHnURUR::dM g g)zCheck if the line is regular (spans.end > span.start for all spans). This is a debugging aid, and unlikely to be useful in your app. Returns: `True` if the content is regular, `False` if it is not (and broken). FT)rlr<r;)rAspans r5 _is_regularContent._is_regulars*JJDxx4::%r7cSSKJn /nURnS/SUR5QSUR5Q[ U5SS4PnUR [ SS5S 9 SnURnUH?upxn Xu:aU"U"X5U55 UnU (dM&U"U(aS U S 3OS U S 35 MA S RU5n U $)zGet the content markup that would create this Content instance. This is essentially the inverse of [`Content.from_markup`][textual.content.Content.from_markup]. Returns: str: A string potentially creating markup tags. r)escape)rFNc3R# UHoRSUR4v M g7fFN)r;r>.0rws r5 !Content.markup..s F+$zz5$**-+%'c3R# UHoRSUR4v M g7fTN)r<r>r~s r5rrs C{txxtzz*{rTNrdkeyz[/][rb) textual.markupr{plainr\rjsortrappendjoin) rAr{outputr markup_spanspositionrrKclosingr>markups r5rContent.markups *   F$++ F Dt{{ C Zt $  jA./&2 "FU veV456!uE7!}qq\B '3  r7c[$)zGet an empty (blank) content) EMPTY_CONTENT)clss r5empty Content.emptys r7c[U[5(aU$[U[5(a U(aURU5$U"U5$[U[5(aUR U5$[ S5e)a+Construct content from Text or str. If the argument is already Content, then return it unmodified. This method exists to make (Rich) Text and Content interchangeable. While Content is preferred, we don't want to make it harder than necessary for apps to use Text. Args: markup_content_or_text: Value to create Content from. markup: If `True`, then str values will be parsed as markup, otherwise they will be considered literals. Raises: TypeError: If the supplied argument is not a valid type. Returns: A new Content instance. zAThis method expects a str, a Text instance, or a Content instance) isinstancer#str from_markuprfrom_rich_text TypeError)rmarkup_content_or_textrs r5 from_textContent.from_textsu* ,g 6 6) ) . 4 4'=>>122 . 5 5%%&<= =S r7c Sn[U[5(aU(a [S5eU$[U5nSU;aU(d [U5$SSKJn U"X=(d SS9nU$)aCreate content from markup, optionally combined with template variables. If `markup` is already a Content instance, it will be returned unmodified. See the guide on [Content](../guide/content.md#content-class) for more details. Example: ```python content = Content.from_markup("Hello, [b]$name[/b]!", name="Will") ``` Args: markup: Content markup, or Content. **variables: Optional template variables used Returns: New Content instance. Tz4A literal string is require to substitute variables.rr) to_contentN)template_variables)rr# ValueErrorr6rr)rr variables_rich_traceback_omitrcontents r5rContent.from_markup s`* $ fg & & !WXXM%f- f Y6? "-V8ITJr7c[U[5(a[R"U5nSnUb URnO,[ R "5nURRnUR(a[ R "5RnURVVVs/sHYupgn[UU[U[5(a[R"U"U5U5O[R"X55PM[ n nnnO/n U"UR U 5n UR"(a{[ R "5RnU R%[UR"[5(a UR"O [R"UR"U55n U $![a [RnGNff=f![a SnGNHf=fs snnnf![a SnNf=f)zCreate equivalent Visual Content for str or Text. Args: text: String or Rich Text. console: A Console object to use if parsing Rich Console markup, or `None` to use app default. Returns: New Content. N)rrrr get_stylergetconsole LookupError RichStyleparser\ ansi_themer$rfrom_rich_stylerr>stylize_before) rr3rrrappr;r<r>rlrs r5rContent.from_rich_text.s dC ##D)D+/  ))I 2 nn& KK11 ;; "'^^-88 *. *5%E&eS11--i.> K"225E *5  EEdjj%( :: "'^^-88 ,,djj#.. **4::zBG K ,%OO  , "!  " ( "!  "s<F3<G+A G'7G.3GG G$#G$. G=<G=c nU(d[$U"UU(a[S[U5U5/OSUUS9nU$)aCreate a Content instance from text and an optional style. Args: text: String content. style: Desired style. cell_length: Cell length of text if known, otherwise `None`. strip_control_codes: Strip control codes that may break output. Returns: New Content instance. rNrn)rr$rj)rr3r>rmrn new_contents r5styledContent.styledms?&  +0T!SY & 'd  3  r7c^U(d[$U"SU-U(a [SX5/OSUS9nU$)zGet a Content instance consisting of spaces. Args: width: Width of blank content (number of spaces). style: Style of blank. Returns: Content instance.  rNrm)rr$)rwidthr>blanks r5r Content.blanks9  %K',T!U " #$   r7)r<rnc /n/n[nURnSnUGHn [U [5(aU"U 5 U[ U 5- nM1[U [ 5(aGU upU"U 5 U (a$URU"X[ U 5-U 55 U[ U 5- nM[U [ 5(dMU"U R5 U R(a?URU RV VV s/sHupn U"X-X-U 5PM sn nn 5 U[ U R5- nGM! W(aU"U5 U"SRU5XRS9nU$s sn nn f)aConstruct new content from string, content, or tuples of (TEXT, STYLE). This is an efficient way of constructing Content composed of smaller pieces of text and / or other Content objects. Example: ```python content = Content.assemble( Content.from_markup("[b]assemble[/b]: "), # Other content "pieces of text or content into a", # Simple string of text ("a single Content instance", "underline"), # A tuple of text and a style ) ``` Args: *parts: Parts to join to gether. A *part* may be a simple string, another Content instance, or tuple containing text and a style. end: Optional end to the Content. strip_control_codes: Strip control codes that may break output. rrbr) r$rrrrjtupler#rrlrGr)rr<rnpartsr3rl_Span text_appendrpart part_text part_styler;r>assembled_contents r5assembleContent.assemblesC6kk D$$$D!CI%D%(((,% I&LLh3y>(A:NC N*D'**DJJ'::LL6:ZZ5? 1E"%"2CNEJ5? C O++,    GGDM5 ! s=E%cUR=n(aUR(aU$[SSS5n/nSnUH}nURUR:XaMUR UR :Xa3[URURUR 5=o#S'SnMjUR U5 UnM U(aX0RSS&SUlU$)arSimplify spans by joining contiguous spans together. This may produce faster renders if you have concatenated a large number of small pieces of content with repeating styles. Note that this modifies the Content instance in-place, which might appear to violate the immutability constraints, but it will not change the rendered output, nor its hash. Returns: Self. r&rbFTN)r\rkr$r;r<r>r)rArl last_span new_spanschangedrws r5simplifyContent.simplifys$$)9)9KR$ " DzzY]]*tzzY__/L,0$((DJJ,WW bM  &  &KKN r7cpU(a.[UR/URQUQURSS9$U$)znAdds spans to this Content instance. Args: spans: A sequence of spans. Returns: A Content instance. Fr)r#rr\r])rArls r5 add_spansContent.add_spanss?  &$++&&!!$)    r7c[U[5(aURU:H$[U[5(aURUR:H$[$)z:Compares text only, so that markup doesn't effect sorting.rrrr#NotImplementedrAothers r5__eq__Content.__eq__ sD eS ! !::& & w ' '::, ,r7c[U[5(aURU:$[U[5(aURUR:$[$rrrrs r5__lt__Content.__lt__sD eS ! !::% % eW % %:: + +r7ctXLagURUR:wagURUR:H$)amCompare to another Content object. Two Content objects are the same if their text *and* spans match. Note that if you use the `==` operator to compare Content instances, it will only consider the plain text portion of the content (and not the spans). Args: content: Content instance. Returns: `True` if this is identical to `content`, otherwise `False`. TF)rrlrArs r5is_sameContent.is_sames2 ? :: &zzW]]**r7cURc3[SURRS555=UlnO URnX1R SS5S--$)a`Get optimal width of the Visual to display its content. The exact definition of "optimal width" is dependant on the Visual, but will typically be wide enough to display output without cropping or wrapping, and without superfluous space. Args: rules: A mapping of style rules, such as the Widgets `styles` object. Returns: A width in cells. c38# UHn[U5v M g7frrr)rlines r5r,Content.get_optimal_width..=s4+A4+As line_padr)remaxrsplitr)rArulescontainer_widthrs r5get_optimal_widthContent.get_optimal_width.sf  $ $ ,034+/::+;+;D+A41 D %--EyyQ/!333r7cURR5(dgURc2[SURR 555=UlnO URnX!R SS5S--$)z)Minimal width is the largest single word.rc3# UH?nUR5H'nUR5(dM[U5v M) MA g7frr)rstripr)rrwords r5r,Content.get_minimal_width..Is;43D JJLD::<(3s -A A rr)rrrfr splitlinesr)rArrs r5get_minimal_widthContent.get_minimal_widthDsxzz!!  $ $ ,034 JJ11341 D %--EyyQ/!333r7cURnU"SS5S-nU"SS5nU"SS5S:HnX$-XV4nURSU:XaURS nU$URRX$- XVS 9n [ U 5nXx4UlU$) zGet the height of the Visual if rendered at the given width. Args: rules: A mapping of style rules, such as the Widgets `styles` object. width: Width of visual in cells. Returns: A height in lines. rrr text_overflowfold text_wrapwrapnowraprd)overflowno_wrap)rrg without_spans_wrap_and_formatrj) rArrget_rulerrr cache_keyheightliness r5 get_heightContent.get_heightSs99J*Q.OV4;/8;%x9   a I -''*F &&77 88EZF"+!4D  r7rFrr+c j/n Ub URn OSSjn [URSS95GHupU bURU 5nUb>U "U 5=nb3UunnUS:Xa[ UR 5nURUUU5nUR U5nU(avUS:XaO[[SURU55SSnURU5Vs/sHn[XXUS 9PM nnGOURXS :HS 9n[XXUS 9nU/nO[XXUS 9n[UR XS -- US:HS 9nURRU5nUS :Hn[U5VVs/sH;unnU(aURUUS 9OUR!5RUUS 9PM= nnn[#US/UQ5VVs/sH2unn[U UR%U5R'XU5UUU US9PM4 nnnSUSlU R+U5 GM U $s snfs snnfs snnf)akWraps the text and applies formatting. Args: width: Desired width. align: Text alignment. overflow: Overflow method. no_wrap: Disabled wrapping. tab_size: Cell with of tabs. selection: Selection information or `None` if no selection. selection_style: Selection style, or `None` if no selection. Returns: List of formatted lines. NcgrrrN)ys r5get_span*Content._wrap_and_format..get_spansr7T) allow_blankr&rrrd)r alignellipsisrr)r)r)r r:rPztuple[int, int] | None)r  enumeraterstylizerjr expand_tabslistrangermdivide_FormattedLinetruncater rrrstripzip rstrip_endpadline_endrG)rArrrrrtab_size selectionselection_style post_styler output_linesr r rrwr;r<cuts new_lines content_lineoffsets divided_linesrlastrrKs r5rContent._wrap_and_formatls6.0   ))H !!=>GA%||J/* 0C/P! s"9djj/C||OUC@##H-Dv%a)9)95 AB12FD%)KK$5!$5D'y%P$5!I  ==Z9O=PD#1!5$L".I-iuQVW %JJ1 48v;M!- 4 4 ; ;G D #z1'0 &> ! '? d  eh ?![[]33EH3MN'? !$,/}qm7m+L ,M#!**5155hI# ,M *. " &    *m?pS!"! sH$/AH)9H/c jU(d/$URRnURUU"SS5U"SS5U"SS5S:HU"SS 5S URURUR UR S 9 nUbUS UnUVs/sHn[URU56PM nnU$s snf) a-Render the Visual into an iterable of strips. Part of the Visual protocol. Args: width: Width of desired render. height: Height of desired render or `None` for any height. style: The base style to render on top of. options: Additional render options. Returns: An list of Strips. text_alignr^rrrrrrrr+) rrrrrrr r!rN) rrrrr r!rrto_strip) rArrr>optionsrrr strip_liness r5 render_stripsContent.render_stripssI==$$%% <0ov6[&1X=j!,''#33))''&    '6NE@EFudmmE23 FGs !B0c,[UR5$rr)rjrr@s r5__len__Content.__len__s4::r7c URS:g$)Nrbrsr@s r5__bool__Content.__bool__szzRr7c,[UR5$rr)hashr[r@s r5__hash__Content.__hash__sDJJr7c#l# URv SUR/4v g![a gf=f7f)Nrl)r[r\AttributeErrorr@s r5rBContent.__rich_repr__s6 ** 4;;* *   s4$4 1414cUR$)zA sequence of spans used to markup regions of the content. !!! warning Never attempt to mutate the spans, as this would certainly break the output--possibly in quite subtle ways! )r\r@s r5rl Content.spanss{{r7chURc[UR5UlUR$)zThe cell length of the content.)r]rrr@s r5rmContent.cell_length s-    $ ( 4D    r7cUR$)z Get the text as a single string.rsr@s r5r Content.plainszzr7chUR(a [UR/URSS9$U$)zThe content with no spansFr)r\r#rr]r@s r5rContent.without_spanss, ;;4::r4+<+[n[TRUTRVVVs/sH"up#nX0s=:aU:dMO MU"SSU5PM$ snnnSS9nU$s snnnf)NrrdF)rlrn)r$r#rr\)rKrr;r<r>rrAs r5 get_text_at(Content.__getitem__..get_text_at'ssE 6".2[[-8)E,u,','E!Q&-8 %*GNsAAArdrFrz%slices with step!=1 are not supported)rKr:rPz 'Content') rr:indicesrjrr# _trim_spansr\r<rLr) rAslicerLr;stopstepr3sliced_contentrwrls ` r5 __getitem__Content.__getitem__&s*  eS ! !u% % % c$**o > EqyA:s4::.# ::et,D%,((t{{;,1&N&% ::e1D%)KK$/D88e+a/, UF+$/ &-d..t;QV&N&%  GHHs D!"D!c[U[5(a"[URU-URSS9$[U[5(a[ UR 5n[UR UR -URURVVVs/sHup4n[X2-XB-U5PM snnn-URbS5nU$URUR-5nU$[$s snnnf)NFr) rrr#r[r\rjrr$r]rmr)rArrKr;r<r>rs r5__add__Content.__add__Ss eS ! !4::-t{{PUV V eW % %_F U[[(KK271=-EU^S\5A1=((4GN**U->->>GNsC8cT[U[5(d[$[U5U-$rr)rrrr#rs r5__radd__Content.__radd__js$%%%! !u~$$r7c [U5n[nUVs/sHXnURU:dMURU:aUO0U"UR[ X5R5UR 5PMZ nnU$s snf)z=Remove or modify any spans that are over the end of the text.)rjr$r;r<minr>)rr3rl max_offsetrrws r5rOContent._trim_spansosY   zzJ& N88j(4::s:xx'@$**MN    s A9AA9c[U[5(aL[URU3URUR cSSS9$UR [ U5-SS9$[RX/5$)zAppend text or content to this content. Note this is a little inefficient, if you have many strings to append, consider [`join`][textual.content.Content.join]. Args: content: A content instance, or a string. Returns: New content. NFr) rrr#rr\r]rrrrs r5rContent.appends gs # #::,wi( ((0%*   **Xg->>$)  !!4/22r7cJUR[RX55$)zAppend text give as a string, with an optional style. Args: text: Text to append. style: Optional style for new text. Returns: New content. )rr#r)rAr3r>s r5 append_textContent.append_texts{{7>>$677r7c^^^ ^ /n/nSUU4SjjnURnURnSm [m TRnU"5HunU(dM U"UR5 U"U U 4SjUR55 T [ UR5- m UcMXURcSO XxR-nMw [ SRU5X75$)a@Join an iterable of content or strings. This works much like the join method on `str` objects. Self is the separator (which maybe empty) placed between each string or Content. Args: lines: An iterable of other Content instances or or strings. Returns: A single Content instance, containing all of the lines. c3># TR(aE[T5H5up[U[5(aUO [USS9v U(aM1Tv M7 gTH&n[U[5(aUO [USS9v M( g7f)z6Iterate the lines, optionally inserting the separator.FrN)rrrr#)r(rrrAs r5 iter_content"Content.join..iter_contents|zz"+E"2JD&dG44$TuE  4" #3"D&dG44$TuE"s A B6Brc3\># UH!upnU(dMT"TU-TU-U5v M# g7frrrN)rr;r<r>rrKs r5rContent.join..s6)7%E;funfslE::)7s,,Nrb)rPzIterable[Content])rGr$r]r[r\rjr#r) rArr3rlrg extend_text extend_spanstotal_cell_lengthrrrKs `` @@r5r Content.joins  &kk || (,(9(9#~G  & )0  c'--( (F ,++3*-A-AA"&"rwwt}e??r7)rrcjURXU5nUVs/sHoURPM nnU$s snf)aWrap text so that it fits within the given dimensions. Note that Textual will automatically wrap Content in widgets. This method is only required if you need some additional processing to lines. Args: width: Maximum width of the line (in cells). align: Alignment of lines. overflow: Overflow of lines (what happens when the text doesn't fit). Returns: A list of Content objects, one per line. )rr)rArrrrr content_liness r5r Content.wraps7 %%eH=278%$% 89s0cU(dU/$URn/nSn[US5nX$XA-nU(dU$[U5nXa:aURXXA-5 U$Xa:Xa%URXXA-5 U[ U5- nMcXa- nUS-=n(a"U[XX*S5-nUS[ U5U- nXa:aU[US5-nUSSnXa:aMURXU[ U5-5 U[ U5- nM)aFold this line into a list of lines which have a cell length no less than 2 and no greater than `width`. Folded lines may be 1 less than the width if it contains double width characters (which may not be subdivided). Note that this method will not do any word wrapping. For that, see [wrap()][textual.content.Content.wrap]. Args: width: Desired maximum width (in cells) Returns: List of content instances. rrNr&)rrrrrj) rArr3rrsnipsnip_cell_length extra_cells start_snips r5r Content.foldsG6Mzz!E1 8#34D, + (~ ' TX-=>?" ! ( TX-=>?CI%*2K(A--z- HT+,-?$@@ 4c$i*45"* HT"X$66 CRy#* LLCI)=> ? D !H/r7cUS:a[U5U-n[5nURHup4nXAs=:aU:dMO MX%- nM U$)zGet the style of a character at give offset. Args: offset (int): Offset into text (negative indexing supported) Returns: Style: A Style instance. r)rjrr\)rArKr>r;r< span_styles r5get_style_at_offsetContent.get_style_at_offset#sP A:Y'F&*kk "E $u$$#'2 r7)rrcURnXA:XaU$URnURnU(a'XA:a"X- nURSU-3n[XVUSS9$XA:agU(a$U(a[ URUS- 5S-nO[ URU5nUR XPR5n[XVUSS9$U$)zTruncate the content at a given cell width. Args: max_width: The maximum width in cells. ellipsis: Insert an ellipsis when cropped. pad: Pad the content if less than `max_width`. Returns: New Content. rFrrdu…)rmrr\r#r rO)rA max_widthrrlengthr3rlspacess r5rContent.truncate6s$!!  Kzz  6%'Fjj\#,0D4 uM M  I$TZZQ?%G$TZZ;$$T;;7E4 uM MKr7c 0[U5S:XdS5eU(aqX!-UR3n[nURVVVs/sHupVnU"XQ-Xa-U5PM nnnn[ UUUR cSOUR U-SS9n U $U$s snnnf)zPad the left with a given character. Args: count (int): Number of characters to pad. character (str, optional): Character to pad with. Defaults to " ". rd&Character must be a string of length 1NFrrjrr$r\r#r]) rAcount characterr3rr;r<r>rlrs r5pad_leftContent.pad_left\s9~"L$LL" '( 5DE*.)4%EemS[%8)4 ))1t7H7H57P$) G N sBc &U(aURn[U5n[UX!-3URVs/sH&nURU:XaUR U5OUPM( snUR cSSS9$UR U-SS9$U$s snf)zAdd repeating characters (typically spaces) to the content with the style(s) of the last character. Args: count: Number of spaces. character: Character to add with. Returns: A Content instance. NFr)rrjr#r\r<rGr])rArrr plain_lenrws r5 extend_rightContent.extend_rightus JJEE I')+,-!%  +,088y+@T[['dJ +))1$)  8<7H7H57P$)  s-B c[U5S:XdS5eU(aE[URX!-3URURcSSS9$URU-SS9$U$)zPad the right with a given character. Args: count (int): Number of characters to pad. character (str, optional): Character to pad with. Defaults to " ". rdrNFr)rjr#rr\r])rArrs r5 pad_rightContent.pad_rights|9~"L$LL" ::,y012 ))1$)  8<7H7H57P$)    r7c t[U5S:XdS5eU(dU(aX1-URX2-3n[nU(a0URVVVs/sHupgnU"Xa-Xq-U5PM n nnnO URn [ UU UR cSOUR U-U-SS9n U $U$s snnnf)aPad both the left and right edges with a given number of characters. Args: left (int): Number of characters to pad on the left. right (int): Number of characters to pad on the right. character (str, optional): Character to pad with. Defaults to " ". rdrNFrr) rAr^r_rr3rr;r<r>rlrs r5r Content.pads9~"L$LL" 5&' |I4E3FGDE.2[[-8)E%, E:-8  ))1t7H7H47ORW7W$) G N sB3cUR5RXS9nXR- S-nX- nURXE5nU$)zAlign a line to the center. Args: width: Desired width of output. ellipsis: Insert ellipsis if content is truncated. Returns: New line Content. rr)rrrmr)rArrrr^r_s r5centerContent.centersJ++-(((B+++1 ++d*r7czUR5RXS9nURXR- 5nU$)zAlign a line to the right. Args: width: Desired width of output. ellipsis: Insert ellipsis if content is truncated. Returns: New line Content. r)rrrrm)rArrrs r5r_ Content.rights;++-(((B""5+>+>#>?r7c [UR5U- n[nURVs/sHXnURU:dMUR U:aUO0U"UR[ X$R 5UR5PMZ nnURSU*nURcSOURU- n[XeUSS9$s snf)zRemove a number of characters from the end of the text. Args: amount: Number of characters to crop. Returns: New Content NFr) rjrr$r\r;r<r]r>r]r#)rAamountr^rrwrlr3r~s r5 right_cropContent.right_crops_v-   $zzJ& N88j(4::s:xx'@$**MN$  zz(F7#**28I8IF8RtFFF s CACc U(dU$[U5nUS:aXB-nUcUnUS:aXC-nX$:dX2::aU$[URUR[ X$U:aUOUU5/-UR SS9$)aRApply a style to the text, or a portion of the text. Args: style (Union[str, Style]): Style instance or style definition to apply. start (int): Start offset (negative indexing is supported). Defaults to 0. end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None. rFr)rjr#rr\r$r]rAr>r;r<r~s r5rContent.stylizesKT 19NE ;C 7,C ?clK JJ KK4#v3NO O    %   r7cU(dU$[U5nUS:aXB-nUcUnUS:aXC-nX$:dX2::aU$[UR[X$U:aUOUU5/URQUR SS9$)aApply a style to the text, or a portion of the text. Styles applies with this method will be applied *before* other styles already present. Args: style (Union[str, Style]): Style instance or style definition to apply. start (int): Start offset (negative indexing is supported). Defaults to 0. end (Optional[int], optional): End offset (negative indexing is supported), or None for end of text. Defaults to None. rFr)rjr#rr$r\r]rs r5rContent.stylize_beforesKT 19NE ;C 7,C ?clK JJ %C<S% @ O4;; O    %   r7rc #j^^^^^^^# UR(dURU4v U(aX!4v gTcS SjnUnO 0mS UU4SjjnUn[[URS55nUVVs0sHCupxU[ UR [ 5(aU"UR 5O UR _ME snnmUTS'URn S/SU5QSU5Q[U 5S S4Pn U R[SS5S 9 /mTRn TRn 0mTRm[RmS UUUUU4S jjn [!XSS5H:uupnun nU(a U "U5 OU "U5 UU:dM-XUU "54v M< U(aX!4v ggs snnf7f)aRender Content in to an iterable of strings and styles. This is typically called by Textual when displaying Content, but may be used if you want to do more advanced processing of the output. Args: base_style: The style used as a base. This will typically be the style of the widget underneath the content. end: Text to end the output, such as a new line. parse_style: Method to parse a style. Use `App.parse_style` to apply CSS variables in styles. Returns: An iterable of string and styles, which make up the content. Nc[U[5(aU$[R"U5nU$![a [R"5nU$f=f)zThe default get_style method.)rrr Exceptionnull)r> visual_styles r5 _get_style"Content.render.._get_styleOsQeU++ L0#(;;u#5L$#!0#(::TRU5=nbU$T"U5=TU'nU$rr)r)r> cached_style_style_parse_style_cache parse_styles r5rr^s9$6$:$:5$AALN''5@5GG"5)F r7rdr)rFrc3D# UHupURSU4v M g7fr})r;rrGrws r5r!Content.render..rs M[[T55nT"U5=nbU$UVs/sHnT UPM nnT"U5=nTU'U$s snf)z#Construct current style from stack.)rsorted) rr _style_idstyles current_stylecombinestack style_cachestyle_cache_get style_maps r5get_current_style)Content.render..get_current_styles_fUm,I / :: G##z str | StylerPr)rPr)r\r[rrrr>rrrjrrrremoverrrr)rA base_styler<rrrenumerated_spansrGrwr3rl stack_append stack_poprrKleavingstyle_id next_offset_rrrrrrs ` @@@@@@r5renderContent.render1s*{{::z* *o%    $#I"$    #I $++q 9: 0   0  )3DJJ)D)D $**%$** U 0  " ! zz  MC F3%F3c[nURX5VVs/sH upEU"XE(a UROS5PM" nnnU$s snnf)zRender the Content in to a list of segments. Args: base_style: Base style for render (style under the content). Defaults to Style.null(). end: Character to end the segments with. Defaults to "". Returns: A list of segments. N)rr rich_style)rArr<_Segmentr3r>segmentss r5render_segmentsContent.render_segmentssS ${{:; ;  TE,,4 A;    s'AcNSSKJn U"UR[5S55$)z-Allow Content to be rendered with rich.print.r)Segmentsr) rich.segmentrrr)rArs r5__rich__Content.__rich__s),,UWd;< start_lineend_lineline_norr new_startnew_ends r5rContent.dividesW6M/zz7G7SY783~ab/ABC 7BC{T_{ C5>?YTWT4(Y ?{{ 8AB ++ B    /  )Z5   X6'27';$ H: #:; h3X 5JKY&!'*5GU+KL 70+D? CsD<.EE)include_separatorr c^^ T(dS5eURm TT ;aU/$TX#4nURc[S5UlURRU5=nbUR 5$U(aYUR [ R"[ R"T5T 5Vs/sHofR5PM sn5nOJSUU 4SjjnUR [U"555V s/sHn U RT:wdMU PM nn U(d&T RT5(aUR5 XpRU'U$s snfs sn f)aSplit rich text into lines, preserving styles. Args: separator (str, optional): String to split on. Defaults to "\\n". include_separator (bool, optional): Include the separator in the lines. Defaults to False. allow_blank (bool, optional): Return a blank line if the text ends with a separator. Defaults to False. Returns: List[Content]: A list of Content, one per line of the original. zseparator must not be emptyrc3># [R"[R"T5T5HnUR5ShvN M gN 7frr)refinditerr{rw)match separatorr3s r5 flatten_spans$Content.split..flatten_spans1s7[[9)=tDE$zz|++E+sAAA A)rPz Iterable[int]) rrirrcopyrrrr{r<rendswithpop) rArrr rrrrrrr3s ` @r5r Content.splits8"777yzz D 6M 1?    $ )! D !..229= =M J %%' ' KK*,++bii 6JD*QR*Q*QRE  , , !KK]_(=>>D::*>  t}}Y77 IIK',)$ %Ss4E?E!E!cURRU5n[X RX R55$)z"Strip characters from end of text.)rrr#rOr\)rAcharsr3s r5rContent.rstripAs0zz  't--dKK@AAr7c[U5nX!:aZX!- n[RUR5nUb4[UR S55nUR [ XS55$U$)zvRemove whitespace beyond a certain width at the end of the text. Args: size (int): The desired size of the text. r)rj_re_whitespacesearchrgrouprr])rAsizerexcesswhitespace_matchwhitespace_counts r5rContent.rstrip_endFsg $i   'F-44TZZ@ +#&'7'='=a'@#A s+;'DEE r7cpUS::aU$URnSU-nU(ad[U5nUVs/sH&nURU:aURU5OUPM( nn[ UR U-X R U-5$[ UR U-URUR5$s snf)zExtend the Text given number of spaces where the spaces have the same style as the last character. Args: spaces (int): Number of spaces to add to the Text. Returns: New content with additional spaces at the end. rr)r\rjr<rGr#r[rmr])rArrl new_spaces end_offsetrws r5 extend_styleContent.extend_styleUs Q;K 6\ TJ"!D(,xx:'= F#4G! 4:: 2E;K;Kf;TU UtzzJ. T=N=NOO s-B3cSUR;aU$UR(d$[URRU55$/nURnUR SSS9HnSUR;a U"U5 MSnUR SSS9nUHnURR S5(ad[URSSS-URUR5nXWR- nXQ-nU(aX- n URU 5nXY- nOXWR- nU"U5 M M [RU5n U $) z\Converts tabs to spaces. Args: tab_size (int, optional): Size of tabs. Defaults to 8.  rTrrNr&r) rr\r# expandtabsrrrr[r]rmrrr) rArnew_textrr cell_positionrr tab_remainderrrs r5rContent.expand_tabsks6 tzz !K{{4::00:; ;"$JJttJrrl append_spanrr re_highlightrrr;r<s r5rContent.highlight_regexs"!KK,,.ll   os + +::o6L*L!**51EJE{E%e45".#ai'U>2tzz56G6GHHr7) r]rhrgrfrerkr\rir[)rbNNT) r3rrlzlist[Span] | Nonerm int | NonernboolrPNonerPr)rPr)rPr#)T)rr%rrrPr#)rz str | ContentrobjectrPr#rr)r3z str | TextrzConsole | NonerPr#)rbNT) r3rr>r=rmrrnrrPr#)rr:r>zStyle | str | NonerPr#)rz'str | Content | tuple[str, str | Style]r<rrnrrPr#)rlSequence[Span]rPr#)rrrPr)rr#rPr)rr rr:rPr:)rr rPr:)rr rr:rPr:)rr:rrrrrrrr:rr:rzSelection | Noner  Style | Noner!rrCallable[[str | Style], Style]rPzlist[_FormattedLine]) rr:rrr>rr-rrPz list[Strip])rPr:rO)rPr)rPz int | slicerPr#)r Content | strrPr#)rrrPr#)r3rrl list[Span]rPr")rr!rPr#)rb)r3rr>r=rPr#)rzIterable[Content | str]rPr#)rr:rrrrrP list[Content])rr:rPr#)rKr:rPr)r}r:rrrPr#)r)rr:rrrPr#)r^r:r_r:rrrPr#)F)rr:rrrPr#)rd)rr:rPr#)rN)r>r=r;r:r<rrPr#)rrr<rrz%Callable[[str | Style], Style] | NonerPzIterable[tuple[str, Style]])rrr<rrP list[Segment])r&ztuple[int, ...]rPzlist[tuple[Span, int, int]])r&z Sequence[int]rPr#)r)rrrrr rrPr#)rz str | NonerPr#)rr:rPr#)rr:rPr#)r+)rr:rPr#)rzre.Pattern[str] | strr>r=rrrPr#)KrRrSrTrUrV __slots___NORMALIZE_TEXT_ALIGNrortpropertyrxrr classmethodrrrrrrrrrrrrrrrrrrr/r2r5r9rBrlrmrrrHrTrWrZrOrrcrrrrzrrrrrrr_rrrrrrrrrrrrrrrrXrNr7r5r#r#sR4I&,WP#'"&$( 1 1! 1 1 " 1  1D  >AE %0 :>    DB9=<<(6< <<| "&$(   "   8&$( ;!7;!;!" ;!  ;!;!z<$+&4, 48"!'&*(,#'49KK\\\ \  \  \\$\&\!\2\ \|$$",$5:$ER$ $L  !! .. +IZ.%   30 8;@|17QW$-BN (-^. $$  $  $L20": G4EI   ), 7A  @          H"JJL=A `"`"`"; `" % `"F#(**,258 &= 7r(X0#(! 00 0  0  0dB P,&Z*. #I.#I #I ' #I  #I#Ir7c\rSrSrSrS S Sjjr\S Sj5rS SjrS Sjr Sr g)rizA line of content with additional formatting information. This class is used internally within Content, and you are unlikely to need it an an app. Nc dXlX lX0lX@lXPlX`lXplXlgrr)rrrxr rr link_style) rArrrr+r rrr,s r5ro_FormattedLine.__init__s,#    $r7c.URR$rr)rrr@s r5r_FormattedLine.plains||!!!r7c [nURnURnS=pVURnURnUR n UR n US;dUS:XaUR(aGOUS:Xa#X@RR- n U S-nX- nGOhUS;aX@RR- nGOHUS:XGaAURSSS 9n [S U 55n [U 5S - nS /U-nSnU(aDX-U:a<U[U5U- S - ==S - ss'US - nUS -[U5-nX-U:aM</nURnURn[U 5HunnURUS U S 9H8unnU"U"UUU-RX555 U[U5S -- nM: U[U5:dMdUU=n(dMrU"U"SU-UW-R 55 M UU4$U(a$[SU-UR"R 5/O/nURnURUS U S 9H5unnU"U"UUU-RX555 U[U5- nM7 U(a/URU"SU-UR"R 55 UURU-U-4$)Nr)r;r^rarr)r<r_rFr c3j# UH)n[URRS55v M+ g7f)rN)rrr)rrs r5r*_FormattedLine.to_strip..s'P%$Xdjj&7&7&<==%s13rdrb)r<r)rrrrr+r rrrmrsumrjrrrrich_style_with_offsetrbackground_style)rAr>rrrrrrr+r r excess_spacewords words_size num_spacesrrGr add_segmentrr3 text_stylers r5r,_FormattedLine.to_strips    ,, FF FFNN % %%9*<  h  <<#;#;;L#q(H$/I & &||777H i MM#M?EP%PPJUaJS:%FE -53v;.23q83!OJ"QY#f+5E!-5 ')H"//KA(/ t(, ry)4)$D*   5:#5"M"Ma"S TQ&A)3v;&6%=,@C,@sUZ5G4S4S TU 0U? "S8^U%;%;%F%F G H  oo 'u") T D*  2JJ1PQ  TNA !U  OOy%*@*@*K*KL '--89DEEr7c [nUVVVs/sH8upEnUcM U"UURcUOSUR;aXQ-OUU5PM: nnnnU$s snnnf)Nz@click)r_metameta)rAr,rrr3r>controls r5_apply_link_style _FormattedLine._apply_link_stylest)1  )1$W H{{*08EJJ0F%,E )1     s A1A)rrrrr,rr+r )rrr^FN)rr rr#rr:r+r:r r:rrrrr,rrPrr)r>rrPztuple[list[Segment], int])r,rrr$rPr$) rRrSrTrUrVror'rr,rArXrNr7r5rrs!#'%1%% %  %  %%%!% %(""EFN#/< r7rrbr)r3rr4zdict[int, None]rPr)KrV __future__rr functoolsrroperatorrtypingrrr r r rich.reprrich rich._wrapr rich.cellsr rich.consolerrr rich.stylerrrich.terminal_themer rich.textrtyping_extensionsrrtextual._cellsrtextual._contextr textual._loopr textual.cacher textual.colorrtextual.css.typesrrtextual.selectionr textual.stripr textual.styletextual.visualrr r!__all__rr"rWr% ANSI_DEFAULTTRANSPARENT_STYLErrr/r0r6reprautor$r#rr) _codepoints0r5r`s# 5BB"$ )-.#'##5':: ,y#~. Y.Py$34 Y40Q1ab)Q1ab) :GG$e(<#';';#% 4L ,  ,!0 , ,-A:-A-A`qIfqIqIh1vvrr{ u"g7#s F