|
Server : LiteSpeed System : Linux server51.dnsbootclub.com 4.18.0-553.62.1.lve.el8.x86_64 #1 SMP Mon Jul 21 17:50:35 UTC 2025 x86_64 User : nandedex ( 1060) PHP Version : 8.1.33 Disable Function : NONE Directory : /opt/cppython/lib/python3.8/site-packages/boto3/docs/__pycache__/ |
U
Q��g� � @ sn d dl Z d dlmZ d dlmZ d dlmZ d dlmZ d dl m
Z
m Z m Z m
Z
G dd� de�Zd d
d �ZdS )
� N)�
xform_name)�DocumentStructure)�get_service_module_name)�NestedDocumenter)�add_resource_type_overview�!get_identifier_args_for_signature�get_identifier_description�!get_identifier_values_for_examplec @ s e Zd Zdd� ZdS )�SubResourceDocumenterc C s� t |dddd� t| jjjjdd� d�}g }|| jd< |D ]�}|�|j� t |jd d
�}|�
d �}|j � | j
d � |�d
|j� �� |�|j� |j
|jd| j� d�id�}t|| j|| jd� tj�| j| j� | j� �}|�||j� q:d S )Nz
Sub-resourcesz�Sub-resources are methods that create a new instance of a child resource. This resource's identifiers get passed along to the child.Zsubresources_intro)�sectionZ
resource_type� descriptionZ
intro_linkc S s | j S )N)�name)� sub_resource� r �C/opt/cppython/lib/python3.8/site-packages/boto3/docs/subresource.py�<lambda>* � z>SubResourceDocumenter.document_sub_resources.<locals>.<lambda>)�keyz
sub-resources�html)�targetZ
breadcrumb�indexz / Sub-Resource / � qualifier�.)�context)r �
resource_name�sub_resource_model�
service_model)r �sortedZ _resource�metaZresource_modelZ subresources�
member_map�appendr
r �add_new_section�style�refZ_resource_class_name�writeZadd_title_section�
class_name�document_sub_resourceZ_resource_nameZ_service_model�os�path�joinZ_root_docs_pathZ
_service_nameZ_resource_sub_pathZ
write_to_file) �selfr Z
sub_resourcesZsub_resources_listr Zsub_resource_docZbreadcrumb_sectionZsub_resource_sectionZsub_resources_dir_pathr r r �document_sub_resources sR �
�
�
�� � �z,SubResourceDocumenter.document_sub_resourcesN)�__name__�
__module__� __qualname__r+ r r r r r
s r
Tc C s� g }|j jD ] }|jdkr |�t|j�� q |r^t|�}| j�dd�� |j � �}| j
� ||� | � d�} d|j j
� d�}
| �|
� | � d�} t|�} t|�}
|j|kr�|}
t|j j
�� d|
� d |j � d
| � d �}| j
�� | �|� | j
�� | � d �}|D ]L}t|j |�}
|�d
|� d�� |j
�� |�d|� d|
� �� |j
�� q�| � d�}|j
�� |�dt|�� d |j j
� d�� |j
�� |�d|j j
� d�� |j
�� dS )aj Documents a resource action
:param section: The section to write to
:param resource_name: The name of the resource
:param sub_resource_model: The model of the subresource
:param service_model: The model of the service
:param include_signature: Whether or not to include the signature.
It is useful for generating docstrings.
�inputr � z method-introz
Creates a z
resource.�examplez = r �(�)�paramsz:type z: stringz:param z: �returnz:rtype: :py:class:`�`z :returns: A z resourceN)�resourceZ identifiers�sourcer r r r r �getr
r" Zstart_sphinx_py_methodr! �typeZinclude_doc_stringr � service_nameZstart_codeblockr$ Z
end_codeblockr �new_liner )r r r r Zinclude_signatureZidentifiers_needed�
identifierZsignature_argsZfull_sub_resource_nameZmethod_intro_sectionr Zexample_sectionZexample_valuesZexample_resource_namer1 Z
param_sectionZreturn_sectionr r r r& O sX
� �
&
�
�
�r& )T)r' Zbotocorer Zbotocore.docs.bcdoc.restdocr Zbotocore.utilsr Zboto3.docs.baser Zboto3.docs.utilsr r r r r
r& r r r r �<module>
s 8 �