o
    °ƒðjÏ?  ã                   @   s²   d Z ddlZddlZddlmZ ddlmZmZmZm	Z	m
Z
mZ ddlmZmZ dZdZ	 e e¡Zdd	d
„Zddd„Zddd„Zdd„ Zdd„ Zefdd„ZG dd„ deƒZdS )a;  
Interactive terminal prompts.

The :mod:`~humanfriendly.prompts` module enables interaction with the user
(operator) by asking for confirmation (:func:`prompt_for_confirmation()`) and
asking to choose from a list of options (:func:`prompt_for_choice()`). It works
by rendering interactive prompts on the terminal.
é    N)Úinteractive_prompt)ÚHIGHLIGHT_COLORÚ
ansi_stripÚ	ansi_wrapÚconnected_to_terminalÚterminal_supports_colorsÚwarning)ÚformatÚconcatenate)	ÚMAX_ATTEMPTSÚTooManyInvalidRepliesÚloggerÚprepare_friendly_promptsÚprepare_prompt_textÚprompt_for_choiceÚprompt_for_confirmationÚprompt_for_inputÚretry_limité
   Tc                 C   s  t | dd�}|r
dn|durdnd}|dt |td� 7 }t d	t|ƒ ¡ ¡ tƒ D ]\}t|d
|dd�}| ¡ dv rBt d|¡  dS | ¡ dv rQt d|¡  dS |se|duret d|r^dnd¡ |  S |rkd| nd}t d|rtdnd||t	¡ t
d|r€dnd
|d� q)dS )aø  
    Prompt the user for confirmation.

    :param question: The text that explains what the user is confirming (a string).
    :param default: The default value (a boolean) or :data:`None`.
    :param padding: Refer to the documentation of :func:`prompt_for_input()`.
    :returns: - If the user enters 'yes' or 'y' then :data:`True` is returned.
              - If the user enters 'no' or 'n' then :data:`False`  is returned.
              - If the user doesn't enter any text or standard input is not
                connected to a terminal (which makes it impossible to prompt
                the user) the value of the keyword argument ``default`` is
                returned (if that value is not :data:`None`).
    :raises: - Any exceptions raised by :func:`retry_limit()`.
             - Any exceptions raised by :func:`prompt_for_input()`.

    When `default` is :data:`False` and the user doesn't enter any text an
    error message is printed and the prompt is repeated:

    >>> prompt_for_confirmation("Are you sure?")
     <BLANKLINE>
     Are you sure? [y/n]
     <BLANKLINE>
     Error: Please enter 'yes' or 'no' (there's no default choice).
     <BLANKLINE>
     Are you sure? [y/n]

    The same thing happens when the user enters text that isn't recognized:

    >>> prompt_for_confirmation("Are you sure?")
     <BLANKLINE>
     Are you sure? [y/n] about what?
     <BLANKLINE>
     Error: Please enter 'yes' or 'no' (the text 'about what?' is not recognized).
     <BLANKLINE>
     Are you sure? [y/n]
    T©Úboldz[Y/n]Nz[y/N]z[y/n]z %s )Úcolorz5Requesting interactive confirmation from terminal: %rÚ ©ÚpaddingÚstrip)ÚyÚyesz#Confirmation granted by reply (%r).)ÚnÚnoz"Confirmation denied by reply (%r).Fú,Default choice selected by empty reply (%r).ÚgrantedÚdeniedzthe text '%s' is not recognizedúthere's no default choiceú&Got %s reply (%s), retrying (%i/%i) ..ÚinvalidÚemptyz6{indent}Error: Please enter 'yes' or 'no' ({details}).ú )ÚindentÚdetails)r   r   r   Údebugr   Úrstripr   r   Úlowerr   r   )ÚquestionÚdefaultr   Úprompt_textÚhintÚattemptÚreplyr)   © r3   ú—/tmp/claude-1000/-var-www-html-academy/3f42efd1-c2b7-4d08-9b05-30d86bb35479/scratchpad/piper/venv/lib/python3.10/site-packages/humanfriendly/prompts.pyr   6   s:   &

ÿ
ÿÿþÿîr   c              	      s  |rdnd}t | ƒ} t| ƒdkrt d| d ¡ | d S | s"tdƒ‚|r&dnd d ‡ fd	d
„t| dd�D ƒ¡dg¡}t|dd�}t dtt	t
| ƒƒ¡ tƒ D ]¼}t|d|dd�}|siˆ durit dˆ ¡ ˆ   S | ¡ r�t|ƒd }d|  krt| ƒk r�n nt d| | |¡ | |   S g }| D ])}	| ¡ }
|	 ¡ }|
|kr®t d|	¡ |	    S |
|v r½t|
ƒdkr½| |	¡ q”t|ƒdkrÓt d|d |¡ |d   S |rÞtd|t|ƒƒ}n| ¡ rêtdt|ƒƒ}n|rö| ¡ sötd|ƒ}nd}t d|rÿdnd||t¡ td||ƒ qOdS )a  
    Prompt the user to select a choice from a group of options.

    :param choices: A sequence of strings with available options.
    :param default: The default choice if the user simply presses Enter
                    (expected to be a string, defaults to :data:`None`).
    :param padding: Refer to the documentation of
                    :func:`~humanfriendly.prompts.prompt_for_input()`.
    :returns: The string corresponding to the user's choice.
    :raises: - :exc:`~exceptions.ValueError` if `choices` is an empty sequence.
             - Any exceptions raised by
               :func:`~humanfriendly.prompts.retry_limit()`.
             - Any exceptions raised by
               :func:`~humanfriendly.prompts.prompt_for_input()`.

    When no options are given an exception is raised:

    >>> prompt_for_choice([])
    Traceback (most recent call last):
      File "humanfriendly/prompts.py", line 148, in prompt_for_choice
        raise ValueError("Can't prompt for choice without any options!")
    ValueError: Can't prompt for choice without any options!

    If a single option is given the user isn't prompted:

    >>> prompt_for_choice(['only one choice'])
    'only one choice'

    Here's what the actual prompt looks like by default:

    >>> prompt_for_choice(['first option', 'second option'])
    <BLANKLINE>
      1. first option
      2. second option
    <BLANKLINE>
     Enter your choice as a number or unique substring (Control-C aborts): second
    <BLANKLINE>
    'second option'

    If you don't like the whitespace (empty lines and indentation):

    >>> prompt_for_choice(['first option', 'second option'], padding=False)
     1. first option
     2. second option
    Enter your choice as a number or unique substring (Control-C aborts): first
    'first option'
    r'   r   é   z=Skipping interactive prompt because there's only option (%r).r   z,Can't prompt for choice without any options!z

Ú
c                    s,   g | ]\}}d ||f |ˆ krdnd ‘qS )z %i. %sz (default choice)r   r3   )Ú.0ÚiÚchoice©r.   r3   r4   Ú
<listcomp>µ   s    ÿÿz%prompt_for_choice.<locals>.<listcomp>)ÚstartzFEnter your choice as a number or unique substring (Control-C aborts): Tr   z=Requesting interactive choice on terminal (options are %s) ..r   Nr    z+Option (%r) selected by numeric reply (%s).z,Option (%r) selected by reply (exact match).z6Option (%r) selected by reply (substring match on %r).z*text '%s' matches more than one choice: %sznumber %i is not a valid choicez#text '%s' doesn't match any choicesr#   r$   r%   r&   z%sError: Invalid input (%s).)ÚlistÚlenr   r*   Ú
ValueErrorÚjoinÚ	enumerater   r
   ÚmapÚreprr   r   ÚisdigitÚintr,   Úappendr	   Úisspacer   r   )Úchoicesr.   r   r(   r/   r1   r2   ÚindexÚmatchesr9   Úlower_replyÚlower_choicer)   r3   r:   r4   r   x   sj   0
þù	ÿ

€þÙr   c              
   C   sð   t ƒ  d}z;|rd|  } |  dd¡} zt| ƒ}W |du r"tj d¡ |r*tj d¡ n|du r5tj d¡ |r>tj d¡ w w W n+ tyk } zt|tƒr_|dur_t	 
d|¡ |W  Y d}~S t	jddd� ‚ d}~ww |durt|st|S | ¡ S )aü  
    Prompt the user for input (free form text).

    :param question: An explanation of what is expected from the user (a string).
    :param default: The return value if the user doesn't enter any text or
                    standard input is not connected to a terminal (which
                    makes it impossible to prompt the user).
    :param padding: Render empty lines before and after the prompt to make it
                    stand out from the surrounding text? (a boolean, defaults
                    to :data:`True`)
    :param strip: Strip leading/trailing whitespace from the user's reply?
    :returns: The text entered by the user (a string) or the value of the
              `default` argument.
    :raises: - :exc:`~exceptions.KeyboardInterrupt` when the program is
               interrupted_ while the prompt is active, for example
               because the user presses Control-C_.
             - :exc:`~exceptions.EOFError` when reading from `standard input`_
               fails, for example because the user presses Control-D_ or
               because the standard input stream is redirected (only if
               `default` is :data:`None`).

    .. _Control-C: https://en.wikipedia.org/wiki/Control-C#In_command-line_environments
    .. _Control-D: https://en.wikipedia.org/wiki/End-of-transmission_character#Meaning_in_Unix
    .. _interrupted: https://en.wikipedia.org/wiki/Unix_signal#SIGINT
    .. _standard input: https://en.wikipedia.org/wiki/Standard_streams#Standard_input_.28stdin.29
    Nr6   z
 z6Got EOF from terminal, returning default value (%r) ..z0Interactive prompt was interrupted by exception!T)Úexc_info)r   Úreplacer   ÚsysÚstderrÚwriteÚBaseExceptionÚ
isinstanceÚEOFErrorr   r*   r   r   )r-   r.   r   r   r2   Úer3   r3   r4   r   ê   s<   
€íû€€ör   c                 K   s(   t tjƒrt| fdttjƒi|¤ŽS | S )aÿ  
    Wrap a text to be rendered as an interactive prompt in ANSI escape sequences.

    :param prompt_text: The text to render on the prompt (a string).
    :param options: Any keyword arguments are passed on to :func:`.ansi_wrap()`.
    :returns: The resulting prompt text (a string).

    ANSI escape sequences are only used when the standard output stream is
    connected to a terminal. When the standard input stream is connected to a
    terminal any escape sequences are wrapped in "readline hints".
    Úreadline_hints)r   rO   Ústdoutr   r   Ústdin)r/   Úoptionsr3   r3   r4   r   8  s   ÿþr   c                  C   s$   zddl } W dS  ty   Y dS w )u¤  
    Make interactive prompts more user friendly.

    The prompts presented by :func:`python2:raw_input()` (in Python 2) and
    :func:`python3:input()` (in Python 3) are not very user friendly by
    default, for example the cursor keys (:kbd:`â†�`, :kbd:`â†‘`, :kbd:`â†’` and
    :kbd:`â†“`) and the :kbd:`Home` and :kbd:`End` keys enter characters instead
    of performing the action you would expect them to. By simply importing the
    :mod:`readline` module these prompts become much friendlier (as mentioned
    in the Python standard library documentation).

    This function is called by the other functions in this module to enable
    user friendly prompts.
    r   N)ÚreadlineÚImportError)rZ   r3   r3   r4   r   I  s
   þr   c                 c   s8   � t | ƒD ]}|d V  qd}||  }t |¡ t|ƒ‚)a	  
    Allow the user to provide valid input up to `limit` times.

    :param limit: The maximum number of attempts (a number,
                  defaults to :data:`MAX_ATTEMPTS`).
    :returns: A generator of numbers starting from one.
    :raises: :exc:`TooManyInvalidReplies` when an interactive prompt
             receives repeated invalid input (:data:`MAX_ATTEMPTS`).

    This function returns a generator for interactive prompts that want to
    repeat on invalid input without getting stuck in infinite loops.
    r5   zTReceived too many invalid replies on interactive prompt, giving up! (tried %i times))Úranger   r   r   )Úlimitr8   ÚmsgÚformatted_msgr3   r3   r4   r   _  s   €
r   c                   @   s   e Zd ZdZdS )r   zLRaised by interactive prompts when they've received too many invalid inputs.N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r3   r3   r3   r4   r   v  s    r   )NT)NTT)rc   ÚloggingrO   Úhumanfriendly.compatr   Úhumanfriendly.terminalr   r   r   r   r   r   Úhumanfriendly.textr	   r
   Ú__all__r   Ú	getLoggerr`   r   r   r   r   r   r   r   Ú	Exceptionr   r3   r3   r3   r4   Ú<module>   s"   
 


B
rN