Vh%ddlmZddlZddlZddlZddlZddlZddlZddlm Z m Z ddl m Z ddl mZddlmcmcmZddlmZddlmZdd lmZdd lmZdd lmZmZm Z m!Z!dd l"m#Z#m$Z$m%Z%dd l&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-m.Z.m/Z/m0Z0ddl1m2Z2m3Z3ddl4m5Z5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@ddlBZ e eCZDe8ZEe dddgZFdZGdZHdqdZIdZJGdd eKZLGd!d"eKZMGd#d$ZNGd%d&eNZOdrd'ZPd(ZQd)ZRd*ZSdsd+ZTdsd,ZUeNd-d.ejd/ZWeNd0d1ejd2d34ZYeNd5d6ejd7Z[eNd8d9ejd:Z]eNd;dd?id@AZ_eNdBdCdDdDZ`eNdEdFejdGZbeNdEdHejdIZdeNdEdHejdIZeeNdJdKejdLdM4ZgeOdNdOejdPeZieOdQdRejdSeZkeNdTdUejdVdW4ZmeNdXdYejdZd[4ZoeNd\d]ejd^ZqeNd_d`ejdadb4ZseNdcddejdedf4ZueNdgdhejdiZweNdjdkejdldm4ZyeNdndoejdpZ{y#eA$rdZ>dZ@Y'wxYw)t) annotationsN) defaultdict namedtuple) import_module) format_exc)AnsibleJinja2Filter)AnsibleJinja2Test) __version__) constants) AnsibleErrorAnsiblePluginCircularRedirectAnsiblePluginRemovedError(AnsibleCollectionUnsupportedVersionError)to_bytesto_text to_native) string_types) from_yaml) AnsibleLoader)get_plugin_class MODULE_CACHE PATH_CACHEPLUGIN_PATH_CACHE)AnsibleCollectionConfigAnsibleCollectionRef)_AnsibleCollectionFinder_get_collection_metadata)Display) add_fragments) _is_unsafe) SpecifierSet)Versionget_with_context_resultobjectplugin_load_contextctjDcgc]\}}t|ts||fc}}Scc}}wN)globalsitems isinstance PluginLoader)nameobjs F/home/dcms/DCMS/lib/python3.12/site-packages/ansible/plugins/loader.pyget_all_plugin_loadersr08s1+29??+< ^KT3 3P\@]T3K ^^ ^s??ctjjt|d}tjj |rt D]\}}|j stjj|t|j }tjj |sf|jt|ytjdt|zy)z3 add any existing plugin dirs in the path provided surrogate_or_stricterrorszFIgnoring invalid path provided to plugin path: '%s' is not a directoryN) ospath expanduserrisdirr0subdirjoin add_directoryrdisplaywarning)r6b_pathr-r. plugin_paths r/add_all_plugin_dirsr@<s WW  6K L MF ww}}V/1 S[[*K,,F GF5Tt45rAceZdZdZy)PluginPathContextc ||_||_yr()r6internal)selfr6r^s r/__init__zPluginPathContext.__init__rs   rAN)rV __module__ __qualname__r`rAr/r\r\qs!rAr\c:eZdZdZedZdZdZdZdZ y)PluginLoadContextcd|_g|_g|_g|_g|_d|_d|_d|_d|_d|_ d|_ d|_ d|_ g|_ d|_d|_d|_yNF) original_name redirect_list error_listimport_error_list load_attemptspending_redirect exit_reasonplugin_resolved_pathplugin_resolved_nameplugin_resolved_collection deprecated removal_dateremoval_versiondeprecation_warningsresolved_resolved_fqcn action_pluginr_s r/r`zPluginLoadContext.__init__xs!!# $$(!$(!*.' #$&! "!rAcR|jsy|js|jd}tj|r%|j dr|j dd}|jr'tj|s|jdz|z}||_|jS)Nansible.legacy..)rvrwrir is_valid_fqcr startswithsplitrq)r_ final_plugins r/ resolved_fqcnzPluginLoadContext.resolved_fqcns}} ""--b1L#11,?LD[D[\mDn+112CDRH ..7K7Y7YZf7g#>>D|S ".D """rAcR|s|S|jddxsd}|jdd}|jdd}|d}dj||rdnd|}tj||||d|_|r||_|r||_|j j||S) N warning_textrsrtz{0} has been deprecated.{1}{2} )dateversioncollection_nameT)rGformatr<rrrsrtruappend)r_r- deprecationrrrsrts r/record_deprecationz$PluginLoadContext.record_deprecationsK#~t<B "~t< %//*;TB  #"O7>>tLS^`bno  $$1!$1!*='& * rAcd||_dj|j||_d|_|S)Nz+pending redirect resolution from {0} to {1}F)rmrrhrnrv)r_ redirect_names r/redirectzPluginLoadContext.redirects3 -HOOPTPbPbdqr  rAc0d|_||_d|_|Srg)rmrnrv)r_rns r/nopezPluginLoadContext.nopes $&  rAN) rVrarbr`propertyrrrrrrcrAr/rerews/"& # #0 rAreceZdZdZd dZedZdZdZdZ dZ d Z d Z d Z d!d Zd!d Zd!dZdZd"dZd#dZd"dZd$dZd$dZddddefdZd%dZd#dZeZdZd dZdZdZd dZ dZ!y)&r,z PluginLoader loads plugins from the configured plugin directories. It searches for plugins by iterating through the combined list of play basedirs, configured paths, and the python path. The first match is used. Nc|in|}||_||_||_||_||_|rt |t s|g}n|sg}||_|tvr it|<|tvr dt|<|tvrttt|<g|_ t||_t||_t||_|jdk(rind|_t%|_yN vars_plugins) class_name base_classpackager9aliasesr+listconfigrrrrdict _extra_dirs _module_cache_paths_plugin_path_cache_plugin_instance_cacheset_searched_paths)r_rrrr9rrequired_base_classs r/r`zPluginLoader.__init__s"W$-   *VT2XFF \ )')L $ Z '%)Jz " . .,7,= j )**5 , "3J"?,0KK>,Ibt#"urAc@tj|jSr()r legacy_plugin_dir_to_plugin_typer9rys r/typezPluginLoader.types#DDT[[QQrAc8dj|jS)NzPluginLoader(type={0}))rrrys r/__repr__zPluginLoader.__repr__s'..tyy99rActjrd|_yit|j<dt |j<t tt|j<t|j|_ t |j|_t|j|_ |jdk(rind|_ t|_yr)COLD_PLUGIN_CACHE_CLEARINGrrrrrrrrrr9rrrrys r/ _clear_cacheszPluginLoader._clear_cachess & &DK-/L )*.Jt '1D $T__5DK&7&HD #04 ~0M"SWD '#&5D rAc|jd}|jd}|jd}|jd}|jd}|jd}|jdt|<|jdt|<|j|||||||jd g|_|jd t |_y ) z Deserializer. rrrr9rrrrrrN)rGrrr`rrr)r_datarrrr9rrs r/ __setstate__zPluginLoader.__setstate__ s XXl+ ((9%(#(#((9%XXl+ !%,!7 :(,1D(E*% j'667JO88M26#xx(935ArAc t|j|j|j|j|j |j |j|jt|jt|j S)z Serializer. ) rrrrr9rrrrr) rrrrrr9rrrrrrys r/ __getstate__zPluginLoader.__getstate__ se LL;;;;LL(( 00!$//2/@  rAc~g}|D]}||vs|j|tjj|S)z; Returns a string suitable for printing of the search path )rr5pathsepr:)r_rXretis r/ format_pathszPluginLoader.format_paths2s? A| 1  zzs##rAcD|j|jdS)NFsubdirs)r _get_pathsrys r/ print_pathszPluginLoader.print_paths<s  !?@@rAcg}|j|tj|dD]A\}}}d|vs |D]1}|jtjj ||3C|S)NT) followlinksz __init__.py)rr5walkr6r:)r_dirresultsrootrfilesxs r/_all_directorieszPluginLoader._all_directories?sms$&GGCT$B : D'5% :ANN277<<a#89: :rAc|jsgSt|dst|j}|jjddd}|D]}t ||}t t jj|jd|_ |r|j|jS|jgS)z# Gets the path of a Python package package_pathr}rNr2r3) rhasattr __import__rrSrr5r6dirname__file__rr)r_rmparts parent_mods r/_get_package_pathszPluginLoader._get_package_pathsHs||It^,4<<(ALL&&s+AB/E# + Az* + ' (CLa bD  (():):; ;!!""rAc R|j |jS|jDcgc]}t|d}}|j|jD]}tj j tj j|}|rtjd|ztjd|zz}|D]O}t|d}tj j|s0||vs5|jt|dQt|d}||vs|jt|d|j|j|Dcgc]}t|dc}|jd ||_|Scc}wcc}w) zE Return a list of PluginPathContext objects to search for plugins in Fz%s/*z%s/*/*r2r3rTc8|jjdS)Nz/windows)r6endswith)ps r/z6PluginLoader._get_paths_with_context..sqvvz:rAkey)rrr\rr5r6abspathr7globrr8rextendrsort)r_rrrr6contentscs r/_get_paths_with_contextz$PluginLoader._get_paths_with_contextWsn ;; ";; 484D4DEq E*EE ;; " ?wwrww'9'9$'?@#yy$7$))HtO:TTH%D#A.CD77==+ JJ'8E'BCD t,ABs?JJ0u=> ? 8O8OX_8O8`a1%a.ab$ :;  UF(bs F)F$cd|j|}|Dcgc]}|jc}Scc}w)z1 Return a list of paths to search for plugins in r)rr6)r_rpaths_with_contextpath_with_contexts r/rzPluginLoader._get_pathss4"99'9J@RS+<!&&SSSs-c|jrt|j}|tjvrtjj ||st t|dd|j}|rpt||t|dk(d|vrUt|dtrAtjj|||dtjd|d|d y y y y y y y ) zf Reads plugin docs to find configuration setting definitions, to push to config manager for later use DOCUMENTATIONr) file_namemodule)fragment_loader is_moduleoptionszLoaded config def from plugin (/)N)rrrCONFIGURABLE_PLUGINSrhas_configuration_definitionrrSget_single_datar rr+r+initialize_plugin_configuration_definitionsr<debug)r_r-rr6 type_namedstrings r/_load_config_defszPluginLoader._load_config_defss ??(9IA222188;`;`ajlp;q'(LX\]mmo!'4]fjr]rt G+ 79;Mt0TLLYX\^efo^pq QZ\`&ab1U+)LM 1 !rAct|j}|sy t|jdj|zt |dd}|sy|j r(dj |j |jg}n |j}|jdij|ij||zd}|s2|jdij|ij|d}|S#t$rYwxYw)Nz .plugins.{0}_collection_metar}plugin_routing) r n_python_collection_package_namer ImportErrorrSrr:resourcerG)r_acr plugin_type extensioncollection_pkgcollection_metasubdir_qualified_resourceentrys r/_query_collection_routing_metaz+PluginLoader._query_collection_routing_metas&s'K'KL  #>>AVAVWbAcc d ".2DdK ;;(+#++s||1L(M %(+ %##$4b9==k2NRRSloxSxz~#''(8"=AA+rRVVWprvwE )   s'C<< DDc  d|_tj|j}tj||}|j |||}d}|r|j dd} |s|j|| |j|j dd} | r| j d} | j d} | j dxsd } d j|| rd nd | } tj| | | d |j }| |_ | |_ d |_||_t|||j dd}|rtj |st#d|jd|d|dtj%dj|||||j&vr|j&j)||j+|S|j,dk(r|j d}t/|j0d}dj|j2|}|r||z }t4j6j |j2}|s t9|j2}t>j@jC|jD}t>j@jG||}t>j@jI|rB|jK|tM||jdj||j|S|r4|j=djtM||jStOjPt>j@jG||dzDcgc]B}t>j@jS|r!|jUtVjXs|D}}|s+|j=dj||jSt[|}t]|dkDr'tj_d d!jG|z|jK|tM|d"|jd#j||j|S#t:$r-|j=dj|j2cYSwxYwcc}w)$zSearch builtin paths to find a plugin. No external paths are searched, meaning plugins inside roles inside collections will be ignored. F)rNr tombstonersrtrrz{0} has been removed.{1}{2}rT)msgrrremovedrr&r Collection  contains invalid redirect for : 6. Redirects must use fully qualified collection names.z"redirecting (type: {0}) {1} to {2}rUrxstrictr3{0}.{1}zPython package {0} not foundz found exact match for {0} in {1}zno match for {0} in {1}z.*z+failed fuzzy extension match for {0} in {1}rzDFound several possible candidates for the plugin but using first: %s,rz*found fuzzy extension match for {0} in {1})0rvrrr9 from_fqcrr rGr collectionrr<get_deprecation_messagersrtrnrr~r vvrirrrrrn_python_package_namerTrUrrrr5r6rrr:existsrrriglobisfilerrMODULE_IGNORE_EXTSsortedlenr)r_fq_namerr&ignore_deprecatedrrrouting_metadatarxrr rsrtr removed_msgr n_resource full_namepkgpkg_pathn_resource_pathf found_filess r/_find_fq_pluginzPluginLoader._find_fq_pluginsu (-$*KKDKKX ",,WkB >>sK[d>e *..}dCK%#66w S^^\(,,[$?I(}}^< "+--0A"B(}}^<B <CCGT`Sfhjvw %==,XgCOY]NQnn>^ 4@#06E#3/3#,2=#// Qdee'++J=H+99(C&%cnn%55TU\T]]_`h_ijOO  ?FF{T[]efg "5"C"CC'55<%> K  ) #Jkkooc778 r#C$=$=>77??3<<0'',,x< 77>>/ *&..7?3S^^EgEnEnoxz}{I{IFJLYZ Z &++,E,L,LWU_M`bebpbp,qr r!% 277<<*+MPT+T UV''..+AJJq?S?S4TV V&++,Y,`,`ajlolzlz,{| |[) { a  MM`cfckcklwcxx y"** w{1~. 8 ? ? 3>> Z\ik k; r*//0N0U0UVYVoVo0pqq r"Vs$R AS 3SSrcv|j|||||}|jr|jr |jSy)z Find a plugin named name N)find_plugin_with_contextrvro)r_r-mod_typer" check_aliasescollection_listresults r/ find_pluginzPluginLoader.find_pluginCs;..tX?PR_apq ??v::.. .rAct}||_ |j||||||}|jr]|j|jvr/t dj |j|j|j}d|_|}nn|jr/tjdj ||j|S)zg Find a plugin named name, returning contextual info about the load, recursively resolving redirection rz.plugin redirect loop resolving {0} (path: {1})Nz;errors were encountered during the plugin load for {0}: {1}) rerh_resolve_plugin_steprmrirrrjr<r=)r_r-r/r"r0r1r&r2s r/r.z%PluginLoader.find_plugin_with_contextKs/1,0)..tX?PR_apGZ.[F&&**f.B.BB78h8o8opvqEqEGMG[G[9\]]..*.'&,#  ) ) OOZaabfh{iGiGH I#"rAc|s td|jj|d|_|t|j vrdj ||_|S|r|}n|jrd}nd}tj|s|r]|jdsKd|vs|s|g}n|D cgc]} dj | |}} |D]} |jj| | jd r%|j|jd ||||}nJ|j| ||| }|jr)| |jvr|jj| |js |j r|cS|j.r?t2j5d j |d j7|j.dj ||_|S|j|||||Scc} w#t"t$t&f$rt($r&} |j*j| Yd} ~ xd} ~ wt,$r/} |j.jt1| Yd} ~ d} ~ wwxYw)NzA PluginLoadContext is requiredFz#{0} matched a defined plugin filterz.pyrAnsibler}rzansible.legacyr|)r&r"z)plugin lookup for {0} failed; errors: {1}z; )r zno matches found for {0}) ValueErrorrirrv_PLUGIN_FILTERSrrrnrrr~rrl_find_plugin_legacy removeprefixr,rmrrrrrkrHrjrr<rr:) r_r-r/r"r0r1r&suffix candidatesrcandidate_nameieexs r/r5z!PluginLoader._resolve_plugin_stepis">? ?))006',$ ?4<<0 0.S.Z.Z[_.`  +& & F __FF ! . .t 4QUQ`Q`ajQkd{/"V APQAi..q$7Q Q", II'55<<^L%001AB/3.F.FtGXGXYjGkGZ\mo|E/F+/3.B.B>SYpCUf/C/h+/77NReRsRsz3PluginLoader._find_plugin_legacy..sj"Wqvv]a]q]qOqvxv}v}wDwDEMNONTNTEUwV!"WsA2AAz trying %sc3^K|]$}tjj|&ywr()r5r6r:)rEr*r>s r/rFz3PluginLoader._find_plugin_legacy..s R!bggll615Rs*-z Error accessing plugin paths: %sNc3K|]A}tjj|s#|jdr5t |Cyw)s __init__.pyN)r5r6rrr)rEr*s r/rFz3PluginLoader._find_plugin_legacy..s3wq"''..QRBS\]\f\fgu\vilws$A A A c3@K|]}j|ywr()r)rEr full_paths r/rFz3PluginLoader._find_plugin_legacy..sKy))!,Ksrrr2r3_z%s is kept for backwards compatibility but usage is discouraged. The module documentation details page may explain more about this rationale.zansible.builtin.{0}r})r!rr&r"z.{0} is not eligible for last-chance resolution)(rvrrGrr6rorpr^rqrwKeyErrorrrr<rrlrr5listdirOSErrorr=rrEanyrrsplitext IndexErrorr\raddrislinkrrlstriprrr~r,r)r_r-r&r"r0r< pull_cacherr6r^ full_pathser& splitname base_namer alias_namecandidate_fqcrr>rJs` @@r/r:z PluginLoader._find_plugin_legacys(-$ <<##D$/D,,V4   *4 0 7H7M7M  47;  4RcRlRl=Nrt  :O`OiOi2Dt2Kos  .+/  (& &   "WT-I-I-K"W4  $))Dd^F MM+, -  - - 4 4T :(11H QRrzz&?QR  Q BWQZ OPP QxJw k GG,,Y7 Ka6J6JKKGG,,Y7 %aL # )! I!# "I#$I6KL D$;$;B$??=NyZb=cD++B/ :D$;$;B$??=NyZb=cD++B/ :D$;$;I$FFDUV_aiDjD++I6yAD$;$;I$FFDUV_aiDjD++I6yA9 k<  $ $T * $.t$4!;L;Q;Q#8;?#8VgVpVpARvx#>RcRlRl5G$5Nrv#2/3#,**  e4 ns#tJZ'$.z$:!(@Q@V@V1W&&(vx|yDyDEHyI(IJ;L;Q;Q#8;E#8VgVpVpARvx#>XiXrXr5G*5TyC#2/3#,**/55d; d?3AA.Q''&fyN_'` `"''(X(_(_`d(effsOAB BBD.. E"7!EE"G G-,G-AL'' L43L4c |j||duS#t$rH}t|trtj dj t|Yd}~yd}~wwxYw)z& Checks if a plugin named name exists r1Nzhas_plugin error: {0})r3rHr+r r<rrr)r_r-r1r@s r/ has_pluginzPluginLoader.has_pluginsb G##D/#JRVV V G"l+ MM188E F F  Gs A(>A##A(cz|jdr|}ndj|j|g}|tjvrtj|St j 5t jdttjjt|t|}tjj|}|tj|< |jj| ddd|S#t $rtj|=wxYw#1swYSxYw)Nansible_collections.r}ignore)rr:rrTrUwarningscatch_warnings simplefilterRuntimeWarning importlibutilspec_from_file_locationrmodule_from_specrY exec_modulerH)r_r-r6r&specrs r/_load_module_sourcez PluginLoader._load_module_source*s ??1 2I$,,!56I  #;;y) )  $ $ &   ! !(N ;>>99)I:NPYZ^P_`D^^44T:F&,CKK "  ''/ "  KK *  " s+A?D0+DD--D00D:ct|d|t|d|t|d|xsgg}|r|j||r|j|ddd|std|t|d|t|d|dy) N_original_path _load_name_redirected_namesr{zMissing FQCN for plugin source ansible_aliases ansible_namer)rLrrr )r_r.r-r6redirected_namesrvnamess r/_update_objectzPluginLoader._update_objectIs %t,\4((*:*@bA  LL "  LL)$B$/ 0!@GH H&.^U1X.rAcB|j|g|i|jSr()get_with_contextr%)r_r-argskwargss r/rGzPluginLoader.get\s%$t$$T;D;F;BBBrAc t|r|j}d}|jdd}|jdd}||jvr|j|}|jxsij |x}r|dj rt|S|j||}|j r |js td|S|j} d| vr)|jrdj|j| f} |j} |j} |jxsij | x}r|dj rt|S|jxsg} | |jvr!|j!| | |j| <d}|j#| |j| | t%|j| |j&} |j(rQt+|j,|j(g } t%||j(}t1| |s td|S|j3|j&| |j4| || |sC t6j9| }|j;|| | | | | j<|g|i||} |j;| | | | | |jt%| ddr| |f|j| <n%|jdtIf|j| <t| |S#t.$rtd|cYSwxYw#t>$rL}d |j@d vr5tBjEd | dtG|td|cYd}~Sd}~wwxYw)z9 instantiates a plugin of the given name using arguments T class_onlyFr1Nrr]r}fromlistfound_in_cacher{abstractrzReturning not found on "z," as it has unimplemented abstract methods; is_stateless)%r! _strip_unsafepoprrrGrvr$r.rorrqr:rprirrlrrSrrrrAttributeError issubclass_display_plugin_loadrr%__new__rur` TypeErrorrxr<vrre)r_r-rxryrr{r1 cached_resultr&r!resolved_type_namer6rsr.r plugin_classinstancerWs r/rwzPluginLoader.get_with_context_s d %%'DZZ e4  **%6= 4<< <<%D"99?RDDTJ JM JP]^_P`PiPi +M: :";;DRa;b"++3F3[3[*41DE E%33 g "5"P"Phh 3 N NPWXYG0EE"77"99?RDDWM MM MS`abScSlSl+M: :.<<B t)) )'+'?'?@RTX'YD  t $"N 143E3Ed3KTRd((.@ ??  7HIF J&vt? c<0.t5HII !!$//3EtG[G[]asANX! Y ">>#.##H.@$HXZab X777 C!3T;KWU  & & 2wsNTY7Z479L3MD ' ' 0  ( ( 448:K:M3ND ' ' 0&s,?@@;" J.t5HII J  *IIl~AJKLAMNO249LMM  s8L$AL2L/.L/2 N;AN;NNNctjrrd|dtjj |d|}t |dkDr|d|j |d}|s|r |d|d|d}tj|y y ) zd formats data to display debug info for plugin loading, also avoids processing unless really needed zLoading z 'z' from rz (searched paths: rz (found_in_cache=z , class_only=N) r DEFAULT_DEBUGr5r6rEr rr<r)r_rr-searched_pathsr6rr{r s r/rz!PluginLoader._display_plugin_loadsj ??1;RWW=M=Md=SUYZC>"Q&368I8I.8YZADnV`a MM#  rAc / K|jdd}|jdd}|jdd}|r |r tdg}d}t}|jD]} t jt t jj| jd} | js|j| |jt| t jjt} |D]} t jj| d } t jj| }t|t }|r| }n|}|s.|t"|j$vrt&j)d |z|d k(s|d k(r(|j$d k(rt&j)d| z|r|| vrt&j)d|z| j+||r| | |vr|}nd|}|j,xsij/|x}r|dj0r |d :| |j2vrZ|j4dvr%dj7t9t;| |}n|} |j=|| }||j2| <d}n|j2| }|jE|||  tG||jH}|jLrGtO|j$|jLg} tG||jL}tQ||s.|jS|jH||jT| |||s ||i|}|jY||| ||j,0d}t[|dr |j\}|s|j_|d |y#t>$r/}t&jAd| dtC|Yd}~d}~wwxYw#tJ$r/}t&jAd| dtC|Yd}~+d}~wwxYw#tJ$rY?wxYw#tV$r/}t&jAd| dtC|Yd}~d}~wwxYww)a Iterate through all plugins of this type, in configured paths (no collections) A plugin loader is initialized with a specific type. This function is an iterator returning all of the plugins of that type to the caller. :kwarg path_only: If this is set to True, then we return the paths to where the plugins reside instead of an instance of the plugin. This conflicts with class_only and both should not be set. :kwarg class_only: If this is set to True then we return the python class which implements a plugin rather than an instance of the plugin. This conflicts with path_only and both should not be set. :kwarg _dedupe: By default, we only return one plugin per plugin name. Deduplication happens in the same way as the :meth:`get` and :meth:`find_plugin` methods resolve which plugin should take precedence. If this is set to False, then we return all of the plugins found, including those with duplicate names. In the case of duplicates, the order in which they are returned is the one that would take precedence first, followed by the others in decreasing precedence order. This should only be used by subclasses which want to manage their own deduplication of the plugins. :*args: Any extra arguments are passed to each plugin when it is instantiated. :**kwargs: Any extra keyword arguments are passed to each plugin when it is instantiated. _dedupeT path_onlyFr{HDo not set both path_only and class_only when calling PluginLoader.all()z*.pyrrz+'%s' skipped due to a defined plugin filterr`baseansible.plugins.cachez!'%s' skipped due to reserved namez'%s' skipped as duplicaterCr)filtertestz{0}_{1}zSkipping plugin (z), cannot load: Nz) as it seems to be invalid: r|r~z ) as it seems to be incomplete: rvREQUIRES_ENABLED)0rr rrrrr5r6r:r^updaterrrErPr+ Jinja2Loaderr9rr<rrRrrGrvrrrabshashrlrHr=rrrSrrrrrrrrrurrrw)r_rxrydeduperr{ all_matchesrlegacy_excluding_builtinrmatchesloaded_modulesr6r-rEis_j2ref_namefqcnrr&rrWr.r needs_enableds r/rIzPluginLoader.allsDDIt,JJ{E2 ZZ e4 ij j #&5 !%!=!=!? F ii "'',,7H7M7Mv*V WXG$--(//8   vg2773C3CD E  Fc D77##D)!,Dww''-Ht\2E#X)FF KhVW:%(f*<QhAh ADHI(n4 9HDE   x ( //)(4"&"="="C!H!H!NN NTabcTdTmTm#A&&4---99 22!* 0 0T$Z( KI (I!55iFF ,2""4(!&++D1  " "8VT : fdoo6 $DLLDOO;LM#*64??#CL"#|4  % %dooxAUAUW[lzHR % Srt.v.C   Xtd  C**6 % 3 23$'$8$8M$))$/2IGc h!OOtU\]^U_$`a" X\^efg^h ij &!rOO_celmneo$pqqrsJ R  O 4R P).R Q.;R *Q2AR  P$O>8R >PR  P>$P93R 9P>>R  Q R  QR  R $R>R R  R NN)T)Fr(rFFN)FFN)"rVrarb__doc__r`rrrrrrrrrrrrrr;r r,r3r.rer5r:r^ __contains__rlrurGrwrrIrcrAr/r,r,s"%HRR:)"B& $$A #3jT c. N>kkZ#<35+0$\m\oGmRigV GL>/&CWAr XrAr,cfeZdZdZd fd ZfdZd dZedZdZ fdZ dZ fd Z xZ S) ra  PluginLoader optimized for Jinja2 plugins The filter and test plugins are Jinja2 plugins encapsulated inside of our plugin format. We need to do a few things differently in the base class because of file == plugin assumptions and dedupe logic. cTtt| ||||||||_i|_y)Nrr)superrr`_plugin_wrapper_type_cached_non_collection_wrappers) r_rrrr9plugin_wrapper_typerr __class__s r/r`zJinja2Loader.__init__hs8 lD*:wX_vI* J$7!/1,rAc8tt| i|_yr()rrrr)r_rs r/rzJinja2Loader._clear_cachesms lD/1/1,rActd)Nz,find_plugin is not supported on Jinja2Loader)NotImplementedError)r_r-r/r"r0r1s r/r3zJinja2Loader.find_pluginqs!"PQQrAc2t|jdzS)Ns)rrrys r/method_map_namezJinja2Loader.method_map_namets0366rAc Bg}djd|d|j|g} ||jvr|j|||j|<|j|}t ||j }|} | td|d| t | |j} | j} | D]g\} } dj|| f}dj|| f}|j| }||vrB|j|||| |j!|i|S#t $r"}td|d|dt|d}~wwxYw#t $r=}tjd|jd t|d ||cYd}~Sd}~wwxYw) Nr}ansible_collectionspluginszFailed to load z for rzCould not find z Ignoring plugins in '' as it seems to be invalid: r)r:rrrlrSrrHrLrrr*r<r=rrrur)r_rr?r-rr&rr.rW plugin_impl method_map plugin_map func_namefuncr!fullplugins r/get_contained_pluginsz"Jinja2Loader.get_contained_pluginsxsHH3ZDIIW[\]  e$"4"44262J2J9Va2b"";/'' 4F&$//2Ce  ZFG G  d.B.BCJ#++-J * #OIthh I67G88Y 23D..t4F    kG  L NN6 " #/ e[*V_`aVbcd d e  OO[_[d[dfmnyfz|}~ N s6AD*+E* E3EE F!2FFFc  |jdd|jddt}|jd}|j|i||jj |x}r`d|_||_|j|_ |jjdrdnd|_ |j|_ t||Sd}t|\}}t!} || vrt#d |zd | j%|t'j(||j*} | st-d j/| t1| j2} | j d ij |j*ij |i} | j d}|r|j dxsd}|j d}|j d}|j*j9d|d|rdnd|}t:j=|||| j2| j d}|r|j dxsd}|j d}|j d}|j*j9d|d|rdnd|}t:j?|||| j2d}tA|| j dd}|rt'jB|s6t#d| j2d| j2d| jDd|d t|| j2\}}t:jGd j/|j*| j2| jD||}nn tI| jJ}| j2}| jNrd!j/|| jN} tQjR|jT|dz"D]\}}}|r tWtX||g|i|}t]|j^|j`}|jc}|D]\}}dji||f} d&| j2d'|j*d| jNd|}!||| fvsL|jk|}|s`|jl}|jo||!|j^j| (|j|_  t||S#t4$r)} t-d j/|t7| d} ~ wwxYw#tL$r} t-t7| d} ~ wwxYw#td$r3} t:jgd#|j*d$|d%| Yd} ~ d} ~ wwxYw#t@$r}"t#t7|"d |")d}"~"wt"t,f$rtd$ru}#t:jgd*j/t7|#t:jGd+j/tqt#t7|#d |#)d}#~#wwxYw),Nr{Fr1r|TrCrBrz*recursive collection redirect found for %rrzinvalid plugin name: {0}zInvalid plugin FQCN ({0}): {1}rrrrsrtz "z" has been deprecated.r)rrrr z" has been removed.)rrrr rrrr}rr)rz&redirecting (type: {0}) {1}.{2} to {3}r)prefix Skipping z plugins in z$'; an error occurred while loading: r`z .plugins.r)orig_excz>An unexpected error occurred during Jinja2 plugin loading: {0}z2Unexpected error during Jinja2 plugin loading: {0})9rrer;_ensure_non_collection_wrappersrrGrvrprnrorrrrqrwr$get_fqcr_and_namerr rRrtry_parse_fqcrrrLrrrr8rtitler<rrrrr~rvvvrrrrpkgutil iter_modules__path__rrrwrSr%rr*rHr=r:rr&rur)%r_r-rxrycontext known_pluginrrleaf_keyseenrtsrW routing_entrydeprecation_entryrrsrttombstone_entryexc_msgrnext_keyr' parent_prefixdummy module_nameispkgrrrrrr!src_nameaprer@rs% r/rwzJinja2Loader.get_with_contextsE <' $d+#%  !23,,,d=f= ??CCDI I< I#G +/G (+7+F+FG (FRF_F_FjFjk}F~1BEGG .%1%>%>G "*<A A)$/ Xud{"#ORV#VXYZZ HHSM&55c499EC9@@EFF [-cnn= FF#3R8<BHb .22>B "1"5"56G"H"&))//"3!4Bse;NVbshjNklxkyz !99,P_frJM..bf:h088%((T:H+99(C&%cnn%55TUXUcUcTddefifrfressuv~u@OO &7xCNN%["( DKKDIIWZWeWegjgsgsu}~sv ) 9 9:C ;;%,,]CKKHM% >-4-A-A#,,WdgjWj-k "){E#( d"L["j[_"jci"jK!(););T=Q=Q!RJ!+!3!3!5J (2 "OIt!hh y'ABG!5cnn5EYtyykYZ[^[f[fZgghirhstHy'22!%!:!:4!@!&1&E&EG //+BTBTBcBcnu/v5;5H5HG2! " "L'vw77 [?FFsIVWLYZZ [b )9Q<( ( )$!OOi {,{mSwxywz${|&) ByDA Ah'   > OO\ccdmnpdqr s KKLSST^T`a by}a"= = >s TU"/V3A U4A V3,V3A V3 U #$UU  U1U,,U14 V0=(V+%V3+V00V33 Y#<WY#.A0YY#c/lK|jdd|jdd}|jdd}|r |r td|j|i||r*d|jj DEd{yd|jj DEd{y7/7w)NrrFr{rc34K|]}|jywr()rnrEws r/rFz#Jinja2Loader.all..0s`Q((`sc3 K|]}|ywr(rcrs r/rFz#Jinja2Loader.all..2sQaQs )rr rrvalues)r_rxryrr{s r/rIzJinja2Loader.all%s 9d#JJ{E2 ZZ e4  ij j,,,d=f= `$2V2V2]2]2_` ` `Q4#G#G#N#N#PQ Q Q a Qs$A>B4B0)B4*B2+B42B4c ~|jrytt||i|D]}|jj d}t ||j} |}|jD]v}d|vr&tj|d|jd.|t |j"vrtjd|z\|j%||} |} |jj'dd k\r-dj)|jj+ddd nd } |j | s| d|} |j-| ||j| || h} |r| j/d|| D]b} |jj1| x}r4tjd | d |jd|jdT| |j| <dyy#t$rF}tjd|jdt|jd|Yd}~d}~wwxYw)NrCrrrr}z skipped in z.; Jinja plugin short names may not contain "."z)%s skipped due to a defined plugin filterrrz Jinja plugin z from z" skipped; shadowed by plugin from r)rrrrIrrrrSrrHr<vvvvrrrnkeysrr9rrcountr:rrurRrG)r_rxryp_map is_builtin plugins_listrrW plugin_namewrapperrr target_names target_nameexisting_pluginrs r/rz,Jinja2Loader._ensure_non_collection_wrappers4sn  / / <2DCFC( PE++667IJJ#5$*>*>?L &. '||~ P +%MM[Me>R>R=STB#CD/$,,"??MM"MP["[\33GK4HI"LQL^L^LdLdehLimnLnSXXe&8&8&>&>s&CBQ&GHtv "--j9(\;-8D##G[%:N:NY]#^ +T2  $$'7 }%EF#/PK*.*N*N*R*RS^*___ k]&I]I]H^_AAPA_A_@``a'cd HOD88E P/ P( P  \`\e\egnotpDpDhEGHIJ sG-- H<6;H77H<rr)rVrarbrr`rr3rrrrwrIr __classcell__)rs@r/rr`sK2 2R77"LE8N R-P-PrArcZd|vr|}|dz|z}||fS|jdd}|}||fS)Nr}r{)r)rrr-fqcrs r/rrdsN (C(* :~~c"2& :rAc t}d}tjd}ntj}d}tjj |rt |d5} t|j} ddd d}t|}|j}|dk(r t!|d |d <|d |d <nKtjd j|n&|r$tjdj|d|d vr#t%djt'||S#t$rC}tjdj|t||cYd}~cdddSd}~wwxYw#1swYxYw#t$r)tjdj||cYSwxYw#t"$r)tjd j||cYSwxYw)NFz/etc/ansible/plugin_filters.ymlTrbz;The plugin filter file, {0} was not parsable. Skipping: {1}filter_versionz2The plugin filter file, {0} was invalid. Skipping.z1.0module_rejectlistansible.moduleszXUnable to parse the plugin filter file {0} as module_rejectlist is not a list. Skipping.ansible.plugins.actionz^The plugin filter file, {0} was a version not recognized by this version of Ansible. Skipping.z5The plugin filter file, {0} does not exist. Skipping.statzThe stat module was specified in the module reject list file, {0}, but Ansible will not function without the stat module. Please remove stat from the reject list.)r9rPLUGIN_FILTERS_CFGr5r6ropenrreadrHr<r=rrrLstrip frozensetrr r)filtersuser_set filter_cfgr* filter_datarWrs r/_load_plugin_filterr osGH#6 ))  ww~~j! *d # q '1   !"23G'"--/ f  -6{CV7W-X)* 188I0JG, - OO>>DfZ>P R  OO**0&*< >*++44:F9Z;P4QS S NQ !228&WQZ2PR        OO**0&*< >N  !..4fZ.@B  sZFD5>F$G5 F>/E<-F.F<FFF/GG/G87G8ctjtdj||t |} t |j ddtsatjjd}dj|t}|dk(rtj|y|dk(r t|yy#t$rt$r/}tjdj||Yd}~yd}~wwxYw) NzLoading collection {0} from {1}requires_ansibler'COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCHz3Collection {0} does not support Ansible version {1}r=errorzQError parsing collection metadata requires_ansible value from collection {0}: {1})r<rrrr(_does_collection_support_ansible_versionrGansible_versionrrget_config_valuer=rr rH)rcollection_pathrmismatch_behaviormessager@s r/_on_collection_load_handlerrs LL:AA/Sbcde.?O I78K8KL^`b8cetu ! 9 9:c d KRRSbdstG I-("g->wGG. v  IkrrtCEGH I IIsA/B=+B==C>%C99C>c|sytstjdyt|}t|j}|j |S)NTz_packaging Python module unavailable; unable to validate collection Ansible version requirements)r"r<r=r# base_versioncontains)requirement_stringrssbase_ansible_versions r/rrsI  yz ( )B#?3@@ ;;+ ,,rActjrtjdy|g}t |t j z}t|t j}|jtxjtz c_ y)Nz3AnsibleCollectionFinder has already been configured) rcollection_finderrbwarnrrCOLLECTIONS_PATHSrCOLLECTIONS_SCAN_SYS_PATH_installon_collection_loadr)prefix_collections_pathrXfinders r/_configure_collection_loaderr$sm00 KL&"$ ( )A,?,? ?E %eQ-H-H IF OO..2MM.rAc.tt|y)aInitialize the plugin filters and the collection loaders This method must be called to configure and insert the collection python loaders into ``sys.meta_path`` and ``sys.path_hooks``. This method is only called in ``CLI.run`` after CLI args have been parsed, so that instantiation of the collection finder can utilize parsed CLI args, and to not cause side effects. N)r r$)r"s r/init_plugin_loaderr&s !89rAModuleDocFragmentzansible.plugins.doc_fragments doc_fragments ActionModuleraction_plugins ActionBase)r CacheModuler cache_pluginsCallbackModulezansible.plugins.callbackcallback_plugins Connectionzansible.plugins.connectionconnection_pluginsparamiko paramiko_sshConnectionBaser ShellModulezansible.plugins.shell shell_pluginsrrlibraryzansible.module_utils module_utils LookupModulezansible.plugins.lookuplookup_plugins LookupBase FilterModulezansible.plugins.filterfilter_plugins TestModulezansible.plugins.test test_pluginsStrategyModulezansible.plugins.strategystrategy_plugins StrategyBaseTerminalModulezansible.plugins.terminalterminal_plugins TerminalBase VarsModulezansible.plugins.varsrCliconfzansible.plugins.cliconfcliconf_plugins CliconfBaseNetconfzansible.plugins.netconfnetconf_plugins NetconfBaseInventoryModulezansible.plugins.inventoryinventory_pluginsHttpApizansible.plugins.httpapihttpapi_plugins HttpApiBase BecomeModulezansible.plugins.becomebecome_pluginsr)rBr()| __future__rrr5os.pathrrTrb collectionsrrrfr tracebackr"ansible.module_utils.compat.typingr8compattypingtrr rr ansibler rr ransible.errorsr rrr+ansible.module_utils.common.text.convertersrrransible.module_utils.sixransible.parsing.utils.yamlransible.parsing.yaml.loaderransible.pluginsrrrransible.utils.collection_loaderrr2ansible.utils.collection_loader._collection_finderrransible.utils.displayransible.utils.plugin_docsr ansible.utils.unsafe_proxyr!packaging.specifiersr"packaging.versionr#rimportlib.utilrr9r<r$r0r@rPrZr%r\rer,rrr rrr$r&DOC_FRAGMENT_PLUGIN_PATHrDEFAULT_ACTION_PLUGIN_PATH action_loaderDEFAULT_CACHE_PLUGIN_PATH cache_loaderDEFAULT_CALLBACK_PLUGIN_PATHcallback_loaderDEFAULT_CONNECTION_PLUGIN_PATHconnection_loaderrFDEFAULT_MODULE_PATH module_loaderDEFAULT_MODULE_UTILS_PATHmodule_utils_loaderps_module_utils_loaderDEFAULT_LOOKUP_PLUGIN_PATH lookup_loaderDEFAULT_FILTER_PLUGIN_PATH filter_loaderDEFAULT_TEST_PLUGIN_PATH test_loaderDEFAULT_STRATEGY_PLUGIN_PATHstrategy_loaderDEFAULT_TERMINAL_PLUGIN_PATHterminal_loaderDEFAULT_VARS_PLUGIN_PATH vars_loaderDEFAULT_CLICONF_PLUGIN_PATHcliconf_loaderDEFAULT_NETCONF_PLUGIN_PATHnetconf_loaderDEFAULT_INVENTORY_PLUGIN_PATHinventory_loaderDEFAULT_HTTPAPI_PLUGIN_PATHhttpapi_loaderBECOME_PLUGIN_PATH become_loaderrcrAr/rs#  /# ..'#2"LLTT105YYYq)311) i( )$%>K`@ab_ rB5!! OOdTTnAP<APH5rI& - N" :"#   $    "" ! $$  ((     # &   $        ""& ""&    !!%  !!%  ##  !!%   g2LGs. K K"!K"