Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
awscli
/
bcdoc
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: restdoc.cpython-310.pyc
o .&�a, � @ sZ d dl Z d dlmZ d dlmZ d dlmZ e �d�ZG dd� de �Z G dd � d e �Z dS ) � N)� OrderedDict)�DocStringParser)� ReSTStyle�bcdocsc @ sn e Zd Zddd�Zdd� Zdd� Zdd � Zd d � Zd d � Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� ZdS ) � ReSTDocument�manc C sB t | �| _|| _t| �| _d| _d| _i | _i | _g | _ d | _ d S )NTF) r �style�targetr �parser� keep_data�do_translation�translation_map�hrefs�_writes�_last_doc_string)�selfr � r �6/usr/lib/python3/dist-packages/awscli/bcdoc/restdoc.py�__init__ s zReSTDocument.__init__c C s& | j r|d ur| j�|� d S d S d S �N)r r �append�r �sr r r �_write# s �zReSTDocument._writec C s | � |� dS )z2 Write content into the document. N)r �r �contentr r r �write' s zReSTDocument.writec C s | � d| j�� |f � dS )z- Write content on a newline. z%s%s N)r r �spacesr r r r �writeln- s zReSTDocument.writelnc C s | j d S )zn Returns the last content written to the document without removing it from the stack. ����r �r r r r � peek_write3 s zReSTDocument.peek_writec C s | j �� S )zL Removes and returns the last content written to the stack. )r �popr! r r r � pop_write: s zReSTDocument.pop_writec C s | j �|� dS )z2 Places new content on the stack. N)r r r r r r � push_write@ s zReSTDocument.push_writec C sD | j r| j�� | j �� D ] \}}| j�||� q d�| j��d�S )zJ Returns the current content of the document as a string. � �utf-8)r r � new_paragraph�items�link_target_definition�joinr �encode)r �refname�linkr r r �getvalueF s zReSTDocument.getvaluec s � fdd�|D �S )Nc s g | ] }� j �||��qS r )r �get)�.0�wr! r r � <listcomp>Q s z0ReSTDocument.translate_words.<locals>.<listcomp>r )r �wordsr r! r �translate_wordsP � z ReSTDocument.translate_wordsc C s |r | j r| �|� d S d S d S r )r r )r �datar r r � handle_dataS s �zReSTDocument.handle_datac C sp |r6z t | j�}| j�|� | j�� t | j�}||f| _W d S ty5 tjddd� t�|� Y d S w d S )NzError parsing doc stringT)�exc_info) �lenr r �feed�closer � Exception�LOG�debug)r � doc_string�start�endr r r �include_doc_stringW s ��z ReSTDocument.include_doc_stringc C s( | j d ur| j \}}| j||�= d S d S r )r r )r rA rB r r r �remove_last_doc_stringc s �z#ReSTDocument.remove_last_doc_stringN)r )�__name__� __module__� __qualname__r r r r r" r$ r% r/ r5 r8 rC rD r r r r r s r c s� e Zd Zd � fdd� Zedd� �Zedd� �Zejd d� �Zed d � �Zed d � �Z dd� Z d dd�Z dd� Z dd� Z dd� Zdd� Zdd� Zd d � Z� ZS ) �DocumentStructureNr c sX t t| �j|d� || _t� | _| jg| _i | _|dur || _|dur*| �|� dS dS )a5 Provides a Hierarichial structure to a ReSTDocument You can write to it similiar to as you can to a ReSTDocument but has an innate structure for more orginaztion and abstraction. :param name: The name of the document :param section_names: A list of sections to be included in the document. :param target: The target documentation of the Document structure :param context: A dictionary of data to store with the strucuture. These are only stored per section not the entire structure. )r N) �superrH r �_namer � _structure�_path�_context�_generate_structure)r �name� section_namesr �context�� __class__r r r k s �zDocumentStructure.__init__c C � | j S )z"The name of the document structure)rJ r! r r r rO � s zDocumentStructure.namec C rT )zv A list of where to find a particular document structure in the overlying document structure. �rL r! r r r �path� s zDocumentStructure.pathc C s || _ d S r rU )r �valuer r r rV � � c C s t | j�S r )�listrK r! r r r �available_sections� rX z$DocumentStructure.available_sectionsc C rT r )rM r! r r r rQ � s zDocumentStructure.contextc C s |D ]}| � |� qd S r )�add_new_section)r rP � section_namer r r rN � s �z%DocumentStructure._generate_structurec C sJ | j || j|d�}| j|g |_| jj|j_| j|_| j|_|| j|< |S )a� Adds a new section to the current document structure This document structure will be considered a section to the current document structure but will in itself be an entirely new document structure that can be written to and have sections as well :param name: The name of the section. :param context: A dictionary of data to store with the strucuture. These are only stored per section not the entire structure. :rtype: DocumentStructure :returns: A new document structure to add to but lives as a section to the document structure it was instantiated from. )rO r rQ )rS r rV r � indentationr r rK )r rO rQ �sectionr r r r[ � s � z!DocumentStructure.add_new_sectionc C s | j | S )zRetrieve a section�rK �r rO r r r � get_section� rX z DocumentStructure.get_sectionc C s | j |= dS )zDelete a sectionNr_ r` r r r �delete_section� s z DocumentStructure.delete_sectionc C sl t | j�dkr | jr | j�� | j�� D ] \}}| j�||� q| �� }| j�� D ] \}}||� � 7 }q)|S )z�Flushes a doc structure to a ReSTructed string The document is flushed out in a DFS style where sections and their subsections' values are added to the string as they are visited. � ) r: rV r r r( r) r* r/ rK �flush_structure)r r- r. rW rO r^ r r r rd � s z!DocumentStructure.flush_structurec C s d� | j��d�S )Nr& r' )r+ r r, r! r r r r/ � r6 zDocumentStructure.getvaluec C s t � | _d S r )r rK r! r r r �remove_all_sections� s z%DocumentStructure.remove_all_sectionsc C s g | _ d S r r r! r r r � clear_text� s z DocumentStructure.clear_text)Nr Nr )rE rF rG r �propertyrO rV �setterrZ rQ rN r[ ra rb rd r/ re rf � __classcell__r r rR r rH j s( rH ) �logging�botocore.compatr � awscli.bcdoc.docstringparserr �awscli.bcdoc.styler � getLoggerr> �objectr rH r r r r �<module> s T
Save
Cancel