File: //opt/alt/python37/lib/python3.7/site-packages/boto3/docs/__pycache__/subresource.cpython-37.pyc
B
�P�e� � @ 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< x�|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<W 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 �G/opt/alt/python37/lib/python3.7/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 s@
z,SubResourceDocumenter.document_sub_resourcesN)�__name__�
__module__� __qualname__r+ r r r r r
s r
Tc C s� g }x*|j jD ] }|jdkr|�t|j�� qW |rbt|�}| j�dd�� |j � �}| j
� ||� | � d�} d|j j
� d�}
| �|
� | � d�} t|�} t|�}
|j|kr�|}
d�t|j j
�|
|j | �}| j
�� | �|� | j
�� | � d �}xT|D ]L}t|j |�}
|�d
|� d �� |j
�� |�d |� d
|
� �� |j
�� q�W | � d�}|j
�� |�d�t|�|j j
�� |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{} = {}.{}({})�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_name�formatZstart_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 sV
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