관리-도구
편집 파일: console.cpython-38.pyc
U &?�fe� � @ s U d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZmZ d dl m Z m Z d dl m Z d dl mZ d dlmZ d dlmZ d dl mZ d d lmZ d d lmZ d d lmZ d d lmZmZm Z d d l m Z m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z, d dl-m.Z. ej/dk�r8d dl m0Z0m1Z1m2Z2 nd dl3m0Z0m1Z1m2Z2 ddl4m5Z5m6Z6 ddl7m7Z7 ddl8m9Z9m:Z: ddl;m<Z< ddl=m>Z>m?Z? ddl@mAZAmBZB ddlCmDZDmEZE ddlFmGZG ddlHmIZI ddlJmKZKmLZL dd lMmNZO dd lPmQZQmRZR dd lSmTZTmUZU dd lVmWZWmXZX dd lYmZZZ dd!l[m\Z\ dd"l]m^Z^ dd#l_m`Z` dd$lambZb dd%lcmdZdmeZe dd&lfmgZg dd'lhmiZimjZjmkZk dd(llmmZmmnZn dd)lompZpmqZq e �r�dd*lrmsZs dd+ltmuZu dd,lvmwZw d-Zxd.Zye�z� d/kZ{e!e+e|d0f gd0f Z}e0d1 Z~e0d2 ZG d3d4� d4�Z�e�� Z�zej���� Z�W n e�k �rD d Z�Y nX zej���� Z�W n e�k �rn dZ�Y nX zej���� Z�W n e�k �r� d5Z�Y nX e�e�e�fZ�e�e�fZ�eDj�eDj�eDj�d6�Z�G d7d8� d8e&�Z�e G d9d:� d:��Z�e2G d;d<� d<e1��Z�e2G d=d>� d>e1��Z�e+e�e�e|f Z�e#e+e�ebf Z�eK� Z�G d?d@� d@e��Z�G dAdB� dB�Z�G dCdD� dD�Z�G dEdF� dF�Z�G dGdH� dH�Z�G dIdJ� dJ�Z�G dKdL� dL�Z�G dMdN� dN�Z�d�e�e!dPe!dPe�f f dQ�dRdS�Z�e�dT�dUdV�Z�eDj�eDj�eDj�eDj{dW�Z�dXdY� e���� D �Z�e G dZd[� d[ej���Z�G d\d]� d]e�Z�da�e'd^ e�d_< d^dT�d`da�Z�e�dT�dbdc�Z�G ddde� de�Z�e|e|df�dgdh�Z�e�dik�re�dOdj�Z�e���dkdldmdOdnddodpdqdrds�dtdu�� e���dvdwe�e��� e���dg dOdxdydzd{d|gd|d}�d~�dndd�d�d�d�gd�d}�d�dd5dtd�gd�d}�d��d��d��� dS )�� N)�ABC�abstractmethod)� dataclass�field)�datetime)�wraps)�getpass)�escape)�isclass)�islice)�ceil)� monotonic)� FrameType� ModuleType� TracebackType)�IO� TYPE_CHECKING�Any�Callable�Dict�Iterable�List�Mapping� NamedTuple�Optional�TextIO�Tuple�Type�Union�cast)� NULL_FILE)� � )�Literal�Protocol�runtime_checkable� )�errors�themes)�_emoji_replace)�CONSOLE_HTML_FORMAT�CONSOLE_SVG_FORMAT)� get_fileno)�FormatTimeCallable� LogRender)�Align� AlignMethod)� ColorSystem� blend_rgb)�Control)� EmojiVariant)�NullHighlighter�ReprHighlighter��render)� Measurement�measure_renderables)�Pager� SystemPager)�Pretty� is_expandable)� rich_cast)�Region)� render_scope)�Screen)�Segment)�Style� StyleType��Styled)�DEFAULT_TERMINAL_THEME�SVG_EXPORT_THEME� TerminalTheme)�Text�TextType)�Theme� ThemeStack)�WindowsConsoleFeatures)�Live��Status�s �d �WindowsrK )�default�left�center�right�full)�fold�crop�ellipsis�ignorec @ s e Zd ZdS )�NoChangeN)�__name__� __module__� __qualname__� rc rc �F/opt/hc_python/lib/python3.8/site-packages/pip/_vendor/rich/console.pyr_ V s r_ � )�kitty�256color�16colorc @ s" e Zd ZU dZeed< eed< dS )�ConsoleDimensionszSize of the terminal.�width�heightN)r` ra rb �__doc__�int�__annotations__rc rc rc rd ri t s ri c @ s� e Zd ZU dZeed< eed< eed< eed< eed< eed< eed< d Z e e ed < d Z e e ed < d Ze e ed < d Ze e ed< d Ze e ed< d Ze e ed< eed�dd��Zd d�dd�Zeeeeeeeeed� eeef eeef eeef ee e ef ee e ef ee e ef ee e ef ee e ef ee e ef d d� dd�Zed d�dd �Zed d �d d �Zd d�d d!�Zeed d"�d#d$�Z d S )%�ConsoleOptionsz$Options for __rich_console__ method.�size�legacy_windows� min_width� max_width� is_terminal�encoding� max_heightN�justify�overflowF�no_wrap� highlight�markuprk ��returnc C s | j �d� S )z+Check if renderables should use ascii only.�utf)ru � startswith��selfrc rc rd � ascii_only� s zConsoleOptions.ascii_onlyc C s t �t �}| j�� |_|S )zdReturn a copy of the options. Returns: ConsoleOptions: a copy of self. )ro �__new__�__dict__�copy�r� �optionsrc rc rd r� � s zConsoleOptions.copy) rj rr rs rw rx ry rz r{ rk ) rj rr rs rw rx ry rz r{ rk r} c C s� | � � } t|t�s$td|� | _| _t|t�s4|| _t|t�sD|| _t|t�sT|| _t|t�sd|| _t|t�st|| _t|t�s�|| _ t|t�s�|| _ t| t�s�| dk r�| | _ | dkr�dntd| �| _ | S )z Update values, return a copy.r N) r� � isinstancer_ �maxrr rs rw rx ry rz r{ rv rk ) r� rj rr rs rw rx ry rz r{ rk r� rc rc rd �update� s, zConsoleOptions.update�rj r} c C s | � � }td|� |_|_|S )z�Update just the width, return a copy. Args: width (int): New width (sets both min_width and max_width) Returns: ~ConsoleOptions: New console options instance. r )r� r� rr rs )r� rj r� rc rc rd � update_width� s zConsoleOptions.update_width�rk r} c C s | � � }| |_|_|S )z�Update the height, and return a copy. Args: height (int): New height Returns: ~ConsoleOptions: New Console options instance. )r� rv rk )r� rk r� rc rc rd � update_height� s z ConsoleOptions.update_heightc C s | � � }d|_|S )z�Return a copy of the options with height set to ``None``. Returns: ~ConsoleOptions: New console options instance. N)r� rk r� rc rc rd � reset_height� s zConsoleOptions.reset_height)rj rk r} c C s* | � � }td|� |_|_| |_|_|S )a Update the width and height, and return a copy. Args: width (int): New width (sets both min_width and max_width). height (int): New height. Returns: ~ConsoleOptions: New console options instance. r )r� r� rr rs rk rv )r� rj rk r� rc rc rd �update_dimensions� s z ConsoleOptions.update_dimensions) r` ra rb rl ri rn �boolrm �strrw r � JustifyMethodrx �OverflowMethodry rz r{ rk �propertyr� r� � NO_CHANGEr r_ r� r� r� r� r� rc rc rc rd ro } sT � � % ro c @ s( e Zd ZdZedd ef d�dd�ZdS )�RichCastz5An object that may be 'cast' to a console renderable.�ConsoleRenderabler| c C s d S �Nrc r� rc rc rd �__rich__ s zRichCast.__rich__N)r` ra rb rl r r� r� rc rc rc rd r� s �r� c @ s" e Zd ZdZdddd�dd�ZdS ) r� z-An object that supports the console protocol.�Consolero � RenderResult��consoler� r} c C s d S r� rc �r� r� r� rc rc rd �__rich_console__ s z"ConsoleRenderable.__rich_console__N)r` ra rb rl r� rc rc rc rd r� s �r� c @ s e Zd ZdZdS )� CaptureErrorz(An error in the Capture context manager.N)r` ra rb rl rc rc rc rd r� ! s r� c @ s8 e Zd ZdZd edd�dd�Zddee d �d d �ZdS ) �NewLinez$A renderable to generate new line(s)r& N��countr} c C s || _ d S r� )r� �r� r� rc rc rd �__init__( s zNewLine.__init__r� ro r� c c s t d| j �V d S )N� )rC r� r� rc rc rd r� + s zNewLine.__rich_console__)r& ) r` ra rb rl rm r� r rC r� rc rc rc rd r� % s �r� c @ s> e Zd ZdZeee eedd�dd�Zdee d�dd �Z dS ) � ScreenUpdatez)Render a list of lines at a given offset.N��lines�x�yr} c C s || _ || _|| _d S r� )�_linesr� r� )r� r� r� r� rc rc rd r� 4 s zScreenUpdate.__init__r� r� c c s> | j }tj}t| j| j�D ] \}}|||�V |E d H qd S r� )r� r3 �move_to� enumerater� r� )r� r� r� r� r� �offset�linerc rc rd r� 9 s z ScreenUpdate.__rich_console__) r` ra rb rl r rC rm r� ro r� r� rc rc rc rd r� 1 s �r� c @ s` e Zd ZdZddd�dd�Zd d�dd �Zeee ee ee dd �d d �Z e d�d d�Z dS )�Capturez�Context manager to capture the result of printing to the console. See :meth:`~rich.console.Console.capture` for how to use. Args: console (Console): A console instance to capture output. r� N)r� r} c C s || _ d | _d S r� )�_console�_result)r� r� rc rc rd r� K s zCapture.__init__r| c C s | j �� | S r� )r� � begin_capturer� rc rc rd � __enter__O s zCapture.__enter__��exc_type�exc_val�exc_tbr} c C s | j �� | _d S r� )r� � end_capturer� �r� r� r� r� rc rc rd �__exit__S s zCapture.__exit__c C s | j dkrtd��| j S )z Get the result of the capture.Nz<Capture result is not available until context manager exits.)r� r� r� rc rc rd �get[ s �z Capture.get) r` ra rb rl r� r� r r � BaseExceptionr r� r� r� rc rc rc rd r� C s � r� c @ sX e Zd ZdZddeedd�dd�Zd d�d d �Zee e ee ee dd �d d �Z dS )� ThemeContextzbA context manager to use a temporary theme. See :meth:`~rich.console.Console.use_theme` for usage.Tr� N)r� �theme�inheritr} c C s || _ || _|| _d S r� )r� r� r� )r� r� r� r� rc rc rd r� g s zThemeContext.__init__r| c C s | j �| j� | S r� )r� � push_themer� r� rc rc rd r� l s zThemeContext.__enter__r� c C s | j �� d S r� )r� � pop_themer� rc rc rd r� p s zThemeContext.__exit__)T) r` ra rb rl rM r� r� r� r r r� r r� rc rc rc rd r� d s �r� c @ s^ e Zd ZdZddee eedd�dd�Zd d�d d �Zee e ee ee dd �d d �Z dS )� PagerContextzZA context manager that 'pages' content. See :meth:`~rich.console.Console.pager` for usage.NFr� )r� �pager�styles�linksr} c C s* || _ |d krt� n|| _|| _|| _d S r� )r� r< r� r� r� )r� r� r� r� r� rc rc rd r� | s zPagerContext.__init__r| c C s | j �� | S r� )r� � _enter_bufferr� rc rc rd r� � s zPagerContext.__enter__r� c C s� |d krx| j j�V | j jd d � }| j jd d �= |}| jsFt�|�}n| jsVt�|�}| j �|�}W 5 Q R X | j � |� | j � � d S r� ) r� �_lock�_bufferr� rC � strip_stylesr� � strip_links�_render_bufferr� �show� _exit_buffer)r� r� r� r� �buffer�segments�contentrc rc rd r� � s zPagerContext.__exit__)NFF) r` ra rb rl r r; r� r� r� r r� r r� rc rc rc rd r� y s" �� �r� c @ st e Zd ZdZddeedd�dd�Zdd�eee dd �d d �Z d d �d d�Z ee e ee ee dd�dd�ZdS )� ScreenContextziA context manager that enables an alternative screen. See :meth:`~rich.console.Console.screen` for usage.� r� N)r� � hide_cursor�styler} c C s" || _ || _t|d�| _d| _d S )N�r� F)r� r� rB �screen�_changed)r� r� r� r� rc rc rd r� � s zScreenContext.__init__r� )� renderablesr� r} c G sJ |r$t |�dkrt|� n|d | j_|dk r4|| j_| jj| jdd� dS )a+ Update the screen. Args: renderable (RenderableType, optional): Optional renderable to replace current renderable, or None for no change. Defaults to None. style: (Style, optional): Replacement style, or None for no change. Defaults to None. r& r Nr� )�end)�len�Groupr� � renderabler� r� �print)r� r� r� rc rc rd r� � s �zScreenContext.updater| c C s* | j �d�| _| jr&| jr&| j �d� | S )NTF)r� �set_alt_screenr� r� � show_cursorr� rc rc rd r� � s zScreenContext.__enter__r� c C s( | j r$| j�d� | jr$| j�d� d S )NFT)r� r� r� r� r� r� rc rc rd r� � s zScreenContext.__exit__)r� )r` ra rb rl r� rE r� �RenderableTyper r� r� r r� r r� rc rc rc rd r� � s( � � � � �r� c @ sb e Zd ZdZdd�dedd�dd�Zeed d �d d ��Zd d dd�dd�Z d d e d�dd�Z dS )r� a$ Takes a group of renderables and returns a renderable object that renders the group. Args: renderables (Iterable[RenderableType]): An iterable of renderable objects. fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True. T��fitr� N)r� r� r} c G s || _ || _d | _d S r� )� _renderablesr� �_render)r� r� r� rc rc rd r� � s zGroup.__init__r| c C s | j d krt| j�| _ | j S r� )r� �listr� r� rc rc rd r� � s zGroup.renderablesr� ro r9 r� c C s& | j rt||| j�S t|j|j�S d S r� )r� r: r� r9 rs r� rc rc rd �__rich_measure__� s zGroup.__rich_measure__c c s | j E d H d S r� )r� r� rc rc rd r� � s zGroup.__rich_console__) r` ra rb rl r� r� r� r r� r� r� r� rc rc rc rd r� � s � �r� T.)r� r} c s, t dtt f t dtf d�� fdd� }|S )z�A decorator that turns an iterable of renderables in to a group. Args: fit (bool, optional): Fit dimension of group to contents, or fill available space. Defaults to True. .)�methodr} c s$ t � �tttd��� fdd� �}|S )zGConvert a method that returns an iterable of renderables in to a Group.)�args�kwargsr} c s �| |�}t |d� i�S )Nr� )r� )r� r� r� )r� r� rc rd �_replace� s z*group.<locals>.decorator.<locals>._replace)r r r� )r� r� r� )r� rd � decorator� s zgroup.<locals>.decorator)r r r� r� )r� r� rc r� rd �group� s � r� r| c C sf zt W n tk r Y dS X t � } | jj}dt| j�ksNt�d�sN|dkrRdS |dkr^dS dS dS )z-Check if we're running in a Jupyter notebook.Fz google.colab�DATABRICKS_RUNTIME_VERSION�ZMQInteractiveShellT�TerminalInteractiveShellN)� get_ipython� NameError� __class__r` r� �os�getenv)�ipython�shellrc rc rd � _is_jupyter s ���r� )�standard�256� truecolor�windowsc C s i | ]\}}||�qS rc rc )�.0�name�systemrc rc rd � <dictcomp>! s r c @ s< e Zd ZU dZeed< eed�Ze e ed< dZ e ed< dS )�ConsoleThreadLocalsz(Thread local values for Console context.� theme_stack)�default_factoryr� r � buffer_indexN) r` ra rb rl rN rn r r� r� r rC r rm rc rc rc rd r $ s r c @ s, e Zd ZdZeee ee d�dd��ZdS )� RenderHookz(Provides hooks in to the render process.)r� r} c C s dS )aL Called with a list of objects to render. This method can return a new list of renderables, or modify and return the same list. Args: renderables (List[ConsoleRenderable]): A number of renderable objects. Returns: List[ConsoleRenderable]: A replacement list of renderables. Nrc )r� r� rc rc rd �process_renderables0 s z RenderHook.process_renderablesN)r` ra rb rl r r r� r rc rc rc rd r - s �r rO �_windows_console_featuresc C s" t d k r t S ddlm} | � a t S )Nr& �� get_windows_console_features)r �_windowsr r rc rc rd r C s r c C s t o t� j S )zDetect legacy Windows.)�WINDOWSr �vtrc rc rc rd �detect_legacy_windowsM s r c @ s� e Zd ZU dZejZeeef e d< dddddddddddddddddddddde � dddddd � e e d e e e e e e e e e e e ee e e e e e e e e e ee e e e e e e e eeef e d e e e e eg ef e eg ef e eeef d � d d �Zed�dd�Zeee d�dd��Zej ee dd�dd��Zee e d�dd��Z eed�dd��Z e j edd�dd��Z ee!d�dd ��Z"e e# d�d d �Z$dd�d d �Z%dd�d!d"�Z&d#dd$�d%d&�Z'dd�d'd(�Z(e)dd)�d*d+�Z*dd�d,d-�Z+d d�d.d/�Z,e-e-e-dd0�d1d2�Z.dd�d3d4�Z/ed�d5d6�Z0dd7�ee dd8�d9d:�Z1dd�d;d<�Z2dd7�ee e3d8�d=d>�Z4ee e d�d?d@��Z5eed�dAdB��Z6ee d�dCdD��Z7ee d�dEdF��Z8ee9d�dGdH��Z:ee;d�dIdJ��Z<e<j e=eef ddK�dLdJ��Z<eed�dMdN��Z>e>j eddO�dPdN��Z>eed�dQdR��Z?e?j eddS�dTdR��Z?dd�dUdV�Z@eAd�dWdX�ZBd�e eC e e eDdY�dZd[�ZEd�edd]�d^d_�ZFd�e dd`�dadb�ZGdcdddedfdg�eHeeeedhdi�djdk�ZId�e e dl�dmdn�ZJd�e e do�dpdq�ZKee d�drds��ZLee dt�dudv�ZMd�e e e dwdx�dydz�ZNdd{�eHe e9 eOd|�d}d~�ZPd�eHe e9 eQe d|�dd��ZRd�dddd��eHe e9 e eS e e e e e d��d�d��ZTd�ddddddd��eeeeSf e eU e eV e e e e e e e eW d�d�� d�d��ZXdd��eeeSf e eeSef eSd��d�d��ZYddddd��eQe- eee eU e e e e e e e eZ d��d�d��Z[d�d�d�d�d��e\eeeeSf e]dd��d�d��Z^e_dd��d�d��Z`d�d�ddd��e-eee eeeSf e e dd��d�d��Zad�d�ddddddddddddd��e-eee eeeSf e eU e eV e e e e e e e e e e e e e e e e dd��d�d��Zbd�dd�dddddddd�� e e e-edeef e e e e e e ee-ge-f e dd�� d�d��Zcddd��eHe ed e e9 dd��d�d��Zed�e e e eedd��d�d��Zfd�d�dddd�d�d��e e ee e e e eQeeegf edd��d�d��Zheiejjkfeeg e el f e=eeemee-f f d��d�d���Znd�d�ddddddd\d�� e-eee eeeSf e eU e e e e e e e edd�� d�d��Zodd�d�dÄZpeQe edĜd�dƄZqd�dddddǜe\e e e e er edȜd�dʄZsddd˜e e ed̜d�d΄Ztddd˜ee e ddϜd�dфZudddddҜe ev e e e e edӜd�dՄZwddexddҜee ev e ee dd֜d�dZyd�ddezd�ddۜee ev e eee e edܜd�dބZ{d�ddezd�ddۜeee ev e eee e ddߜd�d�Z|dS )�r� ar A high level console interface. Args: color_system (str, optional): The color system supported by your terminal, either ``"standard"``, ``"256"`` or ``"truecolor"``. Leave as ``"auto"`` to autodetect. force_terminal (Optional[bool], optional): Enable/disable terminal control codes, or None to auto-detect terminal. Defaults to None. force_jupyter (Optional[bool], optional): Enable/disable Jupyter rendering, or None to auto-detect Jupyter. Defaults to None. force_interactive (Optional[bool], optional): Enable/disable interactive mode, or None to auto detect. Defaults to None. soft_wrap (Optional[bool], optional): Set soft wrap default on print method. Defaults to False. theme (Theme, optional): An optional style theme object, or ``None`` for default theme. stderr (bool, optional): Use stderr rather than stdout if ``file`` is not specified. Defaults to False. file (IO, optional): A file object where the console should write to. Defaults to stdout. quiet (bool, Optional): Boolean to suppress all output. Defaults to False. width (int, optional): The width of the terminal. Leave as default to auto-detect width. height (int, optional): The height of the terminal. Leave as default to auto-detect height. style (StyleType, optional): Style to apply to all output, or None for no style. Defaults to None. no_color (Optional[bool], optional): Enabled no color mode, or None to auto detect. Defaults to None. tab_size (int, optional): Number of spaces used to replace a tab character. Defaults to 8. record (bool, optional): Boolean to enable recording of terminal output, required to call :meth:`export_html`, :meth:`export_svg`, and :meth:`export_text`. Defaults to False. markup (bool, optional): Boolean to enable :ref:`console_markup`. Defaults to True. emoji (bool, optional): Enable emoji code. Defaults to True. emoji_variant (str, optional): Optional emoji variant, either "text" or "emoji". Defaults to None. highlight (bool, optional): Enable automatic highlighting. Defaults to True. log_time (bool, optional): Boolean to enable logging of time by :meth:`log` methods. Defaults to True. log_path (bool, optional): Boolean to enable the logging of the caller by :meth:`log`. Defaults to True. log_time_format (Union[str, TimeFormatterCallable], optional): If ``log_time`` is enabled, either string for strftime or callable that formats the time. Defaults to "[%X] ". highlighter (HighlighterType, optional): Default highlighter. legacy_windows (bool, optional): Enable legacy Windows mode, or ``None`` to auto detect. Defaults to ``None``. safe_box (bool, optional): Restrict box options that don't render on legacy Windows. get_datetime (Callable[[], datetime], optional): Callable that gets the current time as a datetime.datetime object (used by Console.log), or None for datetime.now. get_time (Callable[[], time], optional): Callable that gets the current time in seconds, default uses time.monotonic. �_environ�autoNFr" Tz[%X]) � color_system�force_terminal� force_jupyter�force_interactive� soft_wrapr� �stderr�file�quietrj rk r� �no_color�tab_size�recordr{ �emoji� emoji_variantrz �log_time�log_path�log_time_format� highlighterrq �safe_box� get_datetime�get_timer )r r� r� r� r� �HighlighterTypec ! C sl | d k r| | _ |d kr t� n|| _| jr�| d krZ| j �d�} | d k rV| �� rVt| �} nt} | d kr�| j �d�} | d k r�| �� r�t| �} nt} || _|| _ || _ || _ || _ || _ |d kr�t� o�| j n|| _| d kr�| j �d�} | d k r�| �� r�t| �| j } | d k�r0| j �d�} | d k �r0| �� �r0t| �} || _| | _| | _| d | _|d k �r\|| _|| _| | _|| _|d k�r�d | _n |dk�r�| �� | _n t| | _t�� | _ t |||d�| _ |�p�t | _ || _!|�p�t"j#| _$|�p�t%| _&| | _'| d k �r�| nd| j k| _(|d k�r | j)�o"| j* n|| _+t�� | _,t-t.|d k�rDt/j0n|�d�| _1g | _2g | _3d | _4d | _5d S ) N�JUPYTER_COLUMNS� JUPYTER_LINES�COLUMNS�LINESr )� show_time� show_path� time_format�NO_COLOR)r F)6r r� � is_jupyterr� �isdigitrm �JUPYTER_DEFAULT_COLUMNS�JUPYTER_DEFAULT_LINESr r �_markup�_emoji�_emoji_variant� _highlightr rq r �_width�_height�_force_terminal�_filer r � _color_system�_detect_color_system� COLOR_SYSTEMS� threading�RLockr� r. � _log_render�_null_highlighterr" r# r �nowr$ r r% r� r rt �is_dumb_terminal�is_interactive�_record_buffer_lockr rN r( �DEFAULT�_thread_locals�_record_buffer� _render_hooks�_live�_is_alt_screen)!r� r r r r r r� r r r rj rk r� r r r r{ r r rz r r r! r" rq r# r$ r% r �jupyter_columns� jupyter_lines�columnsr� rc rc rd r� x s� # �� � ��� �zConsole.__init__r| c C s d| j � d| j�d�S )Nz<console width=� �>)rj r; r� rc rc rd �__repr__� s zConsole.__repr__c C s4 | j p| jrtjntj}t|d|�}|dkr0t}|S )z Get the file object to write to.�rich_proxied_fileN)r: r �sys�stdout�getattrr )r� r rc rc rd r � s z Console.file)�new_filer} c C s || _ dS )zSet a new file object.N)r: )r� rV rc rc rd r s c C s | j jS �zGet a thread local buffer.)rG r� r� rc rc rd r� s zConsole._bufferc C s | j jS rW �rG r r� rc rc rd � _buffer_index s zConsole._buffer_index��valuer} c C s || j _d S r� rX )r� r[ rc rc rd rY s c C s | j jS )z!Get the thread local theme stack.)rG r r� rc rc rd � _theme_stack s zConsole._theme_stackc C s� | j r tjS | jr| jr dS trD| jr,tjS t� }|jr>tjS tj S | j � dd�� � � � }|dkrhtjS | j � dd�� � � � }|�d�\}}}t� |tj�}|S dS )z"Detect color system from env vars.N� COLORTERMr� )r� �24bit�TERM�-)r/ r1 � TRUECOLORrt rC r rq r r� � EIGHT_BITr r� �strip�lower� rpartition� _TERM_COLORS�STANDARD)r� �windows_console_features� color_term�term� _term_name�_hyphen�colorsr rc rc rd r< s& ��z Console._detect_color_systemc C s | j d7 _ dS )z4Enter in to a buffer context, and buffer all output.r& N)rY r� rc rc rd r� 0 s zConsole._enter_bufferc C s | j d8 _ | �� dS )z5Leave buffer context, and render content if required.r& N)rY � _check_bufferr� rc rc rd r� 4 s zConsole._exit_bufferrP )�liver} c C s0 | j � | jdk r t�d��|| _W 5 Q R X dS )z�Set Live instance. Used by Live context manager. Args: live (Live): Live instance using this Console. Raises: errors.LiveError: If this Console has a Live context currently active. Nz+Only one live display may be active at once)r� rJ r' � LiveError)r� ro rc rc rd �set_live9 s zConsole.set_livec C s | j � d| _W 5 Q R X dS )zClear the Live instance.N)r� rJ r� rc rc rd � clear_liveG s zConsole.clear_live)�hookr} c C s" | j � | j�|� W 5 Q R X dS )zpAdd a new render hook to the stack. Args: hook (RenderHook): Render hook instance. N)r� rI �append)r� rs rc rc rd �push_render_hookL s zConsole.push_render_hookc C s | j � | j�� W 5 Q R X dS )z'Pop the last renderhook from the stack.N)r� rI �popr� rc rc rd �pop_render_hookU s zConsole.pop_render_hookc C s | � � | S )z,Own context manager to enter buffer context.�r� r� rc rc rd r� Z s zConsole.__enter__)r� � exc_value� tracebackr} c C s | � � dS )zExit buffer context.N)r� )r� r� ry rz rc rc rd r� _ s zConsole.__exit__c C s | � � dS )z`Begin capturing console output. Call :meth:`end_capture` to exit capture mode and return output.Nrx r� rc rc rd r� c s zConsole.begin_capturec C s$ | � | j�}| jdd�= | �� |S )zhEnd capture mode and return captured string. Returns: str: Console output. N)r� r� r� )r� � render_resultrc rc rd r� g s zConsole.end_capture�r� )r� r� r} c C s | j j||d� dS )a� Push a new theme on to the top of the stack, replacing the styles from the previous theme. Generally speaking, you should call :meth:`~rich.console.Console.use_theme` to get a context manager, rather than calling this method directly. Args: theme (Theme): A theme instance. inherit (bool, optional): Inherit existing styles. Defaults to True. r| N)r\ r� �r� r� r� rc rc rd r� r s zConsole.push_themec C s | j �� dS )z9Remove theme from top of stack, restoring previous theme.N)r\ r� r� rc rc rd r� } s zConsole.pop_themec C s t | ||�S )a Use a different theme for the duration of the context manager. Args: theme (Theme): Theme instance to user. inherit (bool, optional): Inherit existing console styles. Defaults to True. Returns: ThemeContext: [description] )r� r} rc rc rd � use_theme� s zConsole.use_themec C s | j dk rt| j S dS dS )zpGet color system string. Returns: Optional[str]: "standard", "256" or "truecolor". N)r; �_COLOR_SYSTEMS_NAMESr� rc rc rd r � s zConsole.color_systemc C s t | jdd�pd�� S )zGet the encoding of the console file, e.g. ``"utf-8"``. Returns: str: A standard encoding string. ru �utf-8)rU r rd r� rc rc rd ru � s zConsole.encodingc C s� | j dk r| j S ttjd�r.tjj�d�r.dS | jr8dS | j�d�}|dk rVd| _ dS t | j dd�}z|dkrrdn|� W S t k r� Y dS X dS )z�Check if the console is writing to a terminal. Returns: bool: True if the console writing to a device capable of understanding terminal codes, otherwise False. Nra �idlelibF� FORCE_COLORT�isatty) r9 �hasattrrS �stdinra r r/ r r� rU r � ValueError)r� � force_colorr� rc rc rd rt � s" � zConsole.is_terminalc C s$ | j �dd�}|�� dk}| jo"|S )zxDetect dumb terminal. Returns: bool: True if writing to a dumb terminal, otherwise False. r_ r� )�dumb�unknown)r r� rd rt )r� �_term�is_dumbrc rc rd rC � s zConsole.is_dumb_terminalc C s$ t | jj| j| jd| j| j| jd�S )z Get default console options.r& )rv rp rq rr rs ru rt )ro rp rk rq rj ru rt r� rc rc rd r� � s �zConsole.optionsc C s< | j dk r(| jdk r(t| j | j | j�S | jr8tdd�S d}d}trrzt�� \}}W q� tt t fk rn Y q�X n<t D ]6}zt�|�\}}W n tt t fk r� Y qvX q�qv| j � d�}|dk r�|�� r�t|�}| j � d�}|dk r�|�� r�t|�}|p�d}|�pd}t| j dk�r || j n| j | jdk�r4|n| j�S )zGet the size of the console. Returns: ConsoleDimensions: A named tuple containing the dimensions. N�P � r) r* )r7 r8 ri rq rC r r� �get_terminal_size�AttributeErrorr� �OSError� _STD_STREAMSr r� r0 rm )r� rj rk �file_descriptorrN r� rc rc rd rp � s: �z Console.size)�new_sizer} c C s |\}}|| _ || _dS )zvSet a new size for the terminal. Args: new_size (Tuple[int, int]): New width and height. N)r7 r8 )r� r� rj rk rc rc rd rp s c C s | j jS )zsGet the width of the console. Returns: int: The width (in characters) of the console. )rp rj r� rc rc rd rj s z Console.widthr� c C s || _ dS )zFSet width. Args: width (int): New width. N)r7 )r� rj rc rc rd rj " s c C s | j jS )zpGet the height of the console. Returns: int: The height (in lines) of the console. )rp rk r� rc rc rd rk + s zConsole.heightr� c C s || _ dS )zISet height. Args: height (int): new height. N)r8 )r� rk rc rc rd rk 4 s c C s | � t�� � dS )z3Play a 'bell' sound (if supported by the terminal).N)�controlr3 �bellr� rc rc rd r� = s z Console.bellc C s t | �}|S )a� A context manager to *capture* the result of print() or log() in a string, rather than writing it to the console. Example: >>> from rich.console import Console >>> console = Console() >>> with console.capture() as capture: ... console.print("[bold magenta]Hello World[/]") >>> print(capture.get()) Returns: Capture: Context manager with disables writing to the terminal. )r� )r� �capturerc rc rd r� A s zConsole.capture)r� r� r� r} c C s t | |||d�S )a A context manager to display anything printed within a "pager". The pager application is defined by the system and will typically support at least pressing a key to scroll. Args: pager (Pager, optional): A pager object, or None to use :class:`~rich.pager.SystemPager`. Defaults to None. styles (bool, optional): Show styles in pager. Defaults to False. links (bool, optional): Show links in pager. Defaults to False. Example: >>> from rich.console import Console >>> from rich.__main__ import make_test_card >>> console = Console() >>> with console.pager(): console.print(make_test_card()) Returns: PagerContext: A context manager. )r� r� r� )r� )r� r� r� r� rc rc rd r� R s z Console.pagerr& r� c C s" |dkst d��| �t|�� dS )zqWrite new line(s). Args: count (int, optional): Number of new lines. Defaults to 1. r zcount must be >= 0N)�AssertionErrorr� r� r� rc rc rd r� i s z Console.line)�homer} c C s, |r| � t�� t�� � n| � t�� � dS )z�Clear the screen. Args: home (bool, optional): Also move the cursor to 'home' position. Defaults to True. N)r� r3 �clearr� )r� r� rc rc rd r� s s z Console.clear�dotszstatus.spinnerg �?g )@)�spinner� spinner_style�speed�refresh_per_secondrR )�statusr� r� r� r� r} c C s$ ddl m} ||| ||||d�}|S )at Display a status and spinner. Args: status (RenderableType): A status renderable (str or Text typically). spinner (str, optional): Name of spinner animation (see python -m rich.spinner). Defaults to "dots". spinner_style (StyleType, optional): Style of spinner. Defaults to "status.spinner". speed (float, optional): Speed factor for spinner animation. Defaults to 1.0. refresh_per_second (float, optional): Number of refreshes per second. Defaults to 12.5. Returns: Status: A Status object that may be used as a context manager. r& rQ )r� r� r� r� r� )r� rR )r� r� r� r� r� r� rR �status_renderablerc rc rd r� ~ s �zConsole.status)r� r} c C s | j r| �t�|�� dS dS )zqShow or hide the cursor. Args: show (bool, optional): Set visibility of the cursor. TF)rt r� r3 r� )r� r� rc rc rd r� � s zConsole.show_cursor)�enabler} c C s. d}| j r*| js*| �t�|�� d}|| _|S )a� Enables alternative screen mode. Note, if you enable this mode, you should ensure that is disabled before the application exits. See :meth:`~rich.Console.screen` for a context manager that handles this for you. Args: enable (bool, optional): Enable (True) or disable (False) alternate screen. Defaults to True. Returns: bool: True if the control codes were written. FT)rt rq r� r3 � alt_screenrK )r� r� �changedrc rc rd r� � s zConsole.set_alt_screenc C s | j S )z�Check if the alt screen was enabled. Returns: bool: True if the alt screen was enabled, otherwise False. )rK r� rc rc rd � is_alt_screen� s zConsole.is_alt_screen)�titler} c C s | j r| �t�|�� dS dS )a Set the title of the console terminal window. Warning: There is no means within Rich of "resetting" the window title to its previous value, meaning the title you set will persist even after your application exits. ``fish`` shell resets the window title before and after each command by default, negating this issue. Windows Terminal and command prompt will also reset the title for you. Most other shells and terminals, however, do not do this. Some terminals may require configuration changes before you can set the title. Some terminals may not support setting the title at all. Other software (including the terminal itself, the shell, custom prompts, plugins, etc.) may also set the terminal window title. This could result in whatever value you write using this method being overwritten. Args: title (str): The new title of the terminal window. Returns: bool: True if the control code to change the terminal title was written, otherwise False. Note that a return value of True does not guarantee that the window title has actually changed, since the feature may be unsupported/disabled in some terminals. TF)rt r� r3 r� )r� r� rc rc rd �set_window_title� s zConsole.set_window_titler� )r� r� r} c C s t | ||p dd�S )au Context manager to enable and disable 'alternative screen' mode. Args: hide_cursor (bool, optional): Also hide the cursor. Defaults to False. style (Style, optional): Optional style for screen. Defaults to None. Returns: ~ScreenContext: Context which enables alternate screen on enter, and disables it on exit. r� )r� r� )r� )r� r� r� rc rc rd r� � s zConsole.screen�r� )r� r� r} c C s t �| |p| j|�}|S )a� Measure a renderable. Returns a :class:`~rich.measure.Measurement` object which contains information regarding the number of characters required to print the renderable. Args: renderable (RenderableType): Any renderable or string. options (Optional[ConsoleOptions], optional): Options to use when measuring, or None to use default options. Defaults to None. Returns: Measurement: A measurement of the renderable. )r9 r� r� )r� r� r� � measurementrc rc rd �measure� s zConsole.measurec c s� |p| j }|jdk rdS t|�}t|d�r@t|�s@|�| |�}n>t|t�rl| j||j |j d�}|�| |�}nt � d|�d���z t |�}W n& tk r� t � d|�d���Y nX t}|�� }|D ](}t||�r�|V q�| �||�E dH q�dS ) ak Render an object in to an iterable of `Segment` instances. This method contains the logic for rendering objects with the console protocol. You are unlikely to need to use it directly, unless you are extending the library. Args: renderable (RenderableType): An object supporting the console protocol, or an object that may be converted to a string. options (ConsoleOptions, optional): An options object, or None to use self.options. Defaults to None. Returns: Iterable[Segment]: An iterable of segments that may be rendered. r& Nr� )rz r{ zUnable to render zC; A str, Segment or object with __rich_console__ method is requiredzobject z is not renderable)r� rs r? r� r r� r� r� � render_strrz r{ r' �NotRenderableError�iter� TypeErrorrC r� r8 ) r� r� r� �_options�render_iterable�text_renderable� iter_render�_Segment� render_outputrc rc rd r8 s8 � � � zConsole.render)r� �pad� new_lines)r� r� r� r� r� r} c C s� | j �� |p| j}| �||�}|r.t�||�}|j}|dk rFtd|�}tttj ||j |||d�d|��} |jdk r�|jt | � } | dkr�|r�td|j |�td�gntd|j |�gg} | � | | � | W 5 Q R � S Q R X dS )aG Render objects in to a list of lines. The output of render_lines is useful when further formatting of rendered console text is required, such as the Panel class which draws a border around any renderable object. Args: renderable (RenderableType): Any object renderable in the console. options (Optional[ConsoleOptions], optional): Console options, or None to use self.options. Default to ``None``. style (Style, optional): Optional style to apply to renderables. Defaults to ``None``. pad (bool, optional): Pad lines shorter than render width. Defaults to ``True``. new_lines (bool, optional): Include " " characters at end of lines. Returns: List[List[Segment]]: A list of lines, where a line is a list of Segment objects. Nr )�include_new_linesr� r� rO r� ) r� r� r8 rC � apply_stylerk r� r� r �split_and_crop_linesrs r� �extend) r� r� r� r� r� r� �render_options� _rendered� render_heightr� � extra_lines�pad_linerc rc rd � render_lines: s< ��� ��zConsole.render_linesr� )r� rw rx r r{ rz r" rK ) �textr� rw rx r r{ rz r" r} c C s� |p|dko| j } |p"|dko"| j} |p4|dko4| j} | rZt||| | jd�} || _|| _n"t| rnt|| jd�n||||d�} | r�|p�| j nd} | dk r�| t | ��}|� | � |S | S )a� Convert a string to a Text instance. This is called automatically if you print or log a string. Args: text (str): Text to render. style (Union[str, Style], optional): Style to apply to rendered text. justify (str, optional): Justify method: "default", "left", "center", "full", or "right". Defaults to ``None``. overflow (str, optional): Overflow method: "crop", "fold", or "ellipsis". Defaults to ``None``. emoji (Optional[bool], optional): Enable emoji, or ``None`` to use Console default. markup (Optional[bool], optional): Enable markup, or ``None`` to use Console default. highlight (Optional[bool], optional): Enable highlighting, or ``None`` to use Console default. highlighter (HighlighterType, optional): Optional highlighter to apply. Returns: ConsoleRenderable: Renderable object. N)r� r r )�default_variant)rw rx r� ) r4 r3 r6 � render_markupr5 rw rx rK r) r" r� � copy_styles)r� r� r� rw rx r r{ rz r" � emoji_enabled�markup_enabled�highlight_enabled� rich_text� _highlighter�highlight_textrc rc rd r� u s4 ��� zConsole.render_str)rV )r rV r} c C s� t |t�r|S z2| j�|�}|dkr.t�|�}|jr<|�� n|W S tjk r� } z6|dk rn| � |� W Y � S t� d|�d|� ��d�W 5 d}~X Y nX dS )a Get a Style instance by its theme name or parse a definition. Args: name (str): The name of a style or a style definition. Returns: Style: A Style object. Raises: MissingStyle: If no style could be parsed from name. NzFailed to get style z; ) r� rD r\ r� �parse�linkr� r' �StyleSyntaxError� get_style� MissingStyle)r� r rV r� �errorrc rc rd r� � s ��zConsole.get_style�rw r r{ rz )�objects�sepr� rw r r{ rz r} c s6 g }|j � g ��j } � ��dkr:tdd�� �fdd� } | �t} |sP|dkrV| jrV| j} dd������fdd� } |D ]�} t| �} t| t�r�| | j| ||| d �� qtt| t �r�| | � qtt| t �r�| � �| � qtt | �r�| � �t | | d �� qt| | t| ��� qt| � | j dk �r2| �| j ���fd d �|D �}|S ) a Combine a number of renderables and text into one renderable. Args: objects (Iterable[Any]): Anything that Rich can render. sep (str): String to write between print data. end (str): String to write at end of print data. justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``. emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Returns: List[ConsoleRenderable]: A list of things to render. )rW rX rY N)r� r} c s � t | tt���� d S r� )r/ r r0 )r� )�_appendrw rc rd � align_append� s z2Console._collect_renderables.<locals>.align_appendr| c s, �r(t ���d�} � | ���� ��� d S )N)rw r� )rK �joinr� )�sep_text)rt r� rw r� r� rc rd � check_text� s z0Console._collect_renderables.<locals>.check_text)r r{ r" )r" c s g | ]}t |� ��qS rc rF �r� r� r� rc rd � <listcomp> s z0Console._collect_renderables.<locals>.<listcomp>)rt r� rA r6 r" r? r� r� r� rK r� r> r= r� r� )r� r� r� r� rw r r{ rz r� � append_textr� r� r� r� rc )r� rt r� rw r� r� r� rd �_collect_renderables� sJ �� z Console._collect_renderablesu ─z rule.linerX )� charactersr� �align)r� r� r� r� r} c C s* ddl m} |||||d�}| �|� dS )u� Draw a line with optional centered title. Args: title (str, optional): Text to render over the rule. Defaults to "". characters (str, optional): Character(s) to form the line. Defaults to "─". style (str, optional): Style of line. Defaults to "rule.line". align (str, optional): How to align the title, one of "left", "center", or "right". Defaults to "center". r& )�Rule)r� r� r� r� N)�ruler� r� )r� r� r� r� r� r� r� rc rc rd r� s z Console.rule)r� r} c G s0 | j s,| � | j�dd� |D �� W 5 Q R X dS )z�Insert non-printing control codes. Args: control_codes (str): Control codes, such as those that may move the cursor. c s s | ] }|j V qd S r� )�segment)r� �_controlrc rc rd � <genexpr>6 s z"Console.control.<locals>.<genexpr>N)rC r� r� )r� r� rc rc rd r� . s zConsole.controlrO r� )r� r� r� rz )r� r� r� r� rz r} c G s4 |� dd� |D ��}| j|||ddddd|d� dS )a� Output to the terminal. This is a low-level way of writing to the terminal which unlike :meth:`~rich.console.Console.print` won't pretty print, wrap text, or apply markup, but will optionally apply highlighting and a basic style. Args: sep (str, optional): String to write between print data. Defaults to " ". end (str, optional): String to write at end of print data. Defaults to "\\n". style (Union[str, Style], optional): A style to apply to output. Defaults to None. highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to ``None``. c s s | ]}t |�V qd S r� )r� )r� �_objectrc rc rd r� K s z Console.out.<locals>.<genexpr>FTr^ )r� rz r r{ ry rx r\ r� N)r� r� )r� r� r� r� rz r� � raw_outputrc rc rd �out8 s �z Console.out)r� r� r� rw rx ry r r{ rz rj rk r\ r �new_line_start)r� r� r� r� rw rx ry r r{ rz rj rk r\ r r� r} c G s� |s t � f}| dkr| j} | r:|dkr*d}|dkr6d}d} | jdd� }| ��. | j||||||| d�}|D ]}|�|�}ql| jj||| dk r�t| | j�nt | ||| d�}g }|j }| j }|dkr�|D ]}||||�� q�n&|D ] }|t � |||�| �|��� q�|�r:td�dd � |D ���� �d k�r:|�d t �� � | �rl| jj }t j|| jdd �D ]}||� �qZn | j� |� W 5 Q R X dS ) a[ Print to the console. Args: objects (positional args): Objects to log to the terminal. sep (str, optional): String to write between print data. Defaults to " ". end (str, optional): String to write at end of print data. Defaults to "\\n". style (Union[str, Style], optional): A style to apply to output. Defaults to None. justify (str, optional): Justify method: "default", "left", "right", "center", or "full". Defaults to ``None``. overflow (str, optional): Overflow method: "ignore", "crop", "fold", or "ellipsis". Defaults to None. no_wrap (Optional[bool], optional): Disable word wrapping. Defaults to None. emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to ``None``. markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to ``None``. highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to ``None``. width (Optional[int], optional): Width of output, or ``None`` to auto-detect. Defaults to ``None``. crop (Optional[bool], optional): Crop output to width of terminal. Defaults to True. soft_wrap (bool, optional): Enable soft wrap mode which disables word wrapping and cropping of text or ``None`` for Console default. Defaults to ``None``. new_line_start (bool, False): Insert a new line at the start if the output contains more than one line. Defaults to ``False``. NTr^ Fr� )rw rx rj rk ry r{ rz r� c s s | ] }|j V qd S r� �r� �r� r� rc rc rd r� � s z Console.print.<locals>.<genexpr>r& r �r� )r� r rI r� r r� r� �minrj r� r� r8 rC r� r� r� r� � splitlines�insertr� r� r� )r� r� r� r� rw rx ry r r{ rz rj rk r\ r r� r� � render_hooksr� rs r� � new_segmentsr� r8 r� � buffer_extendr� rc rc rd r� X sx %� � ���� � z Console.printre ) �data�indentrz � skip_keys� ensure_ascii�check_circular� allow_nanrV � sort_keys) �jsonr� r� rz r� r� r� r� rV r� r} c C sx ddl m} |dkr2| j|||||||| | d� } n4t|t�sLtd|�d���| |||||||| | d� } | j| dd� dS ) a� Pretty prints JSON. Output will be valid JSON. Args: json (Optional[str]): A string containing JSON. data (Any): If json is not supplied, then encode this data. indent (Union[None, int, str], optional): Number of spaces to indent. Defaults to 2. highlight (bool, optional): Enable highlighting of output: Defaults to True. skip_keys (bool, optional): Skip keys not of a basic type. Defaults to False. ensure_ascii (bool, optional): Escape all non-ascii characters. Defaults to False. check_circular (bool, optional): Check for circular references. Defaults to True. allow_nan (bool, optional): Allow NaN and Infinity values. Defaults to True. default (Callable, optional): A callable that converts values that can not be encoded in to something that can be JSON encoded. Defaults to None. sort_keys (bool, optional): Sort dictionary keys. Defaults to False. r )�JSONN)r� rz r� r� r� r� rV r� z/json must be str. Did you mean print_json(data=z) ?T)r )�pip._vendor.rich.jsonr� � from_datar� r� r� r� ) r� r� r� r� rz r� r� r� r� rV r� r� �json_renderablerc rc rd � print_json� s: � �� zConsole.print_json)�regionr� )r� r� r� r} c C sz | j st�d��|p| j}|dkrBd }}|�|j|jp<| j�}n|\}}}}|�||�}| j||d�} | �| ||� dS )a� Update the screen at a given offset. Args: renderable (RenderableType): A Rich renderable. region (Region, optional): Region of screen to update, or None for entire screen. Defaults to None. x (int, optional): x offset. Defaults to 0. y (int, optional): y offset. Defaults to 0. Raises: errors.NoAltScreen: If the Console isn't in alt screen mode. �0Alt screen must be enabled to call update_screenNr r� ) r� r' � NoAltScreenr� r� rs rk r� �update_screen_lines) r� r� r� r� r� r� r� rj rk r� rc rc rd � update_screen� s � zConsole.update_screenr r� c C s> | j st�d��t|||�}| �|�}| j�|� | �� dS )a� Update lines of the screen at a given offset. Args: lines (List[List[Segment]]): Rendered lines (as produced by :meth:`~rich.Console.render_lines`). x (int, optional): x offset (column no). Defaults to 0. y (int, optional): y offset (column no). Defaults to 0. Raises: errors.NoAltScreen: If the Console isn't in alt screen mode. r� N)r� r' r� r� r8 r� r� rn )r� r� r� r� � screen_updater� rc rc rd r s zConsole.update_screen_linesrT r! rc �rj r� r� � word_wrap� show_locals�suppress� max_frames)rj r� r� r r r r r} c C s0 ddl m} ||||||||d�} | �| � dS )a Prints a rich render of the last exception and traceback. Args: width (Optional[int], optional): Number of characters used to render code. Defaults to 100. extra_lines (int, optional): Additional lines of code to render. Defaults to 3. theme (str, optional): Override pygments theme used in traceback word_wrap (bool, optional): Enable word wrapping of long lines. Defaults to False. show_locals (bool, optional): Enable display of local variables. Defaults to False. suppress (Iterable[Union[str, ModuleType]]): Optional sequence of modules or paths to exclude from traceback. max_frames (int): Maximum number of frames to show in a traceback, 0 for no maximum. Defaults to 100. r& )� Tracebackr N)rz r r� ) r� rj r� r� r r r r r rz rc rc rd �print_exception. s � zConsole.print_exception)r� � currentframer} c C sr | d7 } |� }|dk rP| r2|dk r2|j }| d8 } q|dk s>t�|jj|j|jfS t�� | }|j|j |j jfS dS )aE Get caller frame information. Args: offset (int): the caller offset within the current frame stack. currentframe (Callable[[], Optional[FrameType]], optional): the callable to use to retrieve the current frame. Defaults to ``inspect.currentframe``. Returns: Tuple[str, int, Dict[str, Any]]: A tuple containing the filename, the line number and the dictionary of local variables associated with the caller frame. Raises: RuntimeError: If the stack offset is invalid. r& N) �f_backr� �f_code� co_filename�f_lineno�f_locals�inspect�stack�filename�lineno�frame)r� r r � frame_inforc rc rd �_caller_frame_infoQ s zConsole._caller_frame_info) r� r� r� rw r r{ rz � log_locals� _stack_offset) r� r� r� r� rw r r{ rz r r r} c sN | s t � f} | jdd� } | ��$ | j| ||||||d�} � dk rT� fdd�| D �} | �| �\} }}| �d�rrdn tj�| �}| �tj �d }|r�dd� |� � D �}| � t |d d �� | j | | | �� |||d �g} | D ]}|�| �} q�g }|j}| j}| j}| D ]}||||�� �q | jj}tj|| jd d �D ]}||� �q0W 5 Q R X dS )aX Log rich content to the terminal. Args: objects (positional args): Objects to log to the terminal. sep (str, optional): String to write between print data. Defaults to " ". end (str, optional): String to write at end of print data. Defaults to "\\n". style (Union[str, Style], optional): A style to apply to output. Defaults to None. justify (str, optional): One of "left", "right", "center", or "full". Defaults to ``None``. emoji (Optional[bool], optional): Enable emoji code, or ``None`` to use console default. Defaults to None. markup (Optional[bool], optional): Enable markup, or ``None`` to use console default. Defaults to None. highlight (Optional[bool], optional): Enable automatic highlighting, or ``None`` to use console default. Defaults to None. log_locals (bool, optional): Boolean to enable logging of locals where ``log()`` was called. Defaults to False. _stack_offset (int, optional): Offset of caller from end of call stack. Defaults to 1. Nr� c s g | ]}t |� ��qS rc rF r� r� rc rd r� � s z Console.log.<locals>.<listcomp>�<���c S s i | ]\}}|� d �s||�qS )�__)r )r� �keyr[ rc rc rd r � s � z Console.log.<locals>.<dictcomp>z [i]locals)r� )r �path�line_no� link_pathFr� )r� rI r� r r r� r �abspathre r� �itemsrt rA r@ r$ r r� r8 r� r� rC r� rj )r� r� r� r� rw r r{ rz r r r� r� r� r r �localsr r � locals_maprs r� r� r8 r� r� r� r� rc r� rd �logt s^ � ��� � z Console.logc C s� | j r| jdd�= dS | j��j | jrN| j� | j�| jdd� � W 5 Q R X | jdk�r�| jr�ddl m } || j| � | jdd� �� | jdd�= �n�t �rd}| j r�t| j�}|dk r�|tk}|�r ddlm} ddlm} | jdd� }| j�r | j�r tt�|��}|||| j�� n�| � | jdd� �}| jj}d} z�t|�| k�rX||� n�g } | j } d} |� d �D ]L} | t| � | k�r�| �r�|d � | �� | � � d} | | � | t| �7 } �qp| �r�|d � | �� | � � W n4 t k �r } z|j!� d �|_!� W 5 d}~X Y nX nZ| � | jdd� �}z| j�|� W n4 t k �rl } z|j!� d �|_!� W 5 d}~X Y nX | j�"� | jdd�= W 5 Q R X dS ) aQ Check if the buffer may be rendered. Render it if it can (e.g. Console.quiet is False) Rendering is supported on Windows, Unix and Jupyter environments. For legacy Windows consoles, the win32 API is called directly. This method will also record what it renders if recording is enabled via Console.record. Nr r& )�displayF)�LegacyWindowsTerm)�legacy_windows_renderi Tr� zG *** You may need to add PYTHONIOENCODING=utf-8 to your environment ***)#r r� r� r rE rH r� rY r/ �jupyterr% r� r rq r, r �_STD_STREAMS_OUTPUT� pip._vendor.rich._win32_consoler& �"pip._vendor.rich._windows_rendererr' r r; r� rC � remove_color�writer� rt r� r� r� �UnicodeEncodeError�reason�flush)r� r% �use_legacy_windows_render�filenor& r' r� r� r- � MAX_WRITE�batch� batch_appendrp r� r� rc rc rd rn � sp � zConsole._check_buffer)r� r} c C sz g }|j }| j}| j}| j }| jr2|r2t�|�}|D ]4\}}} |rZ||j|||d�� q6|rb| s6||� q6d�|�} | S )z)Render buffered output, and clear buffer.)r rq r� ) rt r; rq rt r rC r, r8 r� ) r� r� �outputrt r rq � not_terminalr� r� r� �renderedrc rc rd r� s( �� zConsole._render_buffer)r{ r �password�stream)�promptr{ r r9 r: r} c C s@ |r| j |||dd� |r(td|d�}n|r6|�� }nt� }|S )a5 Displays a prompt and waits for input from the user. The prompt may contain color / style. It works in the same way as Python's builtin :func:`input` function and provides elaborate line editing and history features if Python's builtin :mod:`readline` module is previously loaded. Args: prompt (Union[str, Text]): Text to render in the prompt. markup (bool, optional): Enable console markup (requires a str prompt). Defaults to True. emoji (bool, optional): Enable emoji (requires a str prompt). Defaults to True. password: (bool, optional): Hide typed text. Defaults to False. stream: (TextIO, optional): Optional file to read input from (rather than stdin). Defaults to None. Returns: str: Text read from stdin. r� )r{ r r� )r: )r� r �readline�input)r� r; r{ r r9 r: �resultrc rc rd r= , s z Console.input�r� r� )r� r� r} c C sf | j std��| j�H |r2d�dd� | jD ��}nd�dd� | jD ��}|rX| jdd�= W 5 Q R X |S )a� Generate text from console contents (requires record=True argument in constructor). Args: clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. styles (bool, optional): If ``True``, ansi escape codes will be included. ``False`` for plain text. Defaults to ``False``. Returns: str: String containing console contents. �ITo export console contents set record=True in the constructor or instancer� c s s& | ] \}}}|r|� |�n|V qd S r� r7 )r� r� r� �_rc rc rd r� ` s �z&Console.export_text.<locals>.<genexpr>c s s | ]}|j s|jV qd S r� )r� r� r� rc rc rd r� e s �N)r r� rE r� rH )r� r� r� r� rc rc rd � export_textN s �� � �zConsole.export_text)r r� r� r} c C s6 | j ||d�}t|ddd��}|�|� W 5 Q R X dS )a� Generate text from console and save to a given location (requires record=True argument in constructor). Args: path (str): Path to write text files. clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. styles (bool, optional): If ``True``, ansi style codes will be included. ``False`` for plain text. Defaults to ``False``. r? �wtr� �ru N)rB �openr- )r� r r� r� r� � write_filerc rc rd � save_textn s zConsole.save_text�r� r� � code_format� inline_styles)r� r� rI rJ r} c C s� | j std��g }|j}|p t}d}|dkr0tn|} | j��~ |r�t�t�| j ��D ]\\} } } t | �} | r�| � |�} | j r�d| j � d| � d�} | r�d| � d| � d�n| } || � qTn�i }t�t�| j ��D ]t\} } } t | �} | �r6| � |�} |� | t|�d �}| j �r$d |� d | j � d| � d�} nd |� d| � d�} || � q�g }|j}|�� D ]&\}}|�rR|d |� d|� d�� �qRd�|�}| jd�|�||jj|jjd�}|�r�| j dd�= W 5 Q R X |S )aI Generate HTML from console contents (requires record=True argument in constructor). Args: theme (TerminalTheme, optional): TerminalTheme object containing console colors. clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. code_format (str, optional): Format string to render HTML. In addition to '{foreground}', '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``. inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag. Defaults to False. Returns: str: String containing console contents as HTML. r@ r� Nz <a href="z">z</a>z <span style="z</span>r& z <a class="rz" href="z<span class="rz.rz {�}r� )�code� stylesheet� foreground� background)r r� rt rH r* rE rC �filter_control�simplifyrH r �get_html_styler� � setdefaultr� r! r� �format�foreground_color�hex�background_color)r� r� r� rI rJ � fragmentsrt �_themerM �render_code_formatr� r� rA r� r� � style_number�stylesheet_rules�stylesheet_append� style_rule� rendered_coderc rc rd � export_html| s` �� � � �zConsole.export_html)r r� r� rI rJ r} c C s: | j ||||d�}t|ddd��}|�|� W 5 Q R X dS )a@ Generate HTML from console contents and write to a file (requires record=True argument in constructor). Args: path (str): Path to write html file. theme (TerminalTheme, optional): TerminalTheme object containing console colors. clear (bool, optional): Clear record buffer after exporting. Defaults to ``True``. code_format (str, optional): Format string to render HTML. In addition to '{foreground}', '{background}', and '{code}', should contain '{stylesheet}' if inline_styles is ``False``. inline_styles (bool, optional): If ``True`` styles will be inlined in to spans, which makes files larger but easier to cut and paste markup. If ``False``, styles will be embedded in a style tag. Defaults to False. rH rC r� rD N)r` rE r- )r� r r� r� rI rJ �htmlrF rc rc rd � save_html� s �zConsole.save_html�Richg��Q� ��?�r� r� r� rI �font_aspect_ratio� unique_id)r� r� r� rI re rf r} c 2 s� ddl m} i �ttd�� �fdd� }|p,t� | j�d} | | �| d �d} d} d} d} d }d }d }d }|| }|| }| | }| | }g }g }i }d}ttd �d d �}d6ttt ttd�dd��| j�$ t t � | j ��}|r�| j � � W 5 Q R X �dk�r2dtt�d�dd� |D ���dd�|�dd� �� �d} tt j|�d��D �]p\} } d} | D �]Z\} } }!| �ppt� } || �}"|"|k�r�|||"< |d7 }d||" � �}#| j�r�d}$| jdk�r jjn | j�� �j}%n:| j}&|&dk �o�|&j }$| jdk�r�� jjn | j�� �j}%|| �}'|$�rJ|� �d|%| � | � d �|' �d d d �� | d t | � k�r�|� �d!|| ��� d"|#� �| � | � | �t | � d#�� d$| � d%�d&�� | || �7 } �qZ�qH�fd'd(�t | �D �}(d)������fd*d�t|(�D ��})d)��fd+d�|� � D ��}*d�|�}+d�|�},t �� | �}-| d � | }.�d� jjd,d-| | |-|.d d.� }/� jj}0|�r�|/�d!||��� d/�|0d0|-d1 | | d2 d3�7 }/|/d47 }/|j!��| ��� d | d � d |-| |.| | | | | |*|/|+|,|)d5�}1|1S )7a Generate an SVG from the console contents (requires record=True in Console constructor). Args: title (str, optional): The title of the tab in the output image theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal clear (bool, optional): Clear record buffer after exporting. Defaults to ``True`` code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables into the string in order to form the final SVG output. The default template used and the variables injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable. font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format`` string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font). If you aren't specifying a different font inside ``code_format``, you probably don't need this. unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node ids). If not set, this defaults to a computed value based on the recorded content. r )�cell_len)r� r} c s� | �kr�| S g }| j dks&| j jr,� jn | j �� �}| jdksJ| jjrP� jn | j�� �}| jrl|| }}| jr~t||d�}|� d|j � �� | j r�|� d� | j r�|� d� | j r�|� d� | jr�|� d� d�|�}|�| < |S ) z%Convert a Style to CSS rules for SVG.Ng�������?zfill: zfont-weight: boldzfont-style: italic;ztext-decoration: underline;z text-decoration: line-through;�;)�color� is_defaultrU � get_truecolor�bgcolorrW �reverse�dimr2 rt rV �bold�italic� underline�striker� )r� � css_rulesri rl �css)rY � style_cacherc rd � get_svg_style s> �� ��� � z)Console.export_svg.<locals>.get_svg_style� g��Q� ��?r& �( r" )r� r} c S s t | ��dd�S )z.HTML escape text and replace spaces with nbsp.rO z )r �replacer� rc rc rd � escape_textA s z'Console.export_svg.<locals>.escape_textN)r r� �attribsr} c s` t td�dd�� d�� fdd�|�� D ��}|rNd| � d|� d|� d | � d� S d| � d|� d �S ) z.Make a tag from name, content, and attributes.rZ c S s t | t�rt| d�S t| �S )N�g)r� �floatrT r� )r[ rc rc rd � stringifyJ s z7Console.export_svg.<locals>.make_tag.<locals>.stringifyrO c 3 s4 | ],\}}|� d ��d d�� d� |�� d�V qdS )rA r` z="�"N)�lstripry )r� �k�v�r~ rc rd r� O s �z7Console.export_svg.<locals>.make_tag.<locals>.<genexpr>r rP z</z/>)�objectr� r� r! )r r� r{ � tag_attribsrc r� rd �make_tagE s �� �z$Console.export_svg.<locals>.make_tagz terminal-r� c s s | ]}t |�V qd S r� )�reprr� rc rc rd r� a s z%Console.export_svg.<locals>.<genexpr>r� r^ )�length�rT�rect� �?� �?� crispEdges)�fillr� r� rj rk �shape_renderingrO r� r` zurl(#�-line-�))�_classr� r� � textLength� clip_pathc s g | ]}|� d �qS )r� rc )r� r )� line_heightrc rd r� � s z&Console.export_svg.<locals>.<listcomp>r� c 3 s@ | ]8\}}d �� d|� d�dd|� � �d d�� d�V qdS ) z<clipPath id="r� z"> r� r r� )r� r� rj rk z </clipPath>Nrc )r� r r� )� char_widthr� r� rf rj rc rd r� � s ��c 3 s* | ]"\}}d � � d|� d|� d�V qdS )�.z-rz { z }Nrc )r� rt �rule_no)rf rc rd r� � s zrgba(255,255,255,0.35)�1)r� �stroke� stroke_widthr� r� rj rk �rxz-title�middlere � )r� r� � text_anchorr� r� z� <g transform="translate(26,22)"> <circle cx="0" cy="0" r="7" fill="#ff5f57"/> <circle cx="22" cy="0" r="7" fill="#febc2e"/> <circle cx="44" cy="0" r="7" fill="#28c840"/> </g> )rf r� � char_heightr� �terminal_width�terminal_heightrj rk � terminal_x� terminal_yr� �chrome� backgrounds�matrixr� )N)"�pip._vendor.rich.cellsrg rD r� rI rj r r� rE r� rC rP rH r� �zlib�adler32r� �encoder� r� rm ri rU rV rk rl rj rW rt r� �ranger! r rT )2r� r� r� r� rI re rf rg rv r� � margin_top� margin_right� margin_bottom� margin_left� padding_top� padding_right�padding_bottom� padding_left� padding_width�padding_height� margin_width� margin_height�text_backgrounds� text_group�classes�style_norz r� r� r� r� r� r� r� �rules� class_name�has_backgroundrO rl � text_length� line_offsetsr� r� r� r� r� r� r� � title_color�svgrc )rY r� r� r� ru rf rj rd � export_svg� s& ! � � � ��� � �� � �� �� �� � � �zConsole.export_svg)r r� r� r� rI re rf r} c C s> | j ||||||d�}t|ddd��} | �|� W 5 Q R X dS )a7 Generate an SVG file from the console contents (requires record=True in Console constructor). Args: path (str): The path to write the SVG to. title (str, optional): The title of the tab in the output image theme (TerminalTheme, optional): The ``TerminalTheme`` object to use to style the terminal clear (bool, optional): Clear record buffer after exporting. Defaults to ``True`` code_format (str, optional): Format string used to generate the SVG. Rich will inject a number of variables into the string in order to form the final SVG output. The default template used and the variables injected by Rich can be found by inspecting the ``console.CONSOLE_SVG_FORMAT`` variable. font_aspect_ratio (float, optional): The width to height ratio of the font used in the ``code_format`` string. Defaults to 0.61, which is the width to height ratio of Fira Code (the default font). If you aren't specifying a different font inside ``code_format``, you probably don't need this. unique_id (str, optional): unique id that is used as the prefix for various elements (CSS styles, node ids). If not set, this defaults to a computed value based on the recorded content. rd rC r� rD N)r� rE r- ) r� r r� r� r� rI re rf r� rF rc rc rd �save_svg� s �zConsole.save_svg)NFF)r& )T)T)T)TN)N)N)r� )N)r r )r� )}r` ra rb rl r� �environr r r� rn r6 r r# r� rM r rm rE r4 r r- r r r} r� rQ r� r �setterr rC r� rY rN r\ r1 r< r� r� rq rr r ru rw r� r r� r� r� r� r� r� r~ r ru rt rC ro r� ri rp r rj rk r� r� r� r; r� r� r� r� r� r� r� r� r� r� r� r9 r� r r8 rD r� r� r� r& r� r� r� r� rL r0 r� r3 r� r� r� r� r@ r r r r � staticmethodr r r r r r$ rn r� r r= rB rG rJ r` r* rb r+ r� r� rc rc rc rd r� R sX #�� � | # - � � �� ! ! � � � � � � 6 �� � ?� � <� � $�� M �� � �� #�� e �� � A�� # � � �� #��%�� QO ��� " �� O�� "�� ��r� )� svg_main_coder} c C s t t�| �� ��S )z�Returns a unique hash for the given SVG main code. Args: svg_main_code (str): The content we're going to inject in the SVG envelope. Returns: str: a hash of the given content )r� r� r� r� )r� rc rc rd � _svg_hash s r� �__main__)r zJSONRPC [i]request[/i]� g�������?Fz2.0�subtract�* � )�minuend� subtrahendr! )Zjsonrpcr� �params�idz Hello, World!z{'a': 1}z&Which one is correct team name in NBA?zNew York BullszLos Angeles KingszGolden State Warriorsz Huston Rocket)�questionr� Zanswer)�answered�q1z 5 + 7 = ?� � � � z 12 - 8 = ?� )r� r� �q2)ZsportZmaths)r �emptyZquiz)T)�r r� �platformrS r> r� �abcr r � dataclassesr r r � functoolsr r ra r r � itertoolsr �mathr �timer �typesr r r �typingr r r r r r r r r r r r r r r �pip._vendor.rich._null_filer � version_infor# r$ r% Z pip._vendor.typing_extensionsr� r' r( r) �_export_formatr* r+ �_filenor, r@ r- r. r� r/ r0 ri r1 r2 r� r3 r r4 r" r5 r6 r{ r8 r� r� r9 r: r� r; r< �prettyr= r> �protocolr? r� r@ �scoperA r� rB r� rC r� rD rE �styledrG �terminal_themerH rI rJ r� rK rL r� rM rN r rO ro rP r� rR r1 r2 r r r� r& r� r� r_ r� � __stdin__r2 � _STDIN_FILENO� Exception� __stdout__�_STDOUT_FILENO� __stderr__�_STDERR_FILENOr� r) rb rg rf ri ro r� r� r� r� rA r� r� r� r� r� r� r� r� r� r� r� ra r= r! r �localr r r rn r r r� r� r` r� r$ r� r� rc rc rc rd �<module> sP D � !'/!"� E ����� � �����