File: //opt/alt/python37/lib/python3.7/site-packages/rich/__pycache__/text.cpython-37.pyc
B
��fĸ � @ sB U d dl Z d dlmZmZ d dlmZ d dlmZ d dlm Z m
Z
m Z m Z m
Z
mZmZmZmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lm 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 �rddl-m.Z.m/Z/m0Z0m1Z1 dZ2de3d< dZ4de3d< e �5d�Z6ee7df Z8e e7gee, f Z9G 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-�@d&� e-jAe>d'd(� e-�A� e-�@d)� e-jAe>d*d+d,� e-�A� e-�@d-� e-jAe>d.d/d,� e-�A� e-�@d0� e-jAe>d1d2d,� e-�A� dS )3� N)�partial�reduce)�gcd)�
itemgetter)
�
TYPE_CHECKING�Any�Callable�Dict�Iterable�List�
NamedTuple�Optional�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< ed�dd�Z e
d�dd �Z ee d e
d f d
�d d �Zed d
�d
d�Zed d
�dd�Zed d�dd�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� r/ �:/opt/alt/python37/lib/python3.7/site-packages/rich/text.py�__repr__8 s z
Span.__repr__c C s | j | jkS )N)r* r) )r. r/ r/ r0 �__bool__; s z
Span.__bool__)�offsetr, c 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)r. r3 r) r* r+ Zspan1Zspan2r/ r/ r0 �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( )r. r3 r) r* r+ r/ r/ r0 �moveK 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( r4 )r. r3 r) r* r+ r/ r/ r0 �
right_cropW s
zSpan.right_crop)�cellsr, c C s& |r | \}}}t ||| |�S | S dS )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.
N)r( )r. r8 r) r* r+ r/ r/ r0 �extende s
z Span.extendN)�__name__�
__module__� __qualname__�__doc__�int�__annotations__r �strr r1 �boolr2 r r
r5 r6 r7 r9 r/ r/ r/ r0 r( . s
r( c
@ s� e Zd ZdZdddddddd d
g Zd�d d d d
d d d�eeeef ed ed ee eee
ee e d d� dd�Z
e
d�dd�Ze d�dd�Zed�dd�Zed�dd �Zed d �d d �Zee d �d d!�Zee d �d"d#�Zee
ef d d$�d%d&�Zee
d�d'd(��Zeed�d)d*��Ze d d+d d d d
d,�eeeef e ee ed ed ed d-�d.d/��Z e d d d d d
d0d1�eeeef ed ed ee eee
d d2�d3d4��Z e d�d d d5�ee ed ed d d6�d7d8��Z!e d d d d d
d0d d9�eed e"ee f f eeef ed ed ee ee
ee#eef d d:� d;d<��Z$eed�d=d>��Z%e%j&ed d?�d@d>��Z%ee e d�dAdB��Z'e'j&e e d dC�dDdB��Z'd�ed dE�dFdG�Z(d d�dHdI�Z)d�eeef e
ee
d dK�dLdM�Z*d�eeef e
ee
d dK�dNdO�Z+d�e#eef e
ee
d dP�dQdR�Z,d�ee#eef ed dS�dTdU�Z-ed dV�dWdX�Z.dYe
edZ�d[d\�Z/e
d d]�d^d_�Z0d�d d`�eeee1e f ee
da�dbdc�Z2d+dd�e3e eeef e e
de�dfdg�Z4d d�dhdi�Z5e
d dj�dkdl�Z6e
d dm�dndo�Z7dYdpe3e8 dq�drds�Z9dYdpe:dq�dtdu�Z;d�dYee3dv dw�dxdy�Z<e3d d dz�d{d|�Z=d�ee
d d}�d~d�Z>d d�d��e
ed e d d��d�d��Z?d d�d�d��Z@d�e
ed d��d�d��ZAd�e
ed d��d�d��ZBd�e
ed d��d�d��ZCd�eDe
ed d��d�d��ZEd�ed ef eeed�f d d��d�d��ZFd d d��d�d��ZGe3e"eee f d d��d�d��ZHd d d��d�d��ZId�d�d�d��ee e eJd��d�d��ZKe3e
eJd��d�d��ZLd�e
d d��d�d��ZMd d d0d d��dYe
ed ed e
ee eJd��d�d��ZNe
eJd��d�d��ZOe
d�d�d��ZPd�d�d�d��ee
ee d d��d�d��ZQd S )�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�
)rC rD rE r* rF �spansr! r" ) �textr+ rC rD rE r* rF rK r, c
C sL t |�} | g| _|| _|| _|| _|| _|| _|| _|p:g | _t | �| _
d S )N) r rB r+ rC rD rE r* rF rG �lenrH )
r. rL r+ rC rD rE r* rF rK �sanitized_textr/ r/ r0 �__init__� s
z
Text.__init__)r, c C s | j S )N)rH )r. r/ r/ r0 �__len__� s z Text.__len__c C s
t | j�S )N)rA rH )r. r/ r/ r0 r2 � s z
Text.__bool__c C s | j S )N)�plain)r. r/ r/ r0 �__str__� s z Text.__str__c C s d| j �d| j�d�S )Nz<text � �>)rQ rG )r. r/ r/ r0 r1 � s z
Text.__repr__)�otherr, c C s( t |ttf�r$| �� }|�|� |S tS )N)�
isinstancer@ r' �copy�append�NotImplemented)r. rU �resultr/ r/ r0 �__add__� s
z Text.__add__c C s& t |t�stS | j|jko$| j|jkS )N)rV r' rY rQ rG )r. rU r/ r/ r0 �__eq__� s
z Text.__eq__c C s. t |t�r|| jkS t |t�r*|j| jkS dS )NF)rV r@ rQ r' )r. rU r/ r/ r0 � __contains__� s
zText.__contains__)�slicer, c sf t dd�� fdd� }t|t �r&||�S |�t� j��\}}}|dkrZ� �||g�}|d S td��d S )Nr' )r3 r, c s. t � t�j� � �fdd��jD �dd�}|S )Nc s6 g | ].\}}}|� kr"|krn q� d d|��qS )r r r/ )�.0r) r* r+ )�_Spanr3 r/ r0 �
<listcomp>� s z9Text.__getitem__.<locals>.get_text_at.<locals>.<listcomp>rI )rK r* )r( r' rQ rG )r3 rL )r. )r` r3 r0 � get_text_at� s z%Text.__getitem__.<locals>.get_text_atr z%slices with step!=1 are not supported)r> rV �indicesrM rQ �divide� TypeError)r. r^ rb r) �stop�step�linesr/ )r. r0 � __getitem__� s
zText.__getitem__c C s
t | j�S )z5Get the number of cells required to render this text.)r rQ )r. r/ r/ r0 r � s z
Text.cell_lenc C s� ddl m} g }| j}dd| jffdd� | jD �dd� | jD �t|�d| jff�}|jtdd�d � d}|j}xV|D ]N\}}} ||kr�|||||� �� |}| rt||r�d
| � d �n
d | � d �� qtW d
� |�}
|
S )z~Get console markup to render this Text.
Returns:
str: A string potentially creating markup tags.
r )�escaper Fc s s | ]}|j d |jfV qdS )FN)r) r+ )r_ �spanr/ r/ r0 � <genexpr>� s z Text.markup.<locals>.<genexpr>c s s | ]}|j d |jfV qdS )TN)r* r+ )r_ rk r/ r/ r0 rl � s T)�keyz[/�]�[rI )
�markuprj rQ r+ rG rM �sortr rX �join) r. rj �outputrQ Z markup_spans�positionrX r3 �closingr+ rp r/ r/ r0 rp � s$ $
z Text.markupT)r+ �emoji�
emoji_variantrC rD r* )rL r+ rv rw rC rD 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)rv rw )rp rx rC rD r* )
�clsrL r+ rv rw rC rD r* rx Z
rendered_textr/ r/ r0 � from_markup s zText.from_markup� )r+ rC rD rE r* rF )rL r+ rC rD rE r* rF r, 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 )� AnsiDecoderrJ )rC rD rE r* rF r+ c s s | ]
}|V qd S )Nr/ )r_ �liner/ r/ r0 rl G s z!Text.from_ansi.<locals>.<genexpr>)�ansir| r' rr �decode) ry rL r+ rC rD rE r* rF r| �joiner�decoderrZ r/ r/ r0 � from_ansi$ s zText.from_ansi)rC rD )rL r+ rC rD r, 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.
)rC rD )�stylize)ry rL r+ rC rD Z styled_textr/ r/ r0 �styledJ s
z Text.styled)r+ rC rD rE r* rF �meta) �partsr+ rC rD rE r* rF r� r, c
G s^ | ||||||d�} | j }
t} x,|D ]$} t| | tf�r@|
| � q$|
| � q$W |rZ| �|� | 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+ rC rD rE r* rF )rX r' rV r@ �
apply_meta)
ry r+ rC rD rE r* rF r� r� rL rX �_Text�partr/ r/ r0 �assemblec s
z
Text.assemblec C s0 t | j�dkr&d�| j�g| jdd�< | jd S )z Get the text as a single string.r rI Nr )rM rB rr )r. r/ r/ r0 rQ � s z
Text.plain)�new_textr, c C sH || j krDt|�}|g| jdd�< | j}t|�| _|| jkrD| �� dS )z Set the text to a new value.N)rQ r rB rH rM � _trim_spans)r. r� rN Z
old_lengthr/ r/ r0 rQ � s
c C s | j S )z.Get a reference to the internal list of spans.)rG )r. r/ r/ r0 rK � s z
Text.spans)rK r, c C s |dd� | _ dS )z
Set spans.N)rG )r. rK r/ r/ r0 rK � s )rQ 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+ rC rD rE r* rF )r' r+ rC rD rE r* rF )r. rQ � copy_selfr/ r/ r0 �
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+ rC rD rE r* rF N) r' rQ r+ rC rD rE r* rF rG )r. r� r/ r/ r0 rW � s
z Text.copyr )r+ r) r* r, c C sj |rft | �}|dk r || }|dkr(|}|dk r8|| }||ksH||krLdS | j�t|t||�|�� 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)rM rG rX r( r4 )r. r+ r) r* �lengthr/ r/ r0 r� � s
z Text.stylizec C sl |rht | �}|dk r || }|dkr(|}|dk r8|| }||ksH||krLdS | j�dt|t||�|�� 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)rM rG �insertr( r4 )r. r+ r) r* r� r/ r/ r0 �stylize_before� s
zText.stylize_before)r� r) r* r, c 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� )r. r� r) r* r+ r/ r/ r0 r� � s
zText.apply_meta)r� �handlersr, c K s< |dkr i 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 )�@r/ )r_ rm �valuer/ r/ r0 �
<dictcomp> s zText.on.<locals>.<dictcomp>)�update�itemsr� r r� )r. r� r� r/ r/ r0 �on
s zText.on)�suffixr, c C s | j �|�r| �t|�� dS )zaRemove a suffix if it exists.
Args:
suffix (str): Suffix to remove.
N)rQ �endswithr7 rM )r. r� r/ r/ r0 �
remove_suffix s zText.remove_suffixr )�consoler3 r, c C sj |dk rt | �| }|j}|| j��� }x<| jD ]2\}}}|| krN|kr0n q0|||dd�7 }q0W |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 rI )r# )rM � get_styler+ rW rG )r. r� r3 r� r+ r) r* Z
span_styler/ r/ r0 �get_style_at_offset' s zText.get_style_at_offset)�spacesr, c sr �dkr dS | j }d� }|r`t| �� � �fdd�|D �| jdd�< | j�|� | j�7 _n| 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 NrS c s$ g | ] }|j � kr |���n|�qS r/ )r* r9 )r_ rk )�
end_offsetr� r/ r0 ra H s z%Text.extend_style.<locals>.<listcomp>)rK rM rG rB rX rH rQ )r. r� rK Z
new_spacesr/ )r� r� r0 � extend_style; s zText.extend_style)� style_prefix)� re_highlightr+ r� r, c C s� d}| j j}t}| j}x�t�||�D ]�}|j} |rx| � \}
} t|�rT|||
| � �n|} | dk rx| |
krx|||
| | �� |d7 }xH|�� � � D ]8}
| |
�\}
} |
dkr�| |
kr�|||
| |� |
� ��� q�W q$W |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 ���)
rG rX r( rQ �re�finditerrk �callable� groupdict�keys)r. r� r+ r� �count� append_spanr` rQ �matchZget_spanr) r* Z match_style�namer/ r/ r0 �highlight_regexP s"
zText.highlight_regex)�case_sensitive)�wordsr+ r� r, c C st d� dd� |D ��}| jj}d}t}xJtj|| j|r8dntjd�D ]*}|�d�\} }
||| |
|�� |d7 }qBW |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 )N)r� rj )r_ �wordr/ r/ r0 rl � s z'Text.highlight_words.<locals>.<genexpr>r )�flagsr ) rr rG rX r( r� r� rQ �
IGNORECASErk ) r. r� r+ r� Zre_wordsZadd_spanr� r` r� r) r* r/ r/ r0 �highlight_wordsv s zText.highlight_wordsc C s | j �� | _ dS )z"Strip whitespace from end of text.N)rQ �rstrip)r. r/ r/ r0 r� � s z Text.rstrip)�sizer, c C sN t | �}||krJ|| }t�| j�}|dk rJt |�d��}| �t||�� dS )z�Remove whitespace beyond a certain width at the end of the text.
Args:
size (int): The desired size of the text.
Nr )rM �_re_whitespace�searchrQ �groupr7 r4 )r. r� � text_lengthZexcessZwhitespace_matchZwhitespace_countr/ r/ r0 �
rstrip_end� s zText.rstrip_end)�
new_lengthr, c C s: t | �}||kr6||k r(| �|| � n| �|| � dS )z<Set new length of the text, clipping or padding is required.N)rM � pad_rightr7 )r. r� r� r/ r/ r0 �
set_length� s
zText.set_lengthr )r� �optionsr, c
c s� | j d kr|j n| j }| jp$|jp$t}| jp4|jp4t}| j||j|||pJdt| j|jd�d�}t d��
|�}|j || j d�E d H d S )Nr{ F)rC rD rF rE rJ )r* )
rF rC r$ rD r& �wrap� max_widthr rE r' rr rx r* )r. r� r� rF rC rD rh Z all_linesr/ r/ r0 �__rich_console__� s zText.__rich_console__c C sT | j }|�� }|r$tdd� |D ��nd}|�� }|rFtdd� |D ��n|}t||�S )Nc s s | ]}t |�V qd S )N)r )r_ r} r/ r/ r0 rl � s z(Text.__rich_measure__.<locals>.<genexpr>r c s s | ]}t |�V qd S )N)r )r_ r� r/ r/ r0 rl � s )rQ �
splitlines�maxr5 r )r. r� r� rL rh Zmax_text_widthr� Zmin_text_widthr/ r/ r0 �__rich_measure__� s zText.__rich_measure__r )r� r* r, c # s\ t }| j}| js,t |�V |r(||�V dS t|jt�� d��tt| jd��}�fdd�|D ���| j ��d< ddd � |D �d
d � |D �t
|�d dff�}|j t dd�d � g ��j
}�j}i ��j�tj� td
�� ����fdd� } x`t||dd� �D ]J\\}
} } \}
}}| �r || � n|| � |
|
kr�|||
|
� | � �V q�W |�rX||�V 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.
N)r# r c s i | ]\}}� |j �|�qS r/ )r+ )r_ �indexrk )r� r/ r0 r� � s z Text.render.<locals>.<dictcomp>r �r Fr c s s | ]\}}|j d |fV qdS )FN)r) )r_ r� rk r/ r/ r0 rl � s z Text.render.<locals>.<genexpr>c s s | ]\}}|j d |fV qdS )TN)r* )r_ r� rk r/ r/ r0 rl � s T)rm )r, c sB t �fdd�t��D ��} �| �}|dk r.|S � | �}|�| < |S )z#Construct current style from stack.c 3 s | ]}� | V qd S )Nr/ )r_ Z _style_id)� style_mapr/ r0 rl � s z9Text.render.<locals>.get_current_style.<locals>.<genexpr>N)�tuple�sorted)ZstylesZ cached_styleZ
current_style)�combine�stack� style_cache�style_cache_getr� r/ r0 �get_current_style� s z&Text.render.<locals>.get_current_style)r� )r rQ rG r r� r �null�list� enumerater+ rM rq r rX �remove�getr� �zip)r. r� r* Z_SegmentrL Zenumerated_spansrK Z stack_appendZ stack_popr� r3 ZleavingZstyle_idZ next_offset�_r/ )r� r� r� r� r� r� r0 rx � s>
(
z Text.render)rh r, c s� �� � }td d���fdd� }|jj}|jj}|jj}d�t� x^|� D ]T}||j� |jrv|� ��t|� |j�� |� �fdd�|jD �� �t|�7 �qHW �|_ |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 r.x0t� �D ]\} }|V | s�V qW n
� E d H d S )N)rQ r )�lastr} )rh r. r/ r0 � iter_text s z Text.join.<locals>.iter_textr c 3 s( | ] \}}}� �| �| |�V qd S )Nr/ )r_ r) r* r+ )r` r3 r/ r0 rl ( s z Text.join.<locals>.<genexpr>)
r� r
rB r9 rG rX r( r+ rM rH )r. rh r� r� Z extend_textr� Z extend_spansrL r/ )r` rh r3 r. r0 rr s"
z Text.join)rF r, c C s" d| j krdS |dkr | j}|dkr(d}g }|j}x�| jddd�D ]�}d|j krZ||� qBd}|jddd�}xx|D ]p}|j �d�r�|jd dd� d |jd< ||j7 }|| }|r�|| } |�| � || 7 }n
||j7 }||� qrW qBW 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{ rJ T)�include_separatorr r� rS rI )
rQ rF rX r5 r� rB r r� r' rr rM rH rG ) r. rF r� rX r} Z
cell_positionr� r� Z
tab_remainderr� rZ r/ r/ r0 � expand_tabs/ s8
zText.expand_tabsF)rD �pad)r� rD r� r, c C s� |p | j p t}|dkr�t| j�}||krV|dkrHt| j|d �d | _nt| j|�| _|r�||k r�|| }| j� d| � �g| _t| j�| _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.
�ignoreZellipsisr u …rS N)rD r& r rQ r rB rM rH )r. r� rD r� Z _overflowr� r� r/ r/ r0 �truncateY 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 s< g | ]4}|j �k r|j�k r |n� |j t�|j�|j��qS r/ )r) r* r4 r+ )r_ rk )r` �
max_offsetr/ r0 ra y s z$Text._trim_spans.<locals>.<listcomp>N)rM rQ r( rG )r. r/ )r` r� r0 r� t s
zText._trim_spansrS )r� � characterr, c s\ t |�dkstd���rX|� }|� | j� |� �| _t� � �fdd�| jD �| jdd�< 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 z&Character must be a string of length 1c s& g | ] \}}}� |� |� |��qS r/ r/ )r_ r) r* r+ )r` r� r/ r0 ra � s z Text.pad.<locals>.<listcomp>N)rM �AssertionErrorrQ r( rG )r. r� r� Zpad_charactersr/ )r` r� r0 r� � s zText.padc sT t |�dkstd���rP|� � | j� �| _t� � �fdd�| jD �| jdd�< 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 z&Character must be a string of length 1c s& g | ] \}}}� |� |� |��qS r/ r/ )r_ r) r* r+ )r` r� r/ r0 ra � s z!Text.pad_left.<locals>.<listcomp>N)rM r� rQ r( rG )r. r� r� r/ )r` r� r0 �pad_left� s z
Text.pad_leftc C s0 t |�dkstd��|r,| j� || � �| _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 z&Character must be a string of length 1N)rM r� rQ )r. r� r� r/ r/ r0 r� � s zText.pad_right)�align�widthr� r, c C sp | � |� |t| j� }|rl|dkr2| �||� n:|dkr`|d }| �||� | �|| |� n | �||� 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 rQ r� r� )r. r� r� r� Z excess_spacer� r/ r/ r0 r� � s
z
Text.alignr )rL r+ r, c s t |ttf�std��t|�r�t |t�rxt|�}| j�|� t| �}t|��|rh| j�t ||� |�� | j
�7 _
n�t |t�r�t � |dk r�t d��| j
�|j r�| j�� ��t|� |j �� | j�|j
� | j�� �fdd�|jD �� | 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 s( | ] \}}}� |� |� |�V qd S )Nr/ )r_ r) r* r+ )r` r� r/ r0 rl � s z Text.append.<locals>.<genexpr>)rV r@ r' re rM r rB rX rG r( rH �
ValueErrorr+ rQ r9 )r. rL r+ rN r3 r/ )r` r� r0 rX � s4
z Text.append)rL r, c sp t � | j�|jr.| j�� ��t|� |j�� | j�|j� | j�� �fdd�|jD �� | 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 s( | ] \}}}� |� |� |�V qd S )Nr/ )r_ r) r* r+ )r` r� r/ r0 rl � s z#Text.append_text.<locals>.<genexpr>) r( rH r+ rG rX rM rB rQ r9 )r. rL r/ )r` r� r0 � append_text� s
zText.append_text)�tokensr, c C sh | j j}| jj}t}t| �}x@|D ]8\}}||� |rN||||t|� |�� |t|�7 }q"W || _| 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.
)rB rX rG r( rM rH )r. r� r� r� r` r3 �contentr+ r/ r/ r0 �
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)rG r9 )r. rL r/ r/ r0 � copy_styles s zText.copy_styles)r� � allow_blank)� separatorr� r� r, c s� � s t d��| j�� �kr(t| �� g�S |rP| �dd� t�t�� ���D ��}n6tt d�� �fdd� }t� fdd�| �|� �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 s s | ]}|� � V qd S )N)r* )r_ r� r/ r/ r0 rl < s z Text.split.<locals>.<genexpr>)r, c 3 s8 x2t �t �� ���D ] } | �� \}}|V |V qW d S )N)r� r� rj rk )r� r) r* )r� rL r/ r0 �
flatten_spans@ s z!Text.split.<locals>.flatten_spansc 3 s | ]}|j � kr|V qd S )N)rQ )r_ r} )r� r/ r0 rl G s ) r� rQ r rW rd r� r� rj r
r> r� �pop)r. r� r� r� rh r� r/ )r� rL r0 r5 # s z
Text.split)�offsetsr, c s� t |�}|st| �� g�S | j�t��}d ||f�}t t||dd� ��}| j�| j�| j�t � t� ����fdd�|D ��}| j
s�|S dd� |j D �}t|�}t } �x:| j
D �].\}
} �d} |}
| |
d }xD|| \}}|
|k r�|d }
n|
|k�r|d } nP | |
d }q�W | |k �r$|}nV| }} |}
xH|| \}}| |k �rR|d }
n| |k�rf|d } nP | |
d }�q2W xbt
||d �D ]P}|| \}}td|
| �}t| | || �}||k�r�|| | ||��� �q�W q�W |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+ rC rD Nr/ )r_ r) r* )r� rC rD r+ rL r/ r0 rl g s z Text.divide.<locals>.<genexpr>c S s g | ] }|j j�qS r/ )rG rX )r_ r} r/ r/ r0 ra r s z Text.divide.<locals>.<listcomp>r� )r )r� r rW rQ rM r� r+ rC rD r' rG �_linesr( �ranger� r4 )r. r� Z_offsetsr� Zdivide_offsetsZ line_ranges� new_linesZ
_line_appends�
line_countr` Z
span_startZspan_endZ lower_boundZ upper_boundZ
start_line_noZ
line_startZline_endZ end_line_no�line_noZ new_startZnew_endr/ )r� rC rD r+ rL r0 rd O sd
z Text.divider )�amountr, c sX t | j�| �t� � �fdd�| jD �| jdd�< | jd| � g| _| j|8 _dS )z7Remove a number of characters from the end of the text.c s< g | ]4}|j �k r|j�k r |n� |j t�|j�|j��qS r/ )r) r* r4 r+ )r_ rk )r` r� r/ r0 ra � s z#Text.right_crop.<locals>.<listcomp>N)rM rQ r( rG rB rH )r. r� r/ )r` r� r0 r7 � s zText.right_crop)rC rD rF rE )r� r� rC rD rF rE r, c
C s� |p | j p t}|p| jpt}t|| jd�p0|dk}t� } x�| jdd�D ]�}
d|
kr\|
�|� |rlt|
g�} n t t
|
�||dkd�} |
� | �} x| D ]}
|
� |� q�W |r�| j ||||d� x| D ]}
|
j
||d � q�W | �| � qFW | 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)r� r� r% )r% )rC rD )rD )rC r$ rD r& r rE r r5 r� r r@ rd r� r� r9 )
r. r� r� rC rD rF rE Z wrap_justifyZ
wrap_overflowrh r} r� r� r/ r/ r0 r� � s(
z Text.wrap)r� r, c C s4 t � }|j}x"| �� D ]}|�|� ||� qW |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 rX r5 r� )r. r� rh rX r} r/ r/ r0 �fit� s
zText.fitc C sX dd� t jd| jt jd�D �}y ttdd� |D ��p6d}W n tk
rR d}Y nX |S )zrAuto-detect indentation of code.
Returns:
int: Number of spaces used to indent code.
c S s h | ]}t |�d ���qS )r )rM r� )r_ r� r/ r/ r0 � <setcomp>� s z*Text.detect_indentation.<locals>.<setcomp>z
^( *)(.*)$)r� c S s g | ]}|d s|�qS )r� r/ )r_ �indentr/ r/ r0 ra � s z+Text.detect_indentation.<locals>.<listcomp>r )r� r� rQ � MULTILINEr r re )r. Z
_indentations� indentationr/ r/ r0 �detect_indentation� s
zText.detect_indentationu │z dim green)r� r+ )� indent_sizer� r+ r, c C s@ |dkr| � � n|}| �� }|�� |� d|d � �}t�d�}g }|j} d}
x�|jdd�D ]�} |�| j�} | r|| � d�s�|
d7 }
q^| � d�}
t
t |
�|�\}}|| � d| � �}|| jt |�d� | _| � |dt |�� |
�r|�
t||d �g|
� d}
| | � q^W |
�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.
NrS r z
^( *)(.*)$r T)r� r� )r+ rI rJ )r rW r� r� �compilerX r5 r� rQ r� �divmodrM r� r9 r' r� rr )r. r r� r+ Z _indent_sizerL Z indent_lineZ re_indentr� Zadd_lineZ blank_linesr} r� r� Z full_indentsZremaining_spaceZ
new_indentr� r/ r/ r0 �with_indent_guides s4
zText.with_indent_guides)rI rI )rI )rI )r N)r N)r N)N)N)rI )N)rS )rS )rS )rS )N)rJ )r )N)Rr: r; r< r= � __slots__r@ r r r
rA r> r r( rO rP r2 rR r1 r r[ �objectr\ r] r^ ri �propertyr rp � classmethodr rz r� r r� r r r� rQ �setterrK r� rW r� r� r� r� r� r� r� �GetStyleCallabler� r
r� r� r� r� r r� r r� rx rr r� r� r� r� r� r� r r� rX r� r� r� r r5 rd r7 r� r� r r r/ r/ r/ r0 r' u s 6 (,H#
%
;'. *
&O '�__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.
ZLoremZboldZipsumZitaliczjustify='left'Zred)r+ zjustify='center'Zgreenr� )r+ rC zjustify='right'Zblue�rightzjustify='full'Zmagenta�full)Br� � functoolsr r �mathr �operatorr �typingr r r r r
r r r
r r Z_loopr Z_pickr �_wrapr r� r r8 r r Z
containersr �controlr rv r Zjupyterr Zmeasurer �segmentr r+ r r r� r r r! r" r$ r? r& r r� r@ ZTextTyper
r( r' r: Z rich.consolerL r� Zrule�printr/ r/ r/ r0 �<module> sl 0
G H