�
N�gd � �" � d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ej Z ej Z dZ
de d d
fd �Z d d e d
e
de
de
de
d d
f d�Z d d e deee eee e f f dee dee de
d ee ef f d�Z d d e dee dee de
d ee e f f
d�Z d!d e de de dee
dee de
d e
fd�Z d d e dee deee dee de
d ee ee f f d�Z d d e dee dee de
d ee e f f
d �Zd e de de de
d d
f
d �Zy
)"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 �R � t j � j | ddd�� y)zMDisplay a basic status message.
:param str msg: message to display
F)�pause�decorate�wrapN�r � get_display� notification)r s ��/build/snapcraft-certbot-2c33630aaf29c47357e5a1683f659d3d/parts/certbot/install/lib/python3.12/site-packages/certbot/display/util.py�notifyr s" � � �O�O��"�"�3�e�e�%�"�P� �messager r �force_interactiver
c �T � t j � j | ||||�� y)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 & s+ � � �O�O��"�"�7�%�d�5F�QY� #� [r �choices�default�cli_flagc �R � t j � 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 s0 � �0 �?�?� � !� !�'�7�G�h�4E� "� G� Gr c �P � t j � 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 s. � � �?�?� � "� "�7�G�h�5F� #� H� Hr � yes_label�no_labelc �T � t j � 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 s4 � �( �?�?� � "� "�7�i�(�\c�,4�HY� #� [� [r �tagsc �R � t j � 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( � s1 � �$ �?�?� � &� &�w��g�PX�9J� '� L� Lr c �P � t j � 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* � s/ � � �?�?� � -� -�g�w�QY�@Q� .� S� Sr �promptc �j � dj | � }|r|dj |� z
}|�
|sJ |� �yy)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_callr. � sK � � 7�
=�
=�f�
E�C�� � 0�06��x�0@� B�� � �"3�8�S�8� 3�"3� r )TTFT)NNF)�Yes�NoNNF)�__doc__�typingr r r r �certbot._internal.displayr �OK�CANCEL�WIDTH�strr �boolr �intr r! r% r( r* r. � r r �<module>r; s| ��
� � � � � )� �V�V�� 3� ���� 9�
��Q�� Q�� Q� AE�CG�[�#� [�d� [�� [�$(�[�<@�[�LP�[�& CG�#(�G�#� G��d�3�i��e�C��H�o�1F�&F� G� G��3�-�G�2:�3�-�G� �G�-2�3��8�_�G�8 W[�).�H�� H�h�s�m� H�h�s�m� H�"&�H�38��c��?�H�( AE�DH�$)�[�3� [�3� [�#� [��D�>�[�4<�S�M�[� !�[�.2�[�0 MQ�(,�(-�L�s� L�$�s�)� L�h�t�C�y�6I� L� ��
�L�!%�L�27��T�#�Y��2G�L�, ]a�/4�S�c� S�H�S�M� S�H�UX�M� S�(,�S�9>�s�C�x� �S�&9�c� 9�C� 9�3� 9�SW� 9�\`� 9r |