ó Á£ô_c@sfdZddlZddlZddlZddlZddlZddlZddlZddl Zddl m Z ddl m Z ddl mZddlmZddlmZyddlmZWn!ek ríddlmZnXejeƒZd d d d d ddddddddddddgZdefd„ƒYZdefd„ƒYZdS(s.Utilities for plugins discovery and selection.iÿÿÿÿN(tDict(terrors(t interfaces(t constants(tos(tMappingtcertbotscertbot-apachescertbot-dns-cloudflarescertbot-dns-cloudxnsscertbot-dns-digitaloceanscertbot-dns-dnsimplescertbot-dns-dnsmadeeasyscertbot-dns-gehirnscertbot-dns-googlescertbot-dns-linodescertbot-dns-luadnsscertbot-dns-nsonescertbot-dns-ovhscertbot-dns-rfc2136scertbot-dns-route53scertbot-dns-sakuraclouds certbot-nginxtPluginEntryPointcBseZdZdZed„Zd„Zed„ƒZ e d„ƒZ e d„ƒZ e d„ƒZ e jd„ƒZ e d„ƒZejd „ƒZd „Ze d „ƒZdd „Zd „Ze d„ƒZd„Ze d„ƒZe d„ƒZe d„ƒZd„Zd„ZRS(sPlugin entry point.cCs^|j||ƒ|_|jƒ|_||_d|_d|_d|_t |_ d|_ dS(N( tentry_point_to_plugin_nametnametloadt plugin_clst entry_pointtNonetwarning_messaget _initializedt _preparedtFalset_hiddent_long_description(tselfR t with_prefix((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt__init__6s     cCs3||jkr/|jr+tj|jƒntStS(s(Check if the name refers to this plugin.(R RtloggertwarningtTrueR(RR ((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt check_name@s  cCs"|r|jjd|jS|jS(s)Unique plugin name for an ``entry_point``t:(tdisttkeyR (tclsR R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRHscCs |jjS(sDescription of the plugin.(R t description(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyROscCsdj|j|jƒS(s$Description with name. Handy for UI.s {0} ({1})(tformatRR (R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytdescription_with_nameTscCs:|jr|jSy|jjSWntk r5|jSXdS(sLong description of the plugin.N(RR tlong_descriptiontAttributeErrorR(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR"Ys   cCs ||_dS(N(R(RR((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR"cscCs|jpt|jdtƒS(s%Should this plugin be hidden from UI?thidden(RtgetattrR R(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR$gscCs ||_dS(N(R(Rthide((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR$lscs!| p t‡fd†|DƒƒS(s2Does plugin implements specified interface groups?c3s+|]!}t‡fd†|DƒƒVqdS(c3s!|]}|jˆjƒVqdS(N(t implementedByR (t.0tiface(R(sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pys ssN(tall(R(tifaces(R(sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pys ss(tany(Rt ifaces_groups((RsC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR+ps  cCs |jdk S(s(Has the plugin been initialized already?N(RR (R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt initializedwscCs8|js1|jjƒ|j||jƒ|_n|jS(sMemoized plugin initialization.(R.R trequireR R R(Rtconfig((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytinit|s  cCs›|jst‚x…|D]}}y tjjj||jƒƒWqtjjjk r’}|j |j ƒrŽt j d|j |j |dtƒntSXqWtS(s<Verify that the plugin conforms to the specified interfaces.s/%s implements %s but object does not verify: %stexc_info(R.tAssertionErrortzopet interfacetverifyt verifyObjectR1t exceptionstBrokenImplementationR'R Rtdebugt__name__RR(RR+R)terror((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR6ƒs   cCs)|jstjd|ƒn|jdk S(s%Has the plugin been prepared already?s$.prepared called on uninitialized %rN(R.RR:RR (R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytprepared‘s cCsë|jst‚|jdkräy|jjƒWn¦tjk ri}tj d||dt ƒ||_qätj k r }tj d||dt ƒ||_qätj k r×}tj d||dt ƒ||_qäXt |_n|jS(sMemoized plugin preparation.sMisconfigured %r: %sR2sNo installation (%r): %ssOther error:(%r): %sN( R.R3RR RtprepareRtMisconfigurationErrorRR:RtNoInstallationErrort PluginError(RR<((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR>˜s     cCst|jtjƒS(sIs plugin misconfigured?(t isinstanceRRR?(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt misconfigured¬scCst|jtƒr|jSdS(sGReturn the Exception raised during plugin setup, or None if all is wellN(RBRt ExceptionR (R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytproblem±scCs|jtkp|jS(s4Is plugin available, i.e. prepared or misconfigured?(RRRC(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt available¸scCsdj|jƒS(NsPluginEntryPoint#{0}(R R (R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt__repr__½scCsÁdj|jƒdj|jjƒdjdjd„tjj|jƒDƒƒƒdj|jƒg}|j r´|j dj|j ƒƒƒ|j r´|j dj|j ƒƒƒq´nd j|ƒS( Ns* {0}sDescription: {0}sInterfaces: {0}s, css|]}|jVqdS(N(R;(R(R)((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pys ÅssEntry point: {0}sInitialized: {0}s Prep: {0}s (R R R RtjoinR4R5R'R R.tappendR1R=R>(Rtlines((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt__str__Às   "N(R;t __module__t__doc__R t__hash__RRRt classmethodRtpropertyRR!R"tsetterR$R+R.R1R6R=R>RCRERFRGRK(((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR0s,       tPluginsRegistrycBsªeZdZd„Zed„ƒZed„ƒZd„Zd„Zd„Z d„Z d„Z d „Z d „Z d „Zd „Zd „Zd„Zd„Zd„ZRS(sPlugins registry.cCs%tjttj|ƒƒƒ|_dS(N(t collectionst OrderedDicttsortedtsixt iteritemst_plugins(Rtplugins((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRÕsc CsBi}tjdƒ}|r*|jdƒng}tjj|ƒx|D]}tjj|ƒqGWt j tj t j ƒtj t jƒƒ}xª|D]¢}|j||dtƒ}|jdk sÅt‚|jjtkr’|j||dtƒ}t|_dj|j|jƒ} | |_dj| |jƒ|_q’q’W||ƒS(s+Find plugins using setuptools entry points.tCERTBOT_PLUGIN_PATHRRsRPlugin legacy name {0} may be removed in a future version. Please use {1} instead.s(WARNING: {0}) {1}N(Rtgetenvtsplittsystpathtextendt pkg_resourcest working_sett add_entryt itertoolstchaintiter_entry_pointsRtSETUPTOOLS_PLUGINS_ENTRY_POINTt"OLD_SETUPTOOLS_PLUGINS_ENTRY_POINTt_load_entry_pointRRR R3RtPREFIX_FREE_DISTRIBUTIONSRR$R R RR"( RRYtplugin_paths_stringt plugin_pathst plugin_patht entry_pointsR t plugin_eptprefixed_plugin_eptmessage((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytfind_allÜs.     cCs—t||ƒ}|j|kr^||j}tdj|j|jjj|jjjƒƒ‚ntjj |j ƒrƒ|||js (ttypeRVRWRX(RR{((R{sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytfilterscCs|jd„ƒS(s#Filter plugins based on visibility.cSs|j S(N(R$(Rn((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt s(R}(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytvisiblescs|j‡fd†ƒS(s#Filter plugins based on interfaces.cs |jˆŒS(N(R+(tp_ep(R-(sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR~$s(R}(RR-((R-sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR+"scs|j‡fd†ƒS(s%Filter plugins based on verification.cs |jˆƒS(N(R6(R€(R+(sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR~(s(R}(RR+((R+sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR6&scCs)gtj|jƒD]}|jƒ^qS(s$Prepare all plugins in the registry.(RVRzRXR>(RRn((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR>*scCs|jd„ƒS(s%Filter plugins based on availability.cSs|jS(N(RF(R€((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR~0s(R}(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRF.scCsjgtj|jƒD]'}|jr|jƒ|kr|^q}t|ƒdksXt‚|rf|dSdS(sÚFind an initialized plugin. This is particularly useful for finding a name for the plugin (although `.IPluginFactory.__call__` takes ``name`` as one of the arguments, ``IPlugin.name`` is not part of the interface):: # plugin is an instance providing IPlugin, initialized # somewhere else in the code plugin_registry.find_init(plugin).name Returns ``None`` if ``plugin`` is not found in the registry. iiN(RVRzRXR.R1RxR3R (RtpluginRnt candidates((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyt find_init3s 'cCs5dj|jjdjd„tj|jƒDƒƒƒS(Ns{0}({1})t,css|]}t|ƒVqdS(N(trepr(R(R€((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pys Ls(R t __class__R;RHRVRzRX(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRGIscCs0|js dSdjd„tj|jƒDƒƒS(Ns No pluginss css|]}t|ƒVqdS(N(tstr(R(R€((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pys Qs(RXRHRVRz(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRKNs (R;RLRMRRORqRhRuRwRyR1R}RR+R6R>RFRƒRGRK(((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRRÒs"              (RMRSRctloggingR]R`RVtzope.interfaceR4tzope.interface.verifytacme.magic_typingRRRRtcertbot._internalRtcertbot.compatRtcollections.abcRt ImportErrort getLoggerR;RRitobjectRRR(((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytsJ          ¢