xTc@ srdZddlmZddlZddlZddlZddlmZmZm Z ddl m Z ddl m ZmZmZmZmZddd d d d gZd dZd dZyeefWn#ek rddf\ZZnXdZd fdYZd fdYZd efdYZd efdYZdZdZdfdYZ dS(sCoptik.option_parser Provides the OptionParser and Values classes. i(tdivisionN(tOptiont NO_DEFAULTt_repr(tIndentedHelpFormatter(tgettexttOptionConflictErrortBadOptionErrortOptionValueErrortAmbiguousOptionErrort SUPPRESS_HELPtSUPPRESS_USAGEtValuestOptionContainert OptionGroupt OptionParsertSUPPRESStHELPtUSAGEiicC s"t|tjp!t|tjS(N(t isinstancettypest StringTypet UnicodeType(tx((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt isbasestringscB sheZd dZdZeZdZdZdZ dZ ddZ ddZ d Z RS( cC s:|r6x-|jD]\}}t|||qWndS(N(titemstsetattr(tselftdefaultstattrtval((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt__init__$scC s t|jS(N(tstrt__dict__(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt__str__)scC sLt|tr"t|j|jSt|tjrDt|j|SdSdS(Ni(RR tcmpR!RtDictType(Rtother((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt__cmp__.s cC sVxOt|D]A}|j|r ||}|dk rNt|||qNq q WdS(s Update the option values from an arbitrary dictionary, but only use keys from dict that already have a corresponding attribute in self. Any keys in dict without a corresponding attribute are silently ignored. N(tdirthas_keytNoneR(RtdictRtdval((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_update_careful6s   cC s|jj|dS(s Update the option values from an arbitrary dictionary, using all keys from the dictionary regardless of whether they have a corresponding attribute in self or not. N(R!tupdate(RR*((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt _update_looseCscC sI|dkr|j|n)|dkr8|j|n td|dS(Ntcarefultloosesinvalid update mode: %r(R,R.t ValueError(RR*tmode((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_updateKs   R/cC s1t|tj|}|jt||dS(N(t __import__tsystmodulesR3tvars(RtmodnameR2tmod((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt read_moduleSs  cC s'i}t|||j||dS(N(texecfileR3(RtfilenameR2R7((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt read_fileXs cC sEt|| s%t||dkr8t|||nt||S(N(thasattrtgetattrR)R(RRtvalue((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt ensure_value]s%N(t__name__t __module__R)RR"Rt__repr__R&R,R.R3R:R=RA(((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyR "s       cB seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZRS(s Abstract base class. Class attributes: standard_option_list : [Option] list of standard options that will be accepted by all instances of this parser class (intended to be overridden by subclasses). Instance attributes: option_list : [Option] the list of Option objects contained by this OptionContainer _short_opt : { string : Option } dictionary mapping short option strings, eg. "-f" or "-X", to the Option instances that implement them. If an Option has multiple short option strings, it will appears in this dictionary multiple times. [1] _long_opt : { string : Option } dictionary mapping long option strings, eg. "--file" or "--exclude", to the Option instances that implement them. Again, a given Option can occur multiple times in this dictionary. [1] defaults : { string : any } dictionary mapping option destination names to default values for each destination [1] [1] These mappings are common to (shared by) all components of the controlling OptionParser, where they are initially created. cC s1|j||_|j||j|dS(N(t_create_option_listt option_classtset_conflict_handlertset_description(RRFtconflict_handlert description((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRs   cC s"i|_t|_i|_dS(N(t _short_optt_long_opt_dictt _long_optR(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_create_option_mappingss  cC s(|j|_|j|_|j|_dS(N(RKRMR(Rtparser((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_share_option_mappingss  cC s)|dkrtd|n||_dS(Nterrortresolves$invalid conflict_resolution value %r(serrorRR(R1RI(Rthandler((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRGs cC s ||_dS(N(RJ(RRJ((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRHscC s|jS(N(RJ(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pytget_descriptionscC s|`|`|`dS(ssee OptionParser.destroy().N(RKRMR(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pytdestroyscC sxg}x@|jD]5}|jj|r|j||j|fqqWx@|jD]5}|jj|rS|j||j|fqSqSW|rt|j}|dkrtddjg|D]}|d^q|qt|dkrtx|D]z\}}|j dr(|jj ||j|=n|jj ||j|=|jpQ|js|j j j |qqWqtndS(NRQs conflicting option string(s): %ss, iRRs--( t _short_optsRKR(tappendt _long_optsRMRIRtjoint startswithtremovet containert option_list(Rtoptiont conflict_optstoptRStcotc_option((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_check_conflicts.!!  $    cO sGt|dtjkr.|j||}nNt|dkrs| rs|d}t|ts|td|q|n td|j||j j |||_ x|j D]}||j | (values : Values, args : [string]) Parse the command-line options found in 'args' (default: sys.argv[1:]). Any errors result in a call to 'error()', which by default prints the usage message to stderr and calls sys.exit() with an error message. On success returns a pair (values, args) where 'values' is an Values instance (with all your option values) and 'args' is the list of arguments left over after parsing options. N( RR)RRRRt _process_argsRRRQR t check_values(RRiRRRtstopterr((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt parse_args's     cC s ||fS(s check_values(values : Values, args : [string]) -> (values : Values, args : [string]) Check that the supplied option values and leftover arguments are valid. Returns the option values and leftover arguments (possibly adjusted, possibly completely new -- whatever you like). Default implementation just returns the passed-in values; subclasses may override as desired. ((RRRi((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRNs cC sx|r|d}|dkr*|d=dS|dd!dkrP|j||q|d dkrt|dkr|j||q|jr|j||d=qdSqWdS(s_process_args(largs : [string], rargs : [string], values : Values) Process command-line arguments and populate 'values', consuming options and arguments from 'rargs'. If 'allow_interspersed_args' is false, stop at the first non-option argument. If true, accumulate any interspersed non-option arguments in 'largs'. is--Niit-(t_process_long_optRet_process_short_optsRRW(RRRRtarg((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyR[s   "   cC st||jS(s_match_long_opt(opt : string) -> string Determine which long option string 'opt' matches, ie. which one it is an unambiguous abbrevation for. Raises BadOptionError if 'opt' doesn't unambiguously match any long option string. (t _match_abbrevRM(RR`((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_match_long_optsc C s_|jd}d|krL|jdd\}}|jd|t}n |}t}|j|}|j|}|jr|j}t ||kr|dkr|j t d|q|j t d||fqE|dkr|jd} qEt |d|!} |d|5n&|r?|j t d|nd} |j|| ||dS(Nit=is%s option requires an arguments%s option requires %d argumentss%s option does not take a value(tpoptsplittinsertRRRRMt takes_valuetnargsReRQRttupleR)R( RRRRR`tnext_argthad_explicit_valueR^RR@((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRs0        c C so|jd}t}d}xM|dD]A}d|}|jj|}|d7}|sgt|n|jrA|t|kr|jd||t}n|j } t|| kr| dkr|j t d|q>|j t d|| fqG| dkr!|jd} qGt |d| !} |d| 5nd} |j|| |||r&Pq&q&WdS(NiiRs%s option requires an arguments%s option requires %d arguments(RRRKRmRRReRRRRQRRR)R( RRRRRtitchR`R^RR@((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRs6        cC s1|jdkr&tjjtjdS|jSdS(Ni(RR)tostpathtbasenameR5R(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt get_prog_namescC s|jd|jS(Ns%prog(treplaceR(Rts((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pytexpand_prog_namescC s|j|jS(N(RRJ(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRTsicC s*|rtjj|ntj|dS(N(R5tstderrtwritetexit(Rtstatustmsg((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRscC s4|jtj|jdd|j|fdS(serror(msg : string) Print a usage message incorporating 'msg' to stderr and exit. If you override this in a subclass, it should not return -- it should either exit or raise an exception. is%s: error: %s N(t print_usageR5RRR(RR((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRQscC s-|jr%|jj|j|jSdSdS(NRr(RRut format_usageR(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt get_usages  cC s |jr||jIJndS(s`print_usage(file : file = stdout) Print the usage message for the current program (self.usage) to 'file' (default stdout). Any occurence of the string "%prog" in self.usage is replaced with the name of the current program (basename of sys.argv[0]). Does nothing if self.usage is empty or not defined. N(RR(Rtfile((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRs cC s!|jr|j|jSdSdS(NRr(RR(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt get_versions cC s |jr||jIJndS(sDprint_version(file : file = stdout) Print the version message for this program (self.version) to 'file' (default stdout). As with print_usage(), any occurence of "%prog" in self.version is replaced by the current program's name. Does nothing if self.version is empty or undefined. N(RR(RR((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt print_versions cC s|dkr|j}n|j|g}|j|jtd|j|jr|jtj |||jdnx4|j D])}|j|j ||jdqW|j dj |d S(NtOptionss Rri(R)Rutstore_option_stringsRWR}RR~R]R RwRRyRRY(RRuRvR((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRw%s      cC s|j|jS(N(t format_epilogR(RRu((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyR6scC s|dkr|j}ng}|jrA|j|jdn|jrg|j|j|dn|j|j||j|j|dj |S(Ns Rr( R)RuRRWRRJRxRwRRY(RRuRv((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRy9s    cC s/|dkrtj}n|j|jdS(sprint_help(file : file = stdout) Print an extended help message, listing all options and any help text provided with them, to 'file' (default stdout). N(R)R5tstdoutRRy(RR((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt print_helpEs  N(,RBRCRzRR)RRRRURERRRRRRRRRRRRRRRRRRRRRRRRTRRQRRRRRwRRyR(((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyR=s`?              ' 3 % *        cC s|j|r|Sg|jD]}|j|r |^q }t|dkr[|dS|spt|nt||dS(s_match_abbrev(s : string, wordmap : {string : Option}) -> string Return the string key in 'wordmap' for which 's' is an unambiguous abbreviation. If 's' is found to be ambiguous or doesn't match any of 'words', raise BadOptionError. iiN(R(tkeysRZReRR (Rtwordmaptwordt possibilities((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRRscC s|d |djddS(NiRR(R(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyt_long_opt_no_underscoresisRLcB sAeZdZdZdZdZddZdZRS(cC s i|_dS(N(t_data(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRnscC s |jjS(N(RR(R((sS/public2/ftp/pub/ccp4/6.5/ccp4-6.5/lib/py2/libtbx/pythonpath/optik/option_parser.pyRqscC s0|djddkst||j|s0 (    A