File: //usr/lib/python3/dist-packages/awscli/bcdoc/__pycache__/docstringparser.cpython-310.pyc
o
.&�a � @ s� d dl mZ G dd� dejjj�ZG dd� de�ZG dd� de�ZG dd � d e�Z G d
d � d e �Z
G d d
� d
e
�Z G dd� de�Z dS )� )�sixc @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dS )�DocStringParserz�
A simple HTML parser. Focused on converting the subset of HTML
that appears in the documentation strings of the JSON models into
simple ReST format.
c C s d | _ || _tjjj�| � d S �N)�tree�docr �moves� html_parser�
HTMLParser�__init__��selfr � r
�>/usr/lib/python3/dist-packages/awscli/bcdoc/docstringparser.pyr
s zDocStringParser.__init__c C s t jjj�| � t| j�| _d S r )r r r r �reset�HTMLTreer r �r r
r
r r s zDocStringParser.resetc C s, t jjj�| |� | j�� t| j�| _d S r ) r r r r �feedr �writer r �r �datar
r
r r s
zDocStringParser.feedc C s* t jjj�| � | j�� t| j�| _d S r ) r r r r �closer r r r r r
r
r r & s
zDocStringParser.closec C s | j j||d� d S )N)�attrs�r �add_tag)r �tagr r
r
r �handle_starttag, � z DocStringParser.handle_starttagc C s | j j|dd� d S )NF)�is_startr )r r r
r
r �
handle_endtag/ r z DocStringParser.handle_endtagc C s | j �|� d S r )r �add_datar r
r
r � handle_data2 � zDocStringParser.handle_dataN) �__name__�
__module__� __qualname__�__doc__r
r r r r r r r
r
r
r r s r c @ s: e Zd ZdZdd� Zddd�Zdd � Zd
d � Zd d
� ZdS )r z�
A tree which handles HTML nodes. Designed to work with a python HTML parser,
meaning that the current_node will be the most recently opened tag. When
a tag is closed, the current_node moves up to the parent node.
c C s || _ t� | _| j| _g | _d S r )r �StemNode�head� current_node�unhandled_tagsr r
r
r r
< s
zHTMLTree.__init__NTc C s` | � ||�s| j�|� d S |r)|dkrt|�}nt||�}| j�|� || _d S | jj| _d S �N�li)�_doc_has_handlerr) �append� LineItemNode�TagNoder( � add_child�parent)r r r r �noder
r
r r B s
zHTMLTree.add_tagc C s$ |rd| }nd| }t | jj|�S )N�start_%s�end_%s)�hasattrr �style)r r r � handler_namer
r
r r, Q s
zHTMLTree._doc_has_handlerc C s | j �t|�� d S r )r( r0 �DataNoder r
r
r r Y r zHTMLTree.add_datac C s | j �| j� d S r )r' r r r r
r
r r \ s zHTMLTree.write)NT) r" r# r$ r% r
r r, r r r
r
r
r r 6 s
r c @ s e Zd Zddd�Zdd� ZdS )�NodeNc C s
|| _ d S r )r1 �r r1 r
r
r r
a s
z
Node.__init__c C s t �r )�NotImplementedErrorr r
r
r r d s z
Node.writer )r" r# r$ r
r r
r
r
r r9 ` s
r9 c s6 e Zd Zd
� fdd� Zdd� Zdd� Zdd � Z� ZS ) r& Nc s t t| ��|� g | _d S r )�superr& r
�childrenr: �� __class__r
r r
i s
zStemNode.__init__c C s | |_ | j�|� d S r )r1 r= r- )r �childr
r
r r0 m s zStemNode.add_childc C s | � |� d S r )�_write_childrenr r
r
r r q s zStemNode.writec C s | j D ]}|�|� qd S r )r= r )r r r@ r
r
r rA t s
�zStemNode._write_childrenr )r" r# r$ r
r0 r rA �
__classcell__r
r
r> r r& h s
r& c s: e Zd ZdZd � fdd� Zdd� Zdd� Zd d
� Z� ZS ) r/ zP
A generic Tag node. It will verify that handlers exist before writing.
Nc s t t| ��|� || _|| _d S r )r< r/ r
r r )r r r r1 r> r
r r
} s
zTagNode.__init__c C s" | � |� | �|� | �|� d S r )� _write_startrA �
_write_endr r
r
r r � s
z
TagNode.writec C s0 d| j }t|j|�rt|j|�| j� d S d S )Nr3 )r r5 r6 �getattrr �r r r7 r
r
r rC � s
�zTagNode._write_startc C s, d| j }t|j|�rt|j|�� d S d S )Nr4 )r r5 r6 rE rF r
r
r rD � s
�zTagNode._write_end�NN) r" r# r$ r% r
r rC rD rB r
r
r> r r/ y s r/ c s2 e Zd Zd� fdd� Z� fdd�Zdd� Z� ZS ) r. Nc s t t| ��d||� d S r* )r< r. r
)r r r1 r> r
r r
� s zLineItemNode.__init__c s | � | � tt| ��|� d S r )�_lstripr< r. r r r> r
r r � s
zLineItemNode.writec C sD |j D ] }t|t�r|�� |jr dS q| �|�}|r dS qdS )z�
Traverses the tree, stripping out whitespace until text data is found
:param node: The node to strip
:return: True if non-whitespace data was found, False otherwise
TF)r= �
isinstancer8 �lstripr rH )r r2 r@ �foundr
r
r rH � s
�
�zLineItemNode._lstriprG )r" r# r$ r
r rH rB r
r
r> r r. � s r. c s2 e Zd ZdZd � fdd� Zdd� Zdd� Z� ZS )
r8 z0
A Node that contains only string data.
Nc s6 t t| ��|� t|tj�stdt|� ��|| _d S )Nz Expecting string type, %s given.) r< r8 r
rI r � string_types�
ValueError�typer )r r r1 r> r
r r
� s
zDataNode.__init__c C s | j �� | _ d S r )r rJ r r
r
r rJ � r! zDataNode.lstripc C s` | j sd S | j �� r
d}n | j d �� }| j �� }|�|�}d�|�}|r)|d7 }|�|� d S )N� ���)r �isspace�split�translate_words�joinr )r r �str_data� end_space�wordsr
r
r r � s
zDataNode.writer )r" r# r$ r% r
rJ r rB r
r
r> r r8 � s
r8 N)
�botocore.compatr r r r r �objectr r9 r& r/ r. r8 r
r
r
r �<module> s &*