|
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`! � @ sp d dl Z d dlmZ d dlmZ d dlmZ d dlZd dl m
Z
d dl m Z m
Z
d dlmZ G dd � d e�ZdS )
� N)�DocumentStructure)�ServiceDocumenter)�DataNotFoundError)�Boto3ClientDocumenter)�ResourceDocumenter�ServiceResourceDocumenter)�ServiceContextc sl e Zd Zej�ej�ej�d�Z � fdd�Z
dd� Z dd� Z dd � Z
d
d � Zd d
� Zdd� Zdd� Z� ZS )r �examplesc sp t � j||j|d� || _| j�|�| _d | _| j| j�� krL| j� |�| _dddddddg| _
|| _ d | _ d S )
N)� service_name�session�root_docs_path�title�client�
paginators�waiters� resourcesr �context-paramszLhttps://boto3.amazonaws.com/v1/documentation/api/latest/guide/resources.html)
�super�__init__�_session�_boto3_sessionr �_client�_service_resource�
_service_nameZget_available_resources�resource�sections�_root_docs_path�_USER_GUIDE_LINK)�selfr
r r �� __class__� �?/opt/cppython/lib/python3.8/site-packages/boto3/docs/service.pyr s* �� �zServiceDocumenter.__init__c C s� t | j| jdd�}| �|�d�� | �|�d�� | �|�d�� | �|�d�� | jrh| � |�d�� | �
|�d�� |�d �}| � |� |� � S )
ziDocuments an entire service.
:returns: The reStructured text of the documented service.
�html)Z
section_names�targetr
r r r r r r )
r r r r
Z get_section�
client_apiZ
paginator_apiZ
waiter_apir �resource_section�_document_examplesZclient_context_paramsZflush_structure)r Z
doc_structureZcontext_params_sectionr! r! r" �document_service9 s �
z"ServiceDocumenter.document_servicec C sD d }z| � | j�}W n tk
r( Y nX t| j| j|��|� d S )N)Z get_examplesr r r r r Zdocument_client)r �sectionr r! r! r" r% M s ��z ServiceDocumenter.client_apic C s� |j �d� |j �� |�d� |j jd| jd� |�d� |j �� |j �� |�d� |j �� |j �� | �|� | �|� d S )NZ Resourcesz�Resources are available in boto3 via the ``resource`` method. For more detailed instructions and examples on the usage of resources, see the resources z
user guide)r
�link�.z The available resources are:) �style�h2�new_line�writeZ
external_linkr Ztoctree�_document_service_resource�_document_resources)r r) r! r! r" r& X s"
��
z"ServiceDocumenter.resource_sectionc C s� t ddd�}|�d�}|j�| jjjd| j� �� |�d� t | j
| j | j ��
|� | j
jjj}|| jkrnd}tj�| j | j� |�� � �}|�|d� |j�| j� d|� d �� d S )
Nzservice-resourcer# �r$ �
breadcrumb�../../z / Resource / ServiceResource�index�/�/index)r �add_new_sectionr, �refr r �__name__r r/ r r r r �document_resource�meta�resource_model�name�os�path�join�lower�
write_to_file�tocitem)r r) Zservice_resource_doc�breadcrumb_section�
resource_name�service_resource_dir_pathr! r! r" r0 n s6 �
�
��
� z,ServiceDocumenter._document_service_resourcec
C sZ d}| j �d�}|�| jd�}| jjjjj}|d D �] }|d | }| jj j
||t | j|d |d d�d�}|jj j
} g }
| D ]} |
�|� q~||
d| ji�} | jj j�� }t|dd �}
|
�d
�}|j�| jjjd | j� �� |�d | jj j� �� t| | j | j��|
�| jj j�� t j � | j| j� |� �}|
� |d
� |j� | j� d|� d�� q4d S )NZfooZ data_loaderz resources-1r )r
Zresource_json_definitions�
service_modelZservice_waiter_model)rF Z single_resource_json_definitionZservice_contextr r# r2 r3 r4 z / Resource / r5 r6 r7 )!r Z
get_componentZload_service_modelr r r< r rH r Zresource_factoryZload_from_definitionr r= � identifiers�appendr r> rB r r8 r, r9 r r: r/ r r r; r? r@ rA rC rD )r r) Ztemp_identifier_value�loaderZjson_resource_modelrH rF r= Z resource_clsrI �args�_r Z resource_docrE rG r! r! r" r1 � sj � ����
�� ��� �z%ServiceDocumenter._document_resourcesc C s t j�t j�| j| jd ��S )Nz.rst)r? r@ �realpathrA � EXAMPLE_PATHr )r r! r! r" �_get_example_file� s �z#ServiceDocumenter._get_example_filec C sP | � � }tj�|�rL|j�d� |j�� t|��}|�|� � � W 5 Q R X d S )NZExamples)
rP r? r@ �isfiler, r- r. �openr/ �read)r r) Z
examples_file�fr! r! r" r' � s
z$ServiceDocumenter._document_examples)r: �
__module__� __qualname__r? r@ rA �dirname�boto3�__file__rO r r( r% r& r0 r1 rP r' �
__classcell__r! r! r r" r s 7r )r? Zbotocore.docs.bcdoc.restdocr Zbotocore.docs.servicer ZBaseServiceDocumenterZbotocore.exceptionsr rX Zboto3.docs.clientr Zboto3.docs.resourcer r Z boto3.utilsr r! r! r! r" �<module>
s