rPj+&ddlZddlZddlZddlmZddlmZddlmZdZ ejdZ dZ ejdZd d d d d d dd d dd d dZddddZGddZGddeZy)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-apicVeZdZddZdZdZdZdZdZdZ dZ d Z d Z d Z d Zy ) ReSTDocumentct||_||_t||_d|_d|_i|_i|_g|_ d|_ y)NTF) rstyletargetrparser keep_datado_translationtranslation_maphrefs_writes_last_doc_string)selfrs `/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/botocore/docs/bcdoc/restdoc.py__init__zReSTDocument.__init__3sMt_  %d+ #!  $cZ|jr||jj|yyyN)rrappendrss r_writezReSTDocument._write>s& >>am LL   ",>rc&|j|y)z2 Write content into the document. N)r"rcontents rwritezReSTDocument.writeBs Grc`|j|jj|dy)z- Write content on a newline.  N)r"rspacesr$s rwritelnzReSTDocument.writelnHs) tzz((*+G9B78rc |jdS)zn Returns the last content written to the document without removing it from the stack. rrs r peek_writezReSTDocument.peek_writeNs ||Brcjt|jdkDr|jjSdS)zL Removes and returns the last content written to the stack. rN)lenrpopr.s r pop_writezReSTDocument.pop_writeUs,&)%6%:t||!DDrc:|jj|y)z2 Places new content on the stack. N)rrr s r push_writezReSTDocument.push_write[s Arc|jrX|jj|jjD]!\}}|jj ||#dj |j jdS)zJ Returns the current content of the document as a string. utf-8)rr new_paragraphitemslink_target_definitionjoinrencode)rrefnamelinks rgetvaluezReSTDocument.getvalueaso :: JJ $ $ &!%!1!1!3 A  11'4@ Awwt||$++G44rc`|Dcgc]}|jj|| c}Scc}wr)rget)rwordsws rtranslate_wordszReSTDocument.translate_wordsks)8=>1$$((A.>>>s#+cF|r|jr|j|yyyr)rr")rdatas r handle_datazReSTDocument.handle_datans DNN KK #4rcR|rj t|j}|jj||jj t|j}||f|_yy#t $r/tjddtj|YywxYw)NzError parsing doc stringT)exc_info) r1rrfeedcloser ExceptionLOGdebug)r doc_stringstartends rinclude_doc_stringzReSTDocument.include_doc_stringrs  &DLL)   , !!#$,,'). %  & 4t D *% &sA(A..5B&%B&cZ|j|j\}}|j||=yyr)rr)rrQrRs rremove_last_doc_stringz#ReSTDocument.remove_last_doc_string~s2  ,..JE3 U3Y' -rN)man)__name__ __module__ __qualname__rr"r&r*r/r3r5r@rErHrSrUrrrr2s? %# 9  E  5? &(rrceZdZdfd ZedZedZejdZedZedZ dZ ddZ d Z d Z d Zdd Zd ZdZdZdZdZxZS)DocumentStructurect||||_t|_|jg|_i|_|||_||j|yy)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__s rrzDocumentStructure.__init__s_ ' %-jj\   #DM  $  $ $] 3 %rc|jS)z"The name of the document structure)r_r.s rrzDocumentStructure.nameszzrc|jS)zv A list of where to find a particular document structure in the overlying document structure. rar.s rpathzDocumentStructure.paths zzrc||_yrri)rvalues rrjzDocumentStructure.paths  rc,t|jSr)listr`r.s ravailable_sectionsz$DocumentStructure.available_sectionssDOO$$rc|jSr)rbr.s rrezDocumentStructure.contexts }}rc4|D]}|j|yr)add_new_section)rrd section_names rrcz%DocumentStructure._generate_structures) /L   . /rc|j||j|}|j|gz|_|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. )rrre)rfrrjr indentationrrr`)rrresections rrrz!DocumentStructure.add_new_sectionsx ..dkk7! yyD6) $(JJ$:$: !"&"6"6  'rc |j|S)zRetrieve a sectionr`rrs r get_sectionzDocumentStructure.get_sectionst$$rc||jvSrrxrys r has_sectionzDocumentStructure.has_sectionst&&rc|j|=y)zDelete a sectionNrxrys rdelete_sectionz DocumentStructure.delete_sections OOD !rcrt|j}|dk(re|jr|jj |jj D]!\}}|jj ||#n'|tj|jdk(rd}|j}|jj D]b\}}tj|j}|r"|jddjn|}||j!|z }dt|j#} t$j|j&} ||jnt(} | r/| | dkDr't*j-| d| j}|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)r1rjrrr9r:r;SECTION_METHOD_PATH_DEPTHrBr@r`DOCUMENTATION_LINK_REGEXsearchdecodegroupr=flush_structure splitlinesSECTION_LINE_LIMIT_CONFIGrDEFAULT_AWS_DOCS_LINKLARGE_SECTION_MESSAGEformat) r docs_link path_lengthr>r?rlrrvmatch line_countsection_config aws_docs_links rrz!DocumentStructure.flush_structures$))n ! zz ((*%)ZZ%5%5%7EMGTJJ55gtDE599$))A,G GI !__224 8MD'-33ELLNCE495;;q>"$'..0y  W,,Y7 7E 8))+, 266tyyA$    &  j>,+GG)00v& fh  rcVdj|jjdS)Nr7r8)r<rr=r.s rr@zDocumentStructure.getvalue s wwt||$++G44rc"t|_yr)rr`r.s rremove_all_sectionsz%DocumentStructure.remove_all_sections s %-rcg|_yrr-r.s r clear_textzDocumentStructure.clear_texts  rc^|jd}|jj||S)Ntitle)rrrh1)rr title_sections radd_title_sectionz#DocumentStructure.add_title_sections,,,W5 u%rc2tjj|stj|tjj ||d}t |d5}|j |jdddy#1swYyxYw)Nz.rstwb)osrjexistsmakedirsr<openr&r)r full_path file_namesub_resource_file_pathfs r write_to_filezDocumentStructure.write_to_filesqww~~i( KK "!#iI;d9K!L ($ / ,1 GGD((* + , , ,s $ B  B)NrVNr)rWrXrYrpropertyrrjsetterrorercrrrzr|r~rr@rrrr __classcell__)rfs@rr\r\s4. [[%%/6%'"(T5( ,rr\)loggingrrebotocore.compatr#botocore.docs.bcdoc.docstringparserrbotocore.docs.bcdoc.stylerrcompilerr getLoggerrNrrrr\rZrrrs '?/@%2::I g!!2$G0E 0E+4@ P(P(fX, X,r