+ Dfj[Rt^RIHt^RIHt!RR]P 4t!RR]P4t!RR]P 4t !R R ]P4t !R R ]P 4t !R R]P 4t !RR]P4t !RR]P4t!RR]P 4t!RR]P 4t!RR]P 4t!RR]P4t!RR]P4t!RR]P4t!RR ]P4t!R!R"]P4t!R#R$]P4t!R%R&]P4tR'#)(zK Tests for L{twisted.python.usage}, a command line option parsing library. usage)unittestcXa]tRt^ to.RO.RO.R O.R O.t.R ORR..tRtRtRtVt R#) WellBehavedNfloutoc$RVPR&R#)PONY!myflagNoptsselfs&9/usr/lib/python3/dist-packages/twisted/test/test_usage.py opt_myflagWellBehaved.opt_myflag!s% (c*V R2VPR&R#)z WITH A PONY!myparamNr rvalues&&r opt_myparamWellBehaved.opt_myparam$s"' 6 )r)longwdefaultzand a docstring)anothernz no docstring)longonlyNnoshort) shortlessNexceptzthis one got docstring)aflagfzO flagallicious docstringness for this here ) __name__ __module__ __qualname____firstlineno__ optParametersoptFlagsrr__static_attributes____classdictcell__ __classdict__s@rrr s<3(%? M  # H&77rrc<a]tRt^(toRtRtRtRtRtRt Vt R#)ParseCorrectnessTestszN Test L{usage.Options.parseOptions} for correct values under good conditions. c RP4Vn\4VnVPP VP4R#)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}}-rc nVPVPPR,R4VPVPPR,R4VPVPPR,R4VPVPPR,R4R #) z! Parameters have correct values. rAlpharBetar r!r"GammaN assertEqualr6r rs&rtest_checkParameters*ParseCorrectnessTests.test_checkParameters;sx /9  2F;  3Y?  4g>rc VPVPPR,^4VPVPPR,^4R#)z Flags have correct values. r$rNr>rs&rtest_checkFlags%ParseCorrectnessTests.test_checkFlagsDs> 0!4 0!4rc VPVPPR,R4VPVPPR,R4R#)z2 Custom flags and parameters have correct values. r r rzTofu WITH A PONY!Nr>rs&rtest_checkCustoms'ParseCorrectnessTests.test_checkCustomsKs? 17;  24GHrr6r5N) r&r'r(r)__doc__r8r@rCrFr,r-r.s@rr1r1(s% .?5IIrr1c^a]tRt^StoRRRR].RRRR].RRRR ].R RRR ]..tR t]tR t Vt R#) TypedOptionsfoointNzFoo intfoofloatQ@z Foo floateggintzEgg int without defaulteggfloatzEgg float without defaultc WnR#)zO This option has an underscore in its name to exercise the _ to - translation. NunderscoreValuers&&ropt_under_scoreTypedOptions.opt_under_score[s %rrS) r&r'r(r)intfloatr*rUopt_ur,r-r.s@rrKrKSsR 4i- T4e4 48#> T4! Test L{usage.Options.parseOptions} for wrong coerce options. c |\4pRP4pVP\VPV4R#)z" Using a non-callable type fails. z--barwrong eggN)rxr4rs TypeErrorr7rusrcs& rtest_nonCallable WrongTypedTests.test_nonCallables0 %%' )R__d;rc @\4p.pVPV4R#)z@ The coerce functions are not called if no values are provided. N)r|r7rs& rtest_notCalledInDefault'WrongTypedTests.test_notCalledInDefaults" # rc <\4pRP4pVP\PVP V4pVP \V4R4\4pRP4pVP\VP V4R#)z9 Errors raised by coerce functions are handled properly. z--foowrong blahz&Parameter type enforcement failed: Yayz--barwrong blahN) r|r4rsrrtr7r?strr)rrrces& rtest_weirdCallable"WrongTypedTests.test_weirdCallablesy" # &&(   e.. F Q!IJ ! # &&( ,>rrN) r&r'r(r)rIrrrr,r-r.s@rrrs< ? ?rrc&a]tRt^toRtRtVtR#) OutputTestsc \4pVP\PVPR.4pVP \ V4R4R#)z6 Error output case adjustment does not mangle options z-Zzoption -Z not recognizedN)rrsrrtr7r?r)roptrs& rtest_uppercasingOutputTests.test_uppercasingsBm   e..0@0@4& I Q!;? h/0 &67Grc r\4pVP.RO4VPVR,4VPVPR4VP VP \4VPVP R,4VPVP R,R4R#)z1 Flags and options of a subcommand are assigned. rrrrfeatherN)r--expect--torture-device=feather rr7rr?rr`rrrrs& r"test_subcommandWithFlagsAndOptions2SubCommandTests.test_subcommandWithFlagsAndOptions s   NO -./ }5 all,>?  X./ &67Crc r\4pVP.RO4VPVR,4VPVPR4VP VP \4VPVP R,4VPVP R,R4R#)z7 Flags and options of a subcommand alias are assigned. rrrrrN)rrrrrs& r'test_subcommandAliasWithFlagsAndOptions7SubCommandTests.test_subcommandAliasWithFlagsAndOptionss   JK -./ }5 all,>?  X./ &67Crc p\4pVPRR.4VPVR,4VPVPR4VP VP \4VPVP R,4VPVP R,4R#)z7 Flags and options of another subcommand are assigned. rz --for-grailrrrN) rr7rr?rr`rrrrs& r)test_anotherSubcommandWithFlagsAndOptions9SubCommandTests.test_anotherSubcommandWithFlagsAndOptions#s    ]34 -./ {3 all,<= k23  [12rc \4pVPR.4VPVR,4VPVP4VP \ VR44R#)zh If no subcommand is specified and no default subcommand is assigned, a subcommand will not be implied. rrrN)rr7rrarrhasattrrs& rtest_noSubcommand!SubCommandTests.test_noSubcommand/sU   ,-. ,-. !,,' L12rc ~\4pRVnVPR.4VPVR,4VP VP R4VP VP\4VPVPR,4VP VPR,R4R#) z; Flags and options in the default subcommand are assigned. rrrrrrrN) rdefaultSubCommandr7rr?rr`rrrrs& rtest_defaultSubcommand&SubCommandTests.test_defaultSubcommand:s  ' ,-. ,-. }5 all,>? h/0 &67Grc :a!RR\P4o!V3RlR\P4pV!4pVPR.4VP\ VP R44VP VP PV4R#)z_ The parseOptions method from the Options object specified for the given subcommand is called. c&a]tRtRtoRtRtVtR#)DSubCommandTests.test_subCommandParseOptionsHasParent..SubOptiMcpVPVn\PP!V.VO5/VBR#r])parent sawParentrOptionsr7)rakws&*,rr7QSubCommandTests.test_subCommandParseOptionsHasParent..SubOpt.parseOptionsNs)!% **4:!:r:r)rN)r&r'r(r)r7r,r-r.s@rSubOptrMs ; ;rrc(<]tRtRtRRZR3.tRtR#)ASubCommandTests.test_subCommandParseOptionsHasParent..OptiRrjr%rorNr&r'r(r)rr,rsrOptrRsVU+KrrrjrN)rrr7rrrr?r)rrrrs& @r$test_subCommandParseOptionsHasParent4SubCommandTests.test_subCommandParseOptionsHasParentGsk  ;U]] ;  %--  E w  k:; //3rc :a!RR\P4o!V3RlR\P4p!V3RlR\P4pV!4pVPR.4V!4pVPR.4VP\ VP R 44VP\ VP R 44VP VP PV4VP VP PV4R #) zP The .parent pointer is correct even when the same Options class is used twice. c]tRtRtRtR#):SubCommandTests.test_subCommandInTwoPlaces..SubOptibrN)r&r'r(r)r,rrrrrbs rrc(<]tRtRtRRZR3.tRtR#):SubCommandTests.test_subCommandInTwoPlaces..OptFooierjr%quuxrNrrsrOptFooreVV,Krrc(<]tRtRtRRZR3.tRtR#):SubCommandTests.test_subCommandInTwoPlaces..OptBarijrobrrNrrsrOptBarrjrrrrjrorN)rrr7rrrfailUnlessIdenticalr)rrroFoooBarrs& @rtest_subCommandInTwoPlaces*SubCommandTests.test_subCommandInTwoPlaces\s  U]]  U]]   U]]  x 5'"x 5'" :; :;   !7!7>   !7!7>rrN)r&r'r(r)rIrrrrrrrrr,r-r.s@rrrs; H D D 3 3 H4*??rrc6a]tRtRtoRtRtRtRtRtVt R#)HelpStringTestsiyz Test generated help strings. c NRP4Vn\4VnR#)z+ Instantiate a well-behaved Options class. r3N)r4r5rr6rs&rr8HelpStringTests.setUp~s! V %'  M rc VPP4R# \dpTPT4Rp?R#Rp?ii;i)z __str__ shouldn't go boom. N)r6__str__ Exceptionfail)rrs& r test_noGoBoomHelpStringTests.test_noGoBooms4  II     IIaLL s AAAc 0\VP4P4Uu.uFqPR4^8gKVNK ppVP \ V4^84VP V^,PR4^84R#uupi)z; Extra whitespace in flag and parameters docs is stripped. r$ flagalliciousN)rr6 splitlinesfindrlen)rsliness& r&test_whitespaceStripFlagsAndParameters6HelpStringTests.test_whitespaceStripFlagsAndParameterssr   N557P7q66'?a;O7P E Q' a o6!;<Qs BBrHN) r&r'r(r)rIr8rrr,r-r.s@rrrys "==rrc0a]tRtRtoRtRtRtRtVtR#)PortCoerceTestsiz+ Test the behavior of L{usage.portCoerce}. c VP^\P!R44VPR\P!R44VPR\P!R44R#)z$ Test the answers with valid input. 0i 3210i65535N)r?r portCoercers&rtest_validCoerce PortCoerceTests.test_validCoercesU E,,S12 u//78  0 0 9:rc .VP\\PR4VP\\PR4VP\\PR4VP\\PR4R#)z Test error path. z-21212189rjN)rsrrrrs&rtest_errorCoerce PortCoerceTests.test_errorCoercesd *e&6&6; *e&6&6> *e&6&6A *e&6&6>rrN) r&r'r(r)rIrrr,r-r.s@rr r s;??rr c`a]tRtRtoRtRtRtRtRtRt Rt R t R t R t R tR tVtR#)ZshCompleterTestsiz Test the behavior of the various L{twisted.usage.Completer} classes for producing output usable by zsh tab-completion system. c (\P!4pVPR\P4pVP VR4\P!RRR7pVPR\P4pVP VR4R#)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 ./rc \P!4pVPR\P4pVP VR4\P!R4pVPR\P4pVP VR4\P!RRRR7pVPR\P4pVP VR4R #) zV CompleteFiles produces zsh shell-code that completes file names according to a glob. rz:some-option (*):_files -g "*"z*.pyz$:some-option (*.py):_files -g "*.py"rTrz%*: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 EFrc (\P!4pVPR\P4pVP VR4\P!RRR7pVPR\P4pVP VR4R#)zF CompleteDirs produces zsh shell-code that completes directory names. rz:some-option:_directoriesrTrz*:some action:_directoriesN)r CompleteDirsr!r"r?r#s& r test_dirsZshCompleterTests.test_dirssn    ll=%**5 9:   ]4 @ll=%**5 :;rc \P!R4pVPR\P4pVP VR4\P!.R O4pVPR\P4pVP VR4\P!.R ORRR7pVPR\P4pVP VR4R #) z_ CompleteList produces zsh shell-code that completes words from a fixed list of possibilities. ABCrz:some-option:(A B C)z:some-option:(1 2 3)rTrz*:some action:(1 2 3)N123)r CompleteListr!r"r?r#s& r test_listZshCompleterTests.test_lists   u %ll=%**5 45    /ll=%**5 45   mD Qll=%**5 56rc \P!R4pVPR\P4pVP VR4\P!.R O4pVPR\P4pVP VR4\P!.R ORRR7pVPR\P4pRpVP W#4R #) z} CompleteMultiList produces zsh shell-code that completes multiple comma-separated words from a fixed list of possibilities. r1rz-:some-option:_values -s , 'some-option' A B Cz-:some-option:_values -s , 'some-option' 1 2 3rTrz.*:some action:_values -s , 'some action' 1 2 3Nr2)rCompleteMultiListr!r"r?)rr$r%expecteds& rtest_multiList ZshCompleterTests.test_multiLists  # #E *ll=%**5 MN  # #O 4ll=%**5 MN  # #O=QU Vll=%**5C 'rc (\P!4pVPR\P4pVP VR4\P!RRR7pVPR\P4pVP VR4R#)zL CompleteUsernames produces zsh shell-code that completes system usernames. rz:some-option:_usersrTrz*:some action:_usersN)rCompleteUsernamesr!r"r?rr$outs& rtest_usernames ZshCompleterTests.test_usernamessn  # # %ll=%**5 34  # #- Ell=%**5 45rc (\P!4pVPR\P4pVP VR4\P!RRR7pVPR\P4pVP VR4R#)zK CompleteGroups produces zsh shell-code that completes system group names. rz:group:_groupsrTrz*:some action:_groupsN)rCompleteGroupsr!r"r?r@s& r test_groupsZshCompleterTests.test_groupssn  "ll=%**5 ./  }T Bll=%**5 56rc (\P!4pVPR\P4pVP VR4\P!RRR7pVPR\P4pVP VR4R#)zE CompleteHostnames produces zsh shell-code that completes hostnames. rz:some-option:_hostsrTrz*:some action:_hostsN)rCompleteHostnamesr!r"r?r@s& rtest_hostnames ZshCompleterTests.test_hostnames sn  # # %ll=%**5 34  # #- Ell=%**5 45rc `\P!4pVPR\P4pVP VP R44\P!RRR7pVPR\P4pVP VP R44R#)zr CompleteUserAtHost produces zsh shell-code that completes hostnames or a word of the form @. rz:host | user@host:rTrrN)rCompleteUserAtHostr!r"r startswithr@s& rtest_userAtHost!ZshCompleterTests.test_userAtHost,sx  $ $ &ll=%**5 ';<=  $ $= Fll=%**5 '789rc (\P!4pVPR\P4pVP VR4\P!RRR7pVPR\P4pVP VR4R#)z^ CompleteNetInterfaces produces zsh shell-code that completes system network interface names. rz:some-option:_net_interfacesrTrz*:some action:_net_interfacesN)rCompleteNetInterfacesr!r"r?r@s& rtest_netInterfaces$ZshCompleterTests.test_netInterfaces9sn  ' ' )ll=%**5 <=  ' 'mD Ill=%**5 =>rrN)r&r'r(r)rIr&r*r.r7r<rBrFrJrOrSr,r-r.s@rrrsB 0G" <7"($ 6 7 6 : ? ?rrc*a]tRtRtoRtRtRtVtR#)CompleterNotImplementedTestsiGzg Using an unknown shell constant with the various Completer() classes should raise NotImplementedError c  \P\P\P\P\P \P \P\P\P\P. pVF-pV!4pVP\VPRR4K/ R# \d T!R4pL=i;i)z= Using an unknown shellType should raise NotImplementedError Nbad_shell_type)rr r)r-r6r:r?rErIrMrR BaseExceptionrsNotImplementedErrorr!)rclassesclsactions& rtest_unknownShell.CompleterNotImplementedTests.test_unknownShellMs OO           # #  # #   # #  $ $  ' '  C #   #V%6%6>N  ! #T #sCC$#C$rN)r&r'r(r)rIr^r,r-r.s@rrVrVGs rrVcPa]tRtRtoRt!RR4tRtRtRtRt R t Vt R #) FlagFunctionTestsihz" Tests for L{usage.flagFunction}. c6a]tRtRtoRtRtRtRtRtVt R#)FlagFunctionTests.SomeClassimz. Dummy class for L{usage.flagFunction} tests. c R#)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.oneArgrrc R#)z= A no argument method to be tested by L{usage.flagFunction}. Nrrs&rnoArg!FlagFunctionTests.SomeClass.noArgyrgrc R#)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)rrrr$s&&&&rmanyArgs$FlagFunctionTests.SomeClass.manyArgs~rgrrN) r&r'r(r)rIrerirlr,r-r.s@r SomeClassrcms      rrnc VPR\P!VP4P44R#)z[ L{usage.flagFunction} returns C{False} if the method checked allows exactly one argument. FN)assertIsr flagFunctionrnrers&r test_hasArgFlagFunctionTests.test_hasArgs* eU//0@0G0GHIrc VPR\P!VP4P44R#)zY L{usage.flagFunction} returns C{True} if the method checked allows exactly no argument. TN)rprrqrnrirs&r test_noArgFlagFunctionTests.test_noArgs* dE..t~~/?/E/EFGrc VP\P\PVP 4P 4pVP R\V44R#)zg L{usage.flagFunction} raises L{usage.UsageError} if the method checked allows more than one argument. z$Invalid Option function for manyArgsNrsrrtrqrnrlr?rrexcs& rtest_tooManyArguments'FlagFunctionTests.test_tooManyArgumentssK    e00$..2B2K2K  ?SJrc VP\P\PVP 4P R4pVP R\V44R#)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 flubudufNrxrys& r,test_tooManyArgumentsAndSpecificErrorMessage>FlagFunctionTests.test_tooManyArgumentsAndSpecificErrorMessagesM    e00$..2B2K2KZ  ?SJrrN) r&r'r(r)rIrnrrrur{rr,r-r.s@rrarahs24JHKKKrrac*a]tRtRtoRtRtRtVtR#)OptionsInternalTestsiz. Tests internal behavior of C{usage.Options}. c  !RR\P4pV!4pVP\P .ROR4RVP R,RVP R,RVP R,/4R#)z[ Options which are synonyms to another option are aliases towards the longest option name. c.a]tRtRtoRt]t]tRtVtR#);OptionsInternalTests.test_optionsAliasesOrder..Optsic R#)zN This is an option method with a very long name, that is going to be aliased. Nrrs&ropt_very_very_longNOptionsInternalTests.test_optionsAliasesOrder..Opts.opt_very_very_longrgrrN) r&r'r(r)r opt_shortopt_sr,r-r.s@rOptsrs  +I&Errrshortvery-very-longN)rrr)rrr?dictfromkeyssynonyms)rrr s& rtest_optionsAliasesOrder-OptionsInternalTests.test_optionsAliasesOrdersi  '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