j+&ddlZddlZddlZddlmZddlmZddlmZdZ ej dZ dZ ej dZd d d d d d dd d dd d dZddddZGddZGddeZdS)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-apicXeZdZddZdZdZdZdZdZdZ d Z d Z d Z d Z d ZdS) ReSTDocumentmanct||_||_t||_d|_d|_i|_i|_g|_ d|_ dS)NTF) rstyletargetrparser keep_datado_translationtranslation_maphrefs_writes_last_doc_string)selfrs \/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/botocore/docs/bcdoc/restdoc.py__init__zReSTDocument.__init__3sXt__  %d++ #!  $cT|jr||j|dSdSdSN)rrappendrss r_writezReSTDocument._write>s: > #am L   " " " " " # #mmrc0||dS)z2 Write content into the document. N)r#rcontents rwritezReSTDocument.writeBs Grch||j|ddS)z- Write content on a newline.  N)r#rspacesr%s rwritelnzReSTDocument.writelnHs8 tz((**7G77788888rc|jdS)zn Returns the last content written to the document without removing it from the stack. rrs r peek_writezReSTDocument.peek_writeNs |Brcht|jdkr|jndS)zL Removes and returns the last content written to the stack. rN)lenrpopr/s r pop_writezReSTDocument.pop_writeUs1&)%6%6%:%:t|!!!Drc:|j|dS)z2 Places new content on the stack. N)rr r!s r push_writezReSTDocument.push_write[s  Arc|jrS|j|jD] \}}|j||!d|jdS)zJ Returns the current content of the document as a string. utf-8)rr new_paragraphitemslink_target_definitionjoinrencode)rrefnamelinks rgetvaluezReSTDocument.getvalueas : A J $ $ & & &!%!1!1!3!3 A A  11'4@@@@wwt|$$++G444rc fd|DS)NcFg|]}j||S)rget).0wrs r z0ReSTDocument.translate_words..ls,>>>1$((A..>>>rrD)rwordss` rtranslate_wordszReSTDocument.translate_wordsks>>>>>>>>rcJ|r|jr||dSdSdSr)rr#)rdatas r handle_datazReSTDocument.handle_datans?  DN  KK         rcf|r t|j}|j||jt|j}||f|_dS#t $r:tddt|YdSwxYwdS)NzError parsing doc stringT)exc_info) r2rrfeedcloser ExceptionLOGdebug)r doc_stringstartends rinclude_doc_stringzReSTDocument.include_doc_stringrs  & &DL))   ,,, !!###$,''). %%% & & & 4t DDD *%%%%%% & & &sA$A**AB.-B.c@|j|j\}}|j||=dSdSr)rr)rrVrWs rremove_last_doc_stringz#ReSTDocument.remove_last_doc_string~s3  ,.JE3 U3Y''' - ,rN)r)__name__ __module__ __qualname__rr#r'r+r0r4r6rArJrMrXrZrDrrrr2s % % % %### 999    EEE  555??? & & &(((((rrceZdZdfd ZedZedZejdZedZedZ d Z dd Z d Z d Z d ZddZdZdZdZdZdZxZS)DocumentStructureNrct|||_t|_|jg|_i|_|||_|||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__s rrzDocumentStructure.__init__sy ''' %--j\   #DM  $  $ $] 3 3 3 3 3 % $rc|jS)z"The name of the document structure)rbr/s rrzDocumentStructure.names zrc|jS)zv A list of where to find a particular document structure in the overlying document structure. rdr/s rpathzDocumentStructure.paths zrc||_dSrrl)rvalues rrmzDocumentStructure.paths  rc*t|jSr)listrcr/s ravailable_sectionsz$DocumentStructure.available_sectionssDO$$$rc|jSr)rer/s rrhzDocumentStructure.contexts }rc:|D]}||dSr)add_new_section)rrg section_names rrfz%DocumentStructure._generate_structures2) / /L   . . . . / /rc|||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. )rrrh)rirrmr indentationrrrc)rrrhsections rruz!DocumentStructure.add_new_sectionsk ..dk7!  yD6) $(J$: !"&"6  'rc|j|S)zRetrieve a sectionrcrrs r get_sectionzDocumentStructure.get_sectionst$$rc||jvSrr{r|s r has_sectionzDocumentStructure.has_sectionst&&rc|j|=dS)zDelete a sectionNr{r|s rdelete_sectionz DocumentStructure.delete_sections OD ! ! !rct|j}|dkr[|jrS|j|jD] \}}|j||!n+|t|jdkrd}| }|j D]w\}}t | }|r*|ddn|}|||z }xt|} t$|j} || nt(} | r?| | dkr3t*| 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)r2rmrrr:r;r<SECTION_METHOD_PATH_DEPTHrErArcDOCUMENTATION_LINK_REGEXsearchdecodegroupr>flush_structure splitlinesSECTION_LINE_LIMIT_CONFIGrDEFAULT_AWS_DOCS_LINKLARGE_SECTION_MESSAGEformat) r docs_link path_lengthr?r@rorrymatch line_countsection_config aws_docs_links rrz!DocumentStructure.flush_structures$)nn !  z E ((***%)Z%5%5%7%7EEMGTJ55gtDDDD 599$)A,GG G GI !_2244 8 8MD'-33ELLNNCCE49H5;;q>>'''..000y  W,,Y77 7EE))++,, 266tyAA$      &   j>,+GGG)00v& fhh  rc\d|jdS)Nr8r9)r=rr>r/s rrAzDocumentStructure.getvalue s$wwt|$$++G444rc,t|_dSr)rrcr/s rremove_all_sectionsz%DocumentStructure.remove_all_sections s%--rcg|_dSrr.r/s r clear_textzDocumentStructure.clear_texts  rcd|d}|j||S)Ntitle)rurh1)rr title_sections radd_title_sectionz#DocumentStructure.add_title_sections2,,W55 u%%%rcRtj|stj|tj||d}t |d5}||ddddS#1swxYwYdS)Nz.rstwb)osrmexistsmakedirsr=openr'r)r full_path file_namesub_resource_file_pathfs r write_to_filezDocumentStructure.write_to_filesw~~i(( # K " " "!#iI9K9K9K!L!L ($ / / ,1 GGD((** + + + , , , , , , , , , , , , , , , , , ,s'(BB #B )NrNr)r[r\r]rpropertyrrmsetterrrrhrfrur}rrrrArrrr __classcell__)ris@rr_r_sv444444.XX [[%%X%X///6%%%'''"""((((T555((( ,,,,,,,rr_)loggingrrebotocore.compatr#botocore.docs.bcdoc.docstringparserrbotocore.docs.bcdoc.stylerrcompilerr getLoggerrSrrrr_rDrrrsT ''''''??????//////@%2:I g!!!2$GG0EE 0EE+4@@ P(P(P(P(P(P(P(P(fX,X,X,X,X, X,X,X,X,X,r