U m/e%@sddlZddlZddlZddlmZddlmZddlmZdZ e dZ dZ e dZd d d d d d dd d dd d dZddddZGdddZGdddeZdS)N) OrderedDict)DocStringParser) ReSTStylez&https://docs.aws.amazon.com/index.htmlzX`AWS API Documentation `_z **{}** :: # This section is too large to render. # Please see the AWS API Documentation linked below. {} ZbcdocszResponse Syntaxi)name line_limitzResponse StructureizRequest SyntaxZ Parameters)zresponse-example descriptionzrequest-examplezrequest-params)z client-apiz paginator-apiz waiter-apic@sneZdZdddZddZddZdd Zd d Zd d ZddZ ddZ ddZ ddZ ddZ ddZdS) ReSTDocumentmancCsBt||_||_t||_d|_d|_i|_i|_g|_ d|_ dS)NTF) rstyletargetrparser keep_dataZdo_translationtranslation_maphrefs_writes_last_doc_string)selfr r?/tmp/pip-unpacked-wheel-3gylhwtm/botocore/docs/bcdoc/restdoc.py__init__3s  zReSTDocument.__init__cCs|jr|dk r|j|dSN)rrappendrsrrr_write>szReSTDocument._writecCs||dS)z2 Write content into the document. N)rrcontentrrrwriteBszReSTDocument.writecCs||j|ddS)z- Write content on a newline.  N)rr spacesrrrrwritelnHszReSTDocument.writelncCs |jdS)zn Returns the last content written to the document without removing it from the stack. rrrrr peek_writeNszReSTDocument.peek_writecCst|jdkr|jSdS)zL Removes and returns the last content written to the stack. rN)lenrpopr%rrr pop_writeUszReSTDocument.pop_writecCs|j|dS)z2 Places new content on the stack. N)rrrrrr push_write[szReSTDocument.push_writecCsD|jr2|j|jD]\}}|j||qd|jdS)zJ Returns the current content of the document as a string. utf-8)rr new_paragraphitemslink_target_definitionjoinrencode)rrefnamelinkrrrgetvalueas  zReSTDocument.getvaluecsfdd|DS)Ncsg|]}j||qSr)rget).0wr%rr lsz0ReSTDocument.translate_words..r)rwordsrr%rtranslate_wordskszReSTDocument.translate_wordscCs|r|jr||dSr)rr)rdatarrr handle_datans zReSTDocument.handle_datacCsn|rjz8t|j}|j||jt|j}||f|_Wn,tk rhtjdddt|YnXdS)NzError parsing doc stringT)exc_info) r'rrfeedcloser ExceptionLOGdebug)rZ doc_stringstartendrrrinclude_doc_stringrs    zReSTDocument.include_doc_stringcCs$|jdk r |j\}}|j||=dSr)rr)rrCrDrrrremove_last_doc_string~s  z#ReSTDocument.remove_last_doc_stringN)r )__name__ __module__ __qualname__rrrr"r&r)r*r4r:r<rErFrrrrr 2s   r cseZdZd"fdd ZeddZeddZejd dZed d Zed d Z ddZ d#ddZ ddZ ddZ d$ddZddZddZddZddZd d!ZZS)%DocumentStructureNr csPtj|d||_t|_|jg|_i|_|dk r:||_|dk rL||dS)a5Provides 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)superr_namer _structure_path_context_generate_structure)rr section_namesr context __class__rrrs  zDocumentStructure.__init__cCs|jS)z"The name of the document structure)rLr%rrrrszDocumentStructure.namecCs|jS)zv A list of where to find a particular document structure in the overlying document structure. rNr%rrrpathszDocumentStructure.pathcCs ||_dSrrU)rvaluerrrrVscCs t|jSr)listrMr%rrravailable_sectionssz$DocumentStructure.available_sectionscCs|jSr)rOr%rrrrRszDocumentStructure.contextcCs|D]}||qdSr)add_new_section)rrQ section_namerrrrPsz%DocumentStructure._generate_structurecCsJ|j||j|d}|j|g|_|jj|j_|j|_|j|_||j|<|S)aAdds 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. )rr rR)rTr rVr indentationrrrM)rrrRsectionrrrrZs  z!DocumentStructure.add_new_sectioncCs |j|S)zRetrieve a sectionrMrrrrr get_sectionszDocumentStructure.get_sectioncCs |j|=dS)zDelete a sectionNr^r_rrrdelete_sectionsz DocumentStructure.delete_sectionc Cs t|j}|dkrF|jr^|j|jD]\}}|j||q,n|t|jdkr^d}| }|j D]@\}}t | }|r|ddn|}|||7}qpt|} t|j} |dk r| nt} | r| | dkrt| d| }|S)zFlushes 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. Nrz rr)r'rVrr r-r.r/SECTION_METHOD_PATH_DEPTHr5r4rMDOCUMENTATION_LINK_REGEXsearchdecodegroupr1flush_structure splitlinesSECTION_LINE_LIMIT_CONFIGrDEFAULT_AWS_DOCS_LINKLARGE_SECTION_MESSAGEformat) rZ docs_linkZ path_lengthr2r3rWrr]match line_countZsection_configZ aws_docs_linkrrrrhs4     z!DocumentStructure.flush_structurecCsd|jdS)Nr+r,)r0rr1r%rrrr4szDocumentStructure.getvaluecCs t|_dSr)rrMr%rrrremove_all_sections sz%DocumentStructure.remove_all_sectionscCs g|_dSrr$r%rrr clear_text szDocumentStructure.clear_textcCs|d}|j||S)Ntitle)rZr h1)rrrZ title_sectionrrradd_title_sections  z#DocumentStructure.add_title_sectionc CsRtj|st|tj||d}t|d}||W5QRXdS)Nz.rstwb)osrVexistsmakedirsr0openrrh)r full_path file_nameZsub_resource_file_pathfrrr write_to_files    zDocumentStructure.write_to_file)Nr N)N)N)rGrHrIrpropertyrrVsetterrYrRrPrZr`rarhr4rprqrtr} __classcell__rrrSrrJs*       *rJ)loggingrvreZbotocore.compatrZ#botocore.docs.bcdoc.docstringparserrZbotocore.docs.bcdoc.stylerrkcompilerdrl getLoggerrArjrcr rJrrrr s,    S