�
E��cd � � � d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ej Z ej Z dZ
de d d
fd �Z d#de de
de
de
de
d d
f d�Z d$de deee eee e f f dee dee de
d ee ef f d�Z d$de dee dee de
d ee e f f
d�Z d%de de d e dee
dee de
d e
fd �Z d$de d ee deee dee de
d ee ee f f d �Z d$de dee dee de
d ee e f f
d �Zd!e de de de
d d
f
d"�Zd
S )&a$ Certbot display.
This module (`certbot.display.util`) or its companion `certbot.display.ops`
should be used whenever:
- Displaying status information to the user on the terminal
- Collecting information from the user via prompts
Other messages can use the `logging` module. See `log.py`.
� )�List)�Optional)�Tuple)�Union)�obj�H �msg�returnNc �Z � t j � � � | ddd�� � dS )zMDisplay a basic status message.
:param str msg: message to display
F)�pause�decorate�wrapN�r � get_display� notification)r s �6/usr/lib/python3/dist-packages/certbot/display/util.py�notifyr s/ � � �O���"�"�3�e�e�%�"�P�P�P�P�P� TF�messager r �force_interactiver
c �\ � t j � � � | ||||�� � dS )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
)r r r r
Nr )r r r r r
s r r r & sD � � �O���"�"�7�%�d�5F�QY� #� [� [� [� [� [r �choices�default�cli_flagc �X � t j � � � | ||||�� � S )a 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 interaction is not possible
: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
�r r r )r r �menu)r r r r r s r r r 8 s7 � �0 �?� � � !� !�'�7�G�h�4E� "� G� G� Gr c �V � t j � � � | |||�� � S )a� Accept input from the user.
:param str message: message to display to the user
:param default: default value to return, if interaction is not possible
: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
r )r r �input�r r r r s r �
input_textr! T s5 � � �?� � � "� "�7�G�h�5F� #� H� H� Hr �Yes�No� yes_label�no_labelc �Z � t j � � � | |||||�� � S )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 interaction is not possible
: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
)r$ r% r r r )r r �yesno)r r$ r% r r r s r r' r' h s; � �( �?� � � "� "�7�i�(�\c�,4�HY� #� [� [� [r �tagsc �X � t j � � � | ||||�� � S )a' 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 interaction is not possible
: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
r )r r � checklist)r r( r r r s r r* r* � s8 � �$ �?� � � &� &�w��g�PX�9J� '� L� L� Lr c �V � t j � � � | |||�� � S )a� Display a directory selection screen.
:param str message: prompt to give the user
:param default: default value to return, if interaction is not possible
: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
r )r r �directory_selectr s r r, r, � s6 � � �?� � � -� -�g�w�QY�@Q� .� S� S� Sr �promptc � � d� | � � }|r|d� |� � z
}|� |s J |� � �dS dS )a0 Verify that provided arguments is a valid display call.
:param str prompt: prompt for the user
:param 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
z)Invalid display call for this prompt:
{0}z7
You can set an answer to this prompt with the {0} flagN)�format)r- r r r r s r �assert_valid_callr0 � sc � � 7�
=�
=�f�
E�
E�C�� B� � 0�06��x�0@�0@� B�� � �"3� � �S� � � � � � � r )TTFT)NNF)r" r# NNF)�__doc__�typingr r r r �certbot._internal.displayr �OK�CANCEL�WIDTH�strr �boolr �intr r! r' r* r, r0 � r r �<module>r; s� ��
�
� � � � � � � � � � � � � � � � � � � � � � � � � )� )� )� )� )� )� �V�� 3� ��� 9�
��Q�� Q�� Q� Q� Q� Q� AE�CG�[� [�#� [�d� [�� [�$(�[�<@�[�LP�[� [� [� [�& CG�#(�G� G�#� G��d�3�i��e�C��H�o�1F�&F� G� G��3�-�G�2:�3�-�G� �G�-2�3��8�_�G� G� G� G�8 W[�).�H� H�� H�h�s�m� H�h�s�m� H�"&�H�38��c��?�H� H� H� H�( AE�DH�$)�[� [�3� [�3� [�#� [��D�>�[�4<�S�M�[� !�[�.2�[� [� [� [�0 MQ�(,�(-�L� L�s� L�$�s�)� L�h�t�C�y�6I� L� ��
�L�!%�L�27��T�#�Y��2G�L� L� L� L�, ]a�/4�S� S�c� S�H�S�M� S�H�UX�M� S�(,�S�9>�s�C�x� �S� S� S� S�&9�c� 9�C� 9�3� 9�SW� 9�\`� 9� 9� 9� 9� 9� 9r |