File: //lib/python2.7/site-packages/awscli/arguments.pyc
�
R$�_c @ s d Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m
Z
e j d � Z d e
f d
� � YZ d � Z d e f d
� � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( s Abstractions for CLI arguments.
This module contains abstractions for representing CLI arguments.
This includes how the CLI argument parser is created, how arguments
are serialized, and how arguments are bound (if at all) to operation
arguments.
The BaseCLIArgument is the interface for all arguments. This is the interface
expected by objects that work with arguments. If you want to implement your
own argument subclass, make sure it implements everything in BaseCLIArgument.
Arguments generally fall into one of several categories:
* global argument. These arguments may influence what the CLI does,
but aren't part of the input parameters needed to make an API call. For
example, the ``--region`` argument specifies which region to send the request
to. The ``--output`` argument specifies how to display the response to the
user. The ``--query`` argument specifies how to select specific elements
from a response.
* operation argument. These are arguments that influence the parameters we
send to a service when making an API call. Some of these arguments are
automatically created directly from introspecting the JSON service model.
Sometimes customizations may provide a pseudo-argument that takes the
user input and maps the input value to several API parameters.
i����N( t
xform_name( t first_non_none_response( t unpack_cli_arg( t SchemaTransformer( t models awscli.argumentst UnknownArgumentErrorc B s e Z RS( ( t __name__t
__module__( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR 4 s c C s: t � } | j | � } t j | � } | j d � } | S( Nt
InputShape( R t transformR t
ShapeResolvert get_shape_by_name( t schemat transformert
shapes_mapt shape_resolvert arg_shape( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt! create_argument_model_from_schema8 s
t BaseCLIArgumentc B s� e Z d Z d � Z d � Z d � Z d � Z e d � � Z e d � � Z e d � � Z
e d � � Z e d � � Z e d
� � Z
e d � � Z e d � � Z e d
� � Z e d � � Z e d � � Z e j d � � Z e d � � Z RS( ss Interface for CLI argument.
This class represents the interface used for representing CLI
arguments.
c C s
| | _ d S( N( t _name( t selft name( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt __init__M s c C s | | | j <d S( s� Add this object to the argument_table.
The ``argument_table`` represents the argument for the operation.
This is called by the ``ServiceOperation`` object to create the
arguments associated with the operation.
:type argument_table: dict
:param argument_table: The argument table. The key is the argument
name, and the value is an object implementing this interface.
N( R ( R t argument_table( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt add_to_arg_tableP s c C s d S( sm Add this object to the parser instance.
This method is called by the associated ``ArgumentParser``
instance. This method should make the relevant calls
to ``add_argument`` to add itself to the argparser.
:type parser: ``argparse.ArgumentParser``.
:param parser: The argument parser associated with the operation.
N( ( R t parser( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt
add_to_parser] s c C s d S( s Add this object to the parameters dict.
This method is responsible for taking the value specified
on the command line, and deciding how that corresponds to
parameters used by the service/operation.
:type parameters: dict
:param parameters: The parameters dictionary that will be
given to ``botocore``. This should match up to the
parameters associated with the particular operation.
:param value: The value associated with the CLI option.
N( ( R t
parameterst value( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt
add_to_paramsj s c C s | j S( N( R ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR { s c C s d | j S( Ns --( R ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt cli_name s c C s t d � � d S( Nt
cli_type_name( t NotImplementedError( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s c C s t d � � d S( Nt required( R ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR! � s c C s t d � � d S( Nt
documentation( R ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR" � s c C s t d � � d S( Nt cli_type( R ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR# � s c C s | j j d d � S( Nt -t _( R t replace( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt py_name� s c C s d S( s� List valid choices for argument value.
If this value is not None then this should return a list of valid
values for the argument.
N( t None( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt choices� s c C s d S( Nt ( ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt synopsis� s c C s t S( N( t False( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt positional_arg� s c C s d S( N( R( ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt nargs� s c C s
| | _ d S( N( R ( R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s c C s d S( s� Get the group name associated with the argument.
An argument can be part of a group. This property will
return the name of that group.
This base class has no default behavior for groups, code
that consumes argument objects can use them for whatever
purposes they like (documentation, mutually exclusive group
validation, etc.).
N( R( ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt
group_name� s
( R R t __doc__R R R R t propertyR R R R! R" R# R' R) R+ R- R. t setterR/ ( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR E s$
t CustomArgumentc B s� e Z d Z d d d d d d d d d e e d d d d � Z d � Z e d � � Z d � Z e d � � Z
e
j d � � Z
e d � � Z e d � � Z
e d
� � Z e d � � Z e d � � Z e d
� � Z e d � � Z e d � � Z RS( sd
Represents a CLI argument that is configured from a dictionary.
For example, the "top level" arguments used for the CLI
(--region, --output) can use a CustomArgument argument,
as these are described in the cli.json file as dictionaries.
This class is also useful for plugins/customizations that want to
add additional args.
R* c C s� | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ |
| _ | | _
| d k rx g } n | | _ | | _
| | _ d | _ |
d k r� | j � }
n |
| _ | j d k r� | j j d k r� d | _ n d S( Nt listt +( R t _helpt _destt _defaultt _actiont _requiredt _nargst _constt _cli_type_namet _group_namet _positional_argR( t _choicest _synopsist no_paramfilet argument_modelt _create_scalar_argument_modelt type_name( R R t help_textt destt defaultt actionR! R) R. R R/ R- RB RC R+ t const( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s. c C s- | j d k r d S| j } t i | d 6� S( Nt type( R; R( R R ( R RE ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyRD � s c C s | j r | j Sd | j Sd S( Ns --( R? R ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s c C s� | j } i } | j d k r. | j | d <n | j d k rM | j | d <n | j d k rl | j | d <n | j r� | j | d <n | j d k r� | j | d <n | j d k r� | j | d <n | j d k r� | j | d <n | j | | � d S( sX
See the ``BaseCLIArgument.add_to_parser`` docs for more information.
RG RI RH R) R! R. RJ N(
R R7 R( R9 R8 R@ R: R; R< t add_argument( R R R t kwargs( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR s" c C s | j d k r t S| j S( N( R: R( R, ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR! s c C s
| | _ d S( N( R: ( R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR! " s c C s | j S( N( R6 ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR" & s c C sJ | j d k r | j S| j d k r) d S| j d k rB | j j Sd Sd S( Nt
store_truet store_falset booleant string( s
store_trues store_false( R= R( R9 RC RE ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR * s
c C s" t } | j d k r t } n | S( NRN RO ( s
store_trues store_false( t strR9 t bool( R R# ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR# 7 s c C s | j S( N( R@ ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR) > s c C s | j S( N( R> ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR/ B s c C s | j S( N( RA ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR+ F s c C s | j S( N( R? ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR- J s c C s | j S( N( R; ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR. N s N( R R R0 R( R, R RD R1 R R R! R2 R" R R# R) R/ R+ R- R. ( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR3 � s&
t CLIArgumentc B s e Z d Z i e d 6e d 6e d 6e d 6e d 6e d 6e d 6e d 6e d 6e d
6e d 6Z e d d � Z
e d
� � Z e d � � Z
e
j d � � Z
e d � � Z e j d � � Z e d � � Z e d � � Z d � Z d � Z d � Z d � Z d � Z RS( sA Represents a CLI argument that maps to a service parameter.
t structuret mapt timestampR4 RQ t floatt integert longRP t doublet blobc C s[ | | _ | d k r | } n | | _ | | _ | | _ | | _ | | _ | j | _ d S( s=
:type name: str
:param name: The name of the argument in "cli" form
(e.g. ``min-instances``).
:type argument_model: ``botocore.model.Shape``
:param argument_model: The shape object that models the argument.
:type argument_model: ``botocore.model.OperationModel``
:param argument_model: The object that models the associated operation.
:type event_emitter: ``botocore.hooks.BaseEventHooks``
:param event_emitter: The event emitter to use when emitting events.
This class will emit events during parts of the argument
parsing process. This event emitter is what is used to emit
such events.
:type is_required: boolean
:param is_required: Indicates if this parameter is required or not.
N( R R( t _serialized_nameRC R: t _operation_modelt _event_emitterR" t _documentation( R R RC t operation_modelt
event_emittert is_requiredt serialized_name( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR f s c C s | j j d d � S( NR$ R% ( R R& ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR' � s c C s | j S( N( R: ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR! � s c C s
| | _ d S( N( R: ( R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR! � s c C s | j S( N( R` ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR" � s c C s
| | _ d S( N( R` ( R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR" � s c C s
| j j S( N( RC RE ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s c C s | j j | j j t � S( N( t TYPE_MAPt getRC RE RR ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR# � s c C s5 | j } | j | d | j d | j d | j �d S( sX
See the ``BaseCLIArgument.add_to_parser`` docs for more information.
t helpRK R! N( R RL R" R# R! ( R R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s c C sI | d k r d S| j | � } t j d | | j | � | | | j <d S( Ns+ Unpacked value of %r for parameter "%s": %r( R( t _unpack_argumentt LOGt debugR' R] ( R R R t unpacked( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s
c C ss | j j j } t | j j d � } | j d | | f d | j d | d | �} | d k rb | St | | � Sd S( NR$ s process-cli-arg.%s.%st paramt cli_argumentR ( R^ t
service_modelt service_nameR R t _emit_first_responseRC R( R ( R R Ro t operation_namet override( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyRh � s c K s | j j | | � S( N( R_ t emit( R R RM ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt _emit� s c K s | j | | � } t | � S( N( Rt R ( R R RM t responses( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyRp � s N( R R R0 RR RX t intRS Re R, R( R R1 R' R! R2 R" R R# R R Rh Rt Rp ( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyRT S s6
%
t ListArgumentc B s e Z d � Z RS( c C s2 | j } | j | d d d | j d | j �d S( NR. t *RK R! ( R RL R# R! ( R R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s
( R R R ( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyRw � s t BooleanArgumentc B sS e Z d Z e d d d d d d � Z d � Z d � Z d � Z e d � � Z
RS( s^ Represent a boolean CLI argument.
A boolean parameter is specified without a value::
aws foo bar --enabled
For cases wher the boolean parameter is required we need to add
two parameters::
aws foo bar --enabled
aws foo bar --no-enabled
We use the capabilities of the CLIArgument to help achieve this.
RN c C s� t t | � j | | | | | d |
�d | _ | | _ | d k rU | j | _ n | | _ | d k ry | j | _ n | | _ | | _
d S( NRd ( t superRy R R( t _mutex_groupR9 R' t _destinationR R> R8 ( R R RC Ra Rb Rc RI RG R/ RH Rd ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR � s c C s | d k r | | | j <n d S( N( R( R] ( R R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR s c
C sj | | | j <d | j } | j | | j | j | j d d d | j d | j d | j �} | | | <d S( Ns no-%sRI RO RG R/ Rd ( R t __class__RC R^ R_ R| R/ R] ( R R t
negative_namet negative_version( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR s
c
C s8 | j | j d | j d | j d | j d | j �d S( NRg RI RH RG ( RL R R" R9 R8 R| ( R R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR * s
c C s | j S( N( R> ( R ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyR/ 1 s N( R R R0 R, R( R R R R R1 R/ ( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyRy � s ( R0 t loggingt botocoreR t botocore.hooksR t awscli.argprocessR t
awscli.schemaR R t getLoggerRi t ExceptionR R t objectR R3 RT Rw Ry ( ( ( s4 /usr/lib/python2.7/site-packages/awscli/arguments.pyt <module>& s
|��