File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/rich/__pycache__/segment.cpython-310.pyc
Back
o ;j�d � @ s� d dl mZ d dlmZ d dlmZ d dlmZ d dlm Z m Z m Z m Z m Z mZmZmZmZmZ ddlmZmZmZmZmZ ddlmZmZ dd l m Z e rXdd l m Z m Z m!Z! G d d � d e�Z"eee" ee"ee#e$f f ee"e#e#f f Z%e� G d d� de ��Z&G dd� d�Z'G dd� d�Z(e)dkr�d dl*m Z d dl+m,Z, d dl-m.Z. dZ/e.�0d�Z1e � Z e �2d� e �3d� e �3d� e �3e,e/d d d �� e �3� e �3d � e4e �5e1��Z6e �3e6� e �3� e �3d � e �3e1� e �3d!� d"S d"S )#� )�IntEnum)� lru_cache)� filterfalse)� attrgetter) � TYPE_CHECKING�Dict�Iterable�List� NamedTuple�Optional�Sequence�Tuple�Type�Union� )�_is_single_cell_widths�cached_cell_len�cell_len�get_character_cell_size� set_cell_size)�Result� rich_repr)�Style)�Console�ConsoleOptions� RenderResultc @ sP e Zd ZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdS )� ControlTypezDNon-printable control codes which typically translate to ANSI codes.r � � � � � � � � � � � � � � � N)�__name__� __module__� __qualname__�__doc__ZBELLZCARRIAGE_RETURN�HOMEZCLEARZ SHOW_CURSORZ HIDE_CURSORZENABLE_ALT_SCREENZDISABLE_ALT_SCREENZ CURSOR_UPZ CURSOR_DOWNZCURSOR_FORWARDZCURSOR_BACKWARDZCURSOR_MOVE_TO_COLUMNZCURSOR_MOVE_TOZ ERASE_IN_LINEZSET_WINDOW_TITLE� r1 r1 �@/opt/saltstack/salt/lib/python3.10/site-packages/rich/segment.pyr s$ r c @ s� e Zd ZU dZeed< dZee ed< dZ ee e ed< e de fdd��Zdefd d �Zdefd d �Ze defd d��Zeed�dd de ded fdd���Zde ded fdd�ZedJdd��Ze dKded dee dee ded fdd ��Ze dLded d eded fd d ��Z eded dee d fd!d"��Z eded deee d ef fd#d$��Z e % %dMded d&e dee d'ed(edee d f d)d*��Z e %dNd+e d d&e dee d'ede d f d,d-��Z!ed+e d de fd.d/��Z"ed0e e d dee e f fd1d2��Z#e dOd0e e d d3e d4ee dee d5ede e d f d6d7��Z$e dLd8e%d d0e e d d3e d4e ded5ede e d fd9d:��Z&e dLd8e%d d0e e d d3e d4e ded5ede e d fd;d<��Z'e dLd8e%d d0e e d d3e d4e ded5ede e d fd=d>��Z(eded ded fd?d@��Z)eded ded fdAdB��Z*eded ded fdCdD��Z+eded ded fdEdF��Z,eded dGee dee d fdHdI��Z-dS )P�Segmenta� A piece of text with associated style. Segments are produced by the Console render process and are ultimately converted in to strings to be written to the terminal. Args: text (str): A piece of text. style (:class:`~rich.style.Style`, optional): An optional style to apply to the text. control (Tuple[ControlCode], optional): Optional sequence of control codes. Attributes: cell_length (int): The cell length of this Segment. �textN�style�control�returnc C s | \}}}|r dS t |�S )zzThe number of terminal cells required to display self.text. Returns: int: A number of cells. r )r )�selfr4 �_styler6 r1 r1 r2 � cell_lengthN s zSegment.cell_lengthc c sB � | j V | jd u r| jd ur| jV d S d S | jV | jV d S �N)r4 r6 r5 �r8 r1 r1 r2 � __rich_repr__X s � � zSegment.__rich_repr__c C s t | j�S )z#Check if the segment contains text.)�boolr4 r< r1 r1 r2 �__bool__a s zSegment.__bool__c C s | j duS )z,Check if the segment contains control codes.N)r6 r< r1 r1 r2 � is_controle s zSegment.is_controli @ �segment�cut)r3 r3 c C s> |\}}}t }|j}||kr||d||�fS t}t|| t|� �} |d| � } t| �} | | } | sC|| ||�||| d� ||�fS | dkri||| �dkri||d| � d ||�|d|| d d� ||�fS | dkr�||| d �dkr�||d| d � d ||�|d|| d� ||�fS | |k r�| d7 } n| d8 } q#)a\ Split a segment in to two at a given cell position. Note that splitting a double-width character, may result in that character turning into two spaces. Args: segment (Segment): A segment to split. cut (int): A cell position to cut on. Returns: A tuple of two segments. � TN���r � r )r3 r: r �int�lenr ) �clsrA rB r4 r5 r6 �_Segmentr: Z cell_size�pos�beforeZcell_posZout_byr1 r1 r2 � _split_cellsj s6 �� � �zSegment._split_cellsc C sn | \}}}|dks J �t |�r1|t|�kr | td||�fS t|d|� ||�t||d� ||�fS | �| |�S )ax Split segment in to two segments at the specified column. If the cut point falls in the middle of a 2-cell wide character then it is replaced by two spaces, to preserve the display width of the parent segment. Args: cut (int): Offset within the segment to cut. Returns: Tuple[Segment, Segment]: Two segments. r rC N)r rG r3 rL )r8 rB r4 r5 r6 r1 r1 r2 � split_cells� s � zSegment.split_cellsc C s | d�S )zMake a new line segment.� r1 )rH r1 r1 r2 �line� s z Segment.line�segments� post_stylec s> |}|r|j � � �fdd�|D �}�r ��fdd�|D �}|S )a Apply style(s) to an iterable of segments. Returns an iterable of segments where the style is replaced by ``style + segment.style + post_style``. Args: segments (Iterable[Segment]): Segments to process. style (Style, optional): Base style. Defaults to None. post_style (Style, optional): Style to apply on top of segment style. Defaults to None. Returns: Iterable[Segments]: A new iterable of segments (possibly the same iterable). c 3 s. � | ]\}}}�||r d n� |�|�V qd S r; r1 ��.0r4 r9 r6 )�applyrH r1 r2 � <genexpr>� s � � �z&Segment.apply_style.<locals>.<genexpr>c 3 s6 � | ]\}}}� ||r d n|r|� n�|�V qd S r; r1 rR )rH rQ r1 r2 rU � s � ��� �)�__add__)rH rP r5 rQ Zresult_segmentsr1 )rT rH rQ r2 � apply_style� s � � zSegment.apply_styleFr@ c C s |r t td�|�S ttd�|�S )a2 Filter segments by ``is_control`` attribute. Args: segments (Iterable[Segment]): An iterable of Segment instances. is_control (bool, optional): is_control flag to match in search. Returns: Iterable[Segment]: And iterable of Segment instances. r6 )�filterr r )rH rP r@ r1 r1 r2 �filter_control� s zSegment.filter_controlc c s� � g }|j }|D ]3}d|jv r7|js7|\}}}|r6|�d�\}} }|r*|| ||�� | r4|V g }|j }|sq||� q|rC|V dS dS )a Split a sequence of segments in to a list of lines. Args: segments (Iterable[Segment]): Segments potentially containing line feeds. Yields: Iterable[List[Segment]]: Iterable of segment lists, one per line. rN N��appendr4 r6 � partition� rH rP rO r[ rA r4 r5 �_�_text�new_liner1 r1 r2 � split_lines� s( � �� �zSegment.split_linesc c s� � g }|j }|D ]5}d|jv r9|js9|\}}}|r8|�d�\}} }|r*|| ||�� | r6|dfV g }|j }|sq||� q|rG|dfV dS dS )a2 Split a sequence of segments in to a list of lines and a boolean to indicate if there was a new line. Args: segments (Iterable[Segment]): Segments potentially containing line feeds. Yields: Iterable[List[Segment]]: Iterable of segment lists, one per line. rN TFNrZ r] r1 r1 r2 �split_lines_terminator s( � �� �z Segment.split_lines_terminatorT�length�pad�include_new_linesc c s� � g }|j }| j}| d�} |D ]A} d| jv rL| jsL| \} } } | rK| �d�\}}} |r1|| || �� |rI|||||d�}|rB|� | � |V |�� | s q|| � q|r^|||||d�V dS dS )a� Split segments in to lines, and crop lines greater than a given length. Args: segments (Iterable[Segment]): An iterable of segments, probably generated from console.render. length (int): Desired line length. style (Style, optional): Style to use for any padding. pad (bool): Enable padding of lines that are less than `length`. Returns: Iterable[List[Segment]]: An iterable of lines of segments. rN )r5 rd N)r[ �adjust_line_lengthr4 r6 r\ �clear)rH rP rc r5 rd re rO r[ rf Znew_line_segmentrA r4 � segment_styler^ r_ r` Z cropped_liner1 r1 r2 �split_and_crop_lines2 s4 � � �� �z Segment.split_and_crop_linesrO c C s� t dd� |D ��}||k r%|r || d|| |�g }|S |dd� }|S ||krag }|j}d}|D ],}|j} || |k s@|jrI||� || 7 }q2|\} } } t| || �} || | | �� |S |S |dd� }|S )a Adjust a line to a given width (cropping or padding as required). Args: segments (Iterable[Segment]): A list of segments in a single line. length (int): The desired width of the line. style (Style, optional): The style of padding if used (space on the end). Defaults to None. pad (bool, optional): Pad lines with spaces if they are shorter than `length`. Defaults to True. Returns: List[Segment]: A line of segments with the desired length. c s s � | ]}|j V qd S r; )r: )rS rA r1 r1 r2 rU t s � z-Segment.adjust_line_length.<locals>.<genexpr>rE Nr )�sumr[ r: r6 r ) rH rO rc r5 rd Z line_lengthr` r[ rA Zsegment_lengthr4 rh r^ r1 r1 r2 rf a s. �� �zSegment.adjust_line_lengthc s t � t� fdd�|D ��S )z�Get the length of list of segments. Args: line (List[Segment]): A line encoded as a list of Segments (assumes no '\\n' characters), Returns: int: The length of the line. c 3 s" � | ] \}}}|s� |�V qd S r; r1 )rS r4 r5 r6 �� _cell_lenr1 r2 rU � s � z*Segment.get_line_length.<locals>.<genexpr>)r rj )rH rO r1 rk r2 �get_line_length� s zSegment.get_line_length�linesc s0 | j � |rt� fdd�|D ��nd}|t|�fS )z�Get the shape (enclosing rectangle) of a list of lines. Args: lines (List[List[Segment]]): A list of lines (no '\\n' characters). Returns: Tuple[int, int]: Width and height in characters. c 3 s � | ]}� |�V qd S r; r1 �rS rO �rm r1 r2 rU � s � z$Segment.get_shape.<locals>.<genexpr>r )rm �maxrG )rH rn Z max_widthr1 rp r2 � get_shape� s zSegment.get_shape�width�height� new_linesc s� |pt |�}|r| d� d ��gn| d� ��g}| j� |d|� }� ��fdd�|D �|dd�< t |�|k rD|�|g|t |� � |S )a� Set the shape of a list of lines (enclosing rectangle). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style, optional): Style of any padding added. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. rE rN Nc s g | ] }� |��d ��qS ))r5 r1 ro �rf r5 rs r1 r2 � <listcomp>� s �z%Segment.set_shape.<locals>.<listcomp>)rG rf �extend) rH rn rs rt r5 ru Z_height�blankZ shaped_linesr1 rv r2 � set_shape� s &� � zSegment.set_shaperH c C s` |t |� }|s|dd� S |d|� }|r | d| d |�n| d| |�}||gg| }|S )a� Aligns lines to top (adds extra lines to bottom as required). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style): Style of any padding added. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. NrE rN �rG �rH rn rs rt r5 ru � extra_linesry r1 r1 r2 � align_top� � $zSegment.align_topc C s` |t |� }|s|dd� S |d|� }|r | d| d |�n| d| |�}|gg| | }|S )a� Aligns render to bottom (adds extra lines above as required). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style): Style of any padding added. Defaults to None. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. NrE rN r{ r| r1 r1 r2 � align_bottom� r zSegment.align_bottomc C s| |t |� }|s|dd� S |d|� }|r | d| d |�n| d| |�}|d }|| } |gg| | |gg| }|S )a� Aligns lines to middle (adds extra lines to above and below as required). Args: lines (List[List[Segment]]): A list of lines. width (int): Desired width. height (int, optional): Desired height or None for no change. style (Style): Style of any padding added. new_lines (bool, optional): Padded lines should include " ". Defaults to False. Returns: List[List[Segment]]: New list of lines. NrE rN r r{ ) rH rn rs rt r5 ru r} ry Z top_linesZ bottom_linesr1 r1 r2 � align_middle s $ zSegment.align_middlec c sv � t |�}zt|�}W n ty Y dS w t}|D ]}|j|jkr0|js0||j|j |j�}q|V |}q|V dS )a) Simplify an iterable of segments by combining contiguous segments with the same style. Args: segments (Iterable[Segment]): An iterable of segments. Returns: Iterable[Segment]: A possibly smaller iterable of segments that will render the same way. N)�iter�next� StopIterationr3 r5 r6 r4 )rH rP Z iter_segmentsZ last_segmentrI rA r1 r1 r2 �simplify& s � �� zSegment.simplifyc c sL � |D ] }|j s |jdu r|V q|\}}}| ||r |�d�nd�V qdS )z�Remove all links from an iterable of styles. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with link removed. N)r6 r5 Z update_link)rH rP rA r4 r5 Z_controlr1 r1 r2 � strip_linksA s � �zSegment.strip_linksc c s$ � |D ] \}}}| |d|�V qdS )z�Remove all styles from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with styles replace with None Nr1 )rH rP r4 r9 r6 r1 r1 r2 � strip_stylesR s � �zSegment.strip_stylesc c s\ � i }|D ]&\}}}|r$|� |�}|du r |j}|||< | |||�V q| |d|�V qdS )z�Remove all color from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with colorless style. N)�getZ without_color)rH rP �cacher4 r5 r6 Zcolorless_styler1 r1 r2 � remove_color_ s � �zSegment.remove_color�cutsc c sF � g }|j }t|�} t|d�}|dkrdS |dkrng V q d}|j}|j} t} |D ]q} | \} } }| r�|r8|n|| | � }||k rI|| � |}nS||krm|| � | � V |� |}t|d�}|dkrl|ri| � V dS n/| �|| �\}} | \} } }||� | � V |� |}t|d�}|dkr�|r�| � V dS | s4q+| � V dS )z�Divides an iterable of segments in to portions. Args: cuts (Iterable[int]): Cell positions where to divide. Yields: [Iterable[List[Segment]]]: An iterable of Segments in List. TrD Nr )r[ r� r� rg �copyr rM )rH rP r� Zsplit_segmentsZ add_segmentZ iter_cutsrB rJ Zsegments_clearZ segments_copyrl rA r4 r9 r6 Zend_posrK r1 r1 r2 �divideu sb � � �� #zSegment.divide)r7 r3 )NN�F)NTT)NT)NNF).r, r- r. r/ �str�__annotations__r5 r r r6 r � ControlCode�propertyrF r: r r= r> r? r@ � classmethodr r rL rM rO r rW rY r ra rb ri rf rm rr rz r r~ r� r� r� r� r� r� r� r1 r1 r1 r2 r3 < sJ / ���� �(��� � � � ������ �.����� �, $ � ����� �#�� ����� � �� ����� � �� ����� � �� �r3 c @ sB e Zd ZdZddee deddfdd�Z ddd�ZdS )�Segmentsa= A simple renderable to render an iterable of segments. This class may be useful if you want to print segments outside of a __rich_console__ method. Args: segments (Iterable[Segment]): An iterable of segments. new_lines (bool, optional): Add new lines between segments. Defaults to False. FrP ru r7 Nc C s t |�| _|| _d S r; )�listrP ru )r8 rP ru r1 r1 r2 �__init__� s zSegments.__init__�consoler �optionsr r c c s< � | j rt�� }| jD ]}|V |V q d S | jE d H d S r; )ru r3 rO rP )r8 r� r� rO rA r1 r1 r2 �__rich_console__� s � �zSegments.__rich_console__r� �r� r r� r r7 r ) r, r- r. r/ r r3 r> r� r� r1 r1 r1 r2 r� � s ���r� c @ sB e Zd Zddeee deddfdd�Z dd d�ZdS )� SegmentLinesFrn ru r7 Nc C s t |�| _|| _dS )a= A simple renderable containing a number of lines of segments. May be used as an intermediate in rendering process. Args: lines (Iterable[List[Segment]]): Lists of segments forming lines. new_lines (bool, optional): Insert new lines after each line. Defaults to False. N)r� rn ru )r8 rn ru r1 r1 r2 r� � s zSegmentLines.__init__r� r r� r r c c sJ � | j rt�� }| jD ] }|E d H |V q d S | jD ]}|E d H qd S r; )ru r3 rO rn )r8 r� r� r` rO r1 r1 r2 r� � s � � �z SegmentLines.__rich_console__r� r� ) r, r- r. r r r3 r> r� r� r1 r1 r1 r2 r� � s ���r� �__main__)r )�Syntax)�Textz�from rich.console import Console console = Console() text = Text.from_markup("Hello, [bold magenta]World[/]!") console.print(text)z Hello, [bold magenta]World[/]!z rich.Segmentz]A Segment is the last step in the Rich render process before generating text with ANSI codes.z Consider the following code: �pythonT)Z line_numberszRWhen you call [b]print()[/b], Rich [i]renders[/i] the object in to the following: zAThe Segments are then processed to produce the following output: zS You will only need to know this if you are implementing your own Rich renderables.N)7�enumr � functoolsr � itertoolsr �operatorr �typingr r r r r r r r r r Zcellsr r r r r �reprr r r5 r r� r r r r rF r� r� r3 r� r� r, Z rich.consoleZ rich.syntaxr� Z rich.textr� �codeZ from_markupr4 Zrule�printr� ZrenderZ fragmentsr1 r1 r1 r2 �<module> sh 0 �� � � ��
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings