관리-도구
편집 파일: text.cpython-38.pyc
U &?�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� r1 �C/opt/hc_python/lib/python3.8/site-packages/pip/_vendor/rich/text.py�__repr__8 s z Span.__repr__c C s | j | jkS �N)r* r) r/ r1 r1 r2 �__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)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 �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( r8 r= r1 r1 r2 � 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. Nr< )r0 r@ r) r* r+ r1 r1 r2 �extende s z Span.extendN)�__name__� __module__� __qualname__�__doc__�int�__annotations__r �strr r3 �boolr5 r r r; r> r? rA r1 r1 r1 r2 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� )rK rL rM r* rN �spansr! r" ) �textr+ rK rL rM r* rN rS r- c C sL t |�} | g| _|| _|| _|| _|| _|| _|| _|p:g | _t | �| _ d S r4 ) 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__r, c C s | j S r4 )rP r/ r1 r1 r2 �__len__� s z Text.__len__c C s t | j�S r4 )rI rP r/ r1 r1 r2 r5 � s z Text.__bool__c C s | j S r4 ��plainr/ r1 r1 r2 �__str__� s z Text.__str__c C s d| j �d| j�d�S )Nz<text � �>)rZ rO r/ r1 r1 r2 r3 � s z Text.__repr__)�otherr- c C s( t |ttf�r$| �� }|�|� |S tS r4 )� isinstancerH r' �copy�append�NotImplemented)r0 r^ �resultr1 r1 r2 �__add__� s z Text.__add__c C s& t |t�stS | j|jko$| j|jkS r4 )r_ r' rb rZ rO �r0 r^ r1 r1 r2 �__eq__� s z Text.__eq__c C s. t |t�r|| jkS t |t�r*|j| jkS dS )NF)r_ rH rZ r' re r1 r1 r2 � __contains__� s zText.__contains__)�slicer- c sf t dd�� fdd� }t|t �r&||�S |�t� j��\}}}|dkrZ� �||g�}|d S td��d S )Nr' r6 c s. t � t�j� � �fdd��jD �dd�}|S )Nc s6 g | ].\}}}|� kr"|krn q� 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' rZ rO )r7 rT r/ rk r2 � get_text_at� s �� z%Text.__getitem__.<locals>.get_text_atr z%slices with step!=1 are not supported)rF r_ �indicesrU rZ �divide� TypeError)r0 rh rn r) �stop�step�linesr1 r/ r2 � __getitem__� s zText.__getitem__c C s t | j�S )z5Get the number of cells required to render this text.)r rZ r/ r1 r1 r2 r � s z Text.cell_lenc C s� ddl m} g }| j}dd| jffdd� | jD �dd� | jD �t|�d| jff�}|jtdd�d � d}|j}|D ]N\}}} ||kr�|||||� �� |}| rr||r�d | � d �n d | � d �� qrd � |�} | 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+ �rj �spanr1 r1 r2 � <genexpr>� s z Text.markup.<locals>.<genexpr>c s s | ]}|j d |jfV qdS �TN)r* r+ rx r1 r1 r2 rz � s T��keyz[/�]�[rQ ) �markuprv rZ r+ rO rU �sortr ra �join) r0 rv �outputrZ � markup_spans�positionra r7 �closingr+ r� r1 r1 r2 r� � s( ��" z Text.markupT)r+ �emoji� emoji_variantrK rL r* )rT r+ r� r� rK rL 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 )rT r+ rK rL rM r* rN 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 )� AnsiDecoderrR )rK rL rM r* rN r+ c s s | ] }|V qd S r4 r1 �rj �liner1 r1 r2 rz G s z!Text.from_ansi.<locals>.<genexpr>)�ansir� r' r� �decode) r� rT r+ rK rL rM r* rN r� �joiner�decoderrc r1 r1 r2 � from_ansi$ s � zText.from_ansi�rK rL )rT r+ rK rL 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. r� )�stylize)r� rT r+ rK rL � styled_textr1 r1 r2 �styledJ s z Text.styled)r+ rK rL rM r* rN �meta) �partsr+ rK rL rM r* rN r� r- c G sZ | ||||||d�} | j } t} |D ]$} t| | tf�r>| | � q"| | � q"|rV| �|� | 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� )ra r' r_ rH � apply_meta) r� r+ rK rL rM r* rN r� r� rT ra �_Text�partr1 r1 r2 �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 rQ Nr )rU rJ r� r/ r1 r1 r2 rZ � 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)rZ r rJ rP rU � _trim_spans)r0 r� rV � old_lengthr1 r1 r2 rZ � s c C s | j S )z.Get a reference to the internal list of spans.�rO r/ r1 r1 r2 rS � s z Text.spans)rS r- c C s |dd� | _ dS )z Set spans.Nr� )r0 rS r1 r1 r2 rS � s )rZ 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 rZ � 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' rZ r+ rK rL rM r* rN rO )r0 r� r1 r1 r2 r` � 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)rU rO ra r( r8 �r0 r+ r) r* �lengthr1 r1 r2 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)rU rO �insertr( r8 r� r1 r1 r2 �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� )r0 r� r) r* r+ r1 r1 r2 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 )�@r1 )rj r} �valuer1 r1 r2 � <dictcomp> s zText.on.<locals>.<dictcomp>)�update�itemsr� r r� )r0 r� r� r1 r1 r2 �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)rZ �endswithr? rU )r0 r� r1 r1 r2 � remove_suffix s zText.remove_suffixr )�consoler7 r- c C sf |dk rt | �| }|j}|| j��� }| jD ]2\}}}|| krL|kr.n 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+ r` rO )r0 r� r7 r� r+ r) r* � span_styler1 r1 r2 �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 Nr\ c s$ g | ] }|j � kr |���n|�qS r1 )r* rA rx �Z end_offsetr� r1 r2 rm G s �z%Text.extend_style.<locals>.<listcomp>)rS rU rO rJ ra rP rZ )r0 r� rS Z new_spacesr1 r� r2 � extend_style; s � zText.extend_style)� style_prefix)� re_highlightr+ r� r- c C s� d}| j j}t}| j}t�||�D ]�}|j} |rv| � \} } t|�rR||| | � �n|} | dk rv| | krv||| | | �� |d7 }|�� � � D ]8} | | �\} } | dkr�| | kr�||| | |� | � ��� q�q"|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 ���) rO ra r( rZ �re�finditerry �callable� groupdict�keys)r0 r� r+ r� �count� append_spanrl rZ �match�get_spanr) r* � match_style�namer1 r1 r2 �highlight_regexP s" zText.highlight_regex)�case_sensitive)�wordsr+ r� r- c C sp d� dd� |D ��}| jj}d}t}tj|| j|r6dntjd�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 r4 )r� rv �rj �wordr1 r1 r2 rz � s z'Text.highlight_words.<locals>.<genexpr>r ��flagsr ) r� rO ra r( r� r� rZ � IGNORECASEry ) r0 r� r+ r� �re_words�add_spanr� rl r� r) r* r1 r1 r2 �highlight_wordsv s � zText.highlight_wordsc C s | j �� | _ dS )z"Strip whitespace from end of text.N)rZ �rstripr/ r1 r1 r2 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 )rU �_re_whitespace�searchrZ �groupr? r8 )r0 r� � text_length�excess�whitespace_match�whitespace_countr1 r1 r2 � 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)rU � pad_rightr? )r0 r� r� r1 r1 r2 � 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�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 rt � all_linesr1 r1 r2 �__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 r4 �r r� r1 r1 r2 rz � s z(Text.__rich_measure__.<locals>.<genexpr>r c s s | ]}t |�V qd S r4 r� r� r1 r1 r2 rz � s )rZ � splitlines�maxr; r )r0 r� r� rT rt �max_text_widthr� �min_text_widthr1 r1 r2 �__rich_measure__� s �zText.__rich_measure__r )r� r* r- c # sX 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� } t||dd� �D ]J\\} } } \} }}| �r || � n|| � | | kr�||| | � | � �V q�|�rT||�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. Nr� r c s i | ]\}}|� |j ��qS r1 �r+ �rj �indexry )r� r1 r2 r� � s z Text.render.<locals>.<dictcomp>r �r Fr c s s | ]\}}|j d |fV qdS rw )r) r� r1 r1 r2 rz � s z Text.render.<locals>.<genexpr>c s s | ]\}}|j d |fV qdS r{ r� r� r1 r1 r2 rz � s Tr| r, c sB t �fdd�t��D ��} �| �}|dk r.|S � | �}|�| < |S )z#Construct current style from stack.c 3 s | ]}� | V qd S r4 r1 )rj � _style_id)� style_mapr1 r2 rz � s 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 rZ rO r r� r �null�list� enumerater+ rU r� r ra �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� � sB � � & z Text.render)rt r- c s� �� � }td d���fdd� }|jj}|jj}|jj}d�t� |� D ]T}||j� |jrt|� ��t|� |j�� |� �fdd�|jD �� �t|�7 �qF�|_ |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 s8 �j r*t� �D ]\} }|V | s�V qn � E d H d S r4 )rZ r )�lastr� )rt r0 r1 r2 � iter_text s z Text.join.<locals>.iter_textr c 3 s( | ] \}}}� �| �| |�V qd S r4 r1 ri rk r1 r2 rz ' s �z Text.join.<locals>.<genexpr>) r� r rJ rA rO ra r( r+ rU rP )r0 rt r� r � extend_textr� � extend_spansrT r1 )rl rt r7 r0 r2 r� s" �z Text.join)rN r- c C s d| j krdS |dkr | j}|dkr(d}g }|j}| jddd�D ]�}d|j krX||� q@d}|jddd�}|D ]p}|j �d�r�|jd dd� d |jd< ||j7 }|| }|r�|| } |�| � || 7 }n ||j7 }||� qnq@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 ) rZ rN ra r; r� rJ r r� r' r� rU rP rO ) r0 rN r� ra r� Z cell_positionr� r� Z tab_remainderr� rc r1 r1 r2 � expand_tabs/ s8 zText.expand_tabsF)rL �pad)r� rL 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. �ignore�ellipsisr u …r\ N)rL r& r rZ r rJ rU rP )r0 r� rL r � _overflowr� r� r1 r1 r2 �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 r1 �r) r* r8 r+ rx �rl � max_offsetr1 r2 rm x s ��z$Text._trim_spans.<locals>.<listcomp>N)rU rZ r( rO r/ r1 r r2 r� t s �zText._trim_spansr\ )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 �&Character must be a string of length 1c s& g | ] \}}}� |� |� |��qS r1 r1 ri �rl r� r1 r2 rm � s �z Text.pad.<locals>.<listcomp>N�rU �AssertionErrorrZ r( rO )r0 r� r �pad_charactersr1 r! r2 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 r c s& g | ] \}}}� |� |� |��qS r1 r1 ri r! r1 r2 rm � s �z!Text.pad_left.<locals>.<listcomp>Nr" �r0 r� r r1 r! r2 �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 r N)rU r# rZ r% r1 r1 r2 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 rZ r� r& )r0 r' r( r � excess_spacer) r1 r1 r2 r' � s z Text.alignr )rT 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 r4 r1 ri �rl r� r1 r2 rz � s �z Text.append.<locals>.<genexpr>)r_ rH r' rq rU r rJ ra rO r( rP � ValueErrorr+ rZ rA )r0 rT r+ rV r7 r1 r- r2 ra � s8 ���z Text.append)rT 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 r4 r1 ri r- r1 r2 rz � s �z#Text.append_text.<locals>.<genexpr>) r( rP r+ rO ra rU rJ rZ rA �r0 rT r1 r- r2 � append_text� s �zText.append_text)�tokensr- c C sd | j j}| jj}t}t| �}|D ]8\}}||� |rL||||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 ra rO r( rU rP )r0 r1 r0 r� rl 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 r/ r1 r1 r2 � copy_styles s zText.copy_styles)r � allow_blank)� separatorr r5 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 r4 r� �rj r� r1 r1 r2 rz ; s z Text.split.<locals>.<genexpr>r, c 3 s4 t �t �� ���D ] } | �� \}}|V |V qd S r4 )r� r� rv ry )r� r) r* �r6 rT r1 r2 � flatten_spans@ s z!Text.split.<locals>.flatten_spansc 3 s | ]}|j � kr|V qd S r4 rY r� )r6 r1 r2 rz F s ) r# rZ r r` rp r� r� rv r rF r� �pop)r0 r6 r r5 rt r9 r1 r8 r2 r; # 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 } | j D �]$\} } �d} |} | | d }|| \}}| |k r�|d } n| |kr�|d } n�q | | d }q�| |k �r |}nT| }} |} || \}}| |k �rH|d } n| |k�rp|d } n�qp| | d }�q(t ||d �D ]P}|| \}}td| | �}t| | || �}||k�r~|| | ||��� �q~q�|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 )rj r) r* �r� rK rL r+ rT r1 r2 rz f s � �z Text.divide.<locals>.<genexpr>c S s g | ] }|j j�qS r1 )rO ra r� r1 r1 r2 rm r s z Text.divide.<locals>.<listcomp>r+ )r )r r r` rZ rU r r+ rK rL r' rO �_linesr( �ranger� r8 )r0 r; �_offsetsr� �divide_offsets� line_ranges� new_lines� _line_appends� line_countrl � span_start�span_end� lower_bound� upper_bound� start_line_no� line_start�line_end� end_line_no�line_no� new_start�new_endr1 r< r2 rp O s` � 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 r1 r rx r r1 r2 rm � s ��z#Text.right_crop.<locals>.<listcomp>N)rU rZ r( rO rJ rP )r0 rP r1 r r2 r? � s � zText.right_cropr� )r� r( rK rL rN rM r- c C s� |p | j p t}|p| jpt}t|| jd�p0|dk}t� } | jdd�D ]�} d| krZ| �|� |rjt| g�} n t t | �||dkd�} | � | �} | D ]} | � |� q�|r�| j ||||d� | D ]} | j ||d � q�| �| � qD| 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�r5 r r% )r% r� )rL )rK r$ rL r& r rM r r; r r rH rp r� r rA ) r0 r� r( rK rL rN rM � wrap_justify� wrap_overflowrt r� rB r; r1 r1 r2 r� � s0 � z Text.wrap)r( r- c 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 ra r; r� )r0 r( rt ra r� r1 r1 r2 �fit� s zText.fitc C sX dd� t jd| jt jd�D �}z 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 )rU r� r7 r1 r1 r2 � <setcomp>� s �z*Text.detect_indentation.<locals>.<setcomp>� ^( *)(.*)$r� c S s g | ]}|d s|�qS )r+ r1 )rj �indentr1 r1 r2 rm � s z+Text.detect_indentation.<locals>.<listcomp>r )r� r� rZ � MULTILINEr r rq )r0 � _indentations� indentationr1 r1 r2 �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} |jdd�D ]�} |�| j�} | rz| � d�s�| 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 rV r TrQ r+ r� rQ rR )r[ r` r r� �compilera r; r� rZ r� �divmodrU r� rA r' r� r� )r0 r\ r r+ � _indent_sizerT � indent_line� re_indentrB �add_line� blank_linesr� r� rW � full_indents�remaining_space� new_indentr� r1 r1 r2 �with_indent_guides s4 zText.with_indent_guides)rQ rQ )rQ )rQ )r N)r N)r N)N)N)rQ )N)r\ )r\ )r\ )r\ )N)rR )r )N)RrB rC rD rE � __slots__rH r r r rI rF r r( rW rX r5 r[ r3 r rd �objectrf rg rh ru �propertyr r� � classmethodr r� r� r r� r r r� rZ �setterrS r� r` r� r� r� r� r� r� r� �GetStyleCallabler� r r� r� r� r� r r� r r� r� r� r r r� r r& r� r r' ra r0 r3 r4 r r; rp r? r� rT r[ rg r1 r1 r1 r2 r' u 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. ZLorem�boldZipsum�italiczjustify='left'�redr� zjustify='center'�greenr* )r+ rK zjustify='right'�blue�rightzjustify='full'�magenta�full)Br� � functoolsr r �mathr �operatorr �typingr r r r r r r r r r �_loopr �_pickr �_wrapr r' 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 �TextTyperm r( r' rB �pip._vendor.rich.consolerT r� �rule�printr1 r1 r1 r2 �<module> sn 0 G H �