File: //usr/local/lib/python3.10/dist-packages/pip/_vendor/rich/__pycache__/text.cpython-310.pyc
o
��h�� � @ sJ U d dl Z d dlmZmZ d dlmZ d dlmZ d dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd l m Z m Z dd l m Z dd
l!m"Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z( ddl)m*Z* ddl+m,Z,m-Z- e r�ddl.m/Z/m0Z0m1Z1m2Z2 dZ3de4d< dZ5de4d< e �6d�Z7ee8df Z9 e e8gee- f Z:G d d � d e�Z;G d d� de&�Z<e=d k�r#d d l>m/Z/ e<d!�Z?e?�@d"gd#� e?�@d$gd%� e/� Z.e.�Ad&� e.jBe?d'd(� e.�B� e.�Ad)� e.jBe?d*d+d,� e.�B� e.�Ad-� e.jBe?d.d/d,� e.�B� e.�Ad0� e.jBe?d1d2d,� e.�B� dS dS )3� N)�partial�reduce)�gcd)�
itemgetter) �
TYPE_CHECKING�Any�Callable�Dict�Iterable�List�
NamedTuple�Optional�Pattern�Tuple�Union� )� loop_last)� pick_bool)� divide_line)� AlignMethod)�cell_len�
set_cell_size)�Lines)�strip_control_codes)� EmojiVariant)� JupyterMixin)� Measurement)�Segment)�Style� StyleType)�Console�ConsoleOptions�
JustifyMethod�OverflowMethod�defaultr" �DEFAULT_JUSTIFY�foldr# �DEFAULT_OVERFLOWz\s+$�Textc @ s� e Zd ZU dZeed< eed< eeef ed< defdd�Z de
fdd �Z d
ede d e
d f fd d �Zd
edd fd
d�Zd
edd fdd�Zdedd fdd�ZdS )�Spanz A marked up region in some text.�start�end�style�returnc C s d| j � d| j� d| j�d�S )NzSpan(z, �))r* r+ r, ��self� r1 �@/usr/local/lib/python3.10/dist-packages/pip/_vendor/rich/text.py�__repr__9 � z
Span.__repr__c C s | j | jkS �N)r+ r* r/ r1 r1 r2 �__bool__< s z
Span.__bool__�offsetc C sV || j k r | dfS || jkr| dfS | \}}}t|t||�|�}t|j||�}||fS )z)Split a span in to 2 from a given offset.N)r* r+ r) �min)r0 r7 r* r+ r, �span1�span2r1 r1 r2 �split? s
z
Span.splitc C s | \}}}t || || |�S )z�Move 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) �r0 r7 r* r+ r, r1 r1 r2 �moveL s
z Span.movec C s( | \}}}||kr | S t |t||�|�S )z�Crop the span at the given offset.
Args:
offset (int): A value between start and end.
Returns:
Span: A new (possibly smaller) span.
)r) r8 r= r1 r1 r2 �
right_cropX s
zSpan.right_crop�cellsc C s" |r| \}}}t ||| |�S | S )z�Extend the span by the given number of cells.
Args:
cells (int): Additional space to add to end of span.
Returns:
Span: A span.
r< )r0 r@ r* r+ r, r1 r1 r2 �extendf s
z Span.extendN)�__name__�
__module__� __qualname__�__doc__�int�__annotations__r �strr r3 �boolr6 r r
r; r> r? rA r1 r1 r1 r2 r) / s
r) c @ s� e Zd ZdZg d�Z d�ddddddd�dedeeef d ed
d ed d
ee dedee
dee e ddfdd�Z
de
fdd�Zde fdd�Zdefdd�Zdefdd�Zd edd fd d �Zd ede fd d �Zd ede fd!d"�Zd#ee
ef dd fd$d%�Zede
fd&d'��Zedefd(d)��Ze dd*ddddd+�dedeeef d,e d-ee d ed
d ed dedd fd.d/��Z e dddddd0d1�dedeeef d ed
d ed d
ee dedee
dd fd2d3��Z e d�ddd4�dede d ed
d ed dd f
d5d6��Z!e dddddd0dd7�d8eed e"ee f f deeef d ed
d ed d
ee dede
d9ee#eef dd fd:d;��Z$edefd<d=��Z%e%j&d>eddfd?d=��Z%ede e fd@dA��Z'e'j&de e ddfdBdA��Z'd�dCedd fdDdE�Z(d�dFdG�Z) H d�deeef dIe
dee
ddfdJdK�Z* H d�deeef dIe
dee
ddfdLdM�Z+ d�d9e#eef dIe
dee
ddfdNdO�Z,d�d9ee#eef dPedd fdQdR�Z-dSeddfdTdU�Z.dVdWdXe
defdYdZ�Z/d[e
ddfd\d]�Z0 d�dd^�d_ee1e ef deee2e f d`ede
fdadb�Z3d*dc�dde4e deeef dee de
fdfdg�Z5d�dhdi�Z6dje
ddfdkdl�Z7dme
ddfdndo�Z8dVdWdpdqde4e9 fdrds�Z:dVdWdpdqde;fdtdu�Z<d�dVdWdede4dv fdwdx�Z=dye4d dd fdzd{�Z>d�dee
ddfd|d}�Z?dd~d�d�e
d ed d�e ddfd�d��Z@d�d�d��ZAd�d�e
d�eddfd�d��ZBd�d�e
d�eddfd�d��ZCd�d�e
d�eddfd�d��ZDd�d�eEd�e
d�eddfd�d��ZF d�ded ef deeed�f dd fd�d��ZGd�d�d��ZHd�e4e"eee f dd fd�d��ZId�d�d��ZJ d�d~d~d��d�ed�e d�e deKfd�d��ZLd�e4e
deKfd�d��ZMd�d�e
ddfd�d��ZNddd0dd��dVdWd�e
d ed
d ed de
d
ee deKfd�d��ZOd�e
deKfd�d��ZPde
fd�d��ZQ d�d�d�d��d�ee
d�ede dd fd�d��ZRdS )�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, �justify�overflow�no_wrapr+ �tab_size�_spans�_length� N�
)rK rL rM r+ rN �spans�textr, rK r" rL r# rM r+ rN rS r- c
C sL t |�} | g| _|| _|| _|| _|| _|| _|| _|p g | _t | �| _
d S r5 ) r rJ r, rK rL rM r+ rN rO �lenrP )
r0 rT r, rK rL rM r+ rN rS �sanitized_textr1 r1 r2 �__init__� s
z
Text.__init__c C � | j S r5 )rP r/ r1 r1 r2 �__len__� � z Text.__len__c C �
t | j�S r5 )rI rP r/ r1 r1 r2 r6 � s
z
Text.__bool__c C rX r5 ��plainr/ r1 r1 r2 �__str__� rZ z Text.__str__c C s d| j �d| j�d| j�d�S )Nz<text � �>)r] rO r, r/ r1 r1 r2 r3 � r4 z
Text.__repr__�otherc C s( t |ttf�r| �� }|�|� |S tS r5 )�
isinstancerH r( �copy�append�NotImplemented)r0 ra �resultr1 r1 r2 �__add__� s
z Text.__add__c C s& t |t�stS | j|jko| j|jkS r5 )rb r( re r] rO �r0 ra r1 r1 r2 �__eq__� s
z Text.__eq__c C s. t |t�r
|| jv S t |t�r|j| jv S dS )NF)rb rH r] r( rh r1 r1 r2 � __contains__� s
zText.__contains__�slicec sd dt ddf� fdd� }t|t �r||�S |�t� j��\}}}|dkr.� �||g�}|d S td��)Nr7 r- r( c s. t � t�j� � �fdd��jD �dd�}|S )Nc s6 g | ]\}}}|� kr|krn n� d d|��qS )r r r1 ��.0r* r+ r, ��_Spanr7 r1 r2 �
<listcomp>� s
�z9Text.__getitem__.<locals>.get_text_at.<locals>.<listcomp>rQ )rS r+ )r) r( r] rO )r7 rT r/ rn r2 � get_text_at� s �� z%Text.__getitem__.<locals>.get_text_atr z%slices with step!=1 are not supported)rF rb �indicesrU r] �divide� TypeError)r0 rk rq r* �stop�step�linesr1 r/ r2 � __getitem__� s
zText.__getitem__c C r[ )z5Get the number of cells required to render this text.)r r] r/ r1 r1 r2 r � s
z
Text.cell_lenc C s� ddl m} g }| j}dd| jfgdd� | jD ��dd� | jD ��t|�d| jf�}|jtdd�d � d}|j}|D ]'\}}} ||krO|||||� �� |}| ra||rZd
| � d �nd | � d �� q:d
� |�}
|
S )z~Get console markup to render this Text.
Returns:
str: A string potentially creating markup tags.
r )�escaper Fc s � � | ]
}|j d |jfV qdS �FN)r* r, �rm �spanr1 r1 r2 � <genexpr>� � � z Text.markup.<locals>.<genexpr>c s rz �TN)r+ r, r| r1 r1 r2 r~ � r T��keyz[/�]�[rQ )
�markupry r] r, rO rU �sortr rd �join) r0 ry �outputr] � markup_spans�positionrd r7 �closingr, r� r1 r1 r2 r� � s.
���� �
z Text.markupT)r, �emoji�
emoji_variantrK rL r+ r� r� c
C s2 ddl m} |||||d�} || _|| _|| _| 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� rK rL r+ )
�clsrT r, r� r� rK rL r+ r� �
rendered_textr1 r1 r2 � from_markup s zText.from_markup� �r, rK rL rM r+ rN c C sF ddl m} td||||||d�} |� }
| �dd� |
�|�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 )� AnsiDecoderrR )rK rL rM r+ rN r, c s s � | ]}|V qd S r5 r1 �rm �liner1 r1 r2 r~ H s � z!Text.from_ansi.<locals>.<genexpr>)�ansir� r( r� �decode) r� rT r, rK rL rM r+ rN r� �joiner�decoderrf r1 r1 r2 � from_ansi% s � zText.from_ansi�rK rL c C s | |||d�}|� |� |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� rT r, rK rL � styled_textr1 r1 r2 �styledK s
z Text.styled)r, rK rL rM r+ rN �meta�partsr� c
G sZ | ||||||d�} | j }
t} |D ]} t| | tf�r |
| � q|
| � q|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� )rd r( rb rH �
apply_meta)
r� r, rK rL rM r+ rN r� r� rT rd �_Text�partr1 r1 r2 �assembled s" �
z
Text.assemblec C s0 t | j�dkrd�| j�g| jdd�< | jd S )z Get the text as a single string.r rQ Nr )rU rJ r� r/ r1 r1 r2 r] � s
z
Text.plain�new_textc C sP || j kr$t|�}|g| jdd�< | j}t|�| _|| jkr&| �� dS dS dS )z Set the text to a new value.N)r] r rJ rP rU � _trim_spans)r0 r� rV �
old_lengthr1 r1 r2 r] � s
�c C rX )z.Get a reference to the internal list of spans.�rO r/ r1 r1 r2 rS � s z
Text.spansc C s |dd� | _ dS )z
Set spans.Nr� )r0 rS r1 r1 r2 rS � s r] c C s& t || j| j| j| j| j| jd�}|S )zNReturn a new Text instance with copied metadata (but not the string or spans).r� )r( r, rK rL rM r+ rN )r0 r] � copy_selfr1 r1 r2 �
blank_copy� s � zText.blank_copyc C s8 t | j| j| j| j| j| j| jd�}| j|jdd�< |S )z Return a copy of this instance.r� N) r( r] r, rK rL rM r+ rN rO )r0 r� r1 r1 r2 rc � s � z Text.copyr r* c C sn |r5t | �}|dk r|| }|du r|}|dk r || }||ks$||kr&dS | 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)rU rO rd r) r8 �r0 r, r* r+ �lengthr1 r1 r2 r� � s
�z Text.stylizec C sp |r6t | �}|dk r|| }|du r|}|dk r || }||ks$||kr&dS | 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)rU rO �insertr) r8 r� r1 r1 r2 �stylize_before� s
�zText.stylize_beforec C s t �|�}| j|||d� 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� )r0 r� r* r+ r, r1 r1 r2 r� � s
zText.apply_meta�handlersc K s< |du ri n|}|� dd� |�� D �� | �t�|�� | 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 S s i | ]
\}}d |� �|�qS )�@r1 )rm r� �valuer1 r1 r2 �
<dictcomp> � zText.on.<locals>.<dictcomp>)�update�itemsr� r r� )r0 r� r� r1 r1 r2 �on s zText.on�suffixc C s" | j �|�r| �t|�� dS dS )zaRemove a suffix if it exists.
Args:
suffix (str): Suffix to remove.
N)r] �endswithr? rU )r0 r� r1 r1 r2 �
remove_suffix s �zText.remove_suffix�consoler r7 c C sf |dk r
t | �| }|j}|| j��� }| jD ]\}}}|| kr&|kr0n q|||dd�7 }q|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 rQ �r$ )rU � get_styler, rc rO )r0 r� r7 r� r, r* r+ �
span_styler1 r1 r2 �get_style_at_offset( s �zText.get_style_at_offset�spacesc st �dkrdS | j }d� }|r1t| �� � �fdd�|D �| jdd�< | j�|� | j�7 _dS | j|7 _dS )z�Extend 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 Nr_ c s$ g | ]}|j � kr|���n|�qS r1 )r+ rA r| ��
end_offsetr� r1 r2 rp H s ��z%Text.extend_style.<locals>.<listcomp>)rS rU rO rJ rd rP r] )r0 r� rS �
new_spacesr1 r� r2 � extend_style< s � zText.extend_style)� style_prefix� re_highlightr� c C s� d}| j j}t}| j}t|t�rt�|�}|�|�D ]Q}|j } |rD| � \}
} t
|�r2|||
| � �n|} | durD| |
krD|||
| | �� |d7 }|� � � � D ] }
| |
�\}
} |
dkrj| |
krj|||
| |� |
� ��� qNq|S )a% Highlight text with a regular expression, where group names are
translated to styles.
Args:
re_highlight (Union[re.Pattern, str]): A regular expression object or string.
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 ���)
rO rd r) r] rb rH �re�compile�finditerr} �callable� groupdict�keys)r0 r� r, r� �count� append_spanro r] �match�get_spanr* r+ � match_style�namer1 r1 r2 �highlight_regexQ s*
��zText.highlight_regex)�case_sensitive�wordsr� c C sp d� dd� |D ��}| jj}d}t}tj|| j|rdntjd�D ]}|�d�\} }
||| |
|�� |d7 }q |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 s s � | ]}t �|�V qd S r5 )r� ry �rm �wordr1 r1 r2 r~ � s � z'Text.highlight_words.<locals>.<genexpr>r ��flagsr ) r� rO rd r) r� r� r] �
IGNORECASEr} ) r0 r� r, r� �re_words�add_spanr� ro r� r* r+ r1 r1 r2 �highlight_wordsy s
�
zText.highlight_wordsc C s | j �� | _ dS )z"Strip whitespace from end of text.N)r] �rstripr/ r1 r1 r2 r� � s z Text.rstrip�sizec C sV t | �}||kr'|| }t�| j�}|dur)t |�d��}| �t||�� dS dS dS )z�Remove whitespace beyond a certain width at the end of the text.
Args:
size (int): The desired size of the text.
Nr )rU �_re_whitespace�searchr] �groupr? r8 )r0 r� � text_length�excess�whitespace_match�whitespace_countr1 r1 r2 �
rstrip_end� s �zText.rstrip_end�
new_lengthc C s@ t | �}||kr ||k r| �|| � dS | �|| � dS dS )z<Set new length of the text, clipping or padding is required.N)rU � pad_rightr? )r0 r� r� r1 r1 r2 �
set_length� s �zText.set_length�optionsr! c
c s� � | j d u r |j n| j }| jp|jpt}| jp|jpt}| j||j|||p&dt| j|jd�d�}t d��
|�}|j || j d�E d H d S )Nr� F�rK rL rN rM rR �r+ )
rN rK r% rL r' �wrap� max_widthr rM r( r� r� r+ )r0 r� r� rN rK rL rw � all_linesr1 r1 r2 �__rich_console__� s ��zText.__rich_console__c C sT | j }|�� }|rtdd� |D ��nd}|�� }|r#tdd� |D ��n|}t||�S )Nc s � � | ]}t |�V qd S r5 �r r� r1 r1 r2 r~ � � � z(Text.__rich_measure__.<locals>.<genexpr>r c s r� r5 r� r� r1 r1 r2 r~ � r� )r] �
splitlines�maxr; r )r0 r� r� rT rw �max_text_widthr� �min_text_widthr1 r1 r2 �__rich_measure__� s �
zText.__rich_measure__r c # s^ � t }| j}| jst |�V |r||�V dS t|jt�� d��tt| jd��}�fdd�|D ���| j ��d< dgdd � |D ��d
d � |D ��t
|�d df�}|j t dd�d � g ��j
}�j}i ��j�tj� d
tf� ����fdd� } t||dd� �D ]$\\}
} } \}
}}| r�|| � n|| � |
|
kr�|||
|
� | � �V q|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 s i | ]
\}}|� |j ��qS r1 �r, �rm �indexr} )r� r1 r2 r� � r� z Text.render.<locals>.<dictcomp>r )r Fr c s � � | ] \}}|j d |fV qdS r{ )r* r� r1 r1 r2 r~ � � � z Text.render.<locals>.<genexpr>c s r r� r� r� r1 r1 r2 r~ � r Tr� r- c sB t �fdd�t��D ��} �| �}|dur|S � | �}|�| < |S )z#Construct current style from stack.c 3 s � | ]}� | V qd S r5 r1 )rm � _style_id)� style_mapr1 r2 r~ � r� z9Text.render.<locals>.get_current_style.<locals>.<genexpr>N)�tuple�sorted)�styles� cached_style�
current_style)�combine�stack� style_cache�style_cache_getr r1 r2 �get_current_style� s z&Text.render.<locals>.get_current_style)r r] rO r r� r �null�list� enumerater, rU r� r rd �remove�getr �zip)r0 r� r+ �_SegmentrT �enumerated_spansrS � stack_append� stack_popr
r7 �leaving�style_id� next_offset�_r1 )r r� r
r r r r2 r� � sL �
� � � �&
��z Text.renderrw c s� �� � }dtd f��fdd� }|jj}|jj}|jj}d�t� |� D ]*}||j� |jr:|� ��t|� |j�� |� �fdd�|jD �� �t|�7 �q#�|_ |S )z�Join text together with this instance as the separator.
Args:
lines (Iterable[Text]): An iterable of Text instances to join.
Returns:
Text: A new text instance containing join text.
r- r( c 3 s< � �j rt� �D ] \} }|V | s�V qd S � E d H d S r5 )r] r )�lastr� )rw r0 r1 r2 � iter_text s ���z Text.join.<locals>.iter_textr c 3 s* � | ]\}}}� �| �| |�V qd S r5 r1 rl rn r1 r2 r~ * �
� �
�z Text.join.<locals>.<genexpr>)
r� r
rJ rA rO rd r) r, rU rP )r0 rw r� r � extend_textr� � extend_spansrT r1 )ro rw r7 r0 r2 r� s"
�z Text.joinc C s d| j vrdS |du r| j}|du rd}g }|j}| jddd�D ]P}d|j vr,||� q d}|jddd�}|D ]8}|j �d�rf|jd dd� d |jd< ||j7 }|| }|re|| } |�| � || 7 }n||j7 }||� q7q td
�� |�}
|
j g| _t
| j �| _ |
j | j dd�< dS ) ztConverts tabs to spaces.
Args:
tab_size (int, optional): Size of tabs. Defaults to 8.
� Nr� rR T)�include_separatorr r� r_ rQ )
r] rN rd r; r� rJ r r� r( r� rU rP rO ) r0 rN r� rd r� �
cell_positionr� r� �
tab_remainderr� rf r1 r1 r2 � expand_tabs2 s<
�
�
zText.expand_tabsF)rL �padr� r& c C s� |p| j pt}|dkrHt| j�}||kr+|dkr$t| j|d �d | _nt| j|�| _|rJ||k rL|| }| j� d| � �g| _t| j�| _dS dS dS dS )au 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.
�ignore�ellipsisr u …r_ N)rL r' r r] r rJ rU rP )r0 r� rL r& � _overflowr� r� r1 r1 r2 �truncate\ s
�z
Text.truncatec s2 t | j��t� � �fdd�| jD �| jdd�< dS )z=Remove or modify any spans that are over the end of the text.c �< g | ]}|j �k r|j�k r|n � |j t�|j�|j��qS r1 �r* r+ r8 r, r| �ro �
max_offsetr1 r2 rp { �
��z$Text._trim_spans.<locals>.<listcomp>N�rU r] r) rO r/ r1 r- r2 r� w s
�zText._trim_spansr_ r� � characterc s` t |�dks
J d���r.|� }|� | j� |� �| _t� � �fdd�| jD �| jdd�< dS dS )z�Pad 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 | ]\}}}� |� |� |��qS r1 r1 rl �ro r� r1 r2 rp � � ��z Text.pad.<locals>.<listcomp>Nr0 )r0 r� r1 �pad_charactersr1 r4 r2 r& � s ��zText.padc sX t |�dks
J d���r*|� � | j� �| _t� � �fdd�| jD �| jdd�< dS dS )z�Pad the left with a given character.
Args:
count (int): Number of characters to pad.
character (str, optional): Character to pad with. Defaults to " ".
r r2 c r3 r1 r1 rl r4 r1 r2 rp � r5 z!Text.pad_left.<locals>.<listcomp>Nr0 �r0 r� r1 r1 r4 r2 �pad_left� s ��z
Text.pad_leftc C s4 t |�dks
J d��|r| j� || � �| _dS dS )z�Pad the right with a given character.
Args:
count (int): Number of characters to pad.
character (str, optional): Character to pad with. Defaults to " ".
r r2 N)rU r] r7 r1 r1 r2 r� � s �zText.pad_right�align�widthc C sx | � |� |t| j� }|r:|dkr| �||� dS |dkr2|d }| �||� | �|| |� dS | �||� dS dS )z�Align 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 " ".
�left�center� N)r* r r] r� r8 )r0 r9 r: r1 � excess_spacer; r1 r1 r2 r9 � s
�z
Text.alignr c s t |ttf�s td��t|�r�t |t�r=t|�}| j�|� t| �}t|��|r4| j�t ||� |�� | j
�7 _
| S t |t�r�t � |durLt d��| j
�|j ra| j�� ��t|� |j �� | j�|j
� | j�� �fdd�|j�� D �� | j
t|�7 _
| S )z�Add 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 �* � | ]\}}}� |� |� |�V qd S r5 r1 rl �ro r� r1 r2 r~ � r z Text.append.<locals>.<genexpr>)rb rH r( rt rU r rJ rd rO r) rP �
ValueErrorr, r] rA rc )r0 rT r, rV r7 r1 r@ r2 rd � s:
����z Text.appendc st t � | j�|jr| j�� ��t|� |j�� | j�|j� | j�� �fdd�|j� � D �� | jt|�7 _| 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 r? r5 r1 rl r@ r1 r2 r~ r z#Text.append_text.<locals>.<genexpr>)
r) rP r, rO rd rU rJ r] rA rc �r0 rT r1 r@ r2 � append_text� s
�zText.append_text�tokensc C sl | j j}| jj}t}t| �}|D ] \}}t|�}||� |r*||||t|� |�� |t|�7 }q|| _| 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.
)rJ rd rO r) rU r rP )r0 rD rC r� ro r7 �contentr, r1 r1 r2 �
append_tokens s zText.append_tokensc C s | j �|j � dS )z�Copy styles from another Text instance.
Args:
text (Text): A Text instance to copy styles from, must be the same length.
N)rO rA rB r1 r1 r2 � copy_styles s zText.copy_styles)r" � allow_blank� separatorr" rH c s� � sJ d��| j �� �vrt| �� g�S |r(| �dd� t�t�� ���D ��}ndtt f� �fdd� }t� fdd�| �|� �D ��}|sN�� � �rN|�
� |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 s s � | ]}|� � V qd S r5 r� �rm r� r1 r1 r2 r~ ? s �
�z Text.split.<locals>.<genexpr>r- c 3 s6 � t �t �� ���D ]} | �� \}}|V |V q
d S r5 )r� r� ry r} )r� r* r+ �rI rT r1 r2 �
flatten_spansD s � �z!Text.split.<locals>.flatten_spansc 3 s � | ]
}|j � kr|V qd S r5 r\ r� )rI r1 r2 r~ J s � �) r] r rc rs r� r� ry r
rF r� �pop)r0 rI r" rH rw rL r1 rK r2 r; ' s
�
�z
Text.split�offsetsc s� t |�}|s
t| �� g�S | j�t��}dg|�|�}t t||dd� ��}| j�| j�| j�t � t� ����fdd�|D ��}| j
sE|S dd� |j D �}t|�}t } | j
D ]�\}
} �d} |}
| |
d } || \}}|
|k ru|d }
n
|
|kr~|d } nn| |
d }qf| |k r�|}n'| }} |}
|| \}}| |k r�|d }
n
| |kr�|d } nn| |
d }q�t
||d �D ]&}|| \}}td|
| �}t| | || �}||kr�|| | ||��� q�qV|S ) z�Divide 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 s, � | ]\}}� �||� ���d �V qdS ))r, rK rL Nr1 )rm r* r+ �r� rK rL r, rT r1 r2 r~ j s � �
�
�z Text.divide.<locals>.<genexpr>c S s g | ]}|j j�qS r1 )rO rd r� r1 r1 r2 rp v s z Text.divide.<locals>.<listcomp>r= )r r rc r] rU r r, rK rL r( rO �_linesr) �ranger� r8 )r0 rN �_offsetsr� �divide_offsets� line_ranges� new_lines�
_line_appends�
line_countro �
span_start�span_end� lower_bound� upper_bound�
start_line_no�
line_start�line_end� end_line_no�line_no� new_start�new_endr1 rO r2 rs S sl �
�
�
��z Text.divider �amountc sX t | j�| �t� � �fdd�| jD �| jdd�< | jd| � g| _| j|8 _dS )z7Remove a number of characters from the end of the text.c r+ r1 r, r| r- r1 r2 rp � r/ z#Text.right_crop.<locals>.<listcomp>N)rU r] r) rO rJ rP )r0 rc r1 r- r2 r? � s � zText.right_cropr� c
C s� |p| j pt}|p
| jp
t}t|| jd�p|dk}t� } | jdd�D ]I}
d|
v r-|
�|� |r5t|
g�} nt t
|
�||dkd�} |
� | �} | D ]}
|
� |� qG|rZ| j ||||d� | D ] }
|
j
||d � q\| �| � q"| 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.
Fr' T�rH r! r& )r& r� )rL )rK r% rL r' r rM r r; r% r rH rs r� r* rA )
r0 r� r: rK rL rN rM � wrap_justify�
wrap_overflowrw r� rU rN r1 r1 r2 r� � s*
� z Text.wrapc C s0 t � }|j}| �� D ] }|�|� ||� q
|S )z�Fit the text in to given width by chopping in to lines.
Args:
width (int): Maximum characters in a line.
Returns:
Lines: Lines container.
)r rd r; r� )r0 r: rw rd r� r1 r1 r2 �fit� s
zText.fitc C sV dd� t jd| jt jd�D �}zttdd� |D ��pd}W |S ty* d}Y |S w )zrAuto-detect indentation of code.
Returns:
int: Number of spaces used to indent code.
c S s h | ] }t |�d ���qS �r )rU r� rJ r1 r1 r2 � <setcomp>� s ��z*Text.detect_indentation.<locals>.<setcomp>�
^( *)(.*)$r� c S s g | ]}|d s|�qS )r= r1 )rm �indentr1 r1 r2 rp s z+Text.detect_indentation.<locals>.<listcomp>r )r� r� r] � MULTILINEr r rt )r0 �
_indentations� indentationr1 r1 r2 �detect_indentation� s �� ��zText.detect_indentationu │z dim green)r1 r, � indent_sizec C s8 |du r| � � n|}| �� }|�� |� d|d � �}t�d�}g }|j} d}
|jdd�D ]U} |�| j�} | r=| � d�sB|
d7 }
q.| � d�}
t
t |
�|�\}}|| � d| � �}|| jt |�d� | _| � |dt |�� |
r|�
t||d �g|
� d}
| | � q.|
r�|�
td
|d �g|
� |�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.
Nr_ r rj r Trd r= r� rQ rR )ro rc r% r� r� rd r; r� r] r� �divmodrU r� rA r( r� r� )r0 rp r1 r, � _indent_sizerT � indent_line� re_indentrU �add_line� blank_linesr� r� rk � full_indents�remaining_space�
new_indentr� r1 r1 r2 �with_indent_guides s4
zText.with_indent_guides)rQ rQ )rQ )r- r( )r Nr5 )r- N)r_ )rT r( r- r( )rT r( r- N)rR rh )SrB rC rD rE � __slots__rH r r r
rI rF r r) rW rY r6 r^ r3 r rg �objectri rj rk rx �propertyr r� � classmethodr r� r� r r� r r r� r] �setterrS r� rc r� r� r� r� r� r� r� r �GetStyleCallabler� r
r� r� r� r� r r� r r� r� r� r% r* r� r& r8 r� r r9 rd rC rF rG r r; rs r? r� rg ro rz r1 r1 r1 r2 r( v s\
���
����� �
�
� ��
����� �
�!��
����� �
�%������ ���
������ �
�-
�
���
� �
���
��
���
�$ �����
�-��
��
�
��
���
� ;'.����
�
�
��
�
,�
�
�����
�,O�������
�0�������__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.
�Lorem�bold�ipsum�italiczjustify='left'�redr� zjustify='center'�greenr< )r, rK zjustify='right'�blue�rightzjustify='full'�magenta�full)Cr� � functoolsr r �mathr �operatorr �typingr r r r r
r r r
r r r �_loopr �_pickr �_wrapr r9 r r@ r r �
containersr �controlr r� r �jupyterr �measurer �segmentr r, r r r� r r! r" r# r% rG r' r� r� rH �TextTyper� r) r( rB �pip._vendor.rich.consolerT r� �rule�printr1 r1 r1 r2 �<module> sr
4
G
K �
�