o Jh+&@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. {} bcdocszResponse Syntaxi)name line_limitzResponse StructureizRequest Syntax 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_datado_translationtranslation_maphrefs_writes_last_doc_string)selfrr{/var/www/vedio/testing/chatpythonscript.ninositsolution.com/env/lib/python3.10/site-packages/botocore/docs/bcdoc/restdoc.py__init__3s   zReSTDocument.__init__cCs&|jr|dur|j|dSdSdSN)rrappendrsrrr_write>szReSTDocument._writecCs||dS)z2 Write content into the document. N)rrcontentrrrwriteBszReSTDocument.writecCs||j|ddS)z- Write content on a newline.  N)rrspacesr rrrwritelnHszReSTDocument.writelncCs |jdS)zn Returns the last content written to the document without removing it from the stack. rrrrr peek_writeNs zReSTDocument.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|jr|j|jD] \}}|j||q d|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_wordskzReSTDocument.translate_wordscCs |r |jr||dSdSdSr)rr)rdatarrr handle_datans zReSTDocument.handle_datacCsp|r6zt|j}|j||jt|j}||f|_WdSty5tjdddt|YdSwdS)NzError parsing doc stringT)exc_info) r*rrfeedcloser ExceptionLOGdebug)r doc_stringstartendrrrinclude_doc_stringrs     zReSTDocument.include_doc_stringcCs(|jdur|j\}}|j||=dSdSr)rr)rrHrIrrrremove_last_doc_string~s  z#ReSTDocument.remove_last_doc_stringN)r )__name__ __module__ __qualname__rrr"r%r)r,r-r7r=r@rJrKrrrrr 2s    r cseZdZd$fdd ZeddZeddZejd dZed d Zed d Z ddZ d%ddZ ddZ ddZ ddZd%ddZddZddZddZd d!Zd"d#ZZS)&DocumentStructureNr csTtj|d||_t|_|jg|_i|_|dur||_|dur(||dSdS)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. )rN)superr_namer _structure_path_context_generate_structure)rr section_namesrcontext __class__rrrs  zDocumentStructure.__init__cC|jS)z"The name of the document structure)rQr(rrrrszDocumentStructure.namecCrZ)zv A list of where to find a particular document structure in the overlying document structure. rSr(rrrpathszDocumentStructure.pathcCs ||_dSrr[)rvaluerrrr\ cCs t|jSr)listrRr(rrravailable_sectionsr^z$DocumentStructure.available_sectionscCrZr)rTr(rrrrWszDocumentStructure.contextcCs|D]}||qdSr)add_new_section)rrV section_namerrrrUs z%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. )rrrW)rYrr\r indentationrrrR)rrrWsectionrrrras  z!DocumentStructure.add_new_sectioncCs |j|S)zRetrieve a sectionrRrrrrr get_sectionr^zDocumentStructure.get_sectioncCs ||jvSrrerfrrr has_section zDocumentStructure.has_sectioncCs |j|=dS)zDelete a sectionNrerfrrrdelete_sections z DocumentStructure.delete_sectionc Cst|j}|dkr#|jr"|j|jD] \}}|j||qn |t|jdkr/d}| }|j D] \}}t | }|rO|ddn|}|||7}q8t|} t|j} |durm| 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*r\rrr0r1r2SECTION_METHOD_PATH_DEPTHr8r7rRDOCUMENTATION_LINK_REGEXsearchdecodegroupr4flush_structure splitlinesSECTION_LINE_LIMIT_CONFIGrDEFAULT_AWS_DOCS_LINKLARGE_SECTION_MESSAGEformat) r docs_link path_lengthr5r6r]rrdmatch line_countsection_config aws_docs_linkrrrrqs8    z!DocumentStructure.flush_structurecCsd|jdS)Nr.r/)r3rr4r(rrrr7 r>zDocumentStructure.getvaluecCs t|_dSr)rrRr(rrrremove_all_sections s z%DocumentStructure.remove_all_sectionscCs g|_dSrr'r(rrr clear_textrizDocumentStructure.clear_textcCs|d}|j||S)Ntitle)rarh1)rr title_sectionrrradd_title_sections  z#DocumentStructure.add_title_sectioncCshtj|s t|tj||d}t|d}||WddS1s-wYdS)Nz.rstwb)osr\existsmakedirsr3openr"rq)r full_path file_namesub_resource_file_pathfrrr write_to_files   "zDocumentStructure.write_to_file)Nr Nr)rLrMrNrpropertyrr\setterr`rWrUrargrhrjrqr7r}r~rr __classcell__rrrXrrOs.       *rO)loggingrrebotocore.compatr#botocore.docs.bcdoc.docstringparserrbotocore.docs.bcdoc.stylerrtcompilermru getLoggerrErsrlr rOrrrrs.     S