U ^3 @sdZddlZddlZddlmZmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZe d ZeeZd d d d dddddg ZGdddejZGdddejZGdddejZeZdS)a,GOption command line parser Extends optparse to use the GOptionGroup, GOptionEntry and GOptionContext objects. So it is possible to use the gtk, gnome_program and gstreamer command line groups and contexts. Use this interface instead of the raw wrappers of GOptionContext and GOptionGroup in glib. N) OptParseError OptionErrorOptionValueErrorBadOptionErrorOptionConflictError)get_introspection_module) string_types)_gi)GErrorGLibrrrrrOption OptionGroup OptionParser make_optionc@sPeZdZdZejjdZejjdddgZdej Z ddZ d d Z d d Z d S)r aRepresents a command line option To use the extended possibilities of the GOption API Option (and make_option) are extended with new types and attributes. Types: filename The supplied arguments are read as filename, GOption parses this type in with the GLib filename encoding. :ivar optional_arg: This does not need a arguement, but it can be supplied. :ivar hidden: The help list does not show this option :ivar in_main: This option apears in the main group, this should only be used for backwards compatibility. Use Option.REMAINING as option name to get all positional arguments. .. NOTE:: Every argument to an option is passed as utf-8 coded string, the only exception are options which use the 'filename' type, its arguments are passed as strings in the GLib filename encoding. For further help, see optparse.Option. )filenamehiddenin_main optional_arg--cOsXtjj|f|||js"tdt|jt|jkr>td|jsTtd|jddS)Nz!%s at least one long option name.z;%s at least more long option names than short option names.z%s needs a help message.r)optparser __init__ _long_opts ValueErrorlen _short_optshelpselfargskwargsr!,/usr/lib/python3/dist-packages/gi/_option.pyr_szOption.__init__cCsF|j|kr|j|jtj||t|jt|jkrBtddS)NzCgoption.Option needs more long option names than short option names) REMAININGrappendrr _set_opt_stringrrr)rZoptsr!r!r"r%ks  zOption._set_opt_stringccsd}|jr|tjjO}|jr(|tjjO}|rD|jrP|tjjO}n |tjj O}|j dkrf|tjj O}t |j |jD]@\}}|d}t|ts|d}|dd|||j|jfVqt|j t|jdD] }|ddd||j|jfVqdS)Nrrrzutf-8)rr Z OptionFlagsZHIDDENrZIN_MAINZ takes_valuerZ OPTIONAL_ARGZNO_ARGtypeZFILENAMEziprr isinstancebytesencodermetavarr)rflagsZ long_nameZ short_nameZ short_bytesr!r!r"_to_goptionentriesss$       zOption._to_goptionentriesN)__name__ __module__ __qualname____doc__rr ZTYPESZATTRSr ZOPTION_REMAININGr#rr%r/r!r!r!r"r 8s   c@s<eZdZdZdddZddZdd Zdd d Zd d ZdS)raA group of command line options. :param str name: The groups name, used to create the --help-{name} option :param str description: Shown as title of the groups help view :param str help_description: Shown as help to the --help-{name} option :param list option_list: The options used in this group, must be option.Option() :param dict defaults: A dicitionary of default values :param translation_domain: Sets the translation domain for gettext(). .. NOTE:: This OptionGroup does not exactly map the optparse.OptionGroup interface. There is no parser object to supply, but it is possible to set default values and option_lists. Also the default values and values are not shared with the OptionParser. To pass a OptionGroup into a function which expects a GOptionGroup (e.g. gnome_program_init() ). OptionGroup.get_option_group() can be used. For further help, see optparse.OptionGroup. NcCsVtj|td|||_d|_||_|r.||_d|_||_ |rR|D]}| |qBdS)Nerror) rZOptionContainerrr nameparserhelp_descriptiondefaultsvaluestranslation_domainZ add_option)rr6 descriptionr8 option_listr9r;optionr!r!r"rszOptionGroup.__init__cCsg|_|dSN)r=Z_create_option_mappings)rr!r!r"_create_option_listszOptionGroup._create_option_listcsbfdd}tjjj|}jr6|jg}jD]}|| q@| ||S)Ncs|drj|}n j|}z|||jWnJtk rtd}tt |}t |_ t j j|_t ||_|YnXdS)Nrr) startswith _long_opt _short_optprocessr:rsysexc_infor strOPTION_CONTEXT_ERROR_QUARKdomainr r BAD_VALUEcodemessage) option_name option_valuegroupoptr5Zgerrorr7rr!r"callbacks       z.OptionGroup._to_goptiongroup..callback) r rr6r<r8r;Zset_translation_domainr=extendr/ add_entries)rr7rRrOentriesr>r!rQr"_to_goptiongroups    zOptionGroup._to_goptiongroupcCs|||S)z Returns the corresponding GOptionGroup object. Can be used as parameter for gnome_program_init(), gtk_init(). )set_values_to_defaultsrV)rr7r!r!r"get_option_groupszOptionGroup.get_option_groupcCsR|jD]8}|j|j}t|tr|}||||j|j<qt |j|_ dSr?) r=r9getdestr*r Zget_opt_stringZ check_valuerZValuesr:)rr>defaultZopt_strr!r!r"rWs  z"OptionGroup.set_values_to_defaults)r4NNN)N) r0r1r2r3rr@rVrXrWr!r!r!r"rs  c@sJeZdZdZddZddZddZdd Zd d Zd d Z dddZ dS)raHCommand line parser with GOption support. :param bool help_enabled: The --help, --help-all and --help-{group} options are enabled (default). :param bool ignore_unknown_options: Do not throw a exception when a option is not knwon, the option will be in the result list. .. NOTE:: The OptionParser interface is not the exactly the same as the optparse.OptionParser interface. Especially the usage parameter is only used to show the metavar of the arguements. OptionParser.add_option_group() does not only accept OptionGroup instances but also glib.OptionGroup, which is returned by gtk_get_option_group(). Only glib.option.OptionGroup and glib.option.Option instances should be passed as groups and options. For further help, see optparse.OptionParser. cOsLd|krt|d<|dd|_|dd|_tjj|f|ddi|dS)NZ option_class help_enabledTignore_unknown_optionsFZadd_help_option)r popr\r]rrrrr!r!r"rs zOptionParser.__init__cCs8|dkrd|_n$|dr.|tdd|_n||_dS)Nr4z%prog)usagerAr)rr_r!r!r" set_usages  zOptionParser.set_usagec sjrjdj}nj}t|}|j|jjD]*}t |tj r\|}n | }| |qFfdd}t ddd|}g}j D]} || q|||||S)Nz - cs4|drj|}n j|}|||dS)Nr)rArBrCrD)rMrNrOrPrr:r!r"rR(s   z1OptionParser._to_goptioncontext..callback)r<r_r Z OptionContextZset_help_enabledr\Zset_ignore_unknown_optionsr] option_groupsr*rrXZ add_groupr=rSr/rTZset_main_group) rr:Zparameter_stringcontextZ option_groupZg_grouprRZ main_groupZ main_entriesr>r!rar"_to_goptioncontexts&          zOptionParser._to_goptioncontextcOst|dtr,tj|t|f||dSt|dkr|st|dtrt|djs^||d_|dj|k rttdt|dt jr|j |ddStjj|f||dS)Nrrz"invalid OptionGroup (wrong parser)) r*r rradd_option_grouprrr7rr rbr$rr!r!r"re8s  zOptionParser.add_option_groupcCs6|jdd}|jD]}t|tjr||jq|Sr?)r=rbr*rrrS)roptionsrOr!r!r"_get_all_optionsHs   zOptionParser._get_all_optionscCs4||}|tjdg|dd|dd<dS)Nrr)rdparserEargv)rZlargsZrargsr:rcr!r!r" _process_argsOs zOptionParser._process_argsNcCsztj|||\}}Wn|tk rtd}|jtkr@|jt j j krZt |j n6|jt j jkrtt|j n|jt j jkrt|j nYnX|jD]&}|jjD]\}}|||qq||fS)Nr)rr parse_argsr rErFrIrHrKr rrJrrLZUNKNOWN_OPTIONrZFAILEDrrbr:__dict__itemsZ ensure_value)rrr:rfr5rOkeyvaluer!r!r"rkWs*       zOptionParser.parse_args)NN) r0r1r2r3rr`rdrergrjrkr!r!r!r"rs  )r3rErrrrrrmodulerZ_compatr Zgir Z gi._errorr r Zquark_to_stringZoption_error_quarkrH__all__r rrrr!r!r!r"s.      Wa