File: //usr/lib/python3/dist-packages/twisted/python/__pycache__/formmethod.cpython-310.pyc
o
�bK/ � @ s� d Z ddlZddlmZmZmZ G dd� de�ZG dd� de�ZG dd � d �Z G d
d � d e �Z
G d d
� d
e
�Z G dd� de
�Z G dd� de
�Z
G dd� de
�ZG dd� de �ZG dd� de�ZG dd� de �ZG dd� de �ZG d d � d e �ZG d d � d e�ZG d d!� d!e�ZG d"d#� d#e �ZG d$d%� d%e �Zd&d'� ZG d(d)� d)e �ZG d*d+� d+e�ZG d,d-� d-�ZG d.d/� d/�Z G d0d1� d1�Z dS )2z�
Form-based method objects.
This module contains support for descriptive method signatures that can be used
to format methods.
� N)�Any�Optional�Tuplec @ � e Zd ZdZdd� ZdS )�
FormExceptionz*An error occurred calling the form method.c O s t j| g|�R � || _d S �N)� Exception�__init__� descriptions)�self�args�kwargs� r �;/usr/lib/python3/dist-packages/twisted/python/formmethod.pyr s
zFormException.__init__N)�__name__�
__module__� __qualname__�__doc__r r r r r r � r c @ � e Zd ZdZdS )�
InputErrorz,
An error occurred with some input.
N�r r r r r r r r r � r c @ sT e Zd ZU dZdZeed< ddd�Zdd� Zdd d
�Z d d � Z
d
d� Z dd� Z dS )�Argumentz Base class for form arguments.N�defaultDefault� c C s> || _ || _|d u r
| j}|| _|| _|| _|si }|| _d S r )�name� allowNoner �default� shortDesc�longDesc�hints)r r r r r r! r r r r r % s
zArgument.__init__c K s | j �|� d S r )r! �update)r r
r r r �addHints3 � zArgument.addHintsc C s | j �||�S r )r! �get)r r r r r r �getHint6 s zArgument.getHintc C s | j p| j�� S r )r r �
capitalize�r r r r �getShortDescription9 r$ z Argument.getShortDescriptionc C s
| j pdS )N� )r r( r r r �getLongDescription< s
zArgument.getLongDescriptionc C s t d��)z(Convert the value to the correct format.zimplement in subclass)�NotImplementedError�r �valr r r �coerce? s zArgument.coerce)NNNNr r )
r r r r r r �__annotations__r r# r& r) r+ r/ r r r r r s
�
r c @ sF e Zd ZU dZdZeed< dZdZ d dd�Z d d
� Z
dS ) �StringzA single string.r* r r Nr c C s( t j| ||||||d� || _|| _d S )N)r r r r! r )r r �min�max) r r r r r r! r r2 r3 r r r r K s �
zString.__init__c C sR t |�}t|�| jk rtd| j ��| jd ur%t|�| jkr%td| j ��t |�S )N�)Value must be at least %s characters long�(Value must be at most %s characters long)�str�lenr2 r r3 )r r. �sr r r r/ b s z
String.coerce)NNNNr r N) r r r r r r6 r0 r2 r3 r r/ r r r r r1 D s
� r1 c @ r )�TextzA long string.Nr r r r r r9 k r r9 c @ r )�Passwordz-A string which should be obscured when input.Nr r r r r r: o r r: c @ r )�VerifiedPasswordzCA string that should be obscured when input and needs verification.c C sv t |�dks|d |d krtd��t|d �}t |�| jk r&td| j ��| jd ur9t |�| jkr9td| j ��|S )N� r r z%Please enter the same password twice.r4 r5 )r7 r r6 r2 r3 )r �valsr8 r r r r/ v s zVerifiedPassword.coerceN)r r r r r/ r r r r r; s r r; c @ r )�HiddenzSA string which is not displayed.
The passed default is used as the value.
Nr r r r r r> � r r> c @ s6 e Zd ZU dZdZee ed< d dd�Zdd� Z dS )
�IntegerzA single integer.Nr r c C � t �| ||||||� d S r �r r �r r r r r r r! r r r r � � zInteger.__init__c C s: |� � s | jr d S zt|�W S ty td�|���w )Nz5{} is not valid, please enter a whole number, e.g. 10)�stripr �int�
ValueErrorr �formatr- r r r r/ � s
��zInteger.coerce�r NNNN)
r r r r r r rE r0 r r/ r r r r r? � s
�
r? c @ s( e Zd Z ddd�Zdd� ZdS )� IntegerRanger Nc C s( || _ || _tj| ||||||d� d S )N)r r r r r! )r2 r3 r? r ) r r r2 r3 r r r r r! r r r r � s
�zIntegerRange.__init__c C sZ t �| |�}| jr|d kr|S || jk r td�|| j���|| jkr+td�|| j���|S )Nz/Value {} is too small, it should be at least {}z.Value {} is too large, it should be at most {})r? r/ r r2 r rG r3 )r r. �resultr r r r/ � s
��
��zIntegerRange.coercerH �r r r r r/ r r r r rI � s
� rI c @ s2 e Zd ZU dZee ed< ddd�Zdd� ZdS ) �FloatNr r c C r@ r rA rB r r r r � rC zFloat.__init__c C s8 |� � s | jr d S zt|�W S ty td| ��w )NzInvalid float: %s)rD r �floatrF r r- r r r r/ � s
�z Float.coercerH ) r r r r r rM r0 r r/ r r r r rL � s
�
rL c @ s. e Zd ZdZg g ddddfdd�Zdd� ZdS )�Choicea�
The result of a choice between enumerated types. The choices should
be a list of tuples of tag, value, and description. The tag will be
the value returned if the user hits "Submit", and the description
is the bale for the enumerated type. default is a list of all the
values (seconds element in choices). If no defaults are specified,
initially the first item will be selected. Only one item can (should)
be selected at once.
Nr c C s< || _ |r|s|�|d d � tj| ||||||d� d S )Nr r �r )�choices�appendr r )r r rP r r r r! r r r r r � s
�zChoice.__init__c C s. | j D ]
\}}}||kr| S qtd| ��)NzInvalid Choice: %s)rP r )r �inIdent�identr. �descr r r r/ s
� z
Choice.coerce�r r r r r r/ r r r r rN � s
� rN c @ s. e Zd ZdZ d dd�Zdd� ZdS )
�Flagsa�
The result of a checkbox group or multi-menu. The flags should be a
list of tuples of tag, value, and description. The tag will be
the value returned if the user hits "Submit", and the description
is the bale for the enumerated type. default is a list of all the
values (second elements in flags). If no defaults are specified,
initially nothing will be selected. Several items may be selected at
once.
r Nr c C s" || _ tj| ||||||d� d S �NrO )�flagsr r )r r rX r r r r! r r r r r s
�zFlags.__init__c C sN |sg S g }|D ] }| j D ]\}}}||kr |�|� nq
td| ��q|S )NzInvalid Flag: %s)rX rQ r )r �
inFlagKeys�outFlags� inFlagKey�flagKey�flagVal�flagDescr r r r/ " s
� �z Flags.coerce)r r NNNr rU r r r r rV s
� rV c @ � e Zd ZdS )�
CheckGroupN�r r r r r r r r` 0 � r` c @ r_ )�
RadioGroupNra r r r r rc 4 rb rc c @ s e Zd Zdd� ZdS )�Booleanc C s$ |sdS t |��� }|dv rdS dS )Nr )�no�n�f�false�0r )r6 �lower)r �inVal�lInValr r r r/ 9 s zBoolean.coerceN)r r r r/ r r r r rd 8 s rd c @ s e Zd Zddd�Zdd� ZdS )�Filer Nc C s t j| |d ||||d� d S rW rA )r r r r r r! r r r r C s
�z
File.__init__c C s |s| j rd S |r |S td��)Nz Invalid File)r r )r �filer r r r/ H s
z File.coerce)r NNNrK r r r r rm B s
rm c C s t | �} | dkr
t�| S )Nr )rE rF )�xr r r � positiveIntQ s rp c @ s@ e Zd ZU dZdZeeeeef ed< d dd�Z dd� Z
dS )
�Datez#A date -- (year, month, day) tuple.Nr r c C s, t �| |||||� || _|sd| _d S d S )N)i� r r )r r r r rB r r r r ] s
�z
Date.__init__c C s� t |�dkr | jr dS z
tt|�\}}}W n ty td��w ||fdkr7t�|�s2td| ��|||fS ztj| }W n t yI td��w ||krRtd��|||fS )z(Return tuple of ints (year, month, day).)r* r* r* Nz Invalid date)r< � z%d was not a leap year)
�tupler �maprp rF r �calendar�isleap�mdays�
IndexError)r r �year�month�dayrw r r r r/ e s& �
�
z Date.coercerH ) r r r r r r r rE r0 r r/ r r r r rq X s
� rq c @ s0 e Zd ZdZdgdddddfdd�Zdd� ZdS ) �Submitz0Submit button or a reasonable facsimile thereof.)r| �submitz Submit formr Nc C s& t j| |||||d� || _|| _d S )N)rP r r r! )rN r r �reset)r r rP r~ r r r r! r r r r s
�
zSubmit.__init__c C s | j r|sd S t�| |�S r )r rN r/ )r �valuer r r r/ � s
z
Submit.coercerU r r r r r| | s
� r| c @ r )�PresentationHintz(
A hint to a particular system.
Nr r r r r r� � r r� c @ s* e Zd ZdZdd� Zdd� Zd
dd�Zd S ) �MethodSignaturez$
A signature of a callable.
c G s
|| _ dS )r* N)�methodSignature)r �sigListr r r r � s
zMethodSignature.__init__c C s" | j D ] }|j|kr| S qd S r )r� r )r r �ar r r � getArgument� s
��zMethodSignature.getArgumentFc C s t | ||�S r )�
FormMethod)r �callable� takesRequestr r r �method� � zMethodSignature.methodN�F)r r r r r r� r� r r r r r� � s
r� c @ s* e Zd ZdZd
dd�Zdd� Zdd� Zd S ) r� z#A callable object with a signature.Fc C s || _ || _|| _d S r )� signaturer� r� )r r� r� r� r r r r � s
zFormMethod.__init__c C s t | jj�S r )rs r� r� r( r r r �getArgs� r� zFormMethod.getArgsc O s | j |i |��S r )r� )r r �kwr r r �call� r$ zFormMethod.callNr� )r r r r r r� r� r r r r r� � s
r� ) r ru �typingr r r r r r r r1 r9 r: r; r> r? rI rL rN rV r` rc rd rm rp rq r| r� r� r� r r r r �<module> s4 %'+$(
$