File: //lib/python3/dist-packages/awscli/customizations/__pycache__/addexamples.cpython-310.pyc
o
.&�a � @ 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� |�rI| j j
�d� t|�}|�� D ]
}| j �|� q@d S d S )N�examples�.z.rstz Looking for example file at: %s�Examples)�os�path�join�dirname�abspath�__file__� event_class�replace�sep�LOG�debug�isfile�doc�style�h2�open� readlines�write)� help_command�kwargs�doc_path�fp�line� r �C/usr/lib/python3/dist-packages/awscli/customizations/addexamples.py� add_examples$ s(
���� �r )�__doc__r �logging� getLogger�__name__r r r r r r �<module> s