File: //usr/lib/python3/dist-packages/click/__pycache__/exceptions.cpython-310.pyc
o
�+ca�# � @ s0 d dl Z d dlZd dlmZ d dlmZ ddlmZ ddlm Z ej
r/ddl m Z ddl m
Z
d ejejeje ef d
eje fd d �ZG d
d� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e �Z G d d � d e �Z dS )!� N)�gettext)�ngettext� )�get_text_stderr)�echo)�Context)� Parameter�
param_hint�returnc C s* | d urt | t�sd�dd� | D ��S | S )Nz / c s s � | ]}t |�V qd S �N)�repr)�.0�x� r �2/usr/lib/python3/dist-packages/click/exceptions.py� <genexpr> s � z$_join_param_hints.<locals>.<genexpr>)�
isinstance�str�join)r r r r �_join_param_hints s r c sf e Zd ZdZdZdeddf� fdd� Zdefdd �Zdefd
d �Zdd e j
e j ddfd
d�Z � Z
S )�ClickExceptionz8An exception that Click can handle and show to the user.r �messager
Nc s t � �|� || _d S r )�super�__init__r )�selfr �� __class__r r r s
zClickException.__init__c C � | j S r �r �r r r r �format_message! � z ClickException.format_messagec C r r r r r r r �__str__$ r! zClickException.__str__�filec C s. |d u rt � }ttd�j| �� d�|d� d S )N�Error: {message}r )r# )r r �_�formatr )r r# r r r �show' s zClickException.showr )�__name__�
__module__� __qualname__�__doc__� exit_coder r r r" �t�Optional�IOr' �
__classcell__r r r r r s $r c sV e Zd ZdZdZd
dedejd ddf� fdd �
Zd
d
ejej ddfd d �Z
� Z S )�
UsageErrora+ An internal exception that signals a usage error. This typically
aborts any further handling.
:param message: the error message to display.
:param ctx: optionally the context that caused this error. Click will
fill in the context automatically in some situations.
� Nr �ctxr r
c s0 t � �|� || _| jr| jj| _d S d | _d S r )r r r3 �command�cmd)r r r3 r r r r 9 s zUsageError.__init__r# c C s� |d u rt � }d }d}| jd ur.| jj�| j�d ur.td�j| jj| jjd d�}|� d�}| jd urF| jj}t | j�
� � d|� �||d� t td�j| � � d�||d� d S ) N� z"Try '{command} {option}' for help.r )r4 �option�
)r# �colorr$ r ) r r3 r4 �get_help_optionr% r& � command_path�help_option_namesr9 r � get_usager )r r# r9 �hintr r r r' > s$
�
�zUsageError.showr ) r( r) r* r+ r, r r- r. r r/ r' r0 r r r r r1 . s
"$r1 c s^ e Zd ZdZ ddedejd dejd deje d df
� fd
d �
Zd efd d
�Z� Z S )� BadParametera
An exception that formats out a standardized error message for a
bad parameter. This is useful when thrown from a callback or type as
Click will attach contextual information to it (for instance, which
parameter it is).
.. versionadded:: 2.0
:param param: the parameter object that caused this error. This can
be left out, and Click will attach this info itself
if possible.
:param param_hint: a string that shows up as parameter name. This
can be used as alternative to `param` in cases
where custom validation should happen. If it is
a string it's used as such, if it's a list then
each item is quoted and separated.
Nr r3 r �paramr r r
c s t � �||� || _|| _d S r )r r r@ r )r r r3 r@ r r r r r g s
zBadParameter.__init__c C sV | j d ur | j }n| jd ur| j�| j�}n td�j| jd�S td�jt|�| jd�S )NzInvalid value: {message}r z)Invalid value for {param_hint}: {message})r r )r r@ �get_error_hintr3 r% r& r r )r r r r r r r s
�zBadParameter.format_message�NNN�
r( r) r* r+ r r- r. r r r0 r r r r r? U s" ������ r? c
s� e Zd ZdZ ddeje dejd dejd deje d eje d
df � fd d �
Zd
efd
d�Zd
efdd�Z � Z
S )�MissingParametera� Raised if click required an option or argument but it was not
provided when invoking the script.
.. versionadded:: 4.0
:param param_type: a string that indicates the type of the parameter.
The default is to inherit the parameter type from
the given `param`. Valid values are ``'parameter'``,
``'option'`` or ``'argument'``.
Nr r3 r r@ r r �
param_typer
c s t � �|pd|||� || _d S )Nr6 )r r rE )r r r3 r@ r rE r r r r � s
zMissingParameter.__init__c C s | j d ur | j }n| jd ur| j�| j�}nd }t|�}|r#d|� �nd}| j}|d u r5| jd ur5| jj}| j}| jd urS| jj� | j�}|rS|rQ|d|� �7 }n|}|rZd|� �nd}|dkret
d�}n|dkrnt
d�}n|dkrwt
d �}nt
d
�j |d �}|� |� d |� �S )
N� r6 z. �argumentzMissing argumentr7 zMissing option� parameterzMissing parameterzMissing {param_type})rE �.) r r@ rA r3 r rE �param_type_namer �type�get_missing_messager% r& )r r rE �msg� msg_extra�missingr r r r � s4
z MissingParameter.format_messagec C s. | j s| jr
| jjnd }td�j|d�S | j S )Nz Missing parameter: {param_name})�
param_name)r r@ �namer% r& )r rP r r r r" � s zMissingParameter.__str__)NNNNN) r( r) r* r+ r- r. r r r r" r0 r r r r rD s,
������� &rD c sd e Zd ZdZ d
dedeje dejeje dejd ddf
� fd d
�
Zdefd d �Z � Z
S )� NoSuchOptionzfRaised if click attempted to handle an option that does not
exist.
.. versionadded:: 4.0
N� option_namer �
possibilitiesr3 r r
c s6 |d u r t d�j|d�}t� �||� || _|| _d S )NzNo such option: {name})rQ )r% r& r r rS rT )r rS r rT r3 r r r r � s
zNoSuchOption.__init__c C sH | j s| jS d�t| j ��}tddt| j ��j||d�}| j� d|� �S )Nz, zDid you mean {possibility}?z#(Possible options: {possibilities}))� possibilityrT rF )rT r r �sortedr �lenr& )r �possibility_str�suggestr r r r � s ��zNoSuchOption.format_messagerB ) r( r) r* r+ r r- r. �Sequencer r r0 r r r r rR � s" ������rR c s< e Zd ZdZ d
dededejd ddf� fdd �
Z� ZS ) �BadOptionUsagea Raised if an option is generally supplied but the use of the option
was incorrect. This is for instance raised if the number of arguments
for an option is not correct.
.. versionadded:: 4.0
:param option_name: the name of the option being used incorrectly.
NrS r r3 r r
c s t � �||� || _d S r )r r rS )r rS r r3 r r r r � s
zBadOptionUsage.__init__r ) r( r) r* r+ r r- r. r r0 r r r r r[ � s
�����r[ c @ � e Zd ZdZdS )�BadArgumentUsagez�Raised if an argument is generally supplied but the use of the argument
was incorrect. This is for instance raised if the number of values
for an argument is not correct.
.. versionadded:: 6.0
N�r( r) r* r+ r r r r r] � � r] c sD e Zd ZdZd
dedeje ddf� fdd�
Zdefdd �Z� Z S ) � FileErrorz"Raised if a file cannot be opened.N�filenamer> r
c s2 |d u rt d�}t� �|� t�|�| _|| _d S )Nz
unknown error)r% r r �os�fsdecode� ui_filenamera )r ra r> r r r r s
zFileError.__init__c C s t d�j| j| jd�S )Nz+Could not open file {filename!r}: {message})ra r )r% r& rd r r r r r r s �zFileError.format_messager rC r r r r r` s "r` c @ r\ )�Abortz=An internal signalling exception that signals Click to abort.Nr^ r r r r re r_ re c @ s( e Zd ZdZdZd deddfdd�ZdS )
�Exitz�An exception that indicates that the application should exit with some
status code.
:param code: the status code to exit with.
�r, r �coder
Nc C s
|| _ d S r rg )r rh r r r r s
z
Exit.__init__)r )r( r) r* r+ � __slots__�intr r r r r rf s rf ) rb �typingr- r r% r �_compatr �utilsr �
TYPE_CHECKING�corer r r. �UnionrZ r r � Exceptionr r1 r? rD rR r[ r] r` � RuntimeErrorre rf r r r r �<module> s0 �
� '*E"