B od^@sddlmZddlmZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZmZmZmZmZmZddlmZmZmZmZmZdd lmZmZdd lmZe rdd l m!Z!m"Z"m#Z#ed Z$Gd ddeZ%eee%ee%ee&e'ffee%e&e&ffZ(eGdddeZ)GdddZ*GdddZ+e,dkrddl-m!Z!ddl.m/Z/ddl0m1Z1dZ2e13dZ4e!Z e 5de 6de 6de 6e/e2ddd e 6e 6d!e7e 8e4Z9e 6e9e 6e 6d"e 6e4e 6d#d$S)%)IntEnum) lru_cache) filterfalse) getLogger) attrgetter) TYPE_CHECKINGDictIterableList NamedTupleOptionalSequenceTupleTypeUnion)_is_single_cell_widthscached_cell_lencell_lenget_character_cell_size set_cell_size)Result rich_repr)Style)ConsoleConsoleOptions RenderResultrichc@sPeZdZdZdZdZdZdZdZdZ 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__BELLCARRIAGE_RETURNHOMECLEAR SHOW_CURSOR HIDE_CURSORENABLE_ALT_SCREENDISABLE_ALT_SCREEN CURSOR_UP CURSOR_DOWNCURSOR_FORWARDCURSOR_BACKWARDCURSOR_MOVE_TO_COLUMNCURSOR_MOVE_TO ERASE_IN_LINESET_WINDOW_TITLErBrBJ/var/www/html/venv/lib/python3.7/site-packages/pip/_vendor/rich/segment.pyr#s"rc @s*eZdZUdZeed<dZeeed<dZ ee e ed<e e dddZedd d Zedd d Ze edd dZeedde eddddZe eddddZeddddZedEedeeeeeddddZedFedeeddddZeedeedd d!d"ZedGede eeeeeedd$d%d&ZedHede eeeedd'd(d)Z eede d*d+d,Z!eeedee e fd-d.d/Z"edIeede ee eeeeedd0d1d2Z#edJe$deede e eeeedd3d4d5Z%edKe$deede e eeeedd3d6d7Z&edLe$deede e eeeedd3d8d9Z'eededd d:d;Z(eededd dd?Z*eededd d@dAZ+eedee eeddBdCdDZ,dS)MSegmentaA 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. textNstylecontrol)returncCs|\}}}|rdSt|S)zzThe number of terminal cells required to display self.text. Returns: int: A number of cells. r)r)selfrE_stylerGrBrBrC cell_lengthQs zSegment.cell_lengthccs:|jV|jdkr&|jdk r6|jVn|jV|jVdS)N)rErGrF)rIrBrBrC __rich_repr__[s    zSegment.__rich_repr__cCs t|jS)z#Check if the segment contains text.)boolrE)rIrBrBrC__bool__dszSegment.__bool__cCs |jdk S)z,Check if the segment contains control codes.N)rG)rIrBrBrC is_controlhszSegment.is_controli@)rDrD)segmentcutrHc Cs0|\}}}t}|j}||kr,||d||fSt}t||t|d} |d| } t| } | |kr|| ||||| d||fSx| t|kr"|| } | d7} | || 7} |d| } | |kr|| ||||| d||fS| |kr|| d| dd|||d|| d||fSqWtddS)Nr zWill never reach here)rDrKrintlenrAssertionError) clsrPrQrErFrG_SegmentrK cell_sizeposbeforecell_poscharrBrBrC _split_cellsms0      zSegment._split_cells)rQrHcCsb|\}}}t|rV|t|kr.|td||fSt|d|||t||d||fS|||S)a0Split 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. Returns: Tuple[Segment, Segment]: Two segments. rRN)rrUrDr^)rIrQrErFrGrBrBrC split_cellss  zSegment.split_cellscCs|dS)zMake a new line segment. rB)rWrBrBrClinesz Segment.line)segmentsrF post_stylerHcs>|}|r"|jfdd|D}r:fdd|D}|S)aApply 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). c3s,|]$\}}}||rdn||VqdS)NrB).0rErJrG)applyrWrBrC sz&Segment.apply_style..c3s4|],\}}}||rdn|r$|n|VqdS)NrB)rdrErJrG)rWrcrBrCrfs )__add__)rWrbrFrcresult_segmentsrB)rerWrcrC apply_styles  zSegment.apply_styleF)rbrOrHcCs$|rttd|Sttd|SdS)a2Filter 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. rGN)filterrr)rWrbrOrBrBrCfilter_controlszSegment.filter_control)rbrHc csg}|j}xp|D]h}d|jkrp|jsp|\}}}xH|rl|d\}} }|rV||||| r0|Vg}|j}q0Wq||qW|r|VdS)aSplit 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. r`N)appendrErG partition) rWrbrarlrPrErF__textnew_linerBrBrC split_liness     zSegment.split_linesT)rblengthrFpadinclude_new_linesrHccsg}|j}|j}|d} x|D]} d| jkr| js| \} } } xd| r| d\}}} |rd|||| |r>|||||d}|r|| |V|q>Wq|| qW|r|||||dVdS)aSplit 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. r`)rFrsN)rladjust_line_lengthrErGrmclear)rWrbrrrFrsrtrarlrunew_line_segmentrPrE segment_stylernrorp cropped_linerBrBrCsplit_and_crop_lines s*    zSegment.split_and_crop_lines)rarrrFrsrHc Cstdd|D}||krF|r8||d|||g}q|dd}n||krg}|j}d}xl|D]V}|j} || |ks~|jr|||| 7}qb|\} } } t| ||} ||| | PqbWn |dd}|S)aAdjust 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. css|] }|jVqdS)N)rK)rdrPrBrBrCrfKsz-Segment.adjust_line_length..rSNr)sumrlrKrGr) rWrarrrFrs line_lengthrprlrPsegment_lengthrErxrnrBrBrCru8s(    zSegment.adjust_line_length)rarHcsttfdd|DS)zGet 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. c3s |]\}}}|s|VqdS)NrB)rdrErFrG) _cell_lenrBrCrfpsz*Segment.get_line_length..)rr{)rWrarB)r~rCget_line_lengthes zSegment.get_line_length)linesrHcs0|j|r tfdd|Dnd}|t|fS)zGet 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. c3s|]}|VqdS)NrB)rdra)rrBrCrf}sz$Segment.get_shape..r)rmaxrU)rWr max_widthrB)rrC get_shapers zSegment.get_shape)rwidthheightrF new_linesrHc s|p t|}|r$|ddgn|dg}|j|d|}fdd|D|dd<t||kr||g|t||S)aSet 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. rSr`Ncsg|]}|dqS))rFrB)rdra)rurFrrBrC sz%Segment.set_shape..)rUruextend) rWrrrrFr_heightblank shaped_linesrB)rurFrrC set_shapes (  zSegment.set_shape)rWrrrrFrrHcCs`|t|}|s|ddS|d|}|r>|d|d|n |d||}||gg|}|S)aAligns 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. NrSr`)rU)rWrrrrFr extra_linesrrBrBrC align_tops   $zSegment.align_topcCs`|t|}|s|ddS|d|}|r>|d|d|n |d||}|gg||}|S)aAligns 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. NrSr`)rU)rWrrrrFrrrrBrBrC align_bottoms   $zSegment.align_bottomc Cs||t|}|s|ddS|d|}|r>|d|d|n |d||}|d}||} |gg|||gg| }|S)aAligns 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. NrSr`r)rU) rWrrrrFrrr top_lines bottom_linesrBrBrC align_middles   $zSegment.align_middleccsxt|}y t|}Wntk r(dSXt}x>|D]6}|j|jkr`|js`||j|j|j}q4|V|}q4W|VdS)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)iternext StopIterationrDrFrGrE)rWrb iter_segments last_segmentrXrPrBrBrCsimplifys   zSegment.simplifyccsNxH|D]@}|js|jdkr"|Vq|\}}}|||r>|dndVqWdS)zRemove all links from an iterable of styles. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with link removed. N)rGrF update_link)rWrbrPrErF_controlrBrBrC strip_linkss  zSegment.strip_linksccs&x |D]\}}}||d|VqWdS)zRemove all styles from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with styles replace with None NrB)rWrbrErJrGrBrBrC strip_styles)s zSegment.strip_stylesccs^i}xT|D]L\}}}|rH||}|dkr8|j}|||<||||Vq ||d|Vq WdS)zRemove all color from an iterable of segments. Args: segments (Iterable[Segment]): An iterable segments. Yields: Segment: Segments with colorless style. N)get without_color)rWrbcacherErFrGcolorless_stylerBrBrC remove_color6s  zSegment.remove_color)rbcutsrHccsNg}|j}t|}x*t|d}|dkr*gS|dkr4PgVqWd}|j}|j} t} x|D]} | \} } }x| r<|rv|n || | }||kr|| |}P||kr|| | V||}t|d}|dkr|r| VdSPn6| ||\}} | \} } }||| V||}t|d}|dkrh|r6| VdSqhWqXW| VdS)zDivides 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. rN)rlrrrvcopyrr_)rWrbrsplit_segments add_segment iter_cutsrQrZsegments_clear segments_copyr~rPrErJrGend_posr[rBrBrCdivideLsZ         zSegment.divide)NN)F)NTT)NT)NNF)F)F)F)-r.r/r0r1str__annotations__rFr rrGr ControlCodepropertyrTrKrrLrMrNrO classmethodrrr^r_rar rirkr rqrzrurrrrrrrrrrrrrBrBrBrCrD?s~   &# '& "   rDc@s:eZdZdZd eeeddddZddd d d d 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. FN)rbrrHcCst||_||_dS)N)listrbr)rIrbrrBrBrC__init__s zSegments.__init__rrr)consoleoptionsrHccs<|jr,t}x(|jD]}|V|VqWn |jEdHdS)N)rrDrarb)rIrrrarPrBrBrC__rich_console__s   zSegments.__rich_console__)F) r.r/r0r1r rDrMrrrBrBrBrCrsrc@s:eZdZd eeeeddddZdddd d d ZdS) SegmentLinesFN)rrrHcCst||_||_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)rrr)rIrrrBrBrCrs zSegmentLines.__init__rrr)rrrHccsN|jr0t}x:|jD]}|EdH|VqWnx|jD]}|EdHq8WdS)N)rrDrar)rIrrrprarBrBrCrs    zSegmentLines.__rich_console__)F) r.r/r0r r rDrMrrrBrBrBrCrs r__main__)r)Syntax)Textzfrom rich.console import Console console = Console() text = Text.from_markup("Hello, [bold magenta]World[/]!") console.print(text)zHello, [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) 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):enumr functoolsr itertoolsrloggingroperatorrtypingrrr r r r r rrrcellsrrrrrreprrrrFrrrrrlogrrTrrrDrrr.pip._vendor.rich.consoleZpip._vendor.rich.syntaxrpip._vendor.rich.textrcode from_markuprEruleprintrrender fragmentsrBrBrBrCs\     0  V