File: //lib/python2.7/site-packages/awscli/clidocs.pyc
�
R$�_c @ s/ d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d l
m Z d d l m
Z
d d l m Z d d l m Z e j e � Z d
e f d � � YZ d e f d
� � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( i����N( t
xform_name( t StringShape( t is_json_value_header( t SCALAR_TYPES( t ParamShorthandDocGen( t
DOC_EVENTS( t
TopicTagDB( t% find_service_and_method_in_event_namet CLIDocumentEventHandlerc B s� e Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z
d � Z d
� Z d � Z
d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z RS( c C s> | | _ | j | j | j � | j | � | _ g | _ d S( N( t help_commandt registert sessiont event_classt _build_arg_table_groupst _arg_groupst _documented_arg_groups( t selfR ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt __init__ s c C sX i } xK | j j � D]: \ } } | j d k r | j | j g � j | � q q W| S( N( t arg_tablet itemst
group_namet Nonet
setdefaultt append( R R t
arg_groupst namet arg( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR
$ s
#c C s t | � r d S| S( Nt JSON( R ( R t shapet default( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt _get_argument_type_name+ s c C s� x� t D]� } | j d d � } t | | � r t | | � } t | } t | j d � � d } | f d | } | | | }
| | } | |
| | � q q Wd S( Nt -t _t .i t *( R" ( R t replacet hasattrt getattrt lent split( R R R t mapfnt eventt event_handler_namet
event_handlert
format_stringt num_argst format_argst event_stringt unique_id( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt
_map_handlers0 s
c C s | j | | | j � d S( s:
The default register iterates through all of the
available document events and looks for a corresponding
handler method defined in the object. If it's there, that
handler method will be registered for the all events of
that type for the specified ``event_class``.
N( R1 R
( R R R ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR
< s c C s, | j | j j | j j | j j j � d S( s>
The default unregister iterates through all of the
available document events and looks for a corresponding
handler method defined in the object. If it's there, that
handler method will be unregistered for the all events of
that type for the specified ``event_class``.
N( R1 R R R t
unregister( R ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR2 F s c K s� | j } | j d k r� | j j d � } | j d � | j d � d g } xR | d D]F } | j d � | j | � d j | � } | j d | | f � qX W| j d
� n d S( Nt manR! s [ s :ref:`aws <cli:aws>`t awsi����s . t s :ref:`%s <cli:%s>`s ]( t doct targetR R' t writeR t join( R R t kwargsR6 t cmd_namest
full_cmd_listt cmdt
full_cmd_name( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_breadcrumbsT s
c K sl | j } | j j � | j j d d � } | d k rD d | } n | j d | � | j j | j � d S( NR! R5 R4 s aws s .. _cli:%s:( R6 t stylet
new_paragraphR R# t writelnt h1R ( R R R: R6 t reference( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_titleb s
c K s: | j } | j j d � | j | j � | j j � d S( Nt Description( R6 R@ t h2t include_doc_stringt descriptionRA ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_descriptionk s c K sG g | _ | j } | j j d � | j j � | j d | j � d S( Nt Synopsiss %s( R R6 R@ RG t start_codeblockRB R ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_synopsis_startq s
c K s� | j } | j | } | j | j k r� | j | j k r> d Sd j g | j | j D] } | j ^ qU � } | j j | j � n/ | j j d � r� d | j } n
d | j } | j p� t
| d t � s� d | } n | j d | � d S( Ns | s --s
%s <value>s <%s>t _DOCUMENT_AS_REQUIREDs [%s]s %s(
R6 R R R R R9 t cli_nameR t
startswitht requiredR% t FalseRB ( R t arg_nameR R: R6 t argumentt at
option_str( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_synopsis_optionx s
&
c K s# | j } | j j � g | _ d S( N( R6 R@ t
end_codeblockR ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_synopsis_end� s
c K s6 | j } | j j d � | j s2 | j d � n d S( Nt Optionss *None*
( R6 R@ RG R R8 ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_options_start� s c K s0 | j } | j | } | j | j k r� | j | j k r> d Sd j g | j | j D] } d | j ^ qU � } | j j | j � n
d | j } | j d | | j | j
| j � f � | j j
� | j | j � t | d � r| j | j
| � | j | j
| � n | j j � | j j � d S( Ns | s ``%s``s %s (%s)
t argument_model( R6 R R R R R9 RO R R8 R R\ t
cli_type_nameR@ t indentRH t
documentationR$ t _document_enumst _document_nested_structuret dedentRA ( R RS R R: R6 RT RU R ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt
doc_option� s&
*
c K s) | j r% | j } | j j d � n d S( Ns See Also( t
related_itemsR6 R@ RG ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_relateditems_start� s c K sD | j } | j d � | j j d d | d | � | j d � d S( Ns * t labels cli:%st texts
( R6 R8 R@ t sphinx_reference_label( R R t related_itemR: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_relateditem� s
c C s~ t | t � rz | j rz | j j � | j d � | j j � x% | j D] } | j j d | � qI W| j j � qz n d S( s# Documents top-level parameter enumss Possible values:s ``%s``N( t
isinstanceR t enumR@ RA R8 t start_ult lit end_ul( R t modelR6 Rl ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR` � s
c
C s t | d d
� } | d k r` x� | j j � D]+ \ } } | j | | | d | j g �q. Wn� | d k r� | j | d | j d | j g �n� | d k r| j } | j j d d � } | j | | | d | j g �| j
} | j j d d � } | j | | | d | j g �n d
S( s5 Recursively documents parameters in nested structurest type_namet structuret stackt listt t mapR t keyt valueN( R% R t membersR t _doc_memberR t memberRw t
serializationt getRx (
R Rp R6 t member_type_namet member_namet member_shapet key_shapet key_namet value_shapet
value_name( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRa � s % c C s� | j | k rM | j | j � d k rM | j d k rF | j d � n d Sn | j | j � z | j | | | | � Wd | j � Xd S( Ni Rr s ( ... recursive ... )( R t countRq R8 R t _do_doc_membert pop( R R6 R R� Rs ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRz � s c
C s� | j } | r8 | j d | | j | | j � f � n | j d | j � | j j � | j j � | j | � | j j � | j } | d k r� x� | j j � D]" \ } } | j
| | | | � q� Wn� | d k rE| j } | j j
d d � }
| j
| |
| | � | j } | j j
d d � } | j
| | | | � n( | d k rm| j
| d | j | � n | j j � | j j � d S(
Ns
%s -> (%s)s (%s)Rr Rv R Rw Rx Rt Ru ( R_ R8 R Rq R@ R^ RA RH Ry R Rz Rw R| R} Rx R{ Rb (
R R6 R R� Rs t docsR~ t sub_namet sub_shapeR� R� R� R� ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � s0
( t __name__t
__module__R R
R R1 R
R2 R? RE RJ RM RW RY R[ Rc Re Rj R` Ra Rz R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR s(
t ProviderDocumentEventHandlerc B sP e Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( c K s d S( N( ( R R t
event_nameR: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR? s c K s@ | j } | j j d � | j j | j � | j | j � d S( NRK ( R6 R@ RG t codeblockt synopsisRH t
help_usage( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRM s c K s d S( N( ( R RS R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRW s c K s | j } | j j � d S( N( R6 R@ RA ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRY s c K s | j } | j j d � d S( NRZ ( R6 R@ RG ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR[ s c K s� | j } | j | } | j d | j | j f � | j | j � | j r� | j j � x! | j D] } | j j
| � qc W| j j � n d S( Ns ``%s`` (%s)( R6 R RB RO R] RH R_ t choicesR@ Rm Rn Ro ( R RS R R: R6 RT t choice( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRc s
c K s* | j } | j j d � | j j � d S( Ns Available Services( R6 R@ RG t toctree( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_subitems_start( s c K s- | j } d | } | j j | d | �d S( Ns %s/indext file_name( R6 R@ t tocitem( R t command_nameR R: R6 R� ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_subitem- s
(
R� R� R? RM RW RY R[ Rc R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� s t ServiceDocumentEventHandlerc B sb e Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z
d � Z RS(
c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRM 6 s c K s d S( N( ( R RS R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRW 9 s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRY < s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR[ @ s c K s d S( N( ( R RS R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRc C s c K s d S( N( ( R RS R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_option_exampleF s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt doc_options_endI s c K s6 | j } | j } | j j d � | j | j � d S( NRF ( R6 t objR@ RG RH R_ ( R R R: R6 t
service_model( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRJ L s c K s* | j } | j j d � | j j � d S( Ns Available Commands( R6 R@ RG R� ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� S s c K sq | j } | j | } t | d i � } t | � d k r] d | } | j j | d | �n | j j | � d S( Nt subcommand_tablei s %s/indexR� ( R6 t
command_tableR% R& R@ R� ( R R� R R: R6 t
subcommandR� R� ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� X s
( R� R� RM RW RY R[ Rc R� R� RJ R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� 3 s t OperationDocumentEventHandlerc B st e Z d Z d � Z d � Z d � Z e d � Z d � Z d � Z d � Z
d � Z d � Z d
� Z
d � Z RS( s' https://docs.aws.amazon.com/goto/WebAPIc K sP | j } | j } | j j d � | j | j � | j | � | j | � d S( NRF ( R6 R� R@ RG RH R_ t _add_webapi_crosslinkt _add_top_level_args_reference( R R R: R6 t operation_model( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRJ j s
c C sP | j j d � | j j d � | j j j d d d d � | j j d � d S( NRu s See t titles
'aws help't pages /reference/indexs' for descriptions of global parameters.( R6 RB R8 R@ t
internal_link( R R ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� r s c C s� | j } | j } | j } | j j d � } | d k r= d S| j j � | j d � d | j | | j
f } | j j d d d | � | j d � d S( Nt uids
See also: s %s/%s/%sR� s AWS API Documentationt linkRu (
R6 R� R� t metadataR} R R@ RA R8 t AWS_DOC_BASER t
external_linkRB ( R R R6 R� R� t service_uidR� ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� { s
c C st t | t � rR | j rK | rK | j } d j g | D] } d | ^ q4 � Sd Sn | j d k re d Sd | j Sd S( Nt |s "%s"s "string"t booleans
true|falses %s( Rk R Rl R9 Rq ( R R\ t include_enum_valuesR� t c( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt _json_example_value_name� s $c C s� | j | k rM | j | j � d k rM | j d k rF | j d � n d Sn | j | j � z | j | | | � Wd | j � Xd S( Ni Rr s { ... recursive ... }( R R� Rq R8 R t _do_json_exampleR� ( R R6 R\ Rs ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt
_json_example� s c C s� | j d k r� | j d � | j j t k rN | j d | j | j � � nd | j j � | j j � | j | | j | � | j j � | j d � | j j � | j j � | j d � n| j d k r�| j d � | j j � | j | j
� } | j d | � | j j t k r<| j | j | j � � n0 | j j � | j | | j | � | j j � | j j � | j d � | j j � | j d � n% | j d
k r�| j | | | � n d S( NRt t [s %s, ...s ...t ]Rv t {s %s: t }Rr (
Rq R8 R{ R R� R@ R^ t new_lineR� Rb Rw Rx t _doc_input_structure_members( R R6 R\ Rs t
key_string( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � s8
c C s� | j d � | j j � | j j � | j } x(t | � D]\ } } | | } | j } | t k r� | j d | | j | � f � n� | d k r� | j d | � | j | | | � nf | d k r� | j d | � | j | | | � n3 | d k r$| j d | � | j | | | � n | t
| � d k r= | j d � | j j � q= q= W| j j � | j j � | j d � d S(
NR� s "%s": %sRr s "%s": Rv Rt i t ,R� ( R8 R@ R^ R� Ry t enumerateRq R R� R� R& Rb ( R R6 R\ Rs Ry t iR t member_modelR~ ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � s2
c K sA t | � \ } } | j } | j | } | j | j k rS | j | j k rS d Sn | j } t � }
|
j | j � r |
j | | | � } | d k r� d S| r | j j � | j
d � | j j � x! | j � D] } | j | � q� W| j j � q n | d k r�| j d k r�| j j t k r�| j }
| j j � | j
d � | j j � | j |
d t �} | j
d | | f � t |
t � r�|
j r�| j | |
j � n | j j � | j j � ni | j t k r=| j j � | j
d � | j j � | j | | d g �| j j � | j j � n d S( Ns Shorthand SyntaxRt t SyntaxR� s %s %s ...s JSON SyntaxRs ( R R6 R R R R R\ R t supports_shorthandt generate_shorthand_exampleR R@ RA R8 RL t
splitlinesRB RX Rq R{ R R� RR Rk R Rl t _write_valid_enumsR] R� ( R RS R R� R: t
service_idt operation_nameR6 t cli_argumentR\ t docgent example_shorthand_syntaxt example_lineR{ t example_type( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � sP
c C sM | j j � | j d � x | D] } | j d | � q! W| j d � d S( Ns Where valid values are:
s %s
s
( R@ RA R8 ( R R6 t enum_valuesRx ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� s
c K s� | j } | j j d � | j } | j } | d k sA | j rQ | j d � n9 x6 | j j � D]% \ } } | j | | | d g �qa Wd S( Nt OutputR Rs (
R6 R@ RG R� t output_shapeR Ry R8 R Rz ( R R R� R: R6 R� R� R R� ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt
doc_output" s c K s | j | � d S( N( R� ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� - s ( R� R� R� RJ R� R� t TrueR� R� R� R� R� R� R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� f s 8 t TopicListerDocumentEventHandlerc B s_ e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z
d � Z RS(
ss This is the AWS CLI Topic Guide. It gives access to a set of topics that provide a deeper understanding of the CLI. To access the list of topics from the command line, run ``aws help topics``. To access a specific topic from the command line, run ``aws help [topicname]``, where ``topicname`` is the name of the topic as it appears in the output from ``aws help topics``.c C s< | | _ | j | j | j � t � | _ | j j � d S( N( R R
R R R t
_topic_tag_dbt load_json_index( R R ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR : s c K sR | j } | j d k rN | j d � | j j d d d d � | j d � n d S( NR3 s [ Rf s cli:awsRg R4 s ]( R6 R7 R8 R@ Rh ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR? @ s
c K sM | j } | j j � | j j d d | j j d d � | j j d � d S( Nt refnames cli:aws help %sR� Ru s AWS CLI Topic Guide( R6 R@ RA t link_target_definitionR R RC ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRE G s
c K s: | j } | j j d � | j | j � | j j � d S( NRF ( R6 R@ RG RH t DESCRIPTIONRA ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRJ O s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRM U s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRY X s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR[ [ s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� ^ s c
K s | j } | j j d � | j j d � } | j j � } t | j � � } x� | D]� } | j j | � | j j � xh t | | � D]V } | j j
| d � } | j d � | j j d d | d | � | j d | � q� WqS W| j j
� x | D] } | j j | � q� Wd S( Ns Available Topicst categoryRI s * Rf s cli:aws help %sRg s : %s
( R6 R@ RG R� t queryt get_all_topic_namest sortedt keyst h3RA t get_tag_single_valueR8 Rh t hidden_toctreet hidden_tocitem(
R R R: R6 t
categoriest topic_namest category_namest
category_namet
topic_nameRI ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� a s&
( R� R� R� R R? RE RJ RM RY R[ R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� 1 s t TopicDocumentEventHandlerc B s> e Z d � Z d � Z d � Z d � Z d � Z d � Z RS( c K sx | j } | j d k rt | j d � | j j d d d d � | j d � | j j d d d d � | j d
� n d S( NR3 s [ Rf s cli:awsRg R4 s . s cli:aws help topicst topicss ]( R6 R7 R8 R@ Rh ( R R R: R6 ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR? � s
c K se | j } | j j � | j j d d | j j d d � | j j | j d � } | j j | � d S( NR� s cli:aws help %sR� Ru R� ( R6 R@ RA R� R R R� R� RC ( R R R: R6 R� ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRE � s
c K sX | j } t j j | j j | j d � } | j | � } | j | � | j j
� d S( Ns .rst( R6 t ost pathR9 R� t topic_dirR t _remove_tags_from_contentRB R@ RA ( R R R: R6 t topic_filenamet contents( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyRJ � s
c C sq t | d � � } | j � } Wd QXd } x3 t | � D]% \ } } | j | � s7 | } Pq7 q7 Wd j | | � S( Nt ri Ru ( t opent readlinesR� t
_line_has_tagR9 ( R t filenamet ft linest content_begin_indexR� t line( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � s c C s6 x/ | j j D]! } | j d | d � r
t Sq
Wt S( Nt :( R� t
valid_tagsRP R� RR ( R R� t tag( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � s c K s d S( N( ( R R R: ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� � s ( R� R� R? RE RJ R� R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyR� s
( t loggingR� t botocoreR t botocore.modelR t botocore.utilsR t awscliR t awscli.argprocessR t awscli.bcdoc.doceventsR t awscli.topictagsR t awscli.utilsR t getLoggerR� t LOGt objectR R� R� R� R� R� ( ( ( s2 /usr/lib/python2.7/site-packages/awscli/clidocs.pyt <module>
s �-3�N