3
گaA @ s d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
dd lm Z dd
lm Z dd lm
Z
dd lmZ ddlZddlZddlZddlZdd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddl m Z ej e Z dddddddddd d d d d d!d"d#gZ!G d$d% d%Z"G d&d' d'e Z#d(Z$d)Z%d*Z&d+Z'e
ej( e
e)d,d-d.Z*e
ej( e
e)d,d/d0Z+ej(e
ej( e
e)d1d2d3Z,dS )4z.Utilities for plugins discovery and selection. N)Callable)cast)Dict)Iterable)Iterator)List)Mapping)Optional)Type)Union)
configuration)errors)
interfaces) constants)os)Errorcertbotzcertbot-apachezcertbot-dns-cloudflarezcertbot-dns-cloudxnszcertbot-dns-digitaloceanzcertbot-dns-dnsimplezcertbot-dns-dnsmadeeasyzcertbot-dns-gehirnzcertbot-dns-googlezcertbot-dns-linodezcertbot-dns-luadnszcertbot-dns-nsonezcertbot-dns-ovhzcertbot-dns-rfc2136zcertbot-dns-route53zcertbot-dns-sakuracloudz
certbot-nginxc @ s e Zd ZdZdZd2ejeddddZe e
eddd Z e ejee
dd
d Z
ee
d d
dZee
d ddZee
d ddZeje
ddddZeed ddZejeddddZee edddZeed d d Zd3e ej ejd d d Z ee ed!d"d#Z eed d$d%Z e ee f d d&d'Z!eed d(d)Z"ee e# d d*d+Z$eed d,d-Z%e
d d.d/Z&e
d d0d1Z'dS )4PluginEntryPointzPlugin entry point.NF) entry_point with_prefixreturnc C s@ | j ||| _|j | _|| _d | _d | _d | _d| _d | _ d S )NF)
entry_point_to_plugin_namenameload
plugin_clsr warning_message _initialized _prepared_hidden_long_description)selfr r r! /usr/lib/python3.6/disco.py__init__: s
zPluginEntryPoint.__init__)r r c C s$ || j kr | jr tj| j dS dS )z(Check if the name refers to this plugin.TF)r r loggerwarning)r r r! r! r"
check_nameD s
zPluginEntryPoint.check_namec C s6 |r0|j s tjd|j d|j jd |j S |jS )z)Unique plugin name for an ``entry_point``z Entrypoint z has no distribution!:)distr
r r key)clsr r r! r! r" r L s
z+PluginEntryPoint.entry_point_to_plugin_name)r c C s | j jS )zDescription of the plugin.)r description)r r! r! r" r+ V s z PluginEntryPoint.descriptionc C s dj | j| jS )z$Description with name. Handy for UI.z {0} ({1}))formatr+ r )r r! r! r" description_with_name[ s z&PluginEntryPoint.description_with_namec C s | j r | j S t| jd| jS )z Long description of the plugin.long_description)r getattrr r+ )r r! r! r" r. ` s z!PluginEntryPoint.long_description)r+ r c C s
|| _ d S )N)r )r r+ r! r! r" r. g s c C s | j pt| jddS )z%Should this plugin be hidden from UI?hiddenF)r r/ r )r r! r! r" r0 k s zPluginEntryPoint.hidden)hider c C s
|| _ d S )N)r )r r1 r! r! r" r0 p s )
ifaces_groupsr c s | pt fdd|D S )z2Does plugin implements specified interface groups?c 3 s$ | ] }t fd d|D V qdS )c 3 s | ]}t j|V qd S )N) _implementsr ).0iface)r r! r" w s z4PluginEntryPoint.ifaces...N)all)r4 ifaces)r r! r" r6 w s z*PluginEntryPoint.ifaces..)any)r r2 r! )r r" r8 t s
zPluginEntryPoint.ifacesc C s
| j dk S )z(Has the plugin been initialized already?N)r )r r! r! r" initialized{ s z PluginEntryPoint.initialized)configr c C s& | j s | jj | j|| j| _ | j S )z Memoized plugin initialization.)r r Zrequirer r )r r; r! r! r" init s
zPluginEntryPoint.init)r8 r c C s6 | j stdx"|D ]}t| j | j|sdS qW dS )z.zEntry point: {0}zInitialized: {0}z Prep: {0}
) r, r r r+ joinmror r: appendr< rA rC )r linesr! r! r" __str__ s
zPluginEntryPoint.__str__)F)N)(rN rM __qualname____doc____hash__
pkg_resources
EntryPointrE r# r strr& classmethodr propertyr+ r- r. setterr0 r r
r8 r: r NamespaceConfigr Pluginr< r? rA r r rC rH rI rJ rK rL rT r! r! r! r" r 4 sF
r c @ sN e Zd ZdZeeef ddddZed dddZ ee
j e eef e
ed d
d Zeed d
dZee dddZedddZejeej dddZeege
f d dddZd dddZ e e d dd d Z e e d d d d Z ee!e
e"f dd!d"Z#d dd#d$Z$eje%e d%d&d'Z&edd(d)Z'edd*d+Z(dS ),PluginsRegistryzPlugins registry.N)pluginsr c C s t t|j | _d S )N)dictsorteditems_plugins)r ra r! r! r" r# s zPluginsRegistry.__init__)r c
C s i }t jd}|r |jdng }tjj| x|D ]}tjj| q2W t j
tj t j
tj t j}xr|D ]j}| j||dd}|jdk st|jjtkrh| j||dd}d|_dj|j|j} | |_dj| |j|_qhW | |S ) z+Find plugins using setuptools entry points.ZCERTBOT_PLUGIN_PATHr' F)r NTzRPlugin legacy name {0} may be removed in a future version. Please use {1} instead.z(WARNING: {0}) {1})r getenvsplitsyspathextendrX Z working_setZ add_entry itertoolschainZiter_entry_pointsr Z SETUPTOOLS_PLUGINS_ENTRY_POINTZ"OLD_SETUPTOOLS_PLUGINS_ENTRY_POINT_load_entry_pointr( AssertionErrorr) PREFIX_FREE_DISTRIBUTIONSr0 r, r r r. )
r* ra Zplugin_paths_stringZ plugin_pathsZ plugin_pathZ entry_pointsr plugin_epZprefixed_plugin_epmessager! r! r" find_all s.
zPluginsRegistry.find_all)r ra r r c C s t ||}|j|kr^||j }|jjr0|jjjnd}|jjrF|jjjnd}tdj|j||t|jt j
rx|||j< n t j d| |S )Nunknownz+Duplicate plugin name {0} from {1} and {2}.z)%r does not inherit from Plugin, skipping)
r r r r( r) rI r, _providesr r r_ r$ r% )r* r ra r rp Zother_epZplugin1Zplugin2r! r! r" rm s
z!PluginsRegistry._load_entry_point)r r c C s
| j | S )N)re )r r r! r! r" __getitem__ s zPluginsRegistry.__getitem__c C s
t | jS )N)iterre )r r! r! r" __iter__ s zPluginsRegistry.__iter__c C s
t | jS )N)lenre )r r! r! r" __len__ s zPluginsRegistry.__len__)r; r c s fdd| j j D S )z'Initialize all plugins in the registry.c s g | ]}|j qS r! )r< )r4 rp )r; r! r"
s z(PluginsRegistry.init..)re values)r r; r! )r; r" r< s
zPluginsRegistry.init)predr c s t | fdd| jj D S )z"Filter plugins based on predicate.c s i | ]\}} |r||qS r! r! )r4 r rp )r| r! r"
$ s z*PluginsRegistry.filter..)typere rd )r r| r! )r| r" filter" s zPluginsRegistry.filterc C s | j dd S )z#Filter plugins based on visibility.c S s | j S )N)r0 )rp r! r! r" ) s z)PluginsRegistry.visible..)r )r r! r! r" visible' s zPluginsRegistry.visible)r2 r c s | j fddS )z#Filter plugins based on interfaces.c s
| j S )N)r8 )p_ep)r2 r! r" r - s z(PluginsRegistry.ifaces..)r )r r2 r! )r2 r" r8 + s zPluginsRegistry.ifaces)r8 r c s | j fddS )z%Filter plugins based on verification.c s
| j S )N)r? )r )r8 r! r" r 1 s z(PluginsRegistry.verify..)r )r r8 r! )r8 r" r? / s zPluginsRegistry.verifyc C s dd | j j D S )z$Prepare all plugins in the registry.c S s g | ] }|j qS r! )rC )r4 rp r! r! r" rz 5 s z+PluginsRegistry.prepare..)re r{ )r r! r! r" rC 3 s zPluginsRegistry.preparec C s | j dd S )z%Filter plugins based on availability.c S s | j S )N)rK )r r! r! r" r 9 s z+PluginsRegistry.available..)r )r r! r! r" rK 7 s zPluginsRegistry.available)pluginr c s8 fdd| j j D }t|dks(t|r4|d S dS )aM Find an initialized plugin.
This is particularly useful for finding a name for the plugin::
# plugin is an instance providing Plugin, initialized
# somewhere else in the code
plugin_registry.find_init(plugin).name
Returns ``None`` if ``plugin`` is not found in the registry.
c s" g | ]}|j r|j kr|qS r! )r: r< )r4 rp )r r! r" rz I s z-PluginsRegistry.find_init.. r N)re r{ rx rn )r r Z
candidatesr! )r r" find_init< s
zPluginsRegistry.find_initc C s& dj | jjdjdd | jj D S )Nz{0}({1}),c s s | ]}t |V qd S )N)repr)r4 r r! r! r" r6 S s z+PluginsRegistry.__repr__..)r, __class__rN rP re r{ )r r! r! r" rL P s
zPluginsRegistry.__repr__c C s$ | j s
dS djdd | j j D S )Nz
No pluginsz
c s s | ]}t |V qd S )N)rZ )r4 r r! r! r" r6 X s z*PluginsRegistry.__str__..)re rP r{ )r r! r! r" rT U s zPluginsRegistry.__str__))rN rM rU rV r rZ r r# r[ rr rX rY r rE rm ru r rw intry r r^ r r r_ r< r r r r r
r8 r? r r rC rK r r rL rT r! r! r! r" r` s*
r` zbZope interface certbot.interfaces.IPlugin is deprecated, use ABC certbot.interface.Plugin instead.zpZope interface certbot.interfaces.IAuthenticator is deprecated, use ABC certbot.interface.Authenticator instead.zhZope interface certbot.interfaces.IInstaller is deprecated, use ABC certbot.interface.Installer instead.ziZope interface certbot.interfaces.IPluginFactory is deprecated, use ABC certbot.interface.Plugin instead.) target_classr5 r c C sB t | |rdS |tjkr>tjj| r>tjt tj tt
dS dS )NTF)
issubclassr r_ ZIPluginFactoryZ
providedByloggingr% _DEPRECATION_FACTORYwarningswarnDeprecationWarning)r r5 r! r! r" rt h s
rt c C s t | |rdS |tjkr>tjj| r>tjt tj tt
dS |tj krntj j| rntjt
tj t
t
dS |tjkrtjj| rtjt tj tt
dS dS )NTF)r r r_ IPlugin
implementedByr r% _DEPRECATION_PLUGINr r r
AuthenticatorIAuthenticator_DEPRECATION_AUTHENTICATOR Installer
IInstaller_DEPRECATION_INSTALLER)r r5 r! r! r" r3 t s
r3 )target_instancer r5 r c C s t ||rdS d }d}|tjkr*tj}t}|tjkr>tj}t}|tjkrRtj }t
}|sft d|j y*t
jjj|| tj| tj|t dS t
jjjk
r } z&|j|rtjd||j |dd W Y d d }~X nX dS )NT zUnexpected type: z/%s implements %s but object does not verify: %s)rB F)r r r_ r r r r r r r r r= rN zopeZ interfacer? Z verifyObjectr r% r r r
exceptionsZBrokenImplementationr r$ r@ )r r r5 Z
zope_ifacerq rF r! r! r" r> s4
"r> )-rV rk r rh Ztypingr r r r r r r r r
r r rX Zzope.interfacer Zzope.interface.verifyr r r
r Zcertbot._internalr Zcertbot.compatr Zcertbot.errorsr Z getLoggerrN r$ ro r r` r r r r r_ rE rt r3 r> r! r! r! r" sj
$