3
‰å<_°3 ã @ sÞ d Z ddlZddlZddlmZmZmZmZmZ ddlm Z ej
dkrTe Z dd„ Z
neZ e Z
dd lmZ dd
lmZ e d ƒZejejƒ ƒZd d
dddddddg ZG dd„ dejƒZG dd„ dejƒZG dd„ dejƒZeZdS )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Ú OptionErrorÚOptionValueErrorÚBadOptionErrorÚOptionConflictErroré )Úget_introspection_moduleé c C s | j ƒ S )N)Úencode)Ús© r ú /usr/lib64/python3.6/_option.pyÚ& s r )Ú_gi)ÚGErrorÚGLibr r r r r ÚOptionÚ OptionGroupÚ OptionParserÚ make_optionc @ sP e Zd ZdZejjd Zejjdddg Zdej Z
dd„ Z d d
„ Z d d „ Z
d
S )r a¹ Represents 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.
ÚfilenameÚhiddenÚin_mainÚ optional_argz--c O sX t jj| f|ž|Ž | js"tdƒ‚t| jƒt| jƒk r>tdƒ‚| jsTtd| jd ƒ‚d S )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Ú
ValueErrorÚlenÚ _short_optsÚhelp)ÚselfÚargsÚkwargsr r r
r e s zOption.__init__c C sF | j |kr| jj| j ƒ tjj| |ƒ t| jƒt| jƒkrBtdƒ‚d S )NzCgoption.Option needs more long option names than short option names) Ú REMAININGr Úappendr r Ú_set_opt_stringr r r )r! Zoptsr r r
r& q s
zOption._set_opt_stringc c sè d}| j r|tjjO }| jr(|tjjO }| jƒ rD| jrP|tjjO }n |tjj O }| j
dkrf|tjj O }x>t | j
| jƒD ],\}}|dd … t|d ƒ|| j| jfV qvW x<| j
t| jƒd … D ]$}|dd … tdƒ|| j| jfV q¼W d S )Nr r é r ú )r r Z OptionFlagsZHIDDENr ZIN_MAINZ takes_valuer Z OPTIONAL_ARGZNO_ARGÚtypeZFILENAMEÚzipr r Ú_bytesr Úmetavarr )r! ÚflagsZ long_nameZ
short_namer r r
Ú_to_goptionentriesy s
(zOption._to_goptionentriesN)r )Ú__name__Ú
__module__Ú __qualname__Ú__doc__r r ZTYPESZATTRSr ZOPTION_REMAININGr$ r r& r. r r r r
r > s
c @ s< e Zd ZdZddd„Zdd„ Zdd „ Zdd
d „Zd d
„ ZdS )r a÷ A 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.
Ú Nc C sZ t jj| td|ƒ || _d | _|| _|r.|| _d | _|| _ |rVx|D ]}| j
|ƒ qDW d S )NÚerror) r ZOptionContainerr r ÚnameÚparserÚhelp_descriptionÚdefaultsÚvaluesÚtranslation_domainZ
add_option)r! r5 Ú descriptionr7 Ú option_listr8 r: Úoptionr r r
r s
zOptionGroup.__init__c C s g | _ | jƒ d S )N)r< Z_create_option_mappings)r! r r r
Ú_create_option_list¿ s z OptionGroup._create_option_listc sf ‡ ‡fdd„}t jˆjˆjˆj|ƒ}ˆjr6|jˆjƒ g }x ˆjD ]}|j|j ƒ ƒ qBW |j
|ƒ |S )Nc s† | j dƒrˆj| }n
ˆj| }y|j| |ˆjˆ ƒ W nJ tk
r€ tjƒ d }tt |ƒƒ}t
|_ t j
j|_t |ƒ|_|‚Y nX d S )Nz--r )Ú
startswithÚ _long_optÚ
_short_optÚprocessr9 r ÚsysÚexc_infor ÚstrÚOPTION_CONTEXT_ERROR_QUARKÚdomainr r Ú BAD_VALUEÚcodeÚmessage)Ú option_nameÚ option_valueÚgroupÚoptr4 Zgerror)r6 r! r r
ÚcallbackÄ s
z.OptionGroup._to_goptiongroup..callback) r r r5 r; r7 r: Zset_translation_domainr< Úextendr. Ú add_entries)r! r6 rO rM Zentriesr= r )r6 r! r
Ú_to_goptiongroupà s
z OptionGroup._to_goptiongroupc C s | j ƒ | j|ƒS )z€ Returns the corresponding GOptionGroup object.
Can be used as parameter for gnome_program_init(), gtk_init().
)Úset_values_to_defaultsrR )r! r6 r r r
Úget_option_groupá s z OptionGroup.get_option_groupc C sV xB| j D ]8}| jj|jƒ}t|tƒr|jƒ }|j||ƒ| j|j< qW tj | jƒ| _
d S )N) r< r8 ÚgetÚdestÚ
isinstanceÚ _basestringZget_opt_stringZ check_valuer ZValuesr9 )r! r= ÚdefaultZopt_strr r r
rS é s
z"OptionGroup.set_values_to_defaults)r3 NNN)N) r/ r0 r1 r2 r r> rR rT rS r r r r
r ’ s
c @ sJ e Zd ZdZdd„ Zdd„ Zdd„ Zdd „ Zd
d „ Zd d
„ Z ddd„Z
dS )r aH Command 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.
c O sL d|krt |d< |jddƒ| _|jddƒ| _tjj| f|žddi|—Ž d S )NZ option_classÚ help_enabledTÚignore_unknown_optionsFZadd_help_option)r ÚpoprZ r[ r r r )r! r" r# r r r
r
s
zOptionParser.__init__c C s8 |d krd| _ n$|jdƒr.|tdƒd … | _ n|| _ d S )Nr3 z%prog)Úusager? r )r! r] r r r
Ú set_usage s
zOptionParser.set_usagec
sÎ ˆ j rˆ jd ˆ j }nˆ j}tj|ƒ}|jˆ jƒ |jˆ jƒ x4ˆ jD ]*}t |tj
ƒr^|}n
|j ˆ ƒ}|j |ƒ qHW ‡ ‡fdd„}tj
d d d |ƒ}g }x ˆ j
D ]} |j| jƒ ƒ q W |j|ƒ |j|ƒ |S )Nz - c s4 | j dƒrˆ j| }n
ˆ j| }|j| |ˆˆ ƒ d S )Nz--)r? r@ rA rB )rK rL rM rN )r! r9 r r
rO + s
z1OptionParser._to_goptioncontext..callback)r; r] r Z
OptionContextZset_help_enabledrZ Zset_ignore_unknown_optionsr[ Ú
option_groupsrW r rT Z add_groupr< rP r. rQ Zset_main_group)
r! r9 Zparameter_stringÚcontextZ option_groupZg_grouprO Z
main_groupZ main_entriesr= r )r! r9 r
Ú_to_goptioncontext s&
z OptionParser._to_goptioncontextc O s² t |d tƒr,tjj| t| f|ž|Žƒ d S t|ƒdkrš| ršt |d tƒrv|d js`| |d _|d j| k rvtdƒ‚t |d t jƒrš| j
j |d ƒ d S tjj| f|ž|Ž d S )Nr r z"invalid OptionGroup (wrong parser)) rW rX r r Úadd_option_groupr r r6 r r r_ r% )r! r" r# r r r
rb ; s
z OptionParser.add_option_groupc C s: | j d d … }x&| jD ] }t|tjƒr|j|j ƒ qW |S )N)r< r_ rW r r rP )r! ÚoptionsrM r r r
Ú_get_all_optionsK s
z OptionParser._get_all_optionsc C s4 | j |ƒ}|jtjd g| ƒdd … |d d …< d S )Nr r )ra ÚparserC Úargv)r! ZlargsZrargsr9 r` r r r
Ú
_process_argsR s
zOptionParser._process_argsNc
C sî |pg }yt jj| ||ƒ\}}W n| tk
rœ tjƒ d }|jtkrH‚ |jt j
j krbt |j
ƒ‚n6|jt j
jkr|t|j
ƒ‚n |jt j
jkr–t|j
ƒ‚n‚ Y nX x4| jD ]*}x$|jjjƒ D ]\}}|j||ƒ q¸W q¦W |dt|ƒ … }||fS )Nr r' )r r Ú
parse_argsr rC rD rG rF rI r r rH r rJ ZUNKNOWN_OPTIONr ZFAILEDr r_ r9 Ú__dict__ÚitemsZ ensure_valuer ) r! r" r9 Zold_argsrc r4 rM ÚkeyÚvaluer r r
rh Z s(
zOptionParser.parse_args)NN) r/ r0 r1 r2 r r^ ra rb rd rg rh r r r r
r ó s )r r ) r2 rC r r r r r r Úmoduler Ú version_inforE rX r+ Z
basestringZgir Z gi._errorr r Zquark_to_stringZoption_error_quarkrF Ú__all__r r r r r r r r
Ú s6
Ta