🔐 Sid Gifari File Manager Pro
v8.0.5 | 2026-06-14 15:45:11 | PHP 8.1.34
📂
/ (Root)
/
usr
/
lib
/
python3.9
/
site-packages
/
certbot
/
_internal
/
display
/
__pycache__
📍 /usr/lib/python3.9/site-packages/certbot/_internal/display/__pycache__
🔄 Refresh
✏️
Editing: obj.cpython-39.opt-1.pyc
Read Only
a }|�g4X � @ s0 d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm Z dd lm Z dd l m Z dd lmZ dd lmZ ddlmZ ddlmZ e�e�ZdZdZdZG dd� d�Ze� Z e d�Z G dd� d�Z G dd� d�Z e e e f d�dd �Z e e e f dd �d d �Z!dS ) zFThis modules define the actual display implementations used in Certbot� N)�Any)�Iterable)�List)�Optional)�TextIO)�Tuple)�TypeVar)�Union)�errors)� constants)� completer)�util)�os�ok�cancelzO- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -c @ s e Zd Zdd�dd�ZdS )�_DisplayServiceN��returnc C s d | _ d S �N��display)�self� r �A/usr/lib/python3.9/site-packages/certbot/_internal/display/obj.py�__init__) s z_DisplayService.__init__)�__name__� __module__� __qualname__r r r r r r ( s r �Tc s� e Zd ZdZeedd�� fdd� Zd*eeeeedd�d d �Zd+ee e e eef e e f e e e e e e e e e e eee ee f d � d d �Zd,ee e e e eee eef d�dd�Zd-eeee e e e eeed�dd�Zd.ee e e e e e e eee ee e f d�dd�Zee e e e ee e d�dd�Zeed �d d �Zd/ee e e e eee eef d�d d �Zee ee f e e e e d!�d"d#�Zee e e eef e e f dd$�d%d&�Ze e ee f d'�d(d)�Z� ZS )0� FileDisplayzFile-based display.N)�outfile�force_interactiver c s t � �� || _|| _d| _d S )NF)�superr r r! �skipped_interaction)r r r! �� __class__r r r 6 s zFileDisplay.__init__TF)�message�pause�wrapr! �decorater c C s~ |rt �|�}t�d|� | j�|r(dndd |r6dnd jtjt |d�� | j� � |rz| � |�rpt � d� n t�d� d S ) a Displays a notification and waits for user acceptance. :param str message: Message to display :param bool pause: Whether or not the program should pause for the user's confirmation :param bool wrap: Whether or not the application should wrap text :param bool force_interactive: True if it's safe to prompt the user because it won't cause any workflow regressions :param bool decorate: Whether to surround the message with a decorated frame �Notifying user: %s�{line}{frame}{line}� � {msg}{line}� {frame}{line}��line�frame�msgzPress Enter to Continuez!Not pausing for user confirmationN) r � wrap_lines�logger�debugr �write�formatr �linesep� SIDE_FRAME�flush� _can_interact�input_with_timeout)r r& r' r( r! r) r r r � notification< s" � ��� zFileDisplay.notification) r& �choices�ok_label� cancel_label� help_label�default�cli_flagr! � unused_kwargsr c K sJ | � ||||�} | dur t| fS | �||� | �t|��\} } | | d fS )aC Display a menu. .. todo:: This doesn't enable the help label/button (I wasn't sold on any interface I came up with for this). It would be a nice feature :param str message: title of menu :param choices: Menu lines, len must be > 0 :type choices: list of tuples (tag, item) or list of descriptions (tags will be enumerated) :param default: default value to return (if one exists) :param str cli_flag: option used to set this value with the CLI :param bool force_interactive: True if it's safe to prompt the user because it won't cause any workflow regressions :returns: tuple of (`code`, `index`) where `code` - str display exit code `index` - int index of the user's selection :rtype: tuple N� )�_return_default�OK� _print_menu�_get_valid_int_ans�len) r r& r> r? r@ rA rB rC r! rD �return_default�code� selectionr r r �menu] s zFileDisplay.menu)r& rB rC r! rD r c K sT | � ||||�}|dur t|fS t�d| �d }t�|�}|dv rLtdfS t|fS )a Accept input from the user. :param str message: message to display to the user :param default: default value to return (if one exists) :param str cli_flag: option used to set this value with the CLI :param bool force_interactive: True if it's safe to prompt the user because it won't cause any workflow regressions :returns: tuple of (`code`, `input`) where `code` - str display exit code `input` - str of the user's input :rtype: tuple Nz%s (Enter 'c' to cancel):� )�c�Cz-1)rF rG r r3 r< �CANCEL)r r& rB rC r! rD rK �ansr r r �input� s zFileDisplay.input�Yes�No)r& � yes_label�no_labelrB rC r! rD r c K s� | � ||||�}|dur |S t�|�}| j�djtjttj |d�� | j� � t� djt� |�t� |�d��} | � |d � � �s�| � |d �� �r�dS | � |d � � �s�| � |d �� �rPdS qPdS ) a� Query the user with a yes/no question. Yes and No label must begin with different letters, and must contain at least one letter each. :param str message: question for the user :param str yes_label: Label of the "Yes" parameter :param str no_label: Label of the "No" parameter :param default: default value to return (if one exists) :param str cli_flag: option used to set this value with the CLI :param bool force_interactive: True if it's safe to prompt the user because it won't cause any workflow regressions :returns: True for "Yes", False for "No" :rtype: bool Nz{0}{frame}{msg}{0}{frame})r1 r2 z {yes}/{no}: )Zyes�nor TF)rF r r3 r r6 r7 r r8 r9 r: r< Zparens_around_char� startswith�lower�upper) r r& rW rX rB rC r! rD rK rS r r r �yesno� s( � ���zFileDisplay.yesno)r& �tagsrB rC r! rD r c K s� | � ||||�}|dur t|fS | �||� | jddd�\}} |tkr�| �� spd�dd� tdt|�d �D ��} t� | �} | � | |�} | r�|| fS | j � d t j � | j �� q |g fS q dS ) aC Display a checklist. :param str message: Message to display to user :param list tags: `str` tags to select, len(tags) > 0 :param default: default value to return (if one exists) :param str cli_flag: option used to set this value with the CLI :param bool force_interactive: True if it's safe to prompt the user because it won't cause any workflow regressions :returns: tuple of (`code`, `tags`) where `code` - str display exit code `tags` - list of selected tags :rtype: tuple NzrSelect the appropriate numbers separated by commas and/or spaces, or leave input blank to select all options shownT)r! rO c s s | ]}t |�V qd S r )�str)�.0�xr r r � <genexpr>� � z(FileDisplay.checklist.<locals>.<genexpr>rE z!** Error - Invalid selection **%s)rF rG rH rT �strip�join�rangerJ r Zseparate_list_input�_scrub_checklist_inputr r6 r r8 r: ) r r& r^ rB rC r! rD rK rL rS �indicesZ selected_tagsr r r � checklist� s& � " � zFileDisplay.checklist)�promptrB rC r! r c C sN | � |�rdS |du r<d�|�}|r2|d�|�7 }t�|��t�d||� |S )a� Should we return the default instead of prompting the user? :param str prompt: prompt for the user :param T default: default answer to prompt :param str cli_flag: command line option for setting an answer to this question :param bool force_interactive: if interactivity is forced :returns: The default value if we should return it else `None` :rtype: T or `None` Nz-Unable to get an answer for the question: {0}zA You can provide an answer on the command line with the {0} flag.z-Falling back to default %s for the prompt: %s)r; r7 r �Errorr4 r5 )r rj rB rC r! r2 r r r rF � s �� �zFileDisplay._return_default)r! r c C s@ | j s |s tj�� r"| j�� r"dS | js<t�dtj � d| _dS )z�Can we safely interact with the user? :param bool force_interactive: if interactivity is forced :returns: True if the display can interact with the user :rtype: bool Tz�Skipped user interaction because Certbot doesn't appear to be running in a terminal. You should probably include --non-interactive or %s on the command line.F) r! �sys�stdin�isattyr r# r4 Zwarningr ZFORCE_INTERACTIVE_FLAG)r r! r r r r; s ���zFileDisplay._can_interactc K s< t �� � | �||||�W d � S 1 s.0 Y dS )a Display a directory selection screen. :param str message: prompt to give the user :param default: default value to return (if one exists) :param str cli_flag: option used to set this value with the CLI :param bool force_interactive: True if it's safe to prompt the user because it won't cause any workflow regressions :returns: tuple of the form (`code`, `string`) where `code` - display exit code `string` - input entered by the user N)r Z CompleterrT )r r& rB rC r! rD r r r �directory_select' s z FileDisplay.directory_select)rh r^ r c st zdd� |D �}W n t y( g Y S 0 tt�|��� �}|D ] }|dk sX|t� �kr@g S q@� fdd�|D �S )z�Validate input and transform indices to appropriate tags. :param list indices: input :param list tags: Original tags of the checklist :returns: valid tags the user selected :rtype: :class:`list` of :class:`str` c S s g | ] }t |��qS r )�int�r` �indexr r r � <listcomp>G rc z6FileDisplay._scrub_checklist_input.<locals>.<listcomp>rE c s g | ]}� |d �qS )rE r rq �r^ r r rs T rc )� ValueError�list�dict�fromkeys�keysrJ )r rh r^ Z indices_intrr r rt r rg : s z"FileDisplay._scrub_checklist_input)r& r> r c C s� |r t |d t�r dd� |D �}| j�tj� |� tj� �� | j�ttj � t|d�D ]6\}}|� d|� �}| j�t� |�� | j�tj� qX| j�ttj � | j� � dS )z�Print a menu on the screen. :param str message: title of menu :param choices: Menu lines :type choices: list of tuples (tag, item) or list of descriptions (tags will be enumerated) r c S s" g | ]}|d � d|d � ��qS )r z - rE r )r` rP r r r rs b rc z+FileDisplay._print_menu.<locals>.<listcomp>rE z: N) � isinstance�tupler r6 r r8 r9 � enumerater r3 r: )r r& r> �iZdescr2 r r r rH V s zFileDisplay._print_menu)�max_r c C s� d}|dkrdj |d�}nd}|dk r�t�|�}|�d�sD|�d�rLtdfS z$t|�}|dk sf||krnd}t�W q ty� | j�d� t j �� | j� � Y q 0 q t |fS ) a5 Get a numerical selection. :param int max: The maximum entry (len of choices), must be positive :returns: tuple of the form (`code`, `selection`) where `code` - str display exit code ('ok' or cancel') `selection` - int user's selection :rtype: tuple ���rE zMSelect the appropriate number [1-{max_}] then [enter] (press 'c' to cancel): )r~ z@Press 1 [enter] to confirm the selection (press 'c' to cancel): rP rQ z{0}** Invalid input **{0}) r7 r r< rZ rR rp ru r r6 r r8 r: rG )r r~ rM Z input_msgrS r r r rI s s* � �z FileDisplay._get_valid_int_ans)TTFT)NNNNNF)NNF)rU rV NNF)NNF)NNF) r r r �__doc__r �boolr r_ r= r r r r rp r rN rT r] ri r rF r; ro r rg rH rI � __classcell__r r r$ r r 2 sf �� " � � $ �� � � , �� +� � � � � r c sh e Zd ZdZeeedd�� fdd� Zd eee ee j d�dd �Z d ee e e edd �d d�Z d eeeeeef ee f ee ee ee ee ee eeeef d� dd�Zd eee ee eeeef d�dd�Zd!eee ee ee ee ee d�dd�Zd"eee eee ee eeeee f d�dd�Zd#eee ee eeeef d�dd �Z� ZS )$�NoninteractiveDisplayzKA display utility implementation that never asks for interactive user inputN)r � unused_argsrD r c s t � �� || _d S r )r" r r )r r r� rD r$ r r r � s z NoninteractiveDisplay.__init__r, )r& rC �extrar c C s8 d}||7 }|r |d| 7 }|r.|d� |�7 }t�|�S )zNReturn error to raise in case of an attempt to interact in noninteractive modez<Missing command line flag or config entry for this setting: � z& (You can set this with the {0} flag))r7 r �MissingCommandlineFlag)r r& rC r� r2 r r r �_interaction_fail� s z'NoninteractiveDisplay._interaction_failFT)r& r' r( r) rD r c K sZ |rt �|�}t�d|� | j�|r(dndd |r6dnd jtjt |d�� | j� � dS )ae Displays a notification without waiting for user acceptance. :param str message: Message to display to stdout :param bool pause: The NoninteractiveDisplay waits for no keyboard :param bool wrap: Whether or not the application should wrap text :param bool decorate: Whether to apply a decorated frame to the message r* r+ r, r- r. r/ N) r r3 r4 r5 r r6 r7 r r8 r9 r: )r r& r' r( r) rD r r r r= � s � ���z"NoninteractiveDisplay.notification) r& r> r? r@ rA rB rC rD r c K s& |du r | � ||dt|� ��t|fS )a_ Avoid displaying a menu. :param str message: title of menu :param choices: Menu lines, len must be > 0 :type choices: list of tuples (tag, item) or list of descriptions (tags will be enumerated) :param int default: the default choice :param dict kwargs: absorbs various irrelevant labelling arguments :returns: tuple of (`code`, `index`) where `code` - str display exit code `index` - int index of the user's selection :rtype: tuple :raises errors.MissingCommandlineFlag: if there was no default Nz Choices: )r� �reprrG ) r r& r> r? r@ rA rB rC rD r r r rN � s zNoninteractiveDisplay.menu)r& rB rC rD r c K s |du r| � ||��t|fS )aK Accept input from the user. :param str message: message to display to the user :returns: tuple of (`code`, `input`) where `code` - str display exit code `input` - str of the user's input :rtype: tuple :raises errors.MissingCommandlineFlag: if there was no default N)r� rG �r r& rB rC rD r r r rT � s zNoninteractiveDisplay.input)r& rW rX rB rC rD r c K s |du r| � ||��|S )a+ Decide Yes or No, without asking anybody :param str message: question for the user :param dict kwargs: absorbs yes_label, no_label :raises errors.MissingCommandlineFlag: if there was no default :returns: True for "Yes", False for "No" :rtype: bool N)r� )r r& rW rX rB rC rD r r r r] � s zNoninteractiveDisplay.yesno)r& r^ rB rC rD r c K s( |du r | � ||d�|�d ��t|fS )aj Display a checklist. :param str message: Message to display to user :param list tags: `str` tags to select, len(tags) > 0 :param dict kwargs: absorbs default_status arg :returns: tuple of (`code`, `tags`) where `code` - str display exit code `tags` - list of selected tags :rtype: tuple Nz? �?)r� re rG )r r& r^ rB rC rD r r r ri � s z NoninteractiveDisplay.checklistc K s | � |||�S )a� Simulate prompting the user for a directory. This function returns default if it is not ``None``, otherwise, an exception is raised explaining the problem. If cli_flag is not ``None``, the error message will include the flag that can be used to set this value with the CLI. :param str message: prompt to give the user :param default: default value to return (if one exists) :param str cli_flag: option used to set this value with the CLI :returns: tuple of the form (`code`, `string`) where `code` - int display exit code `string` - input entered by the user )rT r� r r r ro s z&NoninteractiveDisplay.directory_select)r, )FTT)NNNNN)NN)NNNN)NN)NN)r r r r� r r r r_ r r r� r� r� r= r r r rp rN rT r] r ri ro r� r r r$ r r� � sL � � �� � � � � � �� � �r� r c C s t jstd��t jS )z�Get the display utility. :return: the display utility :rtype: Union[FileDisplay, NoninteractiveDisplay] :raise: ValueError if the display utility is not configured yet. zlThis function was called too early in Certbot's execution as the display utility hasn't been configured yet.)�_SERVICEr ru r r r r � get_display$ s r� )r r c C s | t _dS )zqSet the display service. :param Union[FileDisplay, NoninteractiveDisplay] display: the display service N)r� r r r r r � set_display2 s r� )"r� Zloggingrl �typingr r r r r r r r Zcertbotr Zcertbot._internalr Zcertbot._internal.displayr r Zcertbot.compatr Z getLoggerr r4 rG rR r9 r r� r r r� r� r� r r r r �<module> s: h
💾 Save Changes
❌ Cancel