+
     IiB!  c                   sx    ^ RI t ^ RIHt ^ RIHt ^ RIHt ^ RIt^ RI	H
t
 ^ RIHtHt ^ RIHt  ! R R	]4      tR# )
i    N)DocumentStructure)ServiceDocumenter)DataNotFoundError)Boto3ClientDocumenter)ResourceDocumenterServiceResourceDocumenter)ServiceContextc                   s   a a ] tR t^t o]P
                  P                  ]P
                  P                  ]P                  4      R4      t
V 3R ltR tR tR tR tR tR tR	 tR
tVtV ;t# )r   examplesc                sX  < \         SV `  VVP                  VR 7       W n        V P                  P	                  V4      V n        RV n        V P                  V P                  P                  4       9   d!   V P                  P                  V4      V n        . ROV n
        W0n        RV n        R# ))service_namesessionroot_docs_pathNz=https://docs.aws.amazon.com/boto3/latest/guide/resources.html)titleclient
paginatorswaiters	resourcesr   context-params)Zsuper__init___session_boto3_sessionr   _client_service_resource_service_nameZget_available_resourcesresourcesections_root_docs_path_USER_GUIDE_LINK)selfr   r	   r
   	__class__s   &&&&7/usr/lib/python3.14/site-packages/boto3/docs/service.pyr   ZServiceDocumenter.__init__   s    % $$) 	 	
 &**11,?!%!4!4!L!L!NN%)%8%8%A%A,%OD"
  .K 	    c                sN   \        V P                  V P                  RR7      pV P                  VP	                  R4      4       V P                  VP	                  R4      4       V P                  VP	                  R4      4       V P                  VP	                  R4      4       V P                  '       d!   V P                  VP	                  R4      4       V P                  VP	                  R4      4       VP	                  R	4      pV P                  V4       VP                  4       # )
zYDocuments an entire service.

:returns: The reStructured text of the documented service.
html)Zsection_namestargetr   r   r   r   r   r   r   )r    r   r   r   Zget_section
client_apiZpaginator_apiZ
waiter_apir   resource_section_document_examplesZclient_context_paramsZflush_structure)r   Zdoc_structureZcontext_params_sections   &  r   document_serviceZ"ServiceDocumenter.document_service8   s    
 *dmmF
 	

=,,W5611(;<=44\BC11)<=!!!!!-";";K"HI 9 9* EF!.!:!:;K!L""#9:,,..r   c                s    R p V P                  V P                  4      p\        V P                  V P
                  V4      P                  V4       R #   \         d     L?i ; i)N)Zget_examplesr   r   r   r   r   Zdocument_client)r   sectionr   s   && r   r!   ZServiceDocumenter.client_apiL   s[    	((););<H 	LL$..	

/'
" ! 		s   A AAc                s8   VP                   P                  R 4       VP                   P                  4        VP                  R4       VP                   P	                  RV P
                  R7       VP                  R4       VP                   P                  4        VP                   P                  4        VP                  R4       VP                   P                  4        VP                   P                  4        V P                  V4       V P                  V4       R# )Z	ResourceszResources are available in boto3 via the ``resource`` method. For more detailed instructions and examples on the usage of resources, see the resources z
user guide)r   ZlinkZ.zThe available resources are:N)	styleh2new_linewriteZexternal_linkr   Ztoctree_document_service_resource_document_resources)r   r%   s   &&r   r"   Z"ServiceDocumenter.resource_sectionW   s    % 	
 	##&& 	$ 	
 	c  45 ''0  )r   c                s   \        R RR7      pVP                  R4      pVP                  P                  V P                  P
                  P                  RV P                   24       VP                  R4       \        V P                  V P                  V P                  4      P                  V4       V P                  P                  P                  P                   pW@P                  8X  d   R p\"        P$                  P'                  V P                  V P                   VP)                  4        4      pVP+                  VR4       VP                  P-                  V P                   RV R24       R	# )
zservice-resourcer   r    
breadcrumb../../z / Resource / ServiceResourceindex//indexN)r    add_new_sectionr&   refr   r   __name__r   r)   r   r   r   r   document_resourcemetaresource_modelnameospathjoinlowerwrite_to_filetocitem)r   r%   Zservice_resource_docbreadcrumb_sectionresource_nameservice_resource_dir_paths   &&    r   r*   Z,ServiceDocumenter._document_service_resourcem   s8   0v 
 2AA,O  $$LL""++vd6H6H5I-J	
 	  !@A!""DMM43G3G	


0
1 ..33BBGG....M$&GGLL  !!"""$%%
!
 	**+DgN!3!3 4Am_FKLr   c                sv   R pV P                   P                  R4      pVP                  V P                  R4      pV P                  P
                  P                  P
                  P                  pVR,           EF=  pVR,          V,          pV P                  P                  P                  VV\        V P                  VR,          VRR7      R7      pVP
                  P                  P                  p	. p
V	 F  pV
P                  V4       K  	  V! V
RV P                  / pVP
                  P                  P                   P#                  4       p\%        VRR	7      pVP'                  R
4      pVP(                  P+                  V P                  P,                  P.                  RV P                   24       VP1                  RVP
                  P                  P                    24       \3        WP                   V P4                  4      P7                  VP'                  VP
                  P                  P                   4      4       \8        P:                  P=                  V P4                  V P                   V 4      pVP?                  VR4       VP(                  PA                  V P                   RV R24       EK@  	  R# )ZfooZdata_loaderzresources-1r   N)r   Zresource_json_definitionsservice_modelZservice_waiter_model)r@   Zsingle_resource_json_definitionZservice_contextr   r   r,   r-   r.   z / Resource / r/   r0   r1   )!r   Zget_componentZload_service_modelr   r   r6   r   rB   r   Zresource_factoryZload_from_definitionr   r7   identifiersZappendr   r8   r<   r    r2   r&   r3   r   r4   r)   r   r   r5   r9   r:   r;   r=   r>   )r   r%   Ztemp_identifier_valueZloaderZjson_resource_modelrB   r@   r7   Zresource_clsrC   ZargsZ_r   Zresource_docr?   rA   s   &&              r   r+   Z%ServiceDocumenter._document_resources   s`    %,,];$77
 ..33::??MM0==M0=mLN##44II"/4B$2%)%7%72E'3 '4-1% J   '++::FFKD 12 !#T?$,,?H$MM88==CCEM,]6JL!-!=!=l!K$$((&&//6$:L:L9M1N $$ !=!=!B!B CD --)=)=,,X]]-I-I-N-NO
 )+$$%%& /)%
 &&'@'JMM!!%%&af=Y >r   c                s    \         P                  P                  \         P                  P                  V P                  V P
                   R 24      4      # )z.rst)r9   r:   Zrealpathr;   EXAMPLE_PATHr   )r   s   &r   _get_example_fileZ#ServiceDocumenter._get_example_file   s?    wwGGLL**t/A/A.B$,GH
 	
r   c                s|   V P                  4       p\        P                  P                  V4      '       ds   VP                  P                  R 4       VP                  P                  4        \        V4      ;_uu_ 4       pVP                  VP                  4       4       RRR4       R# R#   + '       g   i     R# ; i)ZExamplesN)
rE   r9   r:   Zisfiler&   r'   r(   Zopenr)   Zread)r   r%   Zexamples_fileZfs   &&  r   r#   Z$ServiceDocumenter._document_examples   s}    ..077>>-((MMZ(MM""$m$$affh' %$ ) %$$s   > B**B;	)r   r   r   r   r   r   )r4   Z
__module__Z__qualname__Z__firstlineno__r9   r:   r;   Zdirnameboto3Z__file__rD   r   r$   r!   r"   r*   r+   rE   r#   Z__static_attributes__Z__classdictcell__Z__classcell__)r   Z__classdict__s   @@r   r   r      sY     77<< ?LL
6/(	#*,M45n

( (r   r   )r9   Zbotocore.docs.bcdoc.restdocr    Zbotocore.docs.servicer   ZBaseServiceDocumenterZbotocore.exceptionsr   rF   Zboto3.docs.clientr   Zboto3.docs.resourcer   r   Zboto3.utilsr   ) r   r   <module>rG      s.    
 9 L 1  3 M &p(- p(r   