File: //opt/alt/python37/lib/python3.7/site-packages/boto3/docs/__pycache__/service.cpython-37.pyc
B
�P�e`! � @ 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 zcontext-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__� �C/opt/alt/python37/lib/python3.7/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 zcontext-params)
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 }y| � | 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" �
breadcrumbz../../z / Resource / ServiceResource�index�/z/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 r. n s$
z,ServiceDocumenter._document_service_resourcec
C sd d}| j �d�}|�| jd�}| jjjjj}�x0|d D �]"}|d | }| jj j
||t | j|d |d d�d�}|jj j
} g }
x| D ]} |
�|� q�W ||
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�� q8W d S )NZfooZ data_loaderz resources-1r )r
Zresource_json_definitions�
service_modelZservice_waiter_model)rA Z single_resource_json_definitionZservice_contextr r! )r" r0 z../../z / Resource / r1 r2 z/index)!r Z
get_componentZload_service_modelr r r7 r rC r Zresource_factoryZload_from_definitionr r8 � identifiers�appendr r9 r= r r3 r* r4 r r5 r- r r r6 r: r; r< r> r? )r r' Ztemp_identifier_value�loaderZjson_resource_modelrC rA r8 Z resource_clsrD �args�_r Z resource_docr@ rB r r r r/ � sL
z%ServiceDocumenter._document_resourcesc C s t j�t j�| j| jd ��S )Nz.rst)r: r; �realpathr< � EXAMPLE_PATHr )r r r r �_get_example_file� s z#ServiceDocumenter._get_example_filec C sP | � � }tj�|�rL|j�d� |j�� t|��}|�|� � � W d Q R X d S )NZExamples)
rK r: r; �isfiler* r+ r, �openr- �read)r r' Z
examples_file�fr r r r% � s
z$ServiceDocumenter._document_examples)r5 �
__module__� __qualname__r: r; r< �dirname�boto3�__file__rJ r r& r# r$ r. r/ rK r% �
__classcell__r r )r r r s 7r )r: Zbotocore.docs.bcdoc.restdocr Zbotocore.docs.servicer ZBaseServiceDocumenterZbotocore.exceptionsr rS Zboto3.docs.clientr Zboto3.docs.resourcer r Z boto3.utilsr r r r r �<module>
s