HEX

File: //opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyc
�
3a[c@s�ddlZyddlmZWn!ek
rCddlmZnXddlmZd�Zd�Zd�Z	d	�Z
d
efd��YZdS(i����Ni(tLexiconi(tArgumentcCs"|jd�jd�jdd�S(Nt_t-(tlstriptrstriptreplace(tname((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyttranslate_underscoresscCs.t|�}t|�dkr&d|Sd|S(NiRs--(Rtlen(R((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pytto_flagscsI|j}d�|D���fd�|D�}t�r>�n|�dS(NcSs1h|]'}t|jd��dkr|�qS(Ri(R	tstrip(t.0tx((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pys	<setcomp>s	cs"h|]}|�kr|�qS(((RR
(tshorts(sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pys	<setcomp>s	i(tnamestsorted(targRtlongs((RsF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pytsort_candidates	cCs�g}t|�}|jt|�dkr0dnd�|j|j��d}x6|D].}||j�rx|j�n	|j�7}qWW|j|�|S(sZ
    Obtain useful key list-of-ints for sorting CLI flags.

    .. versionadded:: 1.0
    iit(RtappendR	tlowertisuppertupper(R
trettinversedtchar((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pytflag_keys%
,
t
ParserContextcBsteZdZd
ddd�Zd�Zd�Zed��Zed��Z	d�Z
d�Zd�Zd	�Z
RS(
s�
    Parsing context with knowledge of flags & their format.

    Generally associated with the core program or a task.

    When run through a parser, will also hold runtime values filled in by the
    parser.

    .. versionadded:: 1.0
    cCs^t�|_g|_t�|_i|_||_||_x|D]}|j|�qCWdS(s�
        Create a new ``ParserContext`` named ``name``, with ``aliases``.

        ``name`` is optional, and should be a string if given. It's used to
        tell ParserContext objects apart, and for use in a Parser when
        determining what chunk of input might belong to a given ParserContext.

        ``aliases`` is also optional and should be an iterable containing
        strings. Parsing will honor any aliases when trying to "find" a given
        context in its input.

        May give one or more ``args``, which is a quick alternative to calling
        ``for arg in args: self.add_arg(arg)`` after initialization.
        N(Rtargstpositional_argstflagst
inverse_flagsRtaliasestadd_arg(tselfRR"RR((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt__init__Fs				
cCs�d}|jr-djdj|j��}n|jrKdj|j|�nd}|jrldj|j�nd}dj||�S(NRs ({})s, s {!r}{}s: {!r}s<parser/Context{}{}>(R"tformattjoinRR(R$R"RR((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt__repr__^s	$!cOs�t|�dkr2t|dt�r2|d}nt||�}x>|jD]3}||jkrKd}t|j|���qKqKW|jd}||j|<|jr�|jj	|�n||j
t|�<xI|jD]>}|jj
|d|�|j
j
t|�dt|��q�W|jr<|jj
|jd|�n|jtkr�|jtkr�tdj|��}t|�|j|<ndS(s�
        Adds given ``Argument`` (or constructor args for one) to this context.

        The Argument in question is added to the following dict attributes:

        * ``args``: "normal" access, i.e. the given names are directly exposed
          as keys.
        * ``flags``: "flaglike" access, i.e. the given names are translated
          into CLI flags, e.g. ``"foo"`` is accessible via ``flags['--foo']``.
        * ``inverse_flags``: similar to ``flags`` but containing only the
          "inverse" versions of boolean flags which default to True. This
          allows the parser to track e.g. ``--no-myflag`` and turn it into a
          False value for the ``myflag`` Argument.

        .. versionadded:: 1.0
        iis;Tried to add an argument named {!r} but one already exists!ttosno-{}N(R	t
isinstanceRRRt
ValueErrorR&t
positionalRRR R
t	nicknamestaliast	attr_nametkindtbooltdefaulttTrueR!(R$RtkwargsRRtmsgtmaintinverse_name((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyR#fs(%


	&	cCs)g|jD]}|jdkr
|^q
S(N(RtvaluetNone(R$R
((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pytmissing_positional_args�scCs4i}x'|jj�D]}|j||j<qW|S(s
        This context's arguments' values keyed by their ``.name`` attribute.

        Results in a dict suitable for use in Python contexts, where e.g. an
        arg named ``foo-bar`` becomes accessible as ``foo_bar``.

        .. versionadded:: 1.0
        (RtvaluesR8R(R$RR((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt	as_kwargs�s
cCs#tt|g|jj|���S(N(tlisttsetR t
aliases_of(R$tflag((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt	names_for�scCsz||jkr9d}t|j||jj����n|j|}idt6dt6j|j�}g}x�|j|�D]�}|rt	|j
d��dkr�|jr�dj|�n|}dj|�}q1dj|�}|jr1dj|�}q1n1||jj
�kr+d	j|d
�}nd}|j||�q|Wdjt|d
t	��}	|jpmd}
|	|
fS(ss
        Return 2-tuple of ``(flag-spec, help-string)`` for given ``flag``.

        .. versionadded:: 1.0
        s@{!r} is not a valid flag for this context! Valid flags are: {!r}tSTRINGtINTRis[{}]s {}s={}s	--[no-]{}iRs, tkey(R R+R&tkeyststrtinttgetR0RAR	RtoptionalR!R;RR'Rthelp(R$R@terrRR8t
full_namesRtvalue_tvaluestrtnamestrthelpstr((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pythelp_for�s*$
 	cs1tt�fd�t�jj�dt���S(s�
        Return sorted iterable of help tuples for all member Arguments.

        Sorts like so:

        * General sort is alphanumerically
        * Short flags win over long flags
        * Arguments with *only* long flags and *no* short flags will come
          first.
        * When an Argument has multiple long or short flags, it will sort using
          the most favorable (lowest alphabetically) candidate.

        This will result in a help list like so::

            --alpha, --zeta # 'alpha' wins
            --beta
            -a, --query # short flag wins
            -b, --argh
            -c

        .. versionadded:: 1.0
        cs�jt|j��S(N(RQR
R(R
(R$(sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt<lambda>�RRD(R=tmapRR R;R(R$((R$sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pythelp_tuples�scCsrt|jj�dt�}g|D]}|jt|j��^q"}|j|jj	��t
tjj
|��S(s�
        Similar to `help_tuples` but returns flag names only, no helpstrs.

        Specifically, all flag names, flattened, in rough order.

        .. versionadded:: 1.0
        RD(RR R;RRAR
RRR!REttuplet	itertoolstchaint
from_iterable(R$R R
R((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt
flag_names�s	+N(((t__name__t
__module__t__doc__R9R%R(R#tpropertyR:R<RARQRTRY(((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyR:s
		1		'	#(
RVtvendor.lexiconRtImportErrortlexicontargumentRRR
RRtobjectR(((sF/opt/alt/python27/lib/python2.7/site-packages/invoke/parser/context.pyt<module>s