U
<�^ � @ s* d Z ddlZddlZe�e�Zdd� ZdS )aZ
Add authored examples to MAN and HTML documentation
---------------------------------------------------
This customization allows authored examples in ReST format to be
inserted into the generated help for an Operation. To get this to
work you need to:
* Register the ``add_examples`` function below with the
``doc-examples.*.*`` event.
* Create a file containing ReST format fragment with the examples.
The file needs to be created in the ``examples/<service_name>``
directory and needs to be named ``<service_name>-<op_name>.rst``.
For example, ``examples/ec2/ec2-create-key-pair.rst``.
� Nc K s� t j�t j�t j�t j�t���d�}t j�|| j�dt jj��}|d }t �
d|� t j�|�r�| jj
�d� t|�}|�� D ]}| j�|� q�d S )NZexamples�.z.rstzLooking for example file at: %sZExamples)�os�path�join�dirname�abspath�__file__Zevent_class�replace�sep�LOG�debug�isfile�docZstyleZh2�open� readlines�write)Zhelp_command�kwargsZdoc_path�fp�line� r �C/usr/lib/python3/dist-packages/awscli/customizations/addexamples.py�add_examples$ s$
����r )�__doc__r ZloggingZ getLogger�__name__r r r r r r �<module>
s