ó !Ž}Mc@sÌdZddlZddlZddlZddlmZddlmZmZmZde fd„ƒYZ e Z de fd„ƒYZ d efd „ƒYZd d „Zed „Zd„Zde_dS(s twisted.python.usage is a module for parsing/handling the command line of your program. For information on how to use it, see U{http://twistedmatrix.com/projects/core/documentation/howto/options.html}, or doc/core/howto/options.xhtml in your Twisted directory. iÿÿÿÿN(tpath(treflectttexttutilt UsageErrorcBseZRS((t__name__t __module__(((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRstCoerceParametercBs eZdZd„Zd„ZRS(sE Utility class that can corce a parameter before storing it. cCs.||_||_t|jddƒ|_dS(sq @param options: parent Options object @param coerce: callable used to coerce the value. t coerceDoctN(toptionstcoercetgetattrtdoc(tselfR R ((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyt__init__$s  cCsr|dkr"td|fƒ‚ny|j|ƒ}Wn&tk r]}td|fƒ‚nX||jj| holyquest --horseback --for-grail"} will cause C{HolyQuestOptions} to be instantiated and asked to parse C{['--horseback', '--for-grail']}. Currently, only the first sub-command is parsed, and all options following it are passed to its parser. If a subcommand is found, the subCommand attribute is set to its name and the subOptions attribute is set to the Option instance that parses the remaining options. If a subcommand is not given to parseOptions, the subCommand attribute will be None. You can also mark one of the subCommands to be the default. | defaultSubCommand = 'holyquest' In this case, the subCommand attribute will never be None, and the subOptions attribute will always be set. If you want to handle your own options, define a method named C{opt_paramname} that takes C{(self, option)} as arguments. C{option} will be whatever immediately follows the parameter on the command line. Options fully supports the mapping interface, so you can do things like C{'self["option"] = val'} in these methods. Advanced functionality is covered in the howto documentation, available at U{http://twistedmatrix.com/projects/core/documentation/howto/options.html}, or doc/core/howto/options.xhtml in your Twisted directory. c Cs tt|ƒjƒ||_i|_g|_d|_i|_i|_i|_ |j |j |j g}x™|D]‘}|ƒ\}}}}}}|jj |ƒ|j||_|jj|ƒ|jj|ƒ|jj|ƒ|jj|ƒ|j j|ƒqqWdS(NR (tsuperRRRtdefaultstlongOpttshortOpttdocstsynonymst _dispatcht _gather_flagst_gather_parameterst_gather_handlerstextendtupdate( Rt collectorstcRRRtsettingsRR((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRˆs(         cCstt|ƒtjƒS(sÜ Define a custom hash function so that Options instances can be used as dictionary keys. This is an internal feature used to implement the parser. Do not rely on it in application code. (tinttidtsystmaxint(R((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyt__hash__¨scCs|jƒGHtjdƒdS(s- Display this help and exit. iN(t__str__R*texit(R((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pytopt_help°s cCs-ddlm}dG|jGHtjdƒdS(Niÿÿÿÿ(t copyrightsTwisted version:i(ttwistedR0tversionR*R.(RR0((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyt opt_version·s cCsZ|d krtjd}ny%tj||j|jƒ\}}Wn(tjk rk}tt|ƒƒ‚nXxÛ|D]Ó\}}|ddkrœ|d}n |d}|}||j krõ|j ddƒ}||j krõtd|fƒ‚qõn|j |}t |j |t ƒr2|j |j||ƒqs|j |||ƒqsWt|dd ƒr|sq|jd k r|s†|jg}n|d|d}} x®|jD]_\} } } } || ksÏ|| kr¥| |_| ƒ|_||j_|jj| ƒPq¥q¥Wtd|ƒ‚n1y|j|ŒWntk rKtd ƒ‚nX|jƒd S( s6 The guts of the command-line parser. it-it_sNo such option '%s't subCommandsisUnknown command: %ssWrong number of arguments.N(RR*targvtgetoptRRterrorRtstrRtreplacet isinstanceRRRR tdefaultSubCommandR6t subCommandt subOptionstparentt parseOptionst parseArgst TypeErrort postOptions(RR RtargsRtopttargt optMangledtsubtresttcmdtshorttparserR ((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRA¾sL         cCsdS(sä I am called after the options are parsed. Override this method in your subclass to do something after the options have been parsed and assigned, like validate that all options are sane. N((R((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRDóscCsdS(s I am called with any leftover arguments which were not options. Override me to do something with the remaining arguments on the command line, those which were not flags or options. e.g. interpret them as a list of files to operate on. Note that if there more arguments on the command line than this method accepts, parseArgs will blow up with a getopt.error. This means if you don't override me, parseArgs will blow up if I am passed any arguments at all! N((R((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRBüscCs6|dkr%td||fƒ‚nd|j|~scSs|ƒS(N((RdRRe((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRf‚siR[R\cSstt|ƒt|ƒƒS(N(tcmptlen(tatb((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyRf—siN(RtaddMethodNamesToDictRRtkeysR t flagFunctionR;RRtgetRhRTtitemstsorttpop(RRRRR'RRtdctRdtmethodttakesArgt prettyNameR tfnt reverse_dctt cmpLengthtnamestnames_tlongest((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyR"VsP        !    cCs|jƒd|jddƒS(Ns twidth(t getSynopsistgetUsageR(R((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyR-¥scCsädtjtjdƒ|jr%dp(df}|jd krpdtjtjdƒ|jrcdpfdf}nd|jr‚dp…d}t|d|ƒ}|jƒ}|jd k ràd j |jj ƒ|jj |fƒ}n|S( s Returns a string containing a description of these options and how to pass them to the executed file. s%s%sis [options]R s Usage: %s%ss%ss [options]tsynopsist N( RtbasenameR*R7RR@RR trstriptjoinR}R>(RRaR((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyR}¨s cCs¬t|dƒr"|jjd|ƒS|sFttjjddƒƒ}nt|dƒrÐg}xM|jD]B\}}}}|ji|d6|d6|d6d d 6dd 6ƒqeWt ||ƒ}d d j |ƒ}nd }i} xg|j j ƒD]V\} } | } | | kr)t| ƒdkr)| | | R=R@RR,R/R3RARDRBROR R!R"R-R}R~(((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyR=s$F    5    ) O  iPc Csud}xc|D][}t|jddƒƒ}|r |jddƒdkrV|d}nt||ƒ}q q W|tdƒ}||}d|}g}i} xÒ|D]Ê}|jd dƒ| ks£|jddƒ| krßq£nxE|jd dƒ|jddƒfD]} | dk rd| | t|ƒ}|dks$|dkr:td|fƒ‚n|S(sO Coerce a string value to an int port number, and checks the validity. iiÿÿsPort number not in range: %s(R(R(R((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyt portCoercevs s#Must be an int between 0 and 65535.(RRŠR*R8Rttwisted.pythonRRRt ExceptionRR9tobjectRtdictRRŒRRmR¯R(((s8/usr/lib/python2.7/dist-packages/twisted/python/usage.pyt s   ÿÒ ]