]e>? d"gd# e>? d$gd% e. Z-e-@ d& e-A e>d'( e-A e-@ d) e-A e>d*d+, e-A e-@ d- e-A e>d.d/, e-A e-@ d0 e-A e>d1d2, e-A dS dS )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 e Zd ZU dZeed< eed< eeef ed< defdZ de
fdZ dede d e
d f fd Zdedd fd
Zdedd fd Zd edd fd
ZdS )Spanz A marked up region in some text.startendstylereturnc 8 d| j d| j d| j dS )NzSpan(z, ))r+ r, r- selfs g/builddir/build/BUILD/cloudlinux-venv-1.0.12/venv/lib/python3.11/site-packages/pip/_vendor/rich/text.py__repr__z
Span.__repr__8 s) @tz@@TX@@@@@@ c " | j | j k S N)r, r+ r1 s r3 __bool__z
Span.__bool__; s x$*$$r5 offsetc || j k r| dfS || j k r| dfS | \ }}}t |t || | }t |j || }||fS )z)Split a span in to 2 from a given offset.N)r+ r, r* min)r2 r9 r+ r, r- span1span2s r3 splitz
Span.split> sv DJ : TX : sEUCV , ,e44UYU++e|r5 c < | \ }}}t ||z ||z | S )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* r2 r9 r+ r, r- s r3 movez Span.moveK s* !sEEFNC&L%888r5 c \ | \ }}}||k r| S t |t || | S )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; rA s r3
right_cropzSpan.right_cropW s: !sE S==KE3vs++U333r5 cellsc > |r| \ }}}t |||z | S | S )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@ )r2 rE r+ r, r- s r3 extendz Span.extende s3 $ E3sU{E22 2Kr5 N)__name__
__module__ __qualname____doc__int__annotations__r strr r4 boolr8 r r r> rB rD rG r5 r3 r* r* . s ** JJJ HHH e )A# A A A A%$ % % % % C E&(62B*B$C
93
96
9
9
9
9 4 4 4 4 4 4
C
F
r5 r* c e Zd ZdZg dZ dddddddddedeeef d ed
d ed d
ee dedee
dee e ddfdZ
de
fdZde fdZdefdZdefdZdedd fdZdede fdZdede fdZdee
ef dd fd Zede
fd Zedefd Ze dd ddddd dedeeef d!e d"ee d ed
d ed dedd fd# Z e dddddd$d%dedeeef d ed
d ed d
ee dedee
dd fd& Z e dddd'dede d ed
d ed dd f
d( Z!e dddddd$dd)d*eed e"ee f f deeef d ed
d ed d
ee dede
d+ee#eef dd fd, Z$edefd- Z%e%j& d.eddfd/ Z%ede e fd0 Z'e'j& de e ddfd1 Z'dd2edd fd3Z(dd4Z) ddeeef d6e
dee
ddfd7Z* ddeeef d6e
dee
ddfd8Z+ dd+e#eef d6e
dee
ddfd9Z,dd+ee#eef d:edd fd;Z-dd?d@e
defdAZ/dBe
ddfdCZ0 dddDdEedeee1e f dFede
fdGZ2d dHdIe3e deeef dJe de
fdKZ4ddLZ5dMe
ddfdNZ6dOe
ddfdPZ7d>d?dQdRde3e8 fdSZ9d>d?dQdRde:fdTZ;dd>d?dede3dU fdVZddZd[d\e
d ed d]e ddfd^Z?dd_Z@ddae
dbeddfdcZAddae
dbeddfddZBddae
dbeddfdeZCddfeDdge
dbeddfdhZE dded ef deeedif dd fdjZFddkZGdle3e"eee f dd fdmZHddnZI ddZdZdodpedqe dre deJfdsZKdte3e
deJfduZLddwe
ddfdxZMddd$ddyd>d?dge
d ed
d ed de
d
ee deJfdzZNdge
deJfd{ZOde
fd|ZP dd}d~ddee
dbede dd fdZQdS )r( 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 None.
spans (List[Span], optional). A list of predefined style spans. Defaults to None.
) _textr- justifyoverflowno_wrapr, tab_size_spans_length N
)rS rT rU r, rV spanstextr- rS r" rT r# rU r, rV r[ r. c t | } | g| _ || _ || _ || _ || _ || _ || _ |pg | _ t | | _
d S r7 ) r rR r- rS rT rU r, rV rW lenrX )
r2 r\ r- rS rT rU r, rV r[ sanitized_texts
r3 __init__z
Text.__init__ sc -T22$%
29 4<
"'+2 / / r5 c | j S r7 )rX r1 s r3 __len__z Text.__len__ s
|r5 c * t | j S r7 )rO rX r1 s r3 r8 z
Text.__bool__ s DL!!!r5 c | j S r7 plainr1 s r3 __str__z Text.__str__ s
zr5 c ( d| j d| j dS )Nz)rf rW r1 s r3 r4 z
Text.__repr__ s 7
77t{7777r5 otherc t |t t f r+| }| | |S t
S r7 )
isinstancerN r( copyappendNotImplemented)r2 rk results r3 __add__z Text.__add__ sB ec4[ ) ) YY[[F MM% M r5 c z t |t st S | j |j k o| j |j k S r7 )rm r( rp rf rW r2 rk s r3 __eq__z Text.__eq__ s7 %&& "! !zU[(HT[EL-HHr5 c t |t r || j v S t |t r|j | j v S dS )NF)rm rN rf r( rt s r3 __contains__zText.__contains__ sG eS ! ! -DJ& &
t
$
$ -;$*, ,ur5 slicec dt ddf fd }t |t r || S | t j \ }}}|dk r ||g }|d S t
d )Nr9 r. r( c x t t j fdj D d }|S )Nc R g | ]#\ }}}|cxk r|k n n
d d| $S )r r rP .0r+ r, r- _Spanr9 s r3
z9Text.__getitem__..get_text_at.. sY )sEV,,,,u,,,,, E!Q&&,,,r5 rY )r[ r, )r* r( rf rW )r9 r\ r~ r2 s ` @r3 get_text_atz%Text.__getitem__..get_text_at sa E
6" -1[
D Kr5 r z%slices with step!=1 are not supported)rL rm indicesr^ rf divide TypeError)r2 rx r r+ stopstepliness ` r3 __getitem__zText.__getitem__ s eS ! !
I ;u%% % %
c$*oo > > E4qyy UDM22 Qx GHHHr5 c * t | j S )z5Get the number of cells required to render this text.)r rf r1 s r3 r z
Text.cell_len s
###r5 c ddl m} g }| j }dd| j fgd | j D d | j D t | d| j f}| t dd d}|j }|D ]C\ }}} ||k r | |||| |}| r ||rd | d
nd | d
Dd | }
|
S )
z~Get console markup to render this Text.
Returns:
str: A string potentially creating markup tags.
r )escaper Fc 3 4 K | ]}|j d |j fV dS FN)r+ r- r} spans r3 z Text.markup.. s-
F
F$tz5$*-
F
F
F
F
F
Fr5 c 3 4 K | ]}|j d |j fV dS TN)r, r- r s r3 r z Text.markup.. s-
C
Cttxtz*
C
C
C
C
C
Cr5 Tkeyz[/][rY )
markupr rf r- rW r^ sortr ro join) r2 r outputrf markup_spanspositionro r9 closingr- r s r3 r z Text.markup sB #"""""
tz "
F
F$+
F
F
F
D
Ct{
C
C
C
ZZtz *
jA . ./// &2 C C "FGU vveHVO 455666!
CA}E}}}}\\\\BBB
r5 T)r- emoji
emoji_variantrS rT r, r r c Z ddl m} ||||| } || _ || _ || _ | S )a Create Text instance from markup.
Args:
text (str): A string containing console markup.
style (Union[str, Style], optional): Base style for text. Defaults to "".
emoji (bool, optional): Also render emoji code. Defaults to True.
emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None.
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 rS rT r, )
clsr\ r- r r rS rT r, r
rendered_texts
r3 from_markupzText.from_markup sL 4 #""""" tU%}UUU
'
!)
r5 r- rS rT rU r, rV c ddl m} t d|||||| } | }
| d |
| D } | S )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 None.
r ) AnsiDecoderrZ )rS rT rU r, rV r- c 3 K | ]}|V d S r7 rP r} lines r3 r z!Text.from_ansi..G s" C CdT C C C C C Cr5 )ansir r( r decode) r r\ r- rS rT rU r, rV r joinerdecoderrq s r3 from_ansizText.from_ansi$ s} . &%%%%%
+-- C CgnnT.B.B C C CCC
r5 rS rT c L | ||| }| | |S )aa 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 r\ r- rS rT styled_texts r3 styledz Text.styledJ s4 * c$(CCC E"""r5 )r- rS rT rU r, rV metapartsr c | |||||| } | j }
t } |D ]*} t | | t f r |
| % |
| +|r| | | S )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.
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 None.
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 )ro r( rm rN
apply_meta)
r r- rS rT rU r, rV r r r\ ro _Textparts
r3 assemblez
Text.assemblec s 6 s
D$ --
t
" OOD ! ! ! r5 c t | j dk r%d | j g| j dd< | j d S )z Get the text as a single string.r rY Nr )r^ rR r r1 s r3 rf z
Text.plain sC tz??a WWTZ 0 0 1DJqqqMz!} r5 new_textc || j k rXt | }|g| j dd< | j }t | | _ || j k r| dS dS dS )z Set the text to a new value.N)rf r rR rX r^ _trim_spans)r2 r r_
old_lengths r3 rf z
Text.plain s{ tz ! ! 0 : :N + ,DJqqqM J ~..DLDL(( """""
" !
)(r5 c | j S )z.Get a reference to the internal list of spans.rW r1 s r3 r[ z
Text.spans s {r5 c $ |dd | _ dS )z
Set spans.Nr )r2 r[ s r3 r[ z
Text.spans s AAAh r5 rf c n t || j | j | j | j | j | j }|S )zNReturn a new Text instance with copied metadata (but not the string or spans).r )r( r- rS rT rU r, rV )r2 rf copy_selfs r3
blank_copyzText.blank_copy s? *L]L]
r5 c t | j | j | j | j | j | j | j }| j |j dd< |S )z Return a copy of this instance.r N) r( rf r- rS rT rU r, rV rW )r2 r s r3 rn z Text.copy sT J*L]L]
#k r5 r r+ c |rpt | }|dk r||z }||}|dk r||z }||k s||k rdS | j t |t || | dS dS )az 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)r^ rW ro r* r; r2 r- r+ r, lengths r3 r z Text.stylize s EYYFqyy { Qww sl#,, K tE3vs+;+;U C C D D D D D E Er5 c
|rqt | }|dk r||z }||}|dk r||z }||k s||k rdS | j dt |t || | dS dS )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)r^ rW insertr* r; r s r3 stylize_beforezText.stylize_before s HYYFqyy { Qww sl#,, K q$uc&#.>.>"F"F G G G G G H Hr5 c ^ t j | }| ||| dS )ag Apply metadata 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 )r2 r r+ r, r- s r3 r zText.apply_meta s1 %% U%S 11111r5 handlersc |i n|}| d | D | t j | | S )a 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.
Nc i | ] \ }}d | | S )@rP )r} r values r3
zText.on.. s$ III*#uYYYIIIr5 )updateitemsr r r )r2 r r s r3 onzText.on
s] \rrt II8H8HIIIJJJ U_T**+++ r5 suffixc | j | r$| t | dS dS )zaRemove a suffix if it exists.
Args:
suffix (str): Suffix to remove.
N)rf endswithrD r^ )r2 r s r3
remove_suffixzText.remove_suffix sD : v & & ) OOCKK ( ( ( ( ( ) )r5 consoler r9 c |dk rt | |z }|j } || j }| j D ]&\ }}}||cxk r|k rn | ||d z
}'|S )a
Get 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 rY r$ )r^ get_styler- rn rW )r2 r r9 r r- r+ r,
span_styles r3 get_style_at_offsetzText.get_style_at_offset' s A::YY'F% $*%%**,,&*k ; ; "E3
V$$$$u$$$$$:r:::: r5 spacesc dk rdS | j }dz }|rTt | fd|D | j dd< | j | | xj z
c_ dS | xj |z
c_ dS )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.
r Nri c T g | ]$}|j k r| n|%S rP )r, rG )r} r
end_offsetr s r3 r z%Text.extend_style..G sF (,x:'='= F###4 r5 )r[ r^ rW rR ro rX rf )r2 r r[
new_spacesr s ` @r3 extend_stylezText.extend_style; s Q;; F
6\
% TJ ! DKN
J j ) ) ) LLF "LLLL JJ* $JJJJr5 ) style_prefix re_highlightr c
d}| j j }t }| j }t j || D ]}|j } |rO | \ }
} t | r |||
| n|} | | |
k r | ||
| | |dz
}| D ]6}
| |
\ }
} |
dk r | |
k r | ||
| | |
7|S )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 Nr )
rW ro r* rf refinditerr callable groupdictkeys)r2 r r- r count append_spanr~ rf matchget_spanr+ r, match_stylenames r3 highlight_regexzText.highlight_regexP s8 & k(
[ u55 L LE zH
@ %XZZ
s9A% SeeE%)$4 5 5 5e *sU{{ KeS+ > >??? QJE ))..00
L
L %Xd^^
sB;;3;; KeS\2I42I2I J JKKK
L r5 )case_sensitivewordsr c . d d |D }| j j }d}t }t j || j |rdn t j D ]5}| d \ } }
| || |
| |dz
}6|S )aB Highlight words with a style.
Args:
words (Iterable[str]): Words to highlight.
style (Union[str, Style]): Style to apply.
case_sensitive (bool, optional): Enable case sensitive matching. Defaults to True.
Returns:
int: Number of words highlighted.
|c 3 > K | ]}t j | V d S r7 )r r r} words r3 r z'Text.highlight_words.. s* >>BIdOO>>>>>>r5 r flagsr ) r rW ro r* r r rf
IGNORECASEr ) r2 r r- r re_wordsadd_spanr r~ r r+ r, s r3 highlight_wordszText.highlight_wordsv s " 88>>>>>>>;%[ dj^(N
E A JE3 HUU5#u-- . . . QJEE r5 c B | j | _ dS )z"Strip whitespace from end of text.N)rf rstripr1 s r3 r z Text.rstrip s Z&&((
r5 sizec t | }||k rm||z
}t | j }|It | d }| t
|| dS dS dS )zRemove whitespace beyond a certain width at the end of the text.
Args:
size (int): The desired size of the text.
Nr )r^ _re_whitespacesearchrf grouprD r; )r2 r text_lengthexcesswhitespace_matchwhitespace_counts r3
rstrip_endzText.rstrip_end s $ii 4'F - 4 4TZ @ @ +#&'7'='=a'@'@#A#A $4f = =>>>>> ,+r5
new_lengthc t | }||k r:||k r| ||z
dS | ||z
dS dS )z. s( > >Xd^^ > > > > > >r5 r c 3 4 K | ]}t | V d S r7 r r s r3 r z(Text.__rich_measure__.. s( 114111111r5 )rf
splitlinesmaxr> r )r2 r r r\ r max_text_widthr min_text_widths r3 __rich_measure__zText.__rich_measure__ s z!!BGN > > > > >>>>Q
5: NC115111 1 1 1 >>:::r5 r c # N K t }| j }| j s"t | V |r
|| V dS t |j t j t t | j d }fd|D | j d< dgd |D d |D t | d df}| t dd
g j
}j }i j t
j d t
ffd } t# ||dd D ]J\ \ }
} } \ }
}}| r || n || |
|
k r |||
|
| V K|r || V dS dS )
a Render 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 c 8 i | ]\ }}| |j S rP r- )r} indexr r s r3 r z Text.render.. s+ VVVkeTUIIdj 1 1VVVr5 r )r Fr c 3 0 K | ]\ }}|j d |fV dS r )r+ r} r* r s r3 r z Text.render.. s/
M
M[UDtz5%(
M
M
M
M
M
Mr5 c 3 0 K | ]\ }}|j d |fV dS r r r, s r3 r z Text.render.. s/
J
J+%txu%
J
J
J
J
J
Jr5 Tr r. c t fdt D } | }||S | }|| < |S )z#Construct current style from stack.c 3 ( K | ] }| V
d S r7 rP )r} _style_id style_maps r3 r z9Text.render..get_current_style.. s( OOI9Y/OOOOOOr5 )tuplesorted)styles cached_style
current_stylecombinestack style_cachestyle_cache_getr1 s r3 get_current_stylez&Text.render..get_current_style sc OOOO OOOOOF*?622L'## #GFOOM"/K r5 )r rf rW r r r nulllist enumerater- r^ r r ro removegetr7 zip)r2 r r, _Segmentr\ enumerated_spansr[ stack_append stack_popr; r9 leavingstyle_id next_offset_r7 r r8 r9 r: r1 s @@@@@@r3 r z Text.render sZ z{ $--
$ hsmm### FG -uz||DDD $+q 9 9::VVVVEUVVV y,, !
M
M.iter_text sq z
!"+E"2"2 # #JD$ JJJ # "
# #
! r5 r c 3 F K | ]\ }}} |z |z | V d S r7 rP r| s r3 r z Text.join..' sS %E3 funfslE:: r5 )
r r rR rG rW ro r* r- r^ rX )
r2 r r rM extend_textr extend_spansr\ r~ r9 s
`` @@r3 r z Text.join s/ ??$$ !8F+ ! ! ! ! ! ! ! n+ o, - IKK D K
# # #z
K EE&&3t99* r rR r r r( r r^ rX rW ) r2 rV r ro r
cell_positionr r
tab_remainderr rq s r3 expand_tabszText.expand_tabs/ s tz ! ! F }H H ! JJttJ<< ! !D4:%%t !
44
@@ ! ! !Dz**400 7)-B ).x f
zJ&& 8j(( U4:s:tx'@'@$*MM '&&r5 Nr^ rf r* rW )r2 r~ ra s @@r3 r zText._trim_spanst sU __
AAAr5 ri r characterc t | dk s
J d r>|z }| | j | | _ t fd| j D | j dd< dS dS )zPad left and right with a given number of characters.
Args:
count (int): Width of padding.
character (str): The character to pad with. Must be a string of length 1.
r &Character must be a string of length 1c > g | ]\ }}} |z |z | S rP rP r} r+ r, r- r~ r s r3 r z Text.pad.. E %E3 eemS5[%88 r5 Nrc )r2 r rd pad_charactersr~ s ` @r3 rW zText.pad s 9~~"""$L""" & .N *HDJHHHDJE )- DKNNN r5 c t | dk s
J d r:|z | j | _ t fd| j D | j dd< dS dS )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 rf c > g | ]\ }}} |z |z | S rP rP rh s r3 r z!Text.pad_left.. ri r5 Nrc )r2 r rd r~ s ` @r3 pad_leftz
Text.pad_left s 9~~"""$L""" % -;tz;;DJE )- DKNNN r5 c n t | dk s
J d |r| j ||z | _ dS dS )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 rf N)r^ rf )r2 r rd s r3 r zText.pad_right sS 9~~"""$L""" < J; E(9;;DJJJ < >>>>
lI66666 7 7r5 r c p t |t t f st d t | rxt |t rt | }| j | t | }t | |r,| j t ||z | | xj
z
c_
nt |t rt |t d | j
|j r:| j t | z |j | j |j
| j fd|j D | xj
t | z
c_
| S )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 TextNz2style must not be set when appending Text instancec 3 F K | ]\ }}} |z |z | V d S r7 rP r} r+ r, r- r~ r
s r3 r z Text.append.. sU # #)sE E%+-s[/@%HH# # # # # #r5 )rm rN r( r r^ r rR ro rW r* rX
ValueErrorr- rf rG )r2 r\ r- r_ r9 r~ r
s @@r3 ro z Text.append s $d ,, H FGG G t99 *$$$
*!4T!:!:
!!.111 T !. 1 1 RK&&tFF[4H%'P'PQQQ + D$''
* $$L #l : K&& k;T+BDJOO
!!$*--- "" # # # # #-1[# # # D ) r5 c x t | j |j r:| j t | z |j | j |j | j fd|j D | xj t | z
c_ | S )a
Append another Text instance. This method is more performant that Text.append, but
only works for Text.
Args:
text (Text): The Text instance to append to this instance.
Returns:
Text: Returns self for chaining.
c 3 F K | ]\ }}} |z |z | V d S r7 rP rx s r3 r z#Text.append_text.. sU
!sE
E%+%s['8% @ @
r5 ) r* rX r- rW ro r^ rR rf rG )r2 r\ r~ r
s @@r3 append_textzText.append_text s l : X K uu[+D 2I4: V V W W W
$*%%%
%)[
D ! r5 tokensc
| j j }| j j }t }t | }|D ]J\ }} || |r& | |||t | z | |t | z
}K|| _ | S )a) Append iterable of str and style. Style may be a Style instance or a str style definition.
Args:
tokens (Iterable[Tuple[str, Optional[StyleType]]]): An iterable of tuples containing str content and style.
Returns:
Text: Returns self for chaining.
)rR ro rW r* r^ rX )r2 r} r| r r~ r9 contentr- s r3
append_tokenszText.append_tokens s j' k( T $ # #NGU K
I EE&&3w<<*? G GHHH c'll "FF r5 c D | j |j dS )zCopy styles from another Text instance.
Args:
text (Text): A Text instance to copy styles from, must be the same length.
N)rW rG )r2 r\ s r3 copy_styleszText.copy_styles s"
4;'''''r5 )rS allow_blank separatorrS r c s
J d | j vr"t | g S |rE| d t j t j D }nOdt t ffd }t fd| | D }|s) r|
|S )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 > K | ]}| V d S r7 r r} r s r3 r z Text.split..; s; % r5 r. c 3 K t j t j D ]!} | \ }}|V |V "d S r7 )r r r r )r r+ r, r r\ s r3
flatten_spansz!Text.split..flatten_spans@ s[ [9)=)=t D D E!& JE3 KKK IIII r5 c 3 2 K | ]}|j k
|V d S r7 re )r} r r s r3 r z Text.split..F s8 yAXAXAXAXAXAX r5 ) rf r rn r r r r r rL r pop)r2 r rS r r r r\ s ` @r3 r> z
Text.split# s9 " 77777yz D $))++ '' ' KK )+RYy5I5I4)P)P EE
8C=
!%]]__!=!= E t}}Y 7 7 IIKKK r5 offsetsc t | }|s"t | g S | j t }dg||}t t ||dd }| j | j | j t t fd|D }| j
s|S d |j D }t | }t } | j
D ]\ }
} d} |}
| |
z dz } || \ }}|
|k r|dz
}
n
|
|k r|dz } nn | |
z dz }-| |k r|}n4|x}} |}
|| \ }}| |k r|dz
}
n
| |k r|dz } nn | |
z dz }-t ||dz D ]X}|| \ }}t d|
|z
}t | |z
||z
}||k r || | || Y|S )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 L K | ] \ }} || V dS ))r- rS rT NrP )r} r+ r, r rS rT r- r\ s r3 r z Text.divide..f sb
s
EU3Y !
r5 c & g | ]}|j j S rP )rW ro r s r3 r z Text.divide..r s III+IIIr5 rt )r= r rn rf r^ rA r- rS rT r( rW _linesr* ranger# r; )r2 r _offsetsr
divide_offsets line_ranges new_lines
_line_appends
line_countr~
span_startspan_end lower_bound upper_bound
start_line_no
line_startline_end end_line_noline_no new_startnew_endr rS rT r- r\ s @@@@@r3 r z Text.divideO s == ($))++ '' 'z$ii 4h4 43~~abb/ABBCC
,=
*
{ II 8HIII
%%
+/; $ M $ M 'J%K$K (; 61 . rb r5 N)r^ rf r* rW rR rX )r2 r r~ ra s @@r3 rD zText.right_crop s __v-
AAA j6'*+
r5 r c ` |p
| j pt }|p
| j pt }t || j d p|dk }t
} | d D ]}
d|
v r|
| |rt
|
g } n8t t |
||dk } |
| } | D ]}
|
| |r| |||| | D ]}
|
|| | | | S )
aC Word wrap the text.
Args:
console (Console): Console instance.
width (int): Number of cells available per line.
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.
FrY Tr rR r& )r& r )rT )rS r% rT r' r rU r r> rV r rN r r r\ rG )
r2 r rp rS rT rV rU wrap_justify
wrap_overflowr r r r s
r3 r z Text.wrap sd . A$,A/ EDME5E
GT\599QX=QJJ4J00 $ $Dt|| ***
1 !4&MM %c$ii]f=TUUU KK 0 0 !
'
'&&&&
!!UL= " "
=
=
em
<<<< LL # # # # r5 c t }|j }| D ]"}| | || #|S )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 ro r> r )r2 rp r ro r s r3 fitzText.fit sQ ww JJLL D OOE " " " F4LLLL r5 c d t j d| j t j D } t t
d |D pd}n# t $ r d}Y nw xY w|S )zrAuto-detect indentation of code.
Returns:
int: Number of spaces used to indent code.
c R h | ]$}t | d %S r )r^ r r s r3 z*Text.detect_indentation.. s:
A
r5
^( *)(.*)$r c g | ] }|d z |
S )rt rP )r} indents r3 r z+Text.detect_indentation.. s" R R RvPQz RV R R Rr5 r )r r rf MULTILINEr r r )r2
_indentations indentations r3 detect_indentationzText.detect_indentation s
]DJblSSS
s R R- R R RSSXWX
K KKK s !A A#"A#u │z dim green)rd r- indent_sizec || n|}| }| | d|dz
z }t j d }g }|j } d}
| d D ]} | | j } | r| d s|
dz
}
9| d }
t t |
| \ }}||z d|z }|| j t | d z | _ | |dt | |
r*|
t || g|
z d}
| | |
r(|
t d
| g|
z | d | }|S ) u 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.
Nri r r r Tr rt r) rY rZ )r rn rV r compilero r> r rf r divmodr^ r rG r( r r )r2 r rd r- _indent_sizer\ indent_line re_indentr add_line blank_linesr r r full_indentsremaining_space
new_indentr s r3 with_indent_guideszText.with_indent_guides s $ 5@4Gt..000[ yy{{ ">C> J}-- " # JJ4J00
D OODJ//E
A
q [[^^F,23v;; ,M,M )L/ ', 6Oo8MOOJ#djZ 1B1B&CCDJ LL3z?? 3 3 3
$z"?"?"?!@;!NOOO HTNNNN D d2U 3 3 3 4{ B C C C??4((--i88r5 )rY rY )rY )r. r( )r Nr7 )r. N)ri )r\ r( r. r( )r\ r( r. N)rZ r )RrH rI rJ rK __slots__rN r r r rO rL r r* r` rb r8 rg r4 r rr objectru rw rx r propertyr r classmethodr r r r r r r
r rf setterr[ r rn r r r r r r r GetStyleCallabler r r r r r r r r r& r r rV r\ r rW rm r r ro ro r| r r r r> r rD r r r r rP r5 r3 r( r( u s
I #%0
.2/3"&"&&*0 0 00 S%Z 0
/* 0 +,
0 $ 0 0 3-0 T
#0
0 0 0 0. "$ " " " " 8# 8 8 8 8 S V IF It I I I I
& T IsEz!2 Iv I I I I4 $# $ $ $ X$ X:
$&04-1/3 S%Z
-
/* +,
[ B
$&-1/3"&"## # ## S%Z #
/* # +,
# $ # # 3-#
# # # [#J
.2/3
/* +,
[0 $&-1/3"&)-+ + +c65i #889+ S%Z + /* +
+, + $
+ + + tCH~&+
+ + + [+Z s X \#c #d # # # \# tDz X \ 4: $ \ V " ! E ES%Z E E c] E
E E E E: ! H HS%Z H H c] H
H H H H6 JN 2 2cN 2+. 29A# 2
2 2 2 2 xS#X/ C F ()C )D ) ) ) )9 c e (%3 %4 % % % %0 ?C$
$ $ $$ . 9:;$
$
$ $ $ $V $ } S%Z
:) ) ) ) ?s ?t ? ? ? ? 5S 5T 5 5 5 5; ;+;; ' ; ; ; ;&
;
;+;
;
;
;
;
;9 9 i 9 c 9 8I;N 9 9 9 9 v%(6* %v % % % %N(' ('HSM ('T (' (' (' ('\ 04 / / // +, /
/
/ / / /6
t " c c D < ? .( ( ( ( * #( ! * * ** *
*
* * * *XMhsm M M M M M^ T * .2/3"&. . .. .
/* . +,
. . $ .
. . . .` C . &*. & . . . c]. .
.
. . . . . .r5 __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'greenrs )r- rS zjustify='right'bluerightzjustify='full'magentafull)Br functoolsr r mathr operatorr typingr r r r
r r r
r r r _loopr _pickr _wrapr ro r rE r r
containersr controlr r r jupyterr measurer segmentr r- r r r r r! r" r# r% rM r' r r
rN TextTyper r* r( rH pip._vendor.rich.consoler\ r ruleprintrP r5 r3 r s % % % % % % % % * * * * * * * * ( ( ( ( ( ( ! ! ! ! ! ! # # # # # # # # POOOOOOOOOOOO#, , , ,%+ " + + + G$$ f 1SE8I#6 67 D D D D D: D D DN| | | | |< | | |~% z000000 4 P D 'F+++'H---giiG LL!""" MM$eM$$$ MMOOO LL#$$$ MM$gxM888 MMOOO LL"### MM$fgM666 MMOOO LL!""" MM$iM888 MMOOOOO3 r5