File: //lib/python3/dist-packages/awscli/__pycache__/arguments.cpython-310.pyc
o
@&�a�I � @ s� d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
e� d�Z G d d
� d
e
�Zd d � ZG d
d� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZdS )a 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.
� N)�
xform_name)�first_non_none_response)�unpack_cli_arg)�SchemaTransformer)�modelzawscli.argumentsc @ s e Zd ZdS )�UnknownArgumentErrorN)�__name__�
__module__� __qualname__� r r �2/usr/lib/python3/dist-packages/awscli/arguments.pyr 4 s r c C s( t � }|�| �}t�|�}|�d�}|S )N�
InputShape)r � transformr �
ShapeResolver�get_shape_by_name)�schema� transformer�
shapes_map�shape_resolver� arg_shaper r r �!create_argument_model_from_schema8 s
r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zed
d � �Z ed d
� �Z
edd� �Z edd� �Z edd� �Z
edd� �Zedd� �Zedd� �Zedd� �Zed d � �Zed d � �Ze jd d � �Z ed!d"� �Zd#S )$�BaseCLIArgumentzsInterface for CLI argument.
This class represents the interface used for representing CLI
arguments.
c C �
|| _ d S �N��_name)�self�namer r r �__init__M s
zBaseCLIArgument.__init__c C s | || j < dS )a� 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 �argument_tabler r r �add_to_arg_tableP s z BaseCLIArgument.add_to_arg_tablec C � dS )am 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.
Nr �r �parserr r r �
add_to_parser] s z BaseCLIArgument.add_to_parserc C r! )a 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.
Nr �r �
parameters�valuer r r �
add_to_paramsj s z BaseCLIArgument.add_to_paramsc C � | j S r r �r r r r r { � zBaseCLIArgument.namec C s
d| j S �Nz--r r* r r r �cli_name �
zBaseCLIArgument.cli_namec C � t d��)N�
cli_type_name��NotImplementedErrorr* r r r r0 � � z BaseCLIArgument.cli_type_namec C r/ )N�requiredr1 r* r r r r4 � r3 zBaseCLIArgument.requiredc C r/ )N�
documentationr1 r* r r r r5 � r3 z BaseCLIArgument.documentationc C r/ )N�cli_typer1 r* r r r r6 � r3 zBaseCLIArgument.cli_typec C � | j �dd�S �N�-�_�r �replacer* r r r �py_name� � zBaseCLIArgument.py_namec C r! )z�List valid choices for argument value.
If this value is not None then this should return a list of valid
values for the argument.
Nr r* r r r �choices� s zBaseCLIArgument.choicesc C r! )N� r r* r r r �synopsis� � zBaseCLIArgument.synopsisc C r! �NFr r* r r r �positional_arg� rB z BaseCLIArgument.positional_argc C s d S r r r* r r r �nargs� rB zBaseCLIArgument.nargsc C r r r �r r' r r r r � r. c C r! )a� 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.).
Nr r* r r r �
group_name� s
zBaseCLIArgument.group_nameN)r r r
�__doc__r r r$ r( �propertyr r- r0 r4 r5 r6 r= r? rA rD rE �setterrG r r r r r E s@
r c @ s� e Zd ZdZ d dd�Zdd� Zed d
� �Zd d � Zed
d� �Z e j
dd� �Z edd� �Z edd� �Z edd� �Z
edd� �Zedd� �Zedd� �Zed d � �Zed d � �ZdS )!�CustomArgumentad
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@ NFc C s� || _ || _|| _|| _|| _|| _|| _|| _| | _|
| _ | | _
|d u r'g }|| _ || _ | | _
d | _|
d u r;| �� }
|
| _| jd urN| jjdkrPd| _d S d S d S )N�list�+)r �_help�_dest�_default�_action� _required�_nargs�_const�_cli_type_name� _group_name�_positional_arg�_choices� _synopsis� no_paramfile�argument_model� _create_scalar_argument_model� type_name)r r � help_text�dest�default�actionr4 r? rE r0 rG rD rZ r[ rA �constr r r r � s2
�zCustomArgument.__init__c C s | j d urd S | j}td|i�S )N�type)rS r0 r )r r] r r r r\ � s
z,CustomArgument._create_scalar_argument_modelc C s | j r| jS d| j S r, )rW r r* r r r r- � s
zCustomArgument.cli_namec C s� | j }i }| jdur| j|d< | jdur| j|d< | jdur#| j|d< | jr+| j|d< | jdur5| j|d< | jdur?| j|d< | jdurI| j|d< |j|fi |�� dS ) �X
See the ``BaseCLIArgument.add_to_parser`` docs for more information.
Nr_ ra r` r? r4 rE rb ) r- rO rQ rP rX rR rS rT � add_argument)r r# r- �kwargsr r r r$ s"
z CustomArgument.add_to_parserc C s | j d u rdS | j S rC �rR r* r r r r4 s
zCustomArgument.requiredc C r r rg rF r r r r4 " r. c C r) r )rN r* r r r r5 & r+ z CustomArgument.documentationc C s4 | j d ur| j S | jdv rdS | jd ur| jjS dS )N��
store_true� store_false�boolean�string)rU rQ r[ r] r* r r r r0 * s
z CustomArgument.cli_type_namec C s t }| jdv r t}|S )Nrh )�strrQ �bool)r r6 r r r r6 7 s
zCustomArgument.cli_typec C r) r )rX r* r r r r? > r+ zCustomArgument.choicesc C r) r �rV r* r r r rG B r+ zCustomArgument.group_namec C r) r )rY r* r r r rA F r+ zCustomArgument.synopsisc C r) r )rW r* r r r rD J r+ z CustomArgument.positional_argc C r) r )rS r* r r r rE N r+ zCustomArgument.nargs)r@ NNNNNNNNFFNr@ N)r r r
rH r r\ rI r- r$ r4 rJ r5 r0 r6 r? rG rA rD rE r r r r rK � s@
�$
rK c @ s� e Zd ZdZeeeeeeeeeeed� Z d dd�Z e
dd� �Z e
d d
� �Z e j
d d
� �Z e
d d
� �Zej
dd
� �Ze
dd� �Ze
dd� �Zdd� Zdd� Zdd� Zdd� Zdd � ZdS ) � CLIArgumentzARepresents a CLI argument that maps to a service parameter.
) � structure�map� timestamprL rl �float�integer�longrk �double�blobFNc C s< || _ |du r |}|| _|| _|| _|| _|| _|j| _dS )a=
: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 �_serialized_namer[ rR �_operation_model�_event_emitterr5 �_documentation)r r r[ �operation_model�
event_emitter� is_required�serialized_namer r r r f s zCLIArgument.__init__c C r7 r8 r; r* r r r r= � r> zCLIArgument.py_namec C r) r rg r* r r r r4 � r+ zCLIArgument.requiredc C r r rg rF r r r r4 � r. c C r) r �r| r* r r r r5 � r+ zCLIArgument.documentationc C r r r� rF r r r r5 � r. c C s | j jS r )r[ r] r* r r r r0 � r3 zCLIArgument.cli_type_namec C s | j �| jjt�S r )�TYPE_MAP�getr[ r] rm r* r r r r6 � s zCLIArgument.cli_typec C s" | j }|j|| j| j| jd� dS )rd )�helprc r4 N)r- re r5 r6 r4 �r r# r- r r r r$ � s
�zCLIArgument.add_to_parserc C s6 |d u rd S | � |�}t�d|| j|� ||| j< d S )Nz+Unpacked value of %r for parameter "%s": %r)�_unpack_argument�LOG�debugr= ry )r r& r' �unpackedr r r r( � s
�zCLIArgument.add_to_paramsc C sJ | j jj}t| j jd�}| jd||f | j| |d�}|d ur |S t| |�S )Nr9 zprocess-cli-arg.%s.%s)�param� cli_argumentr' )rz �
service_model� service_namer r �_emit_first_responser[ r )r r' r� �operation_name�overrider r r r� � s
��
z CLIArgument._unpack_argumentc K s | j j|fi |��S r )r{ �emit)r r rf r r r �_emit� s zCLIArgument._emitc K s | j |fi |��}t|�S r )r� r )r r rf � responsesr r r r� � s z CLIArgument._emit_first_response)FN)r r r
rH rm rt �intrn r� r rI r= r4 rJ r5 r0 r6 r$ r( r� r� r� r r r r rp S sH �
�'
rp c @ s e Zd Zdd� ZdS )� ListArgumentc C s | j }|j|d| j| jd� d S )N�*)rE rc r4 )r- re r6 r4 r� r r r r$ � s
�zListArgument.add_to_parserN)r r r
r$ r r r r r� � s r� c sL e Zd ZdZ d� fdd� Zdd� Zd d
� Zd d � Zed
d� �Z � Z
S )�BooleanArgumenta_ Represent a boolean CLI argument.
A boolean parameter is specified without a value::
aws foo bar --enabled
For cases where 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.
Fri Nc sb t t| �j||||||
d� d | _|| _|d u r | j| _n|| _|d u r)| j| _n|| _| | _ d S )N)r� )
�superr� r � _mutex_grouprQ r= � _destinationr rV rP ) r r r[ r} r~ r ra r_ rG r` r� �� __class__r r r � s �
zBooleanArgument.__init__c C s |d ur ||| j < d S d S r )ry r% r r r r( s �z BooleanArgument.add_to_paramsc
C sF | || j < d| j }| j|| j| j| jd| j| j| jd�}|||< d S )Nzno-%srj )ra r_ rG r� )r r� r[ rz r{ r� rG ry )r r �
negative_name�negative_versionr r r r s
� z BooleanArgument.add_to_arg_tablec C s" |j | j| j| j| j| jd� d S )N)r� ra r` r_ )re r- r5 rQ rP r� r" r r r r$ * s
�z BooleanArgument.add_to_parserc C r) r ro r* r r r rG 1 r+ zBooleanArgument.group_name)Fri NNNN) r r r
rH r r( r r$ rI rG �
__classcell__r r r� r r� � s �r� )rH �logging�botocorer �botocore.hooksr �awscli.argprocessr �
awscli.schemar r � getLoggerr� � Exceptionr r �objectr rK rp r� r� r r r r �<module> s"
|