HEX
Server: LiteSpeed
System: Linux php-prod-1.spaceapp.ru 5.15.0-157-generic #167-Ubuntu SMP Wed Sep 17 21:35:53 UTC 2025 x86_64
User: xnsbb3110 (1041)
PHP: 8.1.33
Disabled: NONE
Upload Files
File: //usr/local/CyberCP/lib/python3.10/site-packages/boto3/docs/__pycache__/resource.cpython-310.pyc
o

�h;�@s�ddlZddlmZddlmZddlmZddlmZddl	m
Z
mZmZddl
mZddlmZdd	lmZdd
lmZmZmZmZddlmZGdd
�d
e�ZGdd�de�ZdS)�N)�
xform_name)�DocumentStructure)�get_official_service_name)�ActionDocumenter)�document_attribute�document_identifier�document_reference)�BaseDocumenter)�CollectionDocumenter)�SubResourceDocumenter)�add_resource_type_overview�!get_identifier_args_for_signature�get_identifier_description�!get_identifier_values_for_example)�WaiterResourceDocumentercs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Z�ZS)!�ResourceDocumentercs>t��|�||_||_|j��|_|j|jkrd|_dSdS)Nzservice-resource)�super�__init__�_botocore_session�_root_docs_path�_resource_name�lower�_resource_sub_path�
_service_name)�self�resource�botocore_session�root_docs_path��	__class__��F/usr/local/CyberCP/lib/python3.10/site-packages/boto3/docs/resource.pyr&s
�zResourceDocumenter.__init__cCsh|�|�|�|�|�|�|�|�|�|�|�|�|�|�|�|�|�|�|�	|�dS)N)
�
_add_title�_add_resource_note�
_add_intro�_add_identifiers�_add_attributes�_add_references�_add_actions�_add_sub_resources�_add_collections�_add_waiters�r�sectionr r r!�document_resource.s








z$ResourceDocumenter.document_resourcecCs|�d�}|j�|j�dS)N�title)�add_new_section�style�h2r�rr-�
title_sectionr r r!r":s
zResourceDocumenter._add_titlec
Cs�g}|jjr|jjD]}|�|j�q
t|�}|�d�}|jj|j�d|�d�d�|�d�}|�	|�|�d�}|�
||�|�d�}|�||�|�d�}	|	j��dS)	N�start_class�(�))�
class_name�description�example�params�	end_class)
�_resource_model�identifiers�append�namer
r0r1�start_sphinx_py_classr8�_add_description�_add_example�_add_params_description�end_sphinx_py_class)
rr-�identifier_names�
identifier�
class_argsr5�description_section�example_section�
param_sectionr<r r r!r$>s"
�




zResourceDocumenter._add_introcCs&t|j�}|�d|�d|j���dS)NzA resource representing an � )r�_service_model�writer�rr-�official_service_namer r r!rB[s
�z#ResourceDocumenter._add_descriptionc
Cs�|j��|j��|�d�|j��|j��|�|j�d|j�d��|j��t|�}|�t|j��d|j�d|j�d|�d��|j��dS)N�import boto3� = boto3.resource('�')z = �.r6r7)	r1�start_codeblock�new_linerNrrrr�
end_codeblock)rr-rF�example_valuesr r r!rCas




�
$�zResourceDocumenter._add_examplecCsV|D]&}t|j|�}|�d|�d��|j��|�d|�d|���|j��qdS)Nz:type z: stringz:param z: )rrrNr1rV)rr-rF�identifier_namer9r r r!rDqs�
�z*ResourceDocumenter._add_params_descriptioncCsR|j��|�d|�d��|j��|j��|j|D]	}|j�|��qdS)Nz#These are the resource's available �:)r1rVrN�toctree�
member_map�tocitem)rr-�resource_member_type�memberr r r!�_add_overview_of_member_type{s

�

�z/ResourceDocumenter._add_overview_of_member_typec	Cs|jjjj}|�d�}g}|r||jd<t|dddd�|D]U}|�|j�t	|jdd�}|�d�}|j
�|jd	�|�
d
|j���|�|j�|j|jd|j�d�id
�}t||j|d�tj�|j|j�|j��}|�||j�q|r~|�|d�dSdS)Nr>�IdentifierszYIdentifiers are properties of a resource that are set upon instantiation of the resource.�identifiers_attributes_intro�r-�
resource_typer9�
intro_link�html��target�
breadcrumb�indexz / Identifier / �	qualifierrT��context)r-�
resource_name�identifier_model)�	_resource�meta�resource_modelr>r0r\rr?r@rr1�ref�_resource_class_namerN�add_title_sectionr8rr�os�path�joinrrr�
write_to_filer`)	rr-r>�member_listrG�identifier_doc�breadcrumb_section�identifier_section�identifiers_dir_pathr r r!r%�sH

�	
����z#ResourceDocumenter._add_identifiersc
	CsJ|jjjjj}i}|jjjjr |�|jjjj�}|jjj�|�}|�d�}g}|r6t	|dddd�||j
d<t|�D]^}||\}}|�|�t
|dd�}	|	�d�}
|
j�|jd	�|
�d
|���|	�|�|	j|d|j�d�id
�}t||j|j||jjjjj|d�tj�|j|j�|j��}|	�||�q:|r�|�|d�dSdS)N�
attributes�
Attributesz�Attributes provide access to the properties of a resource. Attributes are lazy-loaded the first time one is accessed via the :py:meth:`load` method.rbrcrfrgrirjz / Attribute / rkrTrl)r-�service_namern�	attr_name�
event_emitter�
attr_model)rprq�client�
service_modelrr�shape�	shape_for�get_attributesr0rr\�sortedr?rr1rsrtrNrur8rrr�eventsrvrwrxrrryr`)
rr-r�rr��attribute_listr��_�
attr_shape�
attribute_docr|�attribute_section�attributes_dir_pathr r r!r&�s`
�
�
�



��
��z"ResourceDocumenter._add_attributesc	Cs�|�d�}|jjjj}g}|rt|dddd�||jd<|D]S}|�|j�t	|jdd�}|�d�}|j
�|jd	�|�
d
|j���|�|j�|j|jd|j�d�id
�}t||d�tj�|j|j�|j��}|�||j�q|r||�|d�dSdS)N�
references�
ReferenceszNReferences are related resource instances that have a belongs-to relationship.�references_introrcrfrgrirjz / Reference / rkrTrl)r-�reference_model)r0rprqrrr�rr\r?r@rr1rsrtrNrur8rrvrwrxrrrryr`)	rr-r��reference_list�	reference�
reference_docr|�reference_section�references_dir_pathr r r!r'�sF
�
	
����z"ResourceDocumenter._add_referencescC�N|�d�}|jjjj}|r%t|j|j�}|j|_|�|�|�	|d�dSdS)N�actions)
r0rprqrrr�rrr\�document_actionsr`)rr-r��
documenterr r r!r(s

�zResourceDocumenter._add_actionscCr�)Nz
sub-resources)
r0rprqrr�subresourcesrrr\�document_sub_resourcesr`)rr-�
sub_resourcesr�r r r!r)�
�
�z%ResourceDocumenter._add_sub_resourcescCr�)N�collections)
r0rprqrrr�r
rr\�document_collectionsr`)rr-r�r�r r r!r*(r�z#ResourceDocumenter._add_collectionscCs^|�d�}|jjjj}|r-|j�|j�}t|j||j	�}|j
|_
|�|�|�|d�dSdS)N�waiters)
r0rprqrrr�r�get_waiter_modelrrrr\�document_resource_waitersr`)rr-r��service_waiter_modelr�r r r!r+3s
�
�
�zResourceDocumenter._add_waiterscCs,|�d�}|j��|�d�|j��dS)Nzfeature-freezez�Before using anything on this page, please refer to the resources :doc:`user guide <../../../../guide/resources>` for the most recent guidance on using resources.)r0r1�
start_noterN�end_noter,r r r!r#As

�z%ResourceDocumenter._add_resource_note)�__name__�
__module__�__qualname__rr.r"r$rBrCrDr`r%r&r'r(r)r*r+r#�
__classcell__r r rr!r%s"

,9*	rc@s0eZdZedd��Zdd�Zdd�Zdd�Zd	S)
�ServiceResourceDocumentercCs|j�d�S)Nz.ServiceResource)�_service_docs_name)rr r r!r8Msz$ServiceResourceDocumenter.class_namecCs|�d�}|j�d�dS)Nr/zService Resource)r0r1r2r3r r r!r"Qs
z$ServiceResourceDocumenter._add_titlecCst|j�}|�d|���dS)NzA resource representing )rrMrNrOr r r!rBUs
z*ServiceResourceDocumenter._add_descriptioncCsZ|j��|j��|�d�|j��|j��|�|j�d|j�d��|j��dS)NrQrRrS)r1rUrVrNrrW)rr-rFr r r!rCYs




�z&ServiceResourceDocumenter._add_exampleN)r�r�r��propertyr8r"rBrCr r r r!r�Ls
r�)rv�botocorer�botocore.docs.bcdoc.restdocr�botocore.docs.utilsr�boto3.docs.actionr�boto3.docs.attrrrr�boto3.docs.baser	�boto3.docs.collectionr
�boto3.docs.subresourcer�boto3.docs.utilsrr
rr�boto3.docs.waiterrrr�r r r r!�<module>s)