| Server IP : 167.99.254.82 / Your IP : 216.73.217.78 Web Server : Apache System : Linux host.techisquad.com 5.15.0-187-generic #197-Ubuntu SMP Fri Jul 17 19:17:01 UTC 2026 x86_64 User : pawluxera ( 1011) PHP Version : 8.1.34 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/lib/python3/dist-packages/awscli/customizations/__pycache__/ |
Upload File : |
o
.&�a!% � @ sF d dl Z d dlmZ e �e�ZdZG dd� de�ZG dd� de�Z dS )� N)�CustomArgument�.c s: e Zd ZdZ d
� fdd� Zedd� �Zdd � Z� ZS ) �FlattenedArgumenta)
A custom argument which has been flattened from an existing structure. When
added to the call params it is hydrated back into the structure.
Supports both an object and a list of objects, in which case the flattened
parameters will hydrate a list with a single object in it.
� Nc s8 || _ || _|| _|| _|| _tt| �j|||d� d S )N)�name� help_text�required)�type�
_container� _property�_hydrate�_hydrate_value�superr �__init__) �selfr � container�propr r r �hydrate�
hydrate_value�� __class__� �?/usr/lib/python3/dist-packages/awscli/customizations/flatten.pyr s
�zFlattenedArgument.__init__c C s | j S �N)r )r r r r �
cli_type_name* s z FlattenedArgument.cli_type_namec C s� | j jj}| j j}| j}t�d�||�� |durw| jdkr&|� � dk }n| jdv r0t
|�}n | jdv r9t |�}| j rG| � |||||� dS ||vrY|dkrUi g||< ni ||< | j
ra| �
|�}|dkro||| d |< dS ||| |< dS dS ) a
Hydrate the original structure with the value of this flattened
argument.
TODO: This does not hydrate nested structures (``XmlName1.XmlName2``)!
To do this for now you must provide your own ``hydrate`` method.
zHydrating {0}[{1}]N�boolean�false)�integer�long)�float�double�listr )r
�argument_modelr r r �LOG�debug�formatr �lower�intr r r
)r �
parameters�valuer �cli_type�keyr r r �
add_to_params. s.
�z FlattenedArgument.add_to_params)r NNNN) �__name__�
__module__� __qualname__�__doc__r �propertyr r, �
__classcell__r r r r r s �
r c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�FlattenArgumentsa�
Flatten arguments for one or more commands for a particular service from
a given configuration which maps service call parameters to flattened
names. Takes in a configuration dict of the form::
{
"command-cli-name": {
"argument-cli-name": {
"keep": False,
"flatten": {
"XmlName": {
"name": "flattened-cli-name",
"type": "Optional custom type",
"required": "Optional custom required",
"help_text": "Optional custom docs",
"hydrate_value": Optional function to hydrate value,
"hydrate": Optional function to hydrate
},
...
}
},
...
},
...
}
The ``type``, ``required`` and ``help_text`` arguments are entirely
optional and by default are pulled from the model. You should only set them
if you wish to override the default values in the model.
The ``keep`` argument determines whether the original command is still
accessible vs. whether it is removed. It defaults to ``False`` if not
present, which removes the original argument.
The keys inside of ``flatten`` (e.g. ``XmlName`` above) can include nested
references to structures via a colon. For example, ``XmlName1:XmlName2``
for the following structure::
{
"XmlName1": {
"XmlName2": ...
}
}
The ``hydrate_value`` function takes in a value and should return a value.
It is only called when the value is not ``None``. Example::
"hydrate_value": lambda (value): value.upper()
The ``hydrate`` function takes in a list of existing parameters, the name
of the container, its type, the name of the container key and its set
value. For the example above, the container would be
``'argument-cli-name'``, the key would be ``'XmlName'`` and the value
whatever the user passed in. Example::
def my_hydrate(params, container, cli_type, key, value):
if container not in params:
params[container] = {'default': 'values'}
params[container][key] = value
It's possible for ``cli_type`` to be ``list``, in which case you should
ensure that a list of one or more objects is hydrated rather than a
single object.
c C s || _ || _d S r )�configs� service_name)r r5 r4 r r r r � s
zFlattenArguments.__init__c C s, | j }| jD ]
}|�d�||�| j� qdS )z�
Register with a CLI instance, listening for events that build the
argument table for operations in the configuration dict.
z building-argument-table.{0}.{1}N)r5 r4 �registerr% � flatten_args)r �cli�service� operationr r r r6 � s
���zFlattenArguments.registerc
K s� | j |j �� D ]h\}}|| }d}t�d�|j|d�dd� |d �� D ���� |d �� D ]3\}} | �� }
||
d< ||
d< | �|j |�} | �
| ||
� t d i |
��} | || d < || d krbd
}q/|spd |vsm|d sp||= qd S )
NFz$Flattening {0} argument {1} into {2}z, c S s g | ]\}}|d �qS )r r )�.0�k�vr r r �
<listcomp>� s z1FlattenArguments.flatten_args.<locals>.<listcomp>�flattenr r r T�keepr ) r4 r �itemsr# r$ r% �join�copy�_find_nested_argr" �_merge_member_configr )
r �command�argument_table�kwargsr �argument�argument_from_table� overwritten� sub_argument�
new_config�config�_arg�new_argr r r r7 � s4 �� � ���z FlattenArguments.flatten_argsc C sf t |v r1t�d�|�� |�t �dd� D ]}|j�� D ] \}}||kr(|} nq td�|���q|S )z�
Find and return a nested argument, if it exists. If no nested argument
is requested then the original argument is returned. If the nested
argument cannot be found, then a ValueError is raised.
z Finding nested argument in {0}N���zInvalid piece {0})�SEPr# r$ r% �split�membersrA �
ValueError)r rI r �piece� member_name�memberr r r rD � s ��z!FlattenArguments._find_nested_argc C sj |j �� D ]-\}}||�t�d kr2d|vr|j|d< d|vr&||jv |d< d|vr/|j|d< dS qdS )a4
Merges an existing config taken from the configuration dict with an
existing member of an existing argument object. This pulls in
attributes like ``required`` and ``help_text`` if they have not been
overridden in the configuration dict. Modifies the config in-place.
rQ r r r N)rT rA rS rR �
documentation�required_members� type_name)r rI r rN rW rX r r r rE � s
��z%FlattenArguments._merge_member_configN) r- r. r/ r0 r r6 r7 rD rE r r r r r3 W s A % r3 )
�logging�awscli.argumentsr � getLoggerr- r# rR r �objectr3 r r r r �<module> s
?