h[SrSSKJr SSKJr "SS\R 5r"SS\R5r"SS \R 5r "S S \R5r "S S \R 5r "SS\R 5r "SS\R5r "SS\R5r"SS\R 5r"SS\R 5r"SS\R 5r"SS\R5r"SS\R5r"SS\R5r"S S!\R5r"S"S#\R5r"S$S%\R5r"S&S'\R5rg())zK Tests for L{twisted.python.usage}, a command line option parsing library. usage)unittestcL\rSrSr/SQ/SQ/SQ/SQ/r/SQSS//rS rS rS rg ) WellBehaved )longwdefaultzand a docstring)anothernz no docstring)longonlyNnoshort) shortlessNexceptzthis one got docstring)aflagfzO flagallicious docstringness for this here floutoc"SURS'g)NPONY!myflagoptsselfs ^/root/1688_scrapy/alibaba-scraper/venv/lib/python3.13/site-packages/twisted/test/test_usage.py opt_myflagWellBehaved.opt_myflag!s% (c(US3URS'g)Nz WITH A PONY!myparamrrvalues r opt_myparamWellBehaved.opt_myparam$s"' 6 )r N) __name__ __module__ __qualname____firstlineno__ optParametersoptFlagsrr%__static_attributes__r'r rrr s43(%? M  # H&7r rc0\rSrSrSrSrSrSrSrSr g) ParseCorrectnessTests(zN Test L{usage.Options.parseOptions} for correct values under good conditions. cSR5Ul[5UlURR UR5 g)z< Instantiate and parseOptions a well-behaved Options class. A--long Alpha -n Beta --shortless Gamma -f --myflag --myparam TofuN)splitniceArgVrnice parseOptionsrs rsetUpParseCorrectnessTests.setUp.s7 V %'  M  t}}-r cLURURRSS5 URURRSS5 URURRSS5 URURRSS5 g ) z! Parameters have correct values. r Alphar BetarrrGammaN assertEqualr6rrs rtest_checkParameters*ParseCorrectnessTests.test_checkParameters;sx /9  2F;  3Y?  4g>r cURURRSS5 URURRSS5 g)z Flags have correct values. rrrNr>rs rtest_checkFlags%ParseCorrectnessTests.test_checkFlagsDs> 0!4 0!4r cURURRSS5 URURRSS5 g)z2 Custom flags and parameters have correct values. rrr"zTofu WITH A PONY!Nr>rs rtest_checkCustoms'ParseCorrectnessTests.test_checkCustomsKs? 17;  24GHr r6r5N) r(r)r*r+__doc__r8r@rDrGr.r'r rr0r0(s .?5Ir r0cR\rSrSrSSSS\/SSSS\/S SSS \/S SSS \//rS r\rSr g) TypedOptionsSfoointNzFoo intfoofloatQ@z Foo floateggintzEgg int without defaulteggfloatzEgg float without defaultcXlg)zO This option has an underscore in its name to exercise the _ to - translation. NunderscoreValuer#s ropt_under_scoreTypedOptions.opt_under_score[s %r rU) r(r)r*r+intfloatr,rWopt_ur.r'r rrLrLSsO 4i- T4e4 48#> T4! Test L{usage.Options.parseOptions} for wrong coerce options. cz[5nSR5nUR[URU5 g)z" Using a non-callable type fails. z--barwrong eggN)r|r4rw TypeErrorr7rusrfs rtest_nonCallable WrongTypedTests.test_nonCallables0 %%' )R__d;r c>[5n/nURU5 g)z@ The coerce functions are not called if no values are provided. N)rr7rs rtest_notCalledInDefault'WrongTypedTests.test_notCalledInDefaults" # r c:[5nSR5nUR[RUR U5nUR [U5S5 [5nSR5nUR[UR U5 g)z9 Errors raised by coerce functions are handled properly. z--foowrong blahz&Parameter type enforcement failed: Yayz--barwrong blahN) rr4rwrrxr7r?strr)rrrfes rtest_weirdCallable"WrongTypedTests.test_weirdCallablesy" # &&(   e.. F Q!IJ ! # &&( ,>r r'N) r(r)r*r+rJrrrr.r'r rrrs< ?r rc\rSrSrSrSrg) OutputTestsc[5nUR[RURS/5nUR [ U5S5 g)z6 Error output case adjustment does not mangle options z-Zzoption -Z not recognizedN)rrwrrxr7r?r)roptrs rtest_uppercasingOutputTests.test_uppercasingsBm   e..0@0@4& I Q!;? h/0 &67Gr cX[5nUR/SQ5 URUS5 URURS5 UR UR [5 URUR S5 URUR SS5 g)z1 Flags and options of a subcommand are assigned. )r--expect--torture-device=featherrrrrfeatherN rr7rr?rrcrrrrs r"test_subcommandWithFlagsAndOptions2SubCommandTests.test_subcommandWithFlagsAndOptions s   NO -./ }5 all,>?  X./ &67Cr cX[5nUR/SQ5 URUS5 URURS5 UR UR [5 URUR S5 URUR SS5 g)z7 Flags and options of a subcommand alias are assigned. )rrrrrrrrNrrs r'test_subcommandAliasWithFlagsAndOptions7SubCommandTests.test_subcommandAliasWithFlagsAndOptionss   JK -./ }5 all,>?  X./ &67Cr cV[5nURSS/5 URUS5 URURS5 UR UR [5 URUR S5 URUR S5 g)z7 Flags and options of another subcommand are assigned. rz --for-grailrrrN) rr7rr?rrcrrrrs r)test_anotherSubcommandWithFlagsAndOptions9SubCommandTests.test_anotherSubcommandWithFlagsAndOptions#s    ]34 -./ {3 all,<= k23  [12r c[5nURS/5 URUS5 URUR5 UR [ US55 g)zh If no subcommand is specified and no default subcommand is assigned, a subcommand will not be implied. rrrN)rr7rrdrrhasattrrs rtest_noSubcommand!SubCommandTests.test_noSubcommand/sU   ,-. ,-. !,,' L12r cd[5nSUlURS/5 URUS5 UR UR S5 UR UR[5 URURS5 UR URSS5 g) z; Flags and options in the default subcommand are assigned. rrrrrrrN) rdefaultSubCommandr7rr?rrcrrrrs rtest_defaultSubcommand&SubCommandTests.test_defaultSubcommand:s  ' ,-. ,-. }5 all,>? h/0 &67Gr c8^"SS[R5m"U4SjS[R5nU"5nURS/5 UR[ UR S55 UR UR RU5 g)z_ The parseOptions method from the Options object specified for the given subcommand is called. c\rSrSrSrSrg)DSubCommandTests.test_subCommandParseOptionsHasParent..SubOptiMcnURUl[RR"U/UQ70UD6 gr`)parent sawParentrOptionsr7)rakws rr7QSubCommandTests.test_subCommandParseOptionsHasParent..SubOpt.parseOptionsNs)!% **4:!:r:r )rN)r(r)r*r+r7r.r'r rSubOptrMs ;r rc&>\rSrSrSSYS4/rSrg)ASubCommandTests.test_subCommandParseOptionsHasParent..OptiRrnrrsr'Nr(r)r*r+rr.rsrOptrRsVU+Kr rrnrN)rrr7rrrr?r)rrrrs @r$test_subCommandParseOptionsHasParent4SubCommandTests.test_subCommandParseOptionsHasParentGsk  ;U]] ;  %--  E w  k:; //3r c8^"SS[R5m"U4SjS[R5n"U4SjS[R5nU"5nURS/5 U"5nURS/5 UR[ UR S 55 UR[ UR S 55 UR UR RU5 UR UR RU5 g ) zP The .parent pointer is correct even when the same Options class is used twice. c\rSrSrSrg):SubCommandTests.test_subCommandInTwoPlaces..SubOptibr'N)r(r)r*r+r.r'r rrrbs r rc&>\rSrSrSSYS4/rSrg):SubCommandTests.test_subCommandInTwoPlaces..OptFooiernrquuxr'NrrsrOptFooreVV,Kr rc&>\rSrSrSSYS4/rSrg):SubCommandTests.test_subCommandInTwoPlaces..OptBarijrsbrr'NrrsrOptBarrjrr rrnrsrN)rrr7rrrfailUnlessIdenticalr)rrroFoooBarrs @rtest_subCommandInTwoPlaces*SubCommandTests.test_subCommandInTwoPlaces\s  U]]  U]]   U]]  x 5'"x 5'" :; :;   !7!7>   !7!7>r r'N)r(r)r*r+rJrrrrrrrrr.r'r rrrs3 H D D 3 3 H4*?r rc*\rSrSrSrSrSrSrSrg)HelpStringTestsiyz Test generated help strings. cLSR5Ul[5Ulg)z+ Instantiate a well-behaved Options class. r3N)r4r5rr6rs rr8HelpStringTests.setUp~s! V %'  M r cURR5 g![anURU5 SnAgSnAff=f)z __str__ shouldn't go boom. N)r6__str__ Exceptionfail)rrs r test_noGoBoomHelpStringTests.test_noGoBooms4  II     IIaLL s A=Ac&[UR5R5Vs/sHoRS5S:dMUPM nnUR [ U5S:5 UR USRS5S:5 gs snf)z; Extra whitespace in flag and parameters docs is stripped. rr flagalliciousN)rr6 splitlinesfindrlen)rsliness r&test_whitespaceStripFlagsAndParameters6HelpStringTests.test_whitespaceStripFlagsAndParameterssp   N557P7q66'?a;O7P E Q' a o6!;<Qs BBrIN) r(r)r*r+rJr8r rr.r'r rrrys "=r rc$\rSrSrSrSrSrSrg)PortCoerceTestsiz+ Test the behavior of L{usage.portCoerce}. cURS[R"S55 URS[R"S55 URS[R"S55 g)z$ Test the answers with valid input. r0i 3210i65535N)r?r portCoercers rtest_validCoerce PortCoerceTests.test_validCoercesU E,,S12 u//78  0 0 9:r c,UR[[RS5 UR[[RS5 UR[[RS5 UR[[RS5 g)z Test error path. z-21212189rnN)rwrrrrs rtest_errorCoerce PortCoerceTests.test_errorCoercesd *e&6&6; *e&6&6> *e&6&6A *e&6&6>r r'N)r(r)r*r+rJrr!r.r'r rrrs;?r rcT\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rg)ZshCompleterTestsiz Test the behavior of the various L{twisted.usage.Completer} classes for producing output usable by zsh tab-completion system. c [R"5nURS[R5nUR US5 [R"SSS9nURS[R5nUR US5 g)zH Completer produces zsh shell-code that produces no completion matches. some-optionz :some-option: some actionTdescrrepeat*:some action:N)r Completer _shellCode_ZSHr?rcgots rtest_completer ZshCompleterTests.test_completersi OO ll=%**5 o. OO- =ll=%**5 ./r c[R"5nURS[R5nUR US5 [R"S5nURS[R5nUR US5 [R"SSSS9nURS[R5nUR US5 g ) zV 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/s r test_filesZshCompleterTests.test_filess    !ll=%**5 >?    'll=%**5 DE   mD Ill=%**5 EFr c [R"5nURS[R5nUR US5 [R"SSS9nURS[R5nUR US5 g)zF CompleteDirs produces zsh shell-code that completes directory names. r&z:some-option:_directoriesr'Tr(z*:some action:_directoriesN)r CompleteDirsr-r.r?r/s r test_dirsZshCompleterTests.test_dirssn    ll=%**5 9:   ]4 @ll=%**5 :;r c[R"S5nURS[R5nUR US5 [R"/SQ5nURS[R5nUR US5 [R"/SQSSS9nURS[R5nUR US 5 g ) z_ CompleteList produces zsh shell-code that completes words from a fixed list of possibilities. ABCr&z:some-option:(A B C)123z:some-option:(1 2 3)r'Tr(z*:some action:(1 2 3)N)r CompleteListr-r.r?r/s r test_listZshCompleterTests.test_lists   u %ll=%**5 45    /ll=%**5 45   mD Qll=%**5 56r c[R"S5nURS[R5nUR US5 [R"/SQ5nURS[R5nUR US5 [R"/SQSSS9nURS[R5nS nUR X#5 g ) 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)rCompleteMultiListr-r.r?)rr0r1expecteds rtest_multiList ZshCompleterTests.test_multiLists  # #E *ll=%**5 MN  # #O 4ll=%**5 MN  # #O=QU Vll=%**5C 'r c [R"5nURS[R5nUR US5 [R"SSS9nURS[R5nUR US5 g)zL CompleteUsernames produces zsh shell-code that completes system usernames. r&z:some-option:_usersr'Tr(z*:some action:_usersN)rCompleteUsernamesr-r.r?rr0outs rtest_usernames ZshCompleterTests.test_usernamessn  # # %ll=%**5 34  # #- Ell=%**5 45r c [R"5nURS[R5nUR US5 [R"SSS9nURS[R5nUR US5 g)zK CompleteGroups produces zsh shell-code that completes system group names. r&z:group:_groupsr'Tr(z*:some action:_groupsN)rCompleteGroupsr-r.r?rLs r test_groupsZshCompleterTests.test_groupssn  "ll=%**5 ./  }T Bll=%**5 56r c [R"5nURS[R5nUR US5 [R"SSS9nURS[R5nUR US5 g)zE CompleteHostnames produces zsh shell-code that completes hostnames. r&z:some-option:_hostsr'Tr(z*:some action:_hostsN)rCompleteHostnamesr-r.r?rLs rtest_hostnames ZshCompleterTests.test_hostnames sn  # # %ll=%**5 34  # #- Ell=%**5 45r cX[R"5nURS[R5nUR UR S55 [R"SSS9nURS[R5nUR UR S55 g)zr CompleteUserAtHost produces zsh shell-code that completes hostnames or a word of the form @. r&z:host | user@host:r'Tr(r+N)rCompleteUserAtHostr-r.r startswithrLs rtest_userAtHost!ZshCompleterTests.test_userAtHost,sx  $ $ &ll=%**5 ';<=  $ $= Fll=%**5 '789r c [R"5nURS[R5nUR US5 [R"SSS9nURS[R5nUR US5 g)z^ CompleteNetInterfaces produces zsh shell-code that completes system network interface names. r&z:some-option:_net_interfacesr'Tr(z*:some action:_net_interfacesN)rCompleteNetInterfacesr-r.r?rLs rtest_netInterfaces$ZshCompleterTests.test_netInterfaces9sn  ' ' )ll=%**5 <=  ' 'mD Ill=%**5 =>r r'N)r(r)r*r+rJr2r6r:rCrHrNrRrVr[r_r.r'r rr$r$s: 0G" <7"($ 6 7 6 : ?r r$c\rSrSrSrSrSrg)CompleterNotImplementedTestsiGzg Using an unknown shell constant with the various Completer() classes should raise NotImplementedError c [R[R[R[R[R [R [R[R[R[R/ nUH-nU"5nUR[URSS5 M/ g![a U"S5nN;f=f)z= Using an unknown shellType should raise NotImplementedError Nbad_shell_type)rr,r5r9rBrFrKrQrUrYr^ BaseExceptionrwNotImplementedErrorr-)rclassesclsactions rtest_unknownShell.CompleterNotImplementedTests.test_unknownShellMs OO           # #  # #   # #  $ $  ' '  C #   #V%6%6>N  ! #T #sC  C"!C"r'N)r(r)r*r+rJrjr.r'r rrbrbGs  r rbcD\rSrSrSr"SS5rSrSrSrSr S r g ) FlagFunctionTestsihz" Tests for L{usage.flagFunction}. c*\rSrSrSrSrSrSrSrg)FlagFunctionTests.SomeClassimz. Dummy class for L{usage.flagFunction} tests. cg)z A one argument method to be tested by L{usage.flagFunction}. @param a: a useless argument to satisfy the function's signature. Nr')rrs roneArg"FlagFunctionTests.SomeClass.oneArgrr cg)z= A no argument method to be tested by L{usage.flagFunction}. Nr'rs rnoArg!FlagFunctionTests.SomeClass.noArgyrsr cg)a  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')rrrr0s rmanyArgs$FlagFunctionTests.SomeClass.manyArgs~rsr r'N) r(r)r*r+rJrqrurxr.r'r r SomeClassroms     r rzcURS[R"UR5R55 g)z[ L{usage.flagFunction} returns C{False} if the method checked allows exactly one argument. FN)assertIsr flagFunctionrzrqrs r test_hasArgFlagFunctionTests.test_hasArgs* eU//0@0G0GHIr cURS[R"UR5R55 g)zY L{usage.flagFunction} returns C{True} if the method checked allows exactly no argument. TN)r|rr}rzrurs r test_noArgFlagFunctionTests.test_noArgs* dE..t~~/?/E/EFGr cUR[R[RUR 5R 5nUR S[U55 g)zg L{usage.flagFunction} raises L{usage.UsageError} if the method checked allows more than one argument. z$Invalid Option function for manyArgsNrwrrxr}rzrxr?rrexcs rtest_tooManyArguments'FlagFunctionTests.test_tooManyArgumentssK    e00$..2B2K2K  ?SJr cUR[R[RUR 5R S5nUR S[U55 g)zy 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 flubudufNrrs r,test_tooManyArgumentsAndSpecificErrorMessage>FlagFunctionTests.test_tooManyArgumentsAndSpecificErrorMessagesM    e00$..2B2K2KZ  ?SJr r'N) r(r)r*r+rJrzr~rrrr.r'r rrmrmhs)4JHKKr rmc\rSrSrSrSrSrg)OptionsInternalTestsiz. Tests internal behavior of C{usage.Options}. c"SS[R5nU"5nUR[R /SQS5UR SUR SUR SS.5 g)z[ Options which are synonyms to another option are aliases towards the longest option name. c"\rSrSrSr\r\rSrg);OptionsInternalTests.test_optionsAliasesOrder..Optsicg)zN This is an option method with a very long name, that is going to be aliased. Nr'rs ropt_very_very_longNOptionsInternalTests.test_optionsAliasesOrder..Opts.opt_very_very_longrsr r'N)r(r)r*r+r opt_shortopt_sr.r'r rOptsrs  +I&Er r)rshortvery-very-longrrrN)rrr?dictfromkeyssynonyms)rrrs rtest_optionsAliasesOrder-OptionsInternalTests.test_optionsAliasesOrdersc  '5== 'v  MM:rs\ !"7%--76(IH--(IV5==$8K""8KvN N 5== "?h''"?J=(##=u}} |?h''|?~!=h''!=H?h''?.P?))P?f8#4#4B?K))?KD 8,, r