Vh/;ddlmZddlmZmZmZddlmZddlm Z ddl m Z ddlmZmZmZddlmZddlmZdd lmZdd lmZdd lmZeZd Zd ZddZddZ ddZ!ddZ"dZ#dZ$dZ%dZ&y)) annotations)MutableMapping MutableSetMutableSequence)Path) constants) __version__) AnsibleErrorAnsibleParserErrorAnsiblePluginNotFound) string_types) to_native)read_docstring) AnsibleLoader)Displayc^|jD]\}}||vrt||tr|j||ndt||tr|j ||n adg ghhs  cd fd fdfdfdfd}|sy|r |yd|vr |ddt|jdtr |dd t|jd tr |d t|jd tr ||d yy)Nc|rdnd}t|tsys|rd|vr |d|d|vr |d|s|sd|vr |d|yyyy)Nremoved_from_collectioncollection_name removed_inremoved_at_dateversion)rr) deprecation top_levelr$callback is_modules rprocess_deprecationz8_process_versions_and_dates..process_deprecation&sj7@3FW+~6   (C [, @  + ["3_ EYI,D [)_ =-EY r c|D]L}t|tsd|vr |ddt|jdtsB|dNy)N version_addedversion_added_collection deprecated)rrget) specifiers specifierr*r,s rprocess_option_specifiersz>_process_versions_and_dates..process_option_specifiers1sT# =Ii8)+O5OP)-- 5~F#Il$;<  =r c|jD]}t|tsd|vr |ddst|jdtr |dt|jdtr |dt|jdtr |dt|jdtr |dt|jdts|dy)Nr.r/envinivarsr0 suboptions)valuesrrr1list)optionsoptionr*r+r,r4process_optionss rr>z4_process_versions_and_dates..process_options:snn& 6Ffn5&(2LMfjj/6-fUm<fjj/6-fUm<fjj0$7-fVn=fjj6G'|(<=&**\2NC| 45 6r c|jD]L}t|tsd|vr |ddt|jdtsB|dNy)Nr.r/contains)r:rrr1) return_values return_valuer*process_return_valuess rrCz:_process_versions_and_dates..process_return_valuesLsa)002 @LlN;,.8RS,**:6G%l:&>?  @r cp|jD]"}t|tsd|vs|dd$y)Nr.r/)r:rr) attributes attributer*s rprocess_attributesz7_process_versions_and_dates..process_attributesUs?#**, QIi8)+O5OP  Qr r.r/r0T)r)r<rEF)rr1r) fragmentr+ return_docsr*rGr,r4r>rCs ` ` @@@@r_process_versions_and_datesrK%s >=66$@Q h'("?,FG(,,|,n=H\2dC(,,y)>:+,(,,|,n=8L12>r c,fd}t||||y)Nc||vr||<yyNr<r=collection_name_fieldr$s rrz1add_collection_to_versions_and_dates..addns  /-.removevs$ ;;, - @-. Ar rR)rIr$r+rJrVs ` r1remove_current_collection_from_versions_and_datesrWus/ )[&Ir c D|jdg}t|tr|jd}g}|D]}|j }d}|j |} | ?d|vr;|j dd} | d}| dj}|j |} | |j||t| |d} | |dk7r|j|d} t| |j} t| d } d| vr#dj| jddd nd }t| || d | vr0| jd }|rd |vrg|d <|d j|d| vr0| jd}|rd|vrg|d<|dj|d| vrd| vrtd|d|dD]?}|| vs||vr t!||| j|,| j|||<A t!|| |r3t#dj'|t%dj|y#t$r$}t#t%|d|d|d|d}~wwxYw#t$r!}t#t%|d|d|d}~wwxYw)Nextends_documentation_fragment, DOCUMENTATION.rz{}) file_name ansible_namer+notesseealsor<rEz+missing options or attributes in fragment (z), possibly misformatted?: )r<rE  (z) of unknown type: z(unknown doc_fragment(s) in file {0}: {1}z, )poprr splitstripr1rsplitupperappendgetattrrget_single_datajoinrSextendrrr rformat)docfilenamefragment_loaderr+ fragmentsunknown_fragments fragment_slug fragment_name fragment_varfragment_class splitname fragment_yamlrIreal_fragment_namereal_collection_namercrddoc_keyes r add_fragmentsr}s8"=I)\*OOC( #>h %++- & (,,];  !c]&:%,,S!4I%aLM$Q<--/L,00?N  !  $ $] 3  dC  .!((7 $  (CSSU$^^DORVhOhsxx(:(@(@(Ea(JKnp,X7KW`a h LL)E#%#%CLG ##E*  ll9-GC'%'C NI%%g. H $X)Ely|DEF F1 9G("c>@&s7|X\\'5JK$,<<#8CL 9 h 3 )y>h@ELLXW`aeajajk|a}W~A A%@*yYZ|]dfsu}+~@ h ! m]efg g hs0 I I5 I2I--I25 J>JJNc| |d}n|dk(}n t|||}|jddr%|t|d||t|d||||jddr|t|d||d |d|d |d|d fS) z DOCUMENTATION can be extended using documentation fragments loaded by the PluginLoader from the doc_fragments plugins. Fmodule)verbose ignore_errorsrrrb)rtr+ returndocsT)r+rJ plainexamplesmetadata)rr1rSr)rsrtrrr$r+ plugin_typedatas r get_docstringrs   I$0I (G= QD xxu  & 0eoYb c d5k8_Xab xx e$  & 0l1C_`iw{ | ;_-tL/A4 CS SSr cjt|} tjjd}|j ds|dz }|j dr|dd}t jdtdkrtdjt djd d}d j d r+tfd d DstdkDr ddvrd}dj|||S#t$r%}dj|t|cYd}~Sd}~wwxYw)a returns a versioned documentation link for the current Ansible major.minor version; used to generate in-product warning/error links to the configured DOCSITE_ROOT_URL (eg, https://docs.ansible.com/ansible/2.8/somepath/doc.html) :param path: relative path to a document under docs/docsite/rst; :return: absolute URL to the specified doc for the current version of Ansible DOCSITE_ROOT_URL/r]Nr\zinvalid version ({0})z{0}.{1}rr`0c3,K|] }|dv yw)r`NrO).0pre split_vers r z(get_versioned_doclink.. s?SC9Q<'?s)abdevdevelz {0}{1}/{2}z7(unable to create versioned doc link for path {0}: {1})) rCconfigget_config_valueendswith startswithansible_versionrhlen RuntimeErrorrqanyr)pathbase_url doc_versionexrs @rget_versioned_doclinkrs( T?De88,,-?@  % OH ??3 8D#))#. y>A 6==oNO O&&y|Yq\B  Q< " "3 '?J??3y>TUCUZ_clmncoZo% ""8[$?? eHOOPTV_`bVcddesC5D D2 D-'D2-D2ct|}|jdd}|j|k7r|j|}g}|D]D}|j |}||k(r|j s+|j t|F|S)Nr\)rrhstem with_name with_suffixexistsrlr)rplugin extensionsadjacentplugin_base_namepathsext candidates r_find_adjacentrsDzH||C(,}}((%%&67 E/((-       LL9- . / Lr c|j|dd}|r |js|dvr|j|\}}|r |jstd|z|t |j }|j tjvr%t||tj}|r|dnd}n t|}|td |z||fS) zn if the plugin lives in a non-python file (eg, win_X.ps1), require the corresponding 'sidecar' file for docs FT)ignore_deprecated check_aliases)filtertestz%s was not found)plugin_load_contextrNzO%s cannot contain DOCUMENTATION nor does it have a companion documentation file) find_plugin_with_contextresolvedget_with_contextr rplugin_resolved_pathsuffixrDOC_EXTENSIONSrrr )rrloadercontext plugin_objdocfile filenamesrss rfind_plugin_docfiler&s--f]a-bG 7++@R1R$55f= G '**#$6&$AW^__7//0G~~Q---"7FA4D4DE #,9Q<$W%lpvwxx W r c g}t|||\}}|j} t|||||}|ds:t ||t jD]} t| ||||}| }|dn|dt d|d|d||dd <||dd <|j|dd <|S#t$r} t |d|d| d} ~ wwxYw#t$r} t d|d|d| d} ~ wwxYw) N)rr$rz, did not contain a DOCUMENTATION attribute ())orig_excrzAdjacent file zNo documentation available for rfrs collection plugin_name) rplugin_resolved_collectionrrr rrr resolved_fqcn) rrrrtrdocsrsrr$rnewfiles rget_plugin_docsr?sU D,FKHHg88OwXYhwBC 7%h8H8HI MG M$Wow`o~IJ"7&'  M Aw VU]!^__&Q  /Q !(!6!6Q  K- w X^`h!ituvvw M(ntv~)KLMM Ms/B*C* C 3CC  C0C++C0rH)FFNNN)' __future__rcollections.abcrrrpathlibransiblerransible.releaser ransible.errorsr r r ansible.module_utils.sixr +ansible.module_utils.common.text.convertersransible.parsing.plugin_docsransible.parsing.yaml.loaderransible.utils.displayrdisplayrrKrSrWrrrrrrrOr rrsr#GG":RR1A65) )  E3PGJOAdT@eD*2!r