| Server IP : 3.96.16.70 / Your IP : 216.73.216.15 Web Server : Apache System : Linux ip-172-31-26-103.ca-central-1.compute.internal 6.1.163-186.299.amzn2023.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Feb 24 16:35:42 UTC 2026 x86_64 User : ec2-user ( 1000) PHP Version : 8.4.18 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /lib/python3.9/site-packages/awscli/__pycache__/ |
Upload File : |
a
wA�i�S � @ s. d Z ddlZddlZddlmZmZ ddlmZ ddlm Z m
Z
m Z ddl m
Z
mZmZ e�d�ZG dd � d e�ZG d
d � d e�ZG d d
� d
e�ZG dd� de�Zdd� Zdd� Zdd� Zdd� Zdd� Zdd� Z d d � Z d d � Z d-d!d"�Z d#d$� Z d%d&� Z!G d'd(� d(�Z"G d)d*� d*e"�Z#G d+d,� d,e"�Z$dS ).z Module for processing CLI args.� N)� OrderedDict�json)�is_json_value_header)�
COMPLEX_TYPES� SCALAR_TYPES� shorthand)�%find_service_and_method_in_event_name�is_document_type�is_document_type_containerzawscli.argprocessc s e Zd Z� fdd�Z� ZS )�
ParamErrorc s, d||f }t t| ��|� || _|| _dS )aB
:type cli_name: string
:param cli_name: The complete cli argument name,
e.g. "--foo-bar". It should include the leading
hyphens if that's how a user would specify the name.
:type message: string
:param message: The error message to display to the user.
z Error parsing parameter '%s': %sN)�superr �__init__�cli_name�message)�selfr r � full_message�� __class__� �5/usr/lib/python3.9/site-packages/awscli/argprocess.pyr
s zParamError.__init__��__name__�
__module__� __qualname__r
�
__classcell__r r r r r s r c @ s e Zd ZdS )�ParamSyntaxErrorN�r r r r r r r r 2 s r c s e Zd Z� fdd�Z� ZS )�ParamUnknownKeyErrorc s. d� |�}d|� d|� �}tt| ��|� d S )N�, z
Unknown key 'z', valid choices are: )�joinr r r
)r �keyZ
valid_keysr r r r r
7 s
z ParamUnknownKeyError.__init__r r r r r r 6 s r c @ s e Zd ZdS )�TooComplexErrorNr r r r r r! = s r! c C s: t |dd�}| jd|||f ||||d�}|dur6|}|S )a
Unpack an argument's value from the commandline. This is part one of a two
step process in handling commandline arguments. Emits the load-cli-arg
event with service, operation, and parameter names. Example::
load-cli-arg.ec2.describe-instances.foo
�nameZ anonymouszload-cli-arg.%s.%s.%s)�param�value� service_name�operation_nameN)�getattrZ emit_first_non_none_response)Zsessionr% r& � cli_argumentr$ Z
param_nameZvalue_overrider r r �unpack_argumentA s �r) c C s g }t | |�S �N��_detect_shape_structure)r# �stackr r r �detect_shape_structure\ s r. c sT | j � v rdS � �| j � �z(| jtv r6W � �� dS | jdkr҇ fdd�| j�� D �}t|�dkr�tdd� |D ��r�W � �� d S t|�dkr�td
d� |D ��r�W � �� d S d d
� t
t |��� W � �� S nh| jdk� r�dt | j
� � W � �� S | jdk�r:| jjtv �r W � �� dS dt | j� � W � �� S W � �� n
� �� 0 d S )N� recursive�scalar� structurec s g | ]}t |� ��qS r r+ ��.0�p�r- r r �
<listcomp>j s �z+_detect_shape_structure.<locals>.<listcomp>� c s s | ]}|d kV qdS �r0 Nr r2 r r r � <genexpr>r � z*_detect_shape_structure.<locals>.<genexpr>zstructure(scalar)c s s | ]}|d kV qdS r8 r r2 r r r r9 t r: zstructure(scalars)z
structure(%s)r �listzlist-%s�mapz
map-scalarzmap-%s)r" �append� type_namer �pop�members�values�len�allr �sorted�setr, �memberr$ )r# r- Z sub_typesr r5 r r, a sH
�
�
� � � � ��r, c C s t | j|| j�S )a1
Parses and unpacks the encoded string command line parameter
and returns native Python data structures that can be passed
to the Operation.
:type cli_argument: :class:`awscli.arguments.BaseCLIArgument`
:param cli_argument: The CLI argument object.
:param value: The value of the parameter. This can be a number of
different python types (str, list, etc). This is the value as
it's specified on the command line.
:return: The "unpacked" argument than can be sent to the `Operation`
object in python.
)�_unpack_cli_arg�argument_modelr )r( r$ r r r �unpack_cli_arg� s
�rI c C s. | j �d�r*| j �d�dkr*| jdkr*dS dS )NZ jsonvalue�location�header�stringTF)�
serialization�getr> ��modelr r r �
_special_type� s
���rQ c C sT t | �st| �r t| ||�S | jtv r2t| ||�S | jtv rHt| ||�S t|�S d S r* ) r r �_unpack_json_cli_argr> r �unpack_scalar_cli_argr �_unpack_complex_cli_arg�str)rH r$ r r r r rG � s
�
rG c
C sL zt j|td�W S tyF } z t|d||f ��W Y d }~n
d }~0 0 d S )N)Zobject_pairs_hookz"Invalid JSON: %s
JSON received: %s)r �loadsr �
ValueErrorr )rH r$ r �er r r rR � s �rR c s� | j }|dks|dkrB|�� d dkr2t| |� �S t� d| ��n�|dkr�t|t�rr|�� d dkr�t| |� �S nBt|t�r�t|�dkr�|d �� }|r�|d dkr�t| |d � �S z | j �� �fd d
�|D �W S t
t fy� t� |d ��Y n0 d S ) Nr1 r< r �{zInvalid JSON:
%sr; �[r7 c s g | ]}t �|� ��qS r )rG �r3 �v�r Zmember_shape_modelr r r6 � s z+_unpack_complex_cli_arg.<locals>.<listcomp>) r> �lstriprR r �
isinstancerU r; rB �striprF rW � TypeError)rH r$ r r> Z single_valuer r] r rT � s(
�rT � c C s� | j dks| j dkr t|�S | j dks0| j dkr8t|�S | j dkr�| j�d�r�tj�|�}tj�|�}tj� |�s�d}t
||��t |d�S | j d kr�t |t
�r�|�� d
kr�d S t|�S |S d S ) NZintegerZlong�floatZdoubleZblobZ streamingz%Blob values must be a path to a file.�rbZbooleanZfalseF)r> �intrc rM rN �os�path�
expandvars�
expanduser�isfiler �openr_ rU �lower�bool)rH r$ r Z file_path�msgr r r rS � s2 �����
�
rS c C s t | �r dS t| �S )NF)r
�_is_complex_shaperO r r r �_supports_shorthand_syntax� s
rp c C s, | j dvrdS | j dkr(| jj dvr(dS dS )N)r1 r; r< Fr; T)r> rF rO r r r ro s
ro c @ s e Zd Zdd� ZdS )�ParamShorthandc C sN ddgidgdgdgd�dgdgdgdgd �d
�}|� |i �� |g �}||v S ) z�
Determines whether a given operation for a service needs to use the
deprecated shorthand parsing case for lists of structures that only have
a single member.
zput-record-batchZrecordszreboot-workspace-requestszrebuild-workspace-requestsz terminate-workspace-requests)zreboot-workspaceszrebuild-workspaceszterminate-workspaces�tagsZ instances)z remove-tagszdescribe-instance-healthz'deregister-instances-from-load-balancerz%register-instances-with-load-balancer)ZfirehoseZ
workspacesZelb)rN )r � command_namer& Z
argument_nameZcasesr r r �_uses_old_list_case s ���z"ParamShorthand._uses_old_list_caseN)r r r rt r r r r rq s rq c @ s4 e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd S ) �ParamShorthandParserc C s t �� | _t �� | _d S r* )r ZShorthandParser�_parserZBackCompatVisitor�_visitor�r r r r r
+ s
z ParamShorthandParser.__init__c K s0 | � ||�sdS t|�\}}| �||||�S dS )a� Attempt to parse shorthand syntax for values.
This is intended to be hooked up as an event handler (hence the
**kwargs). Given ``param`` object and its string ``value``,
figure out if we can parse it. If we can parse it, we return
the parsed value (typically some sort of python dict).
:type cli_argument: :class:`awscli.arguments.BaseCLIArgument`
:param cli_argument: The CLI argument object.
:type param: :class:`botocore.parameters.Parameter`
:param param: The parameter object (includes various metadata
about the parameter).
:type value: str
:param value: The value for the parameter type on the command
line, e.g ``--foo this_value``, value would be ``"this_value"``.
:returns: If we can parse the value we return the parsed value.
If it looks like JSON, we return None (which tells the event
emitter to use the default ``unpack_cli_arg`` provided that
no other event handlers can parsed the value). If we
run into an error parsing the value, a ``ParamError`` will
be raised.
N)�_should_parse_as_shorthandr �_parse_as_shorthand)r r( r$ Z
event_name�kwargsrs r& r r r �__call__/ s ��z ParamShorthandParser.__call__c
s� zzt �d|j� � �||||�}|d ur.|W S t|t�r\� fdd�|D �}� j�||j� n � j �
|�}� j�||j� W nl t j y� } z t
|jt|���W Y d }~n@d }~0 t
tfy� } z t
|jt|���W Y d }~n
d }~0 0 |S )Nz Parsing param %s as shorthandc s g | ]}� j �|��qS r )rv �parser[ rx r r r6 e r: z<ParamShorthandParser._parse_as_shorthand.<locals>.<listcomp>)�LOG�debugr �_handle_special_casesr_ r; rw ZvisitrH rv r} r ZShorthandParseErrorr rU r )r r( r$ rs r& Z
handled_value�parsedrX r rx r rz U s" �
$&z(ParamShorthandParser._parse_as_shorthandc s� |j }|jdkrf|jjdkrft|jj�dkrf| �|||j�rft|jj�� �d � � fdd�|D �}|S |jdkr�t|j�dkr�d|jv r�|jd jdkr�d |vr�d|iS d S )
Nr; r1 r7 r c s g | ] }� |i�qS r r r[ �Zkey_namer r r6 � r: z>ParamShorthandParser._handle_special_cases.<locals>.<listcomp>�ValuerL �=) rH r> rF rB r@ rt r" r; �keys)r r( r$ rs r& rP Z
new_valuesr r� r r� u s2 �
����� ����z*ParamShorthandParser._handle_special_casesc C sT |rt |t�r|d }n|}t |t�rF|�� �d�rFt�d|j� dS |j}t |�S )Nr )rZ rY z=Param %s looks like JSON, not considered for param shorthand.F)
r_ r; rU r` �
startswithr~ r Zpy_namerH rp )r r( r$ Z check_valrP r r r ry � s
��z/ParamShorthandParser._should_parse_as_shorthandN)r r r r
r| rz r� ry r r r r ru * s
& *ru c @ sZ e Zd ZdZe� ZdZdd� Zdd� Zdd� Z d d
� Z
d d � Z d
d� Z dd� Z
dd� ZdS )�ParamShorthandDocGenz3Documentation generator for param shorthand syntax.� c C s |durt |�S dS )z3Checks if a CLI argument supports shorthand syntax.NF)rp )r rH r r r �supports_shorthand� s z'ParamShorthandDocGen.supports_shorthandc C s| | � |||�}|| ju r dS |r$|S g }z:|jjdkrP|jj}| �||�d W S | �|j|�W S W n tyv Y dS 0 dS )a� Generate documentation for a CLI argument.
:type cli_argument: awscli.arguments.BaseCLIArgument
:param cli_argument: The CLI argument which to generate
documentation for.
:return: Returns either a string or ``None``. If a string
is returned, it is the generated shorthand example.
If a value of ``None`` is returned then this indicates
that no shorthand syntax is available for the provided
``argument_model``.
Nr; z ...rb )r� � _DONT_DOCrH r> rF �_shorthand_docsr! )r r( rs r& Z docstringr- rH r r r �generate_shorthand_example� s �
z/ParamShorthandDocGen.generate_shorthand_examplec C s� |j }|jdkr�|jjdkr�t|jj�dkr�| �|||j�r�t|jj�d }|j}|� d�dkr||� d�dkr|d|j
|f S d|j
|||f S |jdkr�t|j�dkr�d |jv r�|jd jd
kr�| j S d S ) Nr; r1 r7 r �min�maxz%s %s1z%s %s1 %s2 %s3r� rL rb ) rH r> rF rB r@ rt r" r; �metadatarN r r� )r r( rs r& rP � member_namer� r r r r� � s> �
���� �� ���z*ParamShorthandDocGen._handle_special_casesc C s` t |�| jkrt� �|jdkr*| �||�S |jdkr@| �||�S |jdkrV| �||�S |jS d S )Nr1 r; r< )rB �
_MAX_STACKr! r> �_structure_docs�
_list_docs� _map_docs)r rH r- r r r r� s
z$ParamShorthandDocGen._shorthand_docsc C sj |j }|�|j� z| �|j |�}W |�� n
|�� 0 |jtv sNt|�dkrZd||f S d||f S d S )Nr7 z[%s,%s]z%s,%s)rF r= r" r� r? r> r rB )r rH r- Z list_memberZ element_docsr r r r� s z ParamShorthandDocGen._list_docsc C s� |j }|�|jj� z| �|j|�}W |�� n
|�� 0 d||f }|jrr|sr|d7 }|jD ]}|d| 7 }q^n |r~d| }|S )NzKeyName1=%s,KeyName2=%sz
Where valid key names are:
z %s
�{%s})r r= r$ r" r� r? �enum)r rH r- �kZ
value_docs�startr� r r r r� s
z ParamShorthandDocGen._map_docsc C sP g }|j �� D ]&\}}t|�r q|�| �|||�� qd�|�}|sH|S d| S )N�,r� )r@ �itemsr
r= � _member_docsr )r rH r- �partsr" Z member_shapeZ
inner_partr r r r� , s
z$ParamShorthandDocGen._structure_docsc C sP |� |j�dkrdS |�|j� z| �||�}W |�� n
|�� 0 d||f S )Nr z( ... recursive ... )z%s=%s)�countr" r= r� r? )r r" �shaper- Z value_docr r r r� 7 s z!ParamShorthandDocGen._member_docsN)r r r �__doc__�objectr� r� r� r� r� r� r� r� r� r� r r r r r� � s $ r� )rb )%r� Zloggingrf Zbotocore.compatr r Zbotocore.utilsr Zawsclir r r Z awscli.utilsr r r
Z getLoggerr~ � Exceptionr r r r! r) r. r, rI rQ rG rR rT rS rp ro rq ru r� r r r r �<module>
s4
"