2biձ % S SK r S SKJrJr S SKJr S SKJr S SKJ r J
r
J r J r J
r
JrJrJrJrJr SSKJr SSKJr SS KJr SS
KJr SS KJ r J r SS K J r SS
K J!r! SSK"J#r# SSK$J%r% SSK&J'r' SSK(J)r) SSK*J+r+J,r, \ ( a SSK-J.r.J/r/J0r0J1r1 Sr2S\3S' Sr4S\3S' \ Rj " S5 r6\\7S4 r8\ \7/\\, 4 r9 " S S \5 r: " S S\%5 r;\\>R S"/S#5 \>R S$/S%5 \." 5 r-\-R S&5 \-R \>S'S(9 \-R 5 \-R S)5 \-R \>S*S+S,9 \-R 5 \-R S-5 \-R \>S.S/S,9 \-R 5 \-R S05 \-R \>S1S2S,9 \-R 5 gg)3 N)partialreduce)gcd)
itemgetter)
TYPE_CHECKINGAnyCallableDictIterableList
NamedTupleOptionalTupleUnion ) loop_last) pick_bool) divide_line) AlignMethod)cell_len
set_cell_size)Lines)strip_control_codes) EmojiVariant) JupyterMixin) Measurement)Segment)Style StyleType)ConsoleConsoleOptions
JustifyMethodOverflowMethoddefaultr" DEFAULT_JUSTIFYfoldr# DEFAULT_OVERFLOWz\s+$Textc \ rS rSr% Sr\\S' \\S' \\\ 4 \S' S\4S jr
S\ 4S jr S \S\
S \S 4 4S
jrS \SS 4S jrS \SS 4S jrS
rg)Span- z A marked up region in some text.startendstylereturnc X SU R SU R SU R < S3$ )NzSpan(z, ))r, r- r. selfs ڇ/builddir/build/BUILDROOT/alt-python313-pip-23.3.1-3.el8.x86_64/opt/alt/python313/lib/python3.13/site-packages/pip/_vendor/rich/text.py__repr__
Span.__repr__7 s) tzzl"TXXJba@@ c 4 U R U R : $ N)r- r, r2 s r4 __bool__
Span.__bool__: s xx$**$$r7 offsetc XR : a U S4$ XR : a U S4$ U u p#n[ U[ X15 U5 n[ UR X45 nXV4$ )z)Split a span in to 2 from a given offset.N)r, r- r* min)r3 r< r, r- r. span1span2s r4 split
Span.split= sa JJ : XX : EUC ,e4UYY+|r7 c . U u p#n[ X!- X1- U5 $ )zMove start and end by a given offset.
Args:
offset (int): Number of characters to add to start and end.
Returns:
TextSpan: A new TextSpan with adjusted position.
)r* r3 r< r, r- r. s r4 move Span.moveJ s! !EENCL%88r7 c F U u p#nX: a U $ [ U[ X5 U5 $ )zCrop the span at the given offset.
Args:
offset (int): A value between start and end.
Returns:
Span: A new (possibly smaller) span.
)r* r> rD s r4
right_cropSpan.right_cropV s, !E =KE3v+U33r7 N)__name__
__module__ __qualname____firstlineno____doc__int__annotations__r strr r5 boolr: r r rA rE rH __static_attributes__rJ r7 r4 r* r* - s * J H e )A# A%$ % C E&(62B*B$C
93
96
9 4 4 4r7 r* c \ rS rSrSr/ SQr SSSSSSSS.S \S
\\\4 S \ S S
\ S S\ \
S\S\ \ S\ \ \
SS4S jjjrS\ 4S jrS\
4S jrS\4S jrS\4S jrS\SS 4S jrS\S\
4S jrS\S\
4S jrS \\ \4 SS 4S jr\S\ 4S j5 r\S\4S j5 r \ SS!SSSSS".S \S
\\\4 S#\
S$\ \ S \ S S
\ S S\SS 4S% jj5 r \ SSSSSSS&.S \S
\\\4 S \ S S
\ S S\ \
S\S\ \ SS 4S' jj5 r \ SSSS(.S \S
\!S \ S S
\ S SS 4
S) jjj5 r"\ SSSSSSSS*.S+\\S \#\\!4 4 S
\\\4 S \ S S
\ S S\ \
S\S\ S,\ \$\\4 SS 4S- jj5 r%\S\4S. j5 r&\&RN S/\SS4S0 j5 r&\S\ \
4S1 j5 r(\(RN S\ \
SS4S2 j5 r(SS3\SS 4S4 jjr)SS5 jr* SS
\\\4 S6\ S\ \ SS4S7 jjr+ SS
\\\4 S6\ S\ \ SS4S8 jjr, SS,\$\\4 S6\ S\ \ SS4S9 jjr-SS,\ \$\\4 S:\SS 4S; jjr.S<\SS4S= jr/S>S?S@\ S\4SA jr0 SSSB.SC\S
\ \\1\!4 SD\S\ 4SE jjjr2S!SF.SG\3\ S
\\\4 SH\
S\ 4SI jjr4SSJ jr5SK\ SS4SL jr6SM\ SS4SN jr7S>S?SOSPS\3\8 4SQ jr9S>S?SOSPS\:4SR jr;SS>S?S\S\3SS 4ST jjrSSXSY.SZ\ S
\ S S[\
SS4S\ jjr?SS] jr@SS^\ S_\SS4S` jjrASS^\ S_\SS4Sa jjrBSS^\ S_\SS4Sb jjrCSSc\DSd\ S_\SS4Se jjrE SS \S \4 S
\ \\Sf4 SS 4Sg jjrFSSh jrGSi\3\#\\ \! 4 SS 4Sj jrHSSk jrI SSXSXSl.Sm\Sn\
So\
S\J4Sp jjjrKSq\3\ S\J4Sr jrLSSs\ SS4St jjrMSSSSSu.S>S?Sd\ S \ S S
\ S S\ S\ \
S\J4Sv jjrNSd\ S\J4Sw jrOS\ 4Sx jrP SSySzS{.S|\ \ S_\S
\!SS 4S} jjjrQS~rRg)r( e a Text with color / style.
Args:
text (str, optional): Default unstyled text. Defaults to "".
style (Union[str, Style], optional): Base style for text. Defaults to "".
justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
end (str, optional): Character to end text with. Defaults to "\\n".
tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to 8.
spans (List[Span], optional). A list of predefined style spans. Defaults to None.
) _textr. justifyoverflowno_wrapr- tab_size_spans_length N
)rX rY rZ r- r[ spanstextr. rX r" rY r# rZ r- r[ ra r/ c [ U5 n U /U l X l X0l X@l XPl X`l Xpl U=( d / U l [ U 5 U l
g r9 ) r rW r. rX rY rZ r- r[ r\ lenr] )
r3 rb r. rX rY rZ r- r[ ra sanitized_texts
r4 __init__
Text.__init__ sM -T2$%
29 4<
"'+2 / r7 c U R $ r9 )r] r2 s r4 __len__ Text.__len__ s ||r7 c , [ U R 5 $ r9 )rS r] r2 s r4 r:
Text.__bool__ s DLL!!r7 c U R $ r9 plainr2 s r4 __str__ Text.__str__ s zzr7 c @ SU R < SU R < S3$ )Nz)ro r\ r2 s r4 r5
Text.__repr__ s
~Qt{{oQ77r7 otherc [ U[ [ 45 ( a# U R 5 nUR U5 U$ [
$ r9 )
isinstancerR r( copyappendNotImplemented)r3 rv results r4 __add__ Text.__add__ s5 ec4[ ) )YY[F MM% M r7 c [ U[ 5 ( d [ $ U R UR :H =( a U R UR :H $ r9 )rx r( r{ ro r\ r3 rv s r4 __eq__ Text.__eq__ s: %&&! !zzU[[(HT[[ELL-HHr7 c [ U[ 5 ( a XR ; $ [ U[ 5 ( a UR U R ; $ g)NF)rx rR ro r( r s r4 __contains__Text.__contains__ s? eS ! !JJ& &
t
$
$;;$**, ,r7 slicec ^ S[ SS4U 4S jjn[ U[ 5 ( a U" U5 $ UR [ T R 5 5 u p4nUS:X a T R X4/5 nUS $ [
S5 e)Nr< r/ r( c
> [ n[ TR U TR VVVs/ s H" u p#nX0s=: a U: d M O M U" SSU5 PM$ snnnSS9nU$ s snnnf )Nr r r^ )ra r- )r* r( ro r\ )r< _Spanr, r- r. rb r3 s r4 get_text_at%Text.__getitem__..get_text_at ss E
6" .2[[-8)E,u, ', 'E!Q&-8
D Ks A A A r z%slices with step!=1 are not supported)rP rx indicesrd ro divide TypeError)r3 r r r, stopstepliness ` r4 __getitem__Text.__getitem__ sy eS ! ! u% % %
c$**o > Eqy UM2 Qx GHHr7 c , [ U R 5 $ )z5Get the number of cells required to render this text.)r ro r2 s r4 r
Text.cell_len s
##r7 c SSK Jn / nU R nSSU R 4/S U R 5 QS U R 5 Q[ U5 SU R 4PnUR
[ SS5 S9 SnUR nU H? u pxn Xu: a U" U" X5U 5 5 UnU ( d M& U" U( a S U S
3OS U S
35 MA S R U5 n
U
$ )
zfGet console markup to render this Text.
Returns:
str: A string potentially creating markup tags.
r )escaper Fc 3 R # U H oR S UR 4v M g7fFN)r, r. .0spans r4 Text.markup.. s
F+$zz5$**-+ %'c 3 R # U H oR S UR 4v M g7fTN)r- r. r s r4 r r s
C{txxtzz*{r Tkeyz[/][r^ )
markupr ro r. r\ rd sortr rz join) r3 r outputro markup_spanspositionrz r< closingr. r s r4 r Text.markup s #
tzz "
F$++
F
Dt{{
C
Ztzz *
jA ./ &2 "FU veV 456!uE7!}qq\B '3
r7 T)r. emoji
emoji_variantrX rY r- r r c D SSK Jn U" XX4S9n XYl Xil Xyl U $ )a Create Text instance from markup.
Args:
text (str): A string containing console markup.
emoji (bool, optional): Also render emoji code. Defaults to True.
justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
end (str, optional): Character to end text with. Defaults to "\\n".
Returns:
Text: A Text instance with markup rendered.
r )render)r r )r r rX rY r- )
clsrb r. r r rX rY r- r
rendered_texts
r4 from_markupText.from_markup s+ 0 # t%U
' !) r7 r. rX rY rZ r- r[ c
SSK Jn [ SUUUUUUS9n U" 5 n
U R S U
R U5 5 5 n U $ )a Create a Text object from a string containing ANSI escape codes.
Args:
text (str): A string containing escape codes.
style (Union[str, Style], optional): Base style for text. Defaults to "".
justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
no_wrap (bool, optional): Disable text wrapping, or None for default. Defaults to None.
end (str, optional): Character to end text with. Defaults to "\\n".
tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to 8.
r ) AnsiDecoderr_ )rX rY rZ r- r[ r. c 3 $ # U H ov M g 7fr9 rJ r lines r4 r !Text.from_ansi..5 s C.BdT.Bs )ansir r( r decode) r rb r. rX rY rZ r- r[ r joinerdecoderr| s r4 from_ansiText.from_ansi sQ . &
- CgnnT.B CC
r7 rX rY c 6 U " XUS9nUR U5 U$ )a Construct a Text instance with a pre-applied styled. A style applied in this way won't be used
to pad the text when it is justified.
Args:
text (str): A string containing console markup.
style (Union[str, Style]): Style to apply to the text. Defaults to "".
justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
Returns:
Text: A text instance with a style applied to the entire string.
r )stylize)r rb r. rX rY styled_texts r4 styled Text.styled8 s$ * $(C E"r7 )r. rX rY rZ r- r[ metapartsr c U " UUUUUUS9n U R n
[ n U H( n [ X[ 45 ( a
U
" U 5 M# U
" U 6 M* U( a U R U5 U $ )a Construct a text instance by combining a sequence of strings with optional styles.
The positional arguments should be either strings, or a tuple of string + style.
Args:
style (Union[str, Style], optional): Base style for text. Defaults to "".
justify (str, optional): Justify method: "left", "center", "full", "right". Defaults to None.
overflow (str, optional): Overflow method: "crop", "fold", "ellipsis". Defaults to None.
end (str, optional): Character to end text with. Defaults to "\\n".
tab_size (int): Number of spaces per tab, or ``None`` to use ``console.tab_size``. Defaults to 8.
meta (Dict[str, Any], optional). Meta data to apply to text, or None for no meta data. Default to None
Returns:
Text: A new text instance.
r )rz r( rx rR
apply_meta)
r r. rX rY rZ r- r[ r r rb rz _Textparts
r4 assemble
Text.assembleQ sm 4
D$ --t
OOD ! r7 c [ U R 5 S:w a) SR U R 5 /U R SS& U R S $ )z Get the text as a single string.r r^ Nr )rd rW r r2 s r4 ro
Text.plain~ s? tzz?a WWTZZ 0 1DJJqMzz!} r7 new_textc XR :w aX [ U5 nU/U R SS& U R n[ U5 U l X0R : a U R 5 ggg)z Set the text to a new value.N)ro r rW r] rd _trim_spans)r3 r re
old_lengths r4 ro r s] zz ! 0 :N + ,DJJqM J ~.DLLL( " ) "r7 c U R $ )z.Get a reference to the internal list of spans.r\ r2 s r4 ra
Text.spans s {{r7 c USS U l g)z
Set spans.Nr )r3 ra s r4 ra r s Ah r7 ro c
[ UU R U R U R U R U R
U R S9nU$ )zOReturn a new Text instance with copied meta data (but not the string or spans).r )r( r. rX rY rZ r- r[ )r3 ro copy_selfs r4
blank_copyText.blank_copy sA **LL]]LL]]
r7 c
[ U R U R U R U R U R
U R U R S9nU R UR SS& U$ )z Return a copy of this instance.r N) r( ro r. rX rY rZ r- r[ r\ )r3 r s r4 ry Text.copy sY JJ**LL]]LL]]
#kk r7 r, c U( a_ [ U 5 nUS: a XB- nUc UnUS: a XC- nX$: d X2:: a gU R R [ U[ XC5 U5 5 gg)aR Apply 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.
r N)rd r\ rz r* r> r3 r. r, r- lengths r4 r Text.stylize sg YFqy { Qw l#, KK tE3v+;U C D r7 c
U( a` [ U 5 nUS: a XB- nUc UnUS: a XC- nX$: d X2:: a gU R R S[ U[ XC5 U5 5 gg)a Apply a style to the text, or a portion of the text. Styles 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.
r N)rd r\ insertr* r> r s r4 stylize_beforeText.stylize_before si YFqy { Qw l#, KK q$uc&.>"F G r7 c P [ R " U5 nU R XBUS9 g)a@ Apply meta data to the text, or a portion of the text.
Args:
meta (Dict[str, Any]): A dict of meta information.
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.
)r, r- N)r from_metar )r3 r r, r- r. s r4 r Text.apply_meta s" % US 1r7 handlersc Uc 0 OUnUR UR 5 VVs0 s H u p4SU 3U_M
snn5 U R [ R " U5 5 U $ s snnf )at Apply event handlers (used by Textual project).
Example:
>>> from rich.text import Text
>>> text = Text("hello world")
>>> text.on(click="view.toggle('world')")
Args:
meta (Dict[str, Any]): Mapping of meta information.
**handlers: Keyword args are prefixed with "@" to defined handlers.
Returns:
Text: Self is returned to method may be chained.
@)updateitemsr r r )r3 r r r values r4 onText.on s` \rt 8HI8H*#qY%8HIJ U__T*+ Js A'
suffixc z U R R U5 ( a U R [ U5 5 gg)zIRemove a suffix if it exists.
Args:
suffix (str): Suffix to remove.
N)ro endswithrH rd )r3 r s r4
remove_suffixText.remove_suffix s. :: v & & OOCK ( 'r7 consoler r< c US: a [ U 5 U- nUR nU" U R 5 R 5 nU R H! u pVnXbs=: a U: d M O M XC" USS9-
nM# U$ )zGet the style of a character at give offset.
Args:
console (~Console): Console where text will be rendered.
offset (int): Offset in to text (negative indexing supported)
Returns:
Style: A Style instance.
r r^ r$ )rd get_styler. ry r\ )r3 r r< r r. r, r-
span_styles r4 get_style_at_offsetText.get_style_at_offset st A:Y'F%% $**%**,&*kk "E
$u$$:r:: '2 r7 ) style_prefix re_highlightr c
SnU R R n[ nU R n[ R
" X5 H nUR n U( a< U " 5 u p[ U5 ( a
U" XzU 5 OUn U b X: a U" U" XU 5 5 US-
nUR 5 R 5 H/ n
U " U
5 u pU
S:w d M X: d M U" U" XU U
35 5 M1 M U$ )a Highlight text with a regular expression, where group names are
translated to styles.
Args:
re_highlight (str): A regular expression.
style (Union[GetStyleCallable, StyleType]): Optional style to apply to whole match, or a callable
which accepts the matched text and returns a style. Defaults to None.
style_prefix (str, optional): Optional prefix to add to style group names.
Returns:
int: Number of regex matches
r r )
r\ rz r* ro refinditerr callable groupdictkeys)r3 r r. r count append_spanr ro matchget_spanr, r- match_stylenames r4 highlight_regexText.highlight_regex( s & kk((
[[ 5E zzH %Z
9A% eE$4 5e *s{ e+ >? QJE )..0 %d^
B;3; e\N4&2I JK 1 6 r7 )case_sensitivewordsr c : SR S U 5 5 nU R R nSn[ n[ R
" X@R U( a SO[ R S9 H* nUR S5 u pU" U" XU5 5 US-
nM, U$ )a Highlight words with a style.
Args:
words (Iterable[str]): Worlds to highlight.
style (Union[str, Style]): Style to apply.
case_sensitive (bool, optional): Enable case sensitive matchings. Defaults to True.
Returns:
int: Number of words highlighted.
|c 3 N # U H n[ R " U5 v M g 7fr9 )r r r words r4 r 'Text.highlight_words.._ s >BIIdOOs #%r flagsr ) r r\ rz r* r r ro
IGNORECASEr ) r3 r r. r re_wordsadd_spanr r r r, r- s r4 highlight_wordsText.highlight_wordsN s " 88>>>;;%%[[ jj^
E A JE U5u- . QJE
r7 c B U R R 5 U l g)z"Strip whitespace from end of text.N)ro rstripr2 s r4 r! Text.rstripk s ZZ&&(
r7 sizec [ U 5 nX!: a\ X!-
n[ R U R 5 nUb5 [ UR S5 5 nU R [
XS5 5 ggg)zvRemove whitespace beyond a certain width at the end of the text.
Args:
size (int): The desired size of the text.
Nr )rd _re_whitespacesearchro grouprH r> )r3 r# text_lengthexcesswhitespace_matchwhitespace_counts r4
rstrip_endText.rstrip_endo si $i 'F - 4 4TZZ @ +#&'7'='=a'@#A $4 => , r7
new_lengthc ~ [ U 5 nX!:w a- X!: a U R X-
5 gU R X!-
5 gg)zDMM>Q,,D'//D_==HG$4$4H8H ] dllGOOUC
JOOE* ##G#:::s C=D?D Dc U R nUR 5 nU( a [ S U 5 5 OSnUR 5 nU( a [ S U 5 5 OUn[ Xu5 $ )Nc 3 8 # U H n[ U5 v M g 7fr9 r r s r4 r (Text.__rich_measure__.. s >Xd^^ r c 3 8 # U H n[ U5 v M g 7fr9 r> r s r4 r r? s 1545r@ )ro
splitlinesmaxrA r )r3 r r3 rb r max_text_widthr min_text_widths r4 __rich_measure__Text.__rich_measure__ s\ zz!BG > >>Q
5:C151 1 >::r7 r c # | ^^^^^# [ nU R nU R ( d [ U5 v U( a
U" U5 v g[ UR [
R " 5 S9n[ [ U R S5 5 nU VVs0 s H u pxXu" UR 5 _M snnmU" U R 5 TS' S/S U 5 QS U 5 Q[ U5 SS4Pn U R [ SS5 S 9 / mTR n
TR n 0 mTR m[
R mS
[
4UUUUU4S jjn [# XSS 5 H? u u pnu n nU( a U " U5 OU
" U5 UU
: d M- U" XMU U " 5 5 v MA U( a U" U5 v ggs snnf 7f) zRender the text as Segments.
Args:
console (Console): Console instance.
end (Optional[str], optional): Optional end character.
Returns:
Iterable[Segment]: Result of render that may be written to the console.
Nr r r )r Fr c 3 D # U H u pUR S U4v M g7fr )r, r indexr s r4 r Text.render.. s
M [ U4S j[ T5 5 5 n T" U 5 nUb U$ T" U 5 nUTU ' U$ )z#Construct current style from stack.c 3 . ># U H
nTU v M g 7fr9 rJ )r _style_id style_maps r4 r 9Text.render..get_current_style.. s O I9Y/ s )tuplesorted)styles cached_style
current_stylecombinestack style_cachestyle_cache_getrR s r4 get_current_style&Text.render..get_current_style sF O OOF*62L'## #FOM"/K r7 )r ro r\ r r r nulllist enumerater. rd r r rz removegetrY zip)r3 r r- _Segmentrb r enumerated_spansrK r ra stack_append stack_popr] r< leavingstyle_id next_offset_rY rZ r[ r\ rR s @@@@@r4 r Text.render s zz{{$- sm# G - -uzz|D $++q 9:EUVEUkeUIdjj 11EUV , !
M# TR ( a& [ T5 H u pUv U ( a M Tv M g T S h vN g N7fr9 )ro r )lastr r r3 s r4 iter_text Text.join..iter_text s8 zz"+E"2JD J 4 "
#3
! s +AA AAr c 3 J ># U H u pnT" TU- TU- U5 v M g 7fr9 rJ )r r, r- r. r r< s r4 r Text.join.. s1 )4%E funfslE::)4 #)
r r rW extendr\ rz r* r. rd r] )
r3 r r rq extend_textr
extend_spansrb r r< s
`` @@r4 r Text.join s ??$ !8F+ ! ! nn++ oo,, -- KD
#zzE&&3t9* BF sV|V4
4L = ll^
4:: Ar7 F)rY padr8 r c U=( d U R =( d [ nUS:w a [ U R 5 nXQ: aC US:X a" [ U R US-
5 S- U l O[ U R U5 U l U( a> XQ: a8 X-
nU R SU- 3/U l [
U R 5 U l gggg)aM Truncate text if it is longer that a given width.
Args:
max_width (int): Maximum number of characters in text.
overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None, to use self.overflow.
pad (bool, optional): Pad with spaces if the length is less than max_width. Defaults to False.
ignoreellipsisr u …rs N)rY r' r ro r rW rd r] )r3 r8 rY r _overflowr r s r4 truncate
Text.truncate) s A
A1A djj)F!
*!.tzz9q=!IE!QDJ!.tzz9!EDJv)"+!% S6\N ; <
"4:: *s !r7 c
> [ U R 5 n[ nU R Vs/ s HX nUR U: d M UR
U: a UO0U" UR [
XR
5 UR 5 PMZ snU R SS& gs snf )z=Remove or modify any spans that are over the end of the text.N)rd ro r* r\ r, r- r> r. )r3
max_offsetr r s r4 r Text._trim_spansD s _
$zzJ& N88j( 4::s:xx'@$**MN $
A
s BABr characterc
[ U5 S:X d S5 eU( a_ X!- nU U R U 3U l [ nU R VVVs/ s H u pVnU" XQ- Xa- U5 PM snnnU R SS& ggs snnnf )z`Pad left and right with a given number of characters.
Args:
count (int): Width of padding.
r &Character must be a string of length 1Nrd ro r* r\ )r3 r r pad_charactersr r, r- r. s r4 r Text.padR s 9~"L$LL" & .N *+DJJ<7GHDJE *. )4%E emS[%8)4 DKKN s A>c
[ U5 S:X d S5 eU( a[ X!- U R 3U l [ nU R VVVs/ s H u pEnU" XA- XQ- U5 PM snnnU R SS& ggs 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 " ".
r r Nr )r3 r r r r, r- r. s r4 pad_left
Text.pad_leftb s 9~"L$LL" % -.tzzl;DJE *. )4%E emS[%8)4 DKKN s A:c n [ U5 S:X d S5 eU( a U R X!- 3U l gg)zPad the right with a given character.
Args:
count (int): Number of characters to pad.
character (str, optional): Character to pad with. Defaults to " ".
r r N)rd ro )r3 r r s r4 r0 Text.pad_rightr s< 9~"L$LL" JJ< (9':;DJ r7 alignwidthc U R U5 U[ U R 5 -
nU( a[ US:X a U R XC5 gUS:X a+ US- nU R XS5 U R XE-
U5 gU R XC5 gg)zAlign text to a given width.
Args:
align (AlignMethod): One of "left", "center", or "right".
width (int): Desired width.
character (str, optional): Character to pad with. Defaults to " ".
leftcenter N)r r ro r0 r )r3 r r r excess_spacer s r4 r
Text.align} sy
e x
33 |7("#q(
d.| 2I>
l6 r7 r c z ^^ [ U[ [ 45 ( d [ S5 e[ U5 ( Ga [ U[ 5 ( a~ [ U5 nU R R U5 [ U 5 n[ U5 mUb( U R R [ XDT- U5 5 U =R T-
sl
U $ [ U[ 5 ( a [ mUb [ S5 eU R mUR b9 U R R T" TT[ U5 - UR 5 5 U R R UR 5 U R R UU4S jUR 5 5 U =R [ U5 -
sl
U $ )zAdd text with an optional style.
Args:
text (Union[Text, str]): A str or Text to append.
style (str, optional): A style name. Defaults to None.
Returns:
Text: Returns self for chaining.
z(Only str or Text can be appended to Textz2style must not be set when appending Text instancec 3 J ># U H u pnT" UT- UT- U5 v M g 7fr9 rJ r r, r- r. r r( s r4 r Text.append.. s3 #-8)E %+-s[/@%HH-8ru )rx rR r( r rd r rW rz r\ r* r]
ValueErrorr. ro rv )r3 rb r. re r< r r( s @@r4 rz Text.append s^ $d ,, FG G t99$$$!4T!:
!!.1 T !. 1 $KK&&tF[4H%'PQ + $ # D$'' $$L #ll ::)KK&& k;T+BDJJO
!!$**- "" #-1[[# D ) r7 c ^^ [ mU R mUR b9 U R R T" TT[ U5 - UR 5 5 U R R UR 5 U R R UU4S jUR 5 5 U =R [ U5 -
sl U $ )zAppend another Text instance. This method is more performant that Text.append, but
only works for Text.
Returns:
Text: Returns self for chaining.
c 3 J ># U H u pnT" UT- UT- U5 v M g 7fr9 rJ r s r4 r #Text.append_text.. s3
%0!E
%+%s['8% @ @%0ru ) r* r] r. r\ rz rd rW ro rv )r3 rb r r( s @@r4 append_textText.append_text s ll :: ! KK u[+D 2I4:: V W
$**%
%)[[
D ! r7 tokensc
U R R nU R R n[ n[ U 5 nU H9 u pgU" U5 Ub U" U" XU[ U5 - U5 5 U[ U5 -
nM; XPl U $ )a Append iterable of str and style. Style may be a Style instance or a str style definition.
Args:
pairs (Iterable[Tuple[str, Optional[StyleType]]]): An iterable of tuples containing str content and style.
Returns:
Text: Returns self for chaining.
)rW rz r\ r* rd r] )r3 r r r
r r< contentr. s r4
append_tokensText.append_tokens s| jj'' kk(( T $NG E&3w<*? GH c'l "F %
r7 c N U R R UR 5 g)z~Copy styles from another Text instance.
Args:
text (Text): A Text instance to copy styles from, must be the same length.
N)r\ rv )r3 rb s r4 copy_stylesText.copy_styles s
4;;'r7 )r| allow_blank separatorr| r c ^^ T( d S5 eU R mTT; a [ U R 5 /5 $ U( aB U R S [ R
" [ R " T5 T5 5 5 nO?S[ [ 4UU4S jjn[ U4S jU R U" 5 5 5 5 nU( d& TR T5 ( a UR 5 U$ )a Split rich text in to 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[RichText]: A list of rich text, one per line of the original.
zseparator must not be emptyc 3 @ # U H oR 5 v M g 7fr9 r6 )r r s r4 r Text.split.. s )P )Ps r/ c 3 ># [ R " [ R " T5 T5 H n U R 5 u pUv Uv M g 7fr9 )r r r r )r r, r- r rb s r4
flatten_spans!Text.split..flatten_spans s< [[9)=t DE!& JE K I Es AAc 3 J ># U H oR T:w d M Uv M g 7fr9 rn )r r r s r4 r r s !=yAX!=s # #) ro r ry r r r r r rP r pop)r3 r r| r r r rb s ` @r4 rA
Text.split s " 777yzz D $))+ ' ' KK )+RYYy5I4)P E
8C=
!%]_!= E t}}Y 7 7 IIK r7 offsetsc ^^^^^ [ U5 nU( d [ U R 5 /5 $ U R m[ T5 nS/UQUPn[ [ XDSS 5 5 nU R mU R mU R m[ m[ UUUUU4S jU 5 5 nU R ( d U$ UR Vs/ s H owR R PM nn[ U5 n [ n
U R H u pmSn
U nX- S- n X_ u nnU U: a US-
nO
U U: a US- n
OO X- S- nM) U U: a UnO1U=nn
U n UU u nnU U: a US-
nO
U U: a US- n
OO X- S- nM* [ UUS- 5 HG nUU u nn[ SU U-
5 n[! U U-
UU-
5 nUU: d M4 UU " U
" UUT5 5 MI M U$ s snf )zDivide text in to a number of lines at given offsets.
Args:
offsets (Iterable[int]): Offsets used to divide text.
Returns:
Lines: New RichText instances between offsets.
r r Nc 3 > ># U H u pT" TX TTTS 9v M g7f))r. rX rY NrJ )r r, r- r rX rY r. rb s r4 r Text.divide..2 s3
*
U !
*s r )r` r ry ro rd rd r. rX rY r( r\ _linesrz r* rangerC r> )r3 r _offsetsr( divide_offsets line_ranges new_linesr
_line_appends
line_countr
span_startspan_end lower_bound upper_bound
start_line_no
line_startline_end end_line_noline_no new_startnew_endr rX rY r. rb s @@@@@r4 r Text.divide s5 =$))+ ' 'zz$i 4h4 43~ab/ABC
,,==
*
{{ 8A8H8HI8H++8H
I%
+/;; 'J%K$K ( 61 r. rW r] )r3 r r r r s r4 rH Text.right_cropk s _v-
$zzJ& N88j( 4::s:xx'@$**MN $
A jj6'*+
s CACr5 c j U=( d U R =( d [ nU=( d U R =( d [ n[ X`R
S5 =( d US:H n[
5 n U R SS9 H n
SU
; a U
R U5 U( a
[
U
/5 n O'[ [ U
5 X(S:H S9n U
R U 5 n U H n
U
R U5 M U( a U R XXxS9 U H n
U
R X(S 9 M U R U 5 M U $ )
a4 Word wrap the text.
Args:
console (Console): Console instance.
width (int): Number of characters per line.
emoji (bool, optional): Also render emoji code. Defaults to True.
justify (str, optional): Justify method: "default", "left", "center", "full", "right". Defaults to "default".
overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to None.
tab_size (int, optional): Default tab size. Defaults to 8.
no_wrap (bool, optional): Disable wrapping, Defaults to False.
Returns:
Lines: Number of lines.
Fr Tr r{ r& )r& r )rY )rX r% rY r' r rZ r rA r r rR r r, r rv )
r3 r r rX rY r[ rZ wrap_justify
wrap_overflowr r r r s
r4 r7 Text.wrap{ s 0 A$,,A/ EDMME5E
G\\59QX=QJJ4J0Dt| * !4&M %c$if=TU KK 0 !& "!!L " "
e
< " LL #! 1" r7 c [ 5 nUR nU R 5 H nUR U5 U" U5 M U$ )zFit the text in to given width by chopping in to lines.
Args:
width (int): Maximum characters in a line.
Returns:
Lines: Lines container.
)r rz rA r1 )r3 r r rz r s r4 fitText.fit s> w JJLD OOE " 4L ! r7 c X [ R " SU R [ R S9 Vs1 s H n[ UR S5 5 iM nn [
[ U Vs/ s H o3S- ( a M UPM sn5 =( d SnU$ s snf s snf ! [ a Sn U$ f = f)zZAuto-detect indentation of code.
Returns:
int: Number of spaces used to indent code.
^( *)(.*)$r r r ) r r ro MULTILINErd r' r r r )r3 r
_indentationsindent indentations r4 detect_indentationText.detect_indentation s ]DJJbllS
S
A S
s- R-PQzV- RSXWX
S K s/ $BB &
B
7B
=B B B)(B)u │z dim green)r r. indent_sizec @ Uc U R 5 OUnU R 5 nUR 5 U SUS-
- 3n[ R " S5 n/ nUR
n Sn
UR
SS9 H n UR U R 5 n U ( a U R S5 ( d U
S-
n
MB U R S5 n
[ [ U
5 U5 u pXn- SU- 3nUU R [ U5 S - U l U R US[ U5 5 U
( a UR [ UUS 9/U
- 5 Sn
U " U 5 M U
( a UR [ S
US 9/U
- 5 UR S 5 R! U5 nU$ ) uS Adds indent guide lines to text.
Args:
indent_size (Optional[int]): Size of indentation, or None to auto detect. Defaults to None.
character (str, optional): Character to use for indentation. Defaults to "│".
style (Union[Style, str], optional): Style of indent guides.
Returns:
Text: New text with indentation guides.
Nrs r r r Tr r r. r^ r_ )r ry r r compilerz rA r ro r' divmodrd r rv r( r r )r3 r r r. _indent_sizerb indent_line re_indentr add_line blank_linesr r r full_indentsremaining_space
new_indentr s r4 with_indent_guidesText.with_indent_guides s $ 5@4Gt..0[ yy{ " C JJ}- " ## JJ4J0D OODJJ/E Aq [[^F,23v; ,M )L ' 67o8M7NOJ#djjZ 1B&CCDJ LL3z? 3 $z"?!@;!NO TN 1 d2U 3 4{ B C??4(--i8r7 )
r] r\ rW r- rX rZ rY ro r. r[ )r^ r^ )r^ )r/ r( )r Nr9 )r/ N)rs )rb r( r/ r( )rb r( r/ N)r_ )r )SrK rL rM rN rO __slots__rR r r r rS rP r r* rf ri r: rp r5 r r} objectr r r r propertyr r classmethodr r r r r r r
r ro setterra r ry r r r r r r GetStyleCallabler r r r! r, r1 r r: r rF r r r r r r r r0 r r rz r r r r rA r rH r7 r r r rT rJ r7 r4 r( r( e s
I #%0
.2/3"&"#&*00 S%Z 0
/* 0 +,
0 $ 0 0 3-0 T
#0
0. "$ " 8# 8 S V IF It I
& T IsEz!2 Iv I4 $# $ $ :
$&04-1/3 S%Z
-
/* +,
>
$&-1/3"&"### S%Z #
/* # +,
# $ # # 3-#
# #J
.2/3
/* +,
0 $&-1/3"&)-*c65i #889* S%Z * /* *
+, * $
* * * tCH~&*
* *X s \\#c #d # # tDz \\ 4: $ V " ! ES%Z E E c] E
E: ! HS%Z H H c] H
H6 JN 2cN 2+. 29A# 2
2 xS#X/ C F ()C )D )9 c e . ?C$
$$ . 9:;$
$
$V $ } S%Z
:) ?s ?t ? 5S 5T 5; ;+;; ' ;&
;
;+;
;
;9 i 9 c 9 8I;N 9 v%(6* %v %N 'HSM 'T 'L 04 // +, /
/
/6
t c c D ? .( * #( ! ** *
*
*XNhsm N N` T * .2/3"&// /
/* / +,
/ / $ /
/b C . &*. & . c]. .
.
. .r7 __main__)r a
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Loremboldipsumitaliczjustify='left'redr zjustify='center'greenr )r. rX zjustify='right'bluerightzjustify='full'magentafull)Br functoolsr r mathr operatorr typingr r r r
r r r
r r r _loopr _pickr _wrapr r r cellsr r
containersr controlr r r jupyterr measurer segmentr r. r r r r r! r" r# r% rQ r' r r% rR TextTyper r* r( rK pip._vendor.rich.consolerb r ruleprintrJ r7 r4 r s % * ( ! #OO#, ,%+ " + G$ f SE8I#6 67 54: 54pZ< Zz$ z0 P D 'F+'H-iG LL!" MM$eM$ MMO LL#$ MM$gxM8 MMO LL"# MM$fgM6 MMO LL!" MM$iM8 MMO3 r7