ó Á£ô_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Œx…|D]}}y tjjj||jƒƒWqtjjjk rƒ}|j|jƒrt j d|j|j |dt ƒnt SXqWt S(s<Verify that the plugin conforms to the specified interfaces.s/%s implements %s but object does not verify: %stexc_info(tzopet interfacetverifyt verifyObjectR1t exceptionstBrokenImplementationR'R Rtdebugt__name__RR(RR+R)terror((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR5ƒs   cCs)|jstjd|ƒn|jdk S(s%Has the plugin been prepared already?s$.prepared called on uninitialized %rN(R.RR9RR (R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytprepared‘s cCsÜ|jdkrÕy|jjƒWn¦tjk rZ}tjd||dtƒ||_qÕtj k r‘}tjd||dtƒ||_qÕtj k rÈ}tjd||dtƒ||_qÕXt|_n|jS(sMemoized plugin preparation.sMisconfigured %r: %sR2sNo installation (%r): %ssOther error:(%r): %sN( RR RtprepareRtMisconfigurationErrorRR9RtNoInstallationErrort 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(RARt 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?(RRRB(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 RtjoinR3R4R'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.R1R5R<R=RBRDRERFRJ(((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 Cs-i}tjdƒ}|r*|jdƒng}tjj|ƒx|D]}tjj|ƒqGWt j tj t j ƒtj t jƒƒ}x•|D]}|j||dtƒ}|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}(Rtgetenvtsplittsystpathtextendt pkg_resourcest working_sett add_entryt itertoolstchaintiter_entry_pointsRtSETUPTOOLS_PLUGINS_ENTRY_POINTt"OLD_SETUPTOOLS_PLUGINS_ENTRY_POINTt_load_entry_pointRRRtPREFIX_FREE_DISTRIBUTIONSRR$R R RR"( RRXtplugin_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 (ttypeRURVRW(RRz((RzsC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytfilterscCs|jd„ƒS(s#Filter plugins based on visibility.cSs|j S(N(R$(Rm((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(R5(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.pyR5&scCs)gtj|jƒD]}|jƒ^qS(s$Prepare all plugins in the registry.(RURyRWR=(RRm((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyR=*scCs|jd„ƒS(s%Filter plugins based on availability.cSs|jS(N(RE(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.pyRE.scCsRgtj|jƒD]'}|jr|jƒ|kr|^q}|rN|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. iN(RURyRWR.R1R (RtpluginRmt 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:RGRURyRW(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRFIscCs0|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(RWRGRURy(R((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRJNs (R:RKRLRRNRpRgRtRvRxR1R|R~R+R5R=RER‚RFRJ(((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pyRQÒs"              (RLRRRbtloggingR\R_RUtzope.interfaceR3tzope.interface.verifytacme.magic_typingRRRRtcertbot._internalRtcertbot.compatRtcollections.abcRt ImportErrort getLoggerR:RRhtobjectRRQ(((sC/usr/lib/python2.7/site-packages/certbot/_internal/plugins/disco.pytsJ          ¢