| Server IP : 89.117.53.150 / Your IP : 216.73.216.11 Web Server : Apache System : Linux server2.hostofiraq.site 5.15.0-186-generic #196-Ubuntu SMP Sat Jun 20 16:09:34 UTC 2026 x86_64 User : iscmbt-kufa-atu ( 1014) PHP Version : 8.2.32 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /lib/python3/dist-packages/twisted/test/__pycache__/ |
Upload File : |
o
�b[ � @ sd d Z ddlmZ ddlmZ G dd� dej�ZG dd� dej�ZG dd � d ej�Z G d
d � d ej�Z
G d d
� d
ej�Z G dd� dej�Z G dd� dej�Z
G dd� dej�ZG dd� dej�ZG dd� dej�ZG dd� dej�ZG dd� dej�ZG d d � d ej�ZG d d � d ej�ZG d d!� d!ej�ZG d"d#� d#ej�ZG d$d%� d%ej�ZG d&d'� d'ej�Zd(S ))zK
Tests for L{twisted.python.usage}, a command line option parsing library.
� )�usage)�unittestc @ sH e Zd Zg d�g d�g d�g d�gZg d�ddggZdd � Zd
d � Zd S )
� WellBehaved)�long�w�defaultzand a docstring)�another�nz no docstring)�longonlyN�noshort)� shortlessN�exceptzthis one got docstring)�aflag�fzO
flagallicious docstringness for this here
�flout�oc C s d| j d< d S )N�PONY!�myflag��opts��self� r �9/usr/lib/python3/dist-packages/twisted/test/test_usage.py�
opt_myflag! s zWellBehaved.opt_myflagc C s |� d�| j d< d S )Nz
WITH A PONY!�myparamr �r �valuer r r � opt_myparam$ s zWellBehaved.opt_myparamN)�__name__�
__module__� __qualname__�
optParameters�optFlagsr r r r r r r
s � �
r c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) �ParseCorrectnessTestszZ
Test L{usage.Options.parseOptions} for correct values under
good conditions.
c C s$ d� � | _t� | _| j�| j� dS )zL
Instantiate and parseOptions a well-behaved Options class.
�A--long Alpha -n Beta --shortless Gamma -f --myflag --myparam TofuN)�split�niceArgVr �nice� parseOptionsr r r r �setUp. s
�zParseCorrectnessTests.setUpc C sT | � | jjd d� | � | jjd d� | � | jjd d� | � | jjd d� d S )
z1
Parameters have correct values.
r �Alphar �Betar
r r �GammaN�� assertEqualr( r r r r r �test_checkParameters; s z*ParseCorrectnessTests.test_checkParametersc C �, | � | jjd d� | � | jjd d� dS )z,
Flags have correct values.
r � r r Nr. r r r r �test_checkFlagsD � z%ParseCorrectnessTests.test_checkFlagsc C r1 )zB
Custom flags and parameters have correct values.
r r r zTofu WITH A PONY!Nr. r r r r �test_checkCustomsK r4 z'ParseCorrectnessTests.test_checkCustomsN)r r r! �__doc__r* r0 r3 r5 r r r r r$ ( s
r$ c @ sL e Zd Zddddegddddegdddd egd
ddd eggZd d
� ZeZdS )� TypedOptions�foointN� zFoo int�foofloat��Q� ��@z Foo float�eggintzEgg int without default�eggfloatzEgg float without defaultc C s
|| _ dS )zg
This option has an underscore in its name to exercise the _ to -
translation.
N)�underscoreValuer r r r �opt_under_score[ s
z TypedOptions.opt_under_score)r r r! �int�floatr" r? �opt_ur r r r r7 S s �r7 c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )�
TypedTestszK
Test L{usage.Options.parseOptions} for options with forced types.
c C s t � | _d S �N)r7 r r r r r r* j s zTypedTests.setUpc C s� g }| j �|� | �| j jd d� | �| j jd t� | �| j jd d� | �| j jd t� | �| j jd � | �| j jd � dS )z,
Default values are parsed.
r8 r9 r: r; r< r= N)r r) r/ r �assertIsInstancer@ rA � assertIsNone�r �argVr r r �test_defaultValuesm s z TypedTests.test_defaultValuesc C s� d� � }| j�|� | �| jjd d� | �| jjd t� | �| jjd d� | �| jjd t� | �| jjd d� | �| jjd t� | �| jjd d � | �| jjd t� d
S ) z2
int and float values are parsed.
z8--fooint 912 --foofloat -823.1 --eggint 32 --eggfloat 21r8 i� r: g����̸��r< � r= g 5@N)r& r r) r/ r rE r@ rA rG r r r �test_parsingValuesz s z TypedTests.test_parsingValuesc C �$ | j �ddg� | �| j jd� dS )zw
A dash in an option name is translated to an underscore before being
dispatched to a handler.
z
--under-score�fooN�r r) r/ r> r r r r �test_underscoreOption� s z TypedTests.test_underscoreOptionc C rL )zE
An option name with a dash in it can have an alias.
z-u�barNrN r r r r �test_underscoreOptionAlias� s z%TypedTests.test_underscoreOptionAliasc C s d� � }| �tj| jj|� dS )z7
Passing wrong values raises an error.
z --fooint eggN)r& � assertRaisesr �
UsageErrorr) rG r r r �test_invalidValues� s z TypedTests.test_invalidValuesN)
r r r! r6 r* rI rK rO rQ rT r r r r rC e s
rC c @ s e Zd Zg d�gZdS )�WrongTypedOptions)�barwrongNNzBar with wrong coerce�heN)r r r! r" r r r r rU � s rU c @ s8 e Zd Zdd� Zdd� Zddddegdddd eggZdS )
�WeirdCallableOptionsc C � t d��)N�Ouch)� RuntimeError�r r r r �_bar� � zWeirdCallableOptions._barc C rY )N�Yay)�
ValueErrorr\ r r r �_foo� r^ zWeirdCallableOptions._foorV NzBar with strange callable�foowrongzFoo with strange callable)r r r! r] ra r" r r r r rX � s �rX c @ �( e Zd ZdZdd� Zdd� Zdd� ZdS ) �WrongTypedTestszF
Test L{usage.Options.parseOptions} for wrong coerce options.
c C s" t � }d�� }| �t|j|� dS )z2
Using a non-callable type fails.
z--barwrong eggN)rU r& rR � TypeErrorr) �r �usrH r r r �test_nonCallable� s z WrongTypedTests.test_nonCallablec C s t � }g }|�|� dS )zP
The coerce functions are not called if no values are provided.
N)rX r) rf r r r �test_notCalledInDefault� s z'WrongTypedTests.test_notCalledInDefaultc C sR t � }d�� }| �tj|j|�}| �t|�d� t � }d�� }| �t|j|� dS )zI
Errors raised by coerce functions are handled properly.
z--foowrong blahz&Parameter type enforcement failed: Yayz--barwrong blahN) rX r& rR r rS r) r/ �strr[ )r rg rH �er r r �test_weirdCallable� s z"WrongTypedTests.test_weirdCallableN)r r r! r6 rh ri rl r r r r rd � s
rd c @ � e Zd Zdd� ZdS )� OutputTestsc C s. t � }| �tj|jdg�}| �t|�d� dS )zF
Error output case adjustment does not mangle options
z-Zzoption -Z not recognizedN)r rR r rS r) r/ rj )r �optrk r r r �test_uppercasing� s z OutputTests.test_uppercasingN)r r r! rp r r r r rn � � rn c @ s e Zd ZdgZdgZdS )�InquisitionOptions)�expectrk )�torture-device�t� comfy-chairz set preferred torture deviceN)r r r! r# r" r r r r rr � s
��rr c @ s e Zd ZddgZdS )�HolyQuestOptions)� horseback�hz use a horse)� for-grail�gN)r r r! r# r r r r rw � s �rw c @ s* e Zd ZdgZddedfddedfgZdS ) �SubCommandOptions)�europian-swallowNz$set default swallow type to Europian� inquisition�inquestzPerform an inquisition� holyquest�questzEmbark upon a holy questN)r r r! r# rr rw � subCommandsr r r r r| � s �
�r| c @ sP e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dS )�SubCommandTestszJ
Test L{usage.Options.parseOptions} for options with subcommands.
c C sd t � }|�ddg� | �|d � | �|jd� | �|jt� | �|jd � | �|jd d� dS )z-
A subcommand is recognized.
�--europian-swallowr~ r} rs rt rv N) r| r) �
assertTruer/ �
subCommandrE �
subOptionsrr � assertFalse�r r r r r �test_simpleSubcommand� � z%SubCommandTests.test_simpleSubcommandc C �d t � }|�g d�� | �|d � | �|jd� | �|jt� | �|jd � | �|jd d� dS )zA
Flags and options of a subcommand are assigned.
)r~ �--expect�--torture-device=featherr} r~ rs rt �featherN� r| r) r� r/ r� rE r� rr r� r� r r r �"test_subcommandWithFlagsAndOptions r� z2SubCommandTests.test_subcommandWithFlagsAndOptionsc C r� )zG
Flags and options of a subcommand alias are assigned.
)r r� r� r} r~ rs rt r� Nr� r� r r r �'test_subcommandAliasWithFlagsAndOptions r� z7SubCommandTests.test_subcommandAliasWithFlagsAndOptionsc C sb t � }|�ddg� | �|d � | �|jd� | �|jt� | �|jd � | �|jd � dS )zG
Flags and options of another subcommand are assigned.
r� z --for-grailr} rx rz N) r| r) r� r/ r� rE r� rw r� r� r r r �)test_anotherSubcommandWithFlagsAndOptions# s z9SubCommandTests.test_anotherSubcommandWithFlagsAndOptionsc C s@ t � }|�dg� | �|d � | �|j� | �t|d�� dS )z�
If no subcommand is specified and no default subcommand is assigned,
a subcommand will not be implied.
r� r} r� N)r| r) r� rF r� r� �hasattrr� r r r �test_noSubcommand/ s
z!SubCommandTests.test_noSubcommandc C sh t � }d|_|�dg� | �|d � | �|jd� | �|jt� | � |jd � | �|jd d� dS ) zK
Flags and options in the default subcommand are assigned.
r r� r} r~ rs rt rv N)
r| �defaultSubCommandr) r� r/ r� rE r� rr r� r� r r r �test_defaultSubcommand: s z&SubCommandTests.test_defaultSubcommandc s` G dd� dt j�� G � fdd�dt j�}|� }|�dg� | �t|jd�� | �|jj|� dS )zw
The parseOptions method from the Options object specified for the
given subcommand is called.
c @ rm )zDSubCommandTests.test_subCommandParseOptionsHasParent.<locals>.SubOptc _ s& | j | _tjj| g|�R i |�� d S rD )�parent� sawParentr �Optionsr) )r �a�kwr r r r) N s zQSubCommandTests.test_subCommandParseOptionsHasParent.<locals>.SubOpt.parseOptionsN)r r r! r) r r r r �SubOptM rq r� c � e Zd Zdd� dfgZdS )zASubCommandTests.test_subCommandParseOptionsHasParent.<locals>.OptrM r rP N�r r r! r� r �r� r r �OptR �
�r� rM r� N)r r� r) r� r� r� r/ r� )r r� r r r� r �$test_subCommandParseOptionsHasParentG s z4SubCommandTests.test_subCommandParseOptionsHasParentc s� G dd� dt j�� G � fdd�dt j�}G � fdd�dt j�}|� }|�dg� |� }|�dg� | �t|jd �� | �t|jd �� | �|jj|� | �|jj|� d
S ) zh
The .parent pointer is correct even when the same Options class is
used twice.
c @ s e Zd ZdS )z:SubCommandTests.test_subCommandInTwoPlaces.<locals>.SubOptN)r r r! r r r r r� b s r� c r� )z:SubCommandTests.test_subCommandInTwoPlaces.<locals>.OptFoorM r �quuxNr� r r� r r �OptFooe r� r� c r� )z:SubCommandTests.test_subCommandInTwoPlaces.<locals>.OptBarrP �br� Nr� r r� r r �OptBarj r� r� rM rP r� N)r r� r) r� r� r� �failUnlessIdenticalr� )r r� r� �oFoo�oBarr r� r �test_subCommandInTwoPlaces\ s z*SubCommandTests.test_subCommandInTwoPlacesN) r r r! r6 r� r� r� r� r� r� r� r� r r r r r� � s
r� c @ rc ) �HelpStringTestsz&
Test generated help strings.
c C s d� � | _t� | _dS )z;
Instantiate a well-behaved Options class.
r% N)r& r' r r( r r r r r* ~ s � zHelpStringTests.setUpc
C sB z| j �� W dS ty } z | �|� W Y d}~dS d}~ww )z,
__str__ shouldn't go boom.
N)r( �__str__� Exception�fail)r rk r r r �
test_noGoBoom� s ��z HelpStringTests.test_noGoBoomc C sF dd� t | j��� D �}| �t|�dk� | �|d �d�dk� dS )zK
Extra whitespace in flag and parameters docs is stripped.
c S s g | ] }|� d �dkr|�qS )r r )�find)�.0�sr r r �
<listcomp>� s zJHelpStringTests.test_whitespaceStripFlagsAndParameters.<locals>.<listcomp>r �
flagalliciousN)rj r( �
splitlinesr� �lenr� )r �linesr r r �&test_whitespaceStripFlagsAndParameters� s z6HelpStringTests.test_whitespaceStripFlagsAndParametersN)r r r! r6 r* r� r� r r r r r� y s
r� c @ s e Zd ZdZdd� Zdd� ZdS )�PortCoerceTestsz3
Test the behavior of L{usage.portCoerce}.
c C s: | � dt�d�� | � dt�d�� | � dt�d�� dS )z4
Test the answers with valid input.
r �0i� �3210i�� �65535N)r/ r �
portCoercer r r r �test_validCoerce� s z PortCoerceTests.test_validCoercec C sD | � ttjd� | � ttjd� | � ttjd� | � ttjd� dS )z"
Test error path.
� z-21�212189rM N)rR r` r r� r r r r �test_errorCoerce� s z PortCoerceTests.test_errorCoerceN)r r r! r6 r� r� r r r r r� � s r� c @ s` e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dS )�ZshCompleterTestsz�
Test the behavior of the various L{twisted.usage.Completer} classes
for producing output usable by zsh tab-completion system.
c C �N t �� }|�dt j�}| �|d� t jddd�}|�dt j�}| �|d� dS )zX
Completer produces zsh shell-code that produces no completion matches.
� some-optionz
:some-option:� some actionT��descr�repeat�*:some action:N)r � Completer�
_shellCode�_ZSHr/ �r �c�gotr r r �test_completer� � z ZshCompleterTests.test_completerc C st t �� }|�dt j�}| �|d� t �d�}|�dt j�}| �|d� t jdddd�}|�dt j�}| �|d� d S )
zn
CompleteFiles produces zsh shell-code that completes file names
according to a glob.
r� z :some-option (*):_files -g "*"z*.pyz$:some-option (*.py):_files -g "*.py"r� Tr� z%*:some action (*.py):_files -g "*.py"N)r �
CompleteFilesr� r� r/ r� r r r �
test_files� s
z ZshCompleterTests.test_filesc C r� )zV
CompleteDirs produces zsh shell-code that completes directory names.
r� z:some-option:_directoriesr� Tr� z*:some action:_directoriesN)r � CompleteDirsr� r� r/ r� r r r � test_dirs� r� zZshCompleterTests.test_dirsc C s~ t �d�}|�dt j�}| �|d� t �g d��}|�dt j�}| �|d� t jg d�ddd�}|�dt j�}| �|d � d
S ) zw
CompleteList produces zsh shell-code that completes words from a fixed
list of possibilities.
�ABCr� z:some-option:(A B C)��1�2�3z:some-option:(1 2 3)r� Tr� z*:some action:(1 2 3)N)r � CompleteListr� r� r/ r� r r r � test_list� s
zZshCompleterTests.test_listc C s� t �d�}|�dt j�}| �|d� t �g d��}|�dt j�}| �|d� t jg d�ddd�}|�dt j�}d }| �||� d
S ) z�
CompleteMultiList produces zsh shell-code that completes multiple
comma-separated words from a fixed list of possibilities.
r� r� z-:some-option:_values -s , 'some-option' A B Cr� z-:some-option:_values -s , 'some-option' 1 2 3r� Tr� z.*:some action:_values -s , 'some action' 1 2 3N)r �CompleteMultiListr� r� r/ )r r� r� �expectedr r r �test_multiList� s
z ZshCompleterTests.test_multiListc C r� )zd
CompleteUsernames produces zsh shell-code that completes system
usernames.
r� z:some-option:_usersr� Tr� z*:some action:_usersN)r �CompleteUsernamesr� r� r/ �r r� �outr r r �test_usernames � z ZshCompleterTests.test_usernamesc C r� )zc
CompleteGroups produces zsh shell-code that completes system group
names.
r� z:group:_groupsr� Tr� z*:some action:_groupsN)r �CompleteGroupsr� r� r/ r� r r r � test_groups r� z ZshCompleterTests.test_groupsc C r� )zU
CompleteHostnames produces zsh shell-code that completes hostnames.
r� z:some-option:_hostsr� Tr� z*:some action:_hostsN)r �CompleteHostnamesr� r� r/ r� r r r �test_hostnames r� z ZshCompleterTests.test_hostnamesc C sV t �� }|�dt j�}| �|�d�� t jddd�}|�dt j�}| �|�d�� dS )z�
CompleteUserAtHost produces zsh shell-code that completes hostnames or
a word of the form <username>@<hostname>.
r� z:host | user@host:r� Tr� r� N)r �CompleteUserAtHostr� r� r� �
startswithr� r r r �test_userAtHost, s z!ZshCompleterTests.test_userAtHostc C r� )zv
CompleteNetInterfaces produces zsh shell-code that completes system
network interface names.
r� z :some-option:_net_interfacesr� Tr� z *:some action:_net_interfacesN)r �CompleteNetInterfacesr� r� r/ r� r r r �test_netInterfaces9 r� z$ZshCompleterTests.test_netInterfacesN)r r r! r6 r� r� r� r� r� r� r� r� r� r� r r r r r� � s
r� c @ � e Zd ZdZdd� ZdS )� CompleterNotImplementedTestszs
Using an unknown shell constant with the various Completer() classes
should raise NotImplementedError
c
C sr t jt jt jt jt jt jt jt jt j t j
g
}|D ] }z|� }W n
t y, |d�}Y nw | � t
|jdd� qdS )zM
Using an unknown shellType should raise NotImplementedError
N�bad_shell_type)r r� r� r� r� r� r� r� r� r� r� �
BaseExceptionrR �NotImplementedErrorr� )r �classes�cls�actionr r r �test_unknownShellM s* �
�
��z.CompleterNotImplementedTests.test_unknownShellN)r r r! r6 r� r r r r r� G s r� c @ s> e Zd ZdZG dd� d�Zdd� Zdd� Zdd � Zd
d � Zd S )
�FlagFunctionTestsz*
Tests for L{usage.flagFunction}.
c @ rc ) zFlagFunctionTests.SomeClassz>
Dummy class for L{usage.flagFunction} tests.
c C � dS )z�
A one argument method to be tested by L{usage.flagFunction}.
@param a: a useless argument to satisfy the function's signature.
Nr )r r� r r r �oneArgr � z"FlagFunctionTests.SomeClass.oneArgc C r� )zU
A no argument method to be tested by L{usage.flagFunction}.
Nr r r r r �noArgy r� z!FlagFunctionTests.SomeClass.noArgc C r� )aG
A multiple arguments method to be tested by L{usage.flagFunction}.
@param a: a useless argument to satisfy the function's signature.
@param b: a useless argument to satisfy the function's signature.
@param c: a useless argument to satisfy the function's signature.
Nr )r r� r� r� r r r �manyArgs~ r� z$FlagFunctionTests.SomeClass.manyArgsN)r r r! r6 r� r� r� r r r r � SomeClassm s
r� c C � | � dt�| �� j�� dS )zs
L{usage.flagFunction} returns C{False} if the method checked allows
exactly one argument.
FN)�assertIsr � flagFunctionr� r� r r r r � test_hasArg� � z FlagFunctionTests.test_hasArgc C r� )zq
L{usage.flagFunction} returns C{True} if the method checked allows
exactly no argument.
TN)r r r r� r� r r r r �
test_noArg� r z FlagFunctionTests.test_noArgc C s, | � tjtj| �� j�}| �dt|�� dS )z
L{usage.flagFunction} raises L{usage.UsageError} if the method checked
allows more than one argument.
z$Invalid Option function for manyArgsN�rR r rS r r� r� r/ rj �r �excr r r �test_tooManyArguments� s �z'FlagFunctionTests.test_tooManyArgumentsc C s. | � tjtj| �� jd�}| �dt|�� dS )z�
L{usage.flagFunction} uses the given method name in the error message
raised when the method allows too many arguments.
�flubudufz$Invalid Option function for flubudufNr r r r r �,test_tooManyArgumentsAndSpecificErrorMessage� s �z>FlagFunctionTests.test_tooManyArgumentsAndSpecificErrorMessageN) r r r! r6 r� r r r r
r r r r r� h s
r� c @ r� )�OptionsInternalTestsz6
Tests internal behavior of C{usage.Options}.
c C sN G dd� dt j�}|� }| �t�g d�d�|jd |jd |jd d�� dS )zs
Options which are synonyms to another option are aliases towards the
longest option name.
c @ s e Zd Zdd� ZeZeZdS )z;OptionsInternalTests.test_optionsAliasesOrder.<locals>.Optsc S r� )z~
This is an option method with a very long name, that is going to
be aliased.
Nr r r r r �opt_very_very_long� r� zNOptionsInternalTests.test_optionsAliasesOrder.<locals>.Opts.opt_very_very_longN)r r r! r � opt_short�opt_sr r r r �Opts� s r )r� �short�very-very-longr r� r N)r r� r/ �dict�fromkeys�synonyms)r r r r r r �test_optionsAliasesOrder� s
��z-OptionsInternalTests.test_optionsAliasesOrderN)r r r! r6 r r r r r r � s r N)r6 �twisted.pythonr �
twisted.trialr r� r �TestCaser$ r7 rC rU rX rd rn rr rw r| r� r� r� r� r� r� r r r r r �<module> s, +;
%
$ !B