JFIF $
d d 7
Viewing File: /usr/lib/python3.9/site-packages/certbot/_internal/plugins/__pycache__/disco.cpython-39.pyc
a
}|�g�, � @ s0 d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z dd lm
Z
dd
lm Z dd lm Z dd lm
Z
dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ejdkr�ddlmZ nddlZe� e �Z ej ej ej!gZ"G dd� d�Z#G dd� de
�Z$dS )z.Utilities for plugins discovery and selection.� N)�Callable)�cast)�Dict)�Iterable)�Iterator)�List)�Mapping)�Optional)�Type)�Union)�
configuration)�errors)�
interfaces)� constants)�os)�Error)� �
c @ sV e Zd ZdZdZejdd�dd�Zee e
d�dd�Z e eje d�d d
��Z
ee d �d d
��Zee d �dd��Zee d �dd��Zee
d �dd��Zee e
d�dd�Zee
d �dd��Zd*eej ejd�dd�Zee
d �d d ��Z e e
e f d �d d �Z ee
d �d d!��Z eee! d �d"d#��Z"ee
d �d$d%��Z#e d �d&d'�Z$e d �d(d)�Z%dS )+�PluginEntryPointzPlugin entry point.N)� entry_point�returnc C s2 | � |�| _|�� | _|| _d | _d | _d | _d S �N)�entry_point_to_plugin_name�name�load�
plugin_clsr Zwarning_message� _initialized� _prepared)�selfr � r �C/usr/lib/python3.9/site-packages/certbot/_internal/plugins/disco.py�__init__( s
zPluginEntryPoint.__init__�r r c C s || j krdS dS )z(Check if the name refers to this plugin.TF�r �r r r r r �
check_name0 s
zPluginEntryPoint.check_namec C s |j S )z)Unique plugin name for an ``entry_point``r# )�clsr r r r r 6 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( ; s z PluginEntryPoint.descriptionc C s d� | j| j�S )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 t | jd| j�S )z Long description of the plugin.�long_description)�getattrr r( r) r r r r, E s z!PluginEntryPoint.long_descriptionc C s t | jdd�S )z%Should this plugin be hidden from UI?�hiddenF)r- r r) r r r r. J s zPluginEntryPoint.hidden��
ifaces_groupsr c s | pt � fdd�|D ��S )z1Does plugin implement specified interface groups?c 3 s$ | ] }t � fd d�|D ��V qdS )c 3 s | ]}t � j|�V qd S r )�
issubclassr ��.0Zifacer) r r � <genexpr>R s �z4PluginEntryPoint.ifaces.<locals>.<genexpr>.<genexpr>N)�all)r3 �ifacesr) r r r4 Q s � �z*PluginEntryPoint.ifaces.<locals>.<genexpr>)�any�r r0 r r) r r6 O s �zPluginEntryPoint.ifacesc C s
| j duS )z(Has the plugin been initialized already?N)r r) r r r � initializedV s z PluginEntryPoint.initialized��configr c C s | j s| �|| j�| _ | j S )z Memoized plugin initialization.)r r r �r r; r r r �init[ s zPluginEntryPoint.initc C s | j st�d| � | jduS )z%Has the plugin been prepared already?z$.prepared called on uninitialized %rN)r9 �logger�debugr r) r r r �preparedc s zPluginEntryPoint.preparedc
C s� | j du rtd��| jdu r�z| j �� W n� tjyh } z$tjd| |dd� || _W Y d}~n�d}~0 tjy� } z$tjd| |dd� || _W Y d}~nLd}~0 tj y� } z$tjd| |dd� || _W Y d}~nd}~0 0 d| _t
t t t
f | j�S )z Memoized plugin preparation.NzPlugin is not initialized.zMisconfigured %r: %sT)�exc_infozNo installation (%r): %szOther error:(%r): %s)r �
ValueErrorr �preparer
�MisconfigurationErrorr> r? ZNoInstallationError� PluginErrorr r �boolr )r �errorr r r rC j s$
� zPluginEntryPoint.preparec C s t | jtj�S )zIs plugin misconfigured?)�
isinstancer r
rD r) r r r �
misconfigured� s z PluginEntryPoint.misconfiguredc C s t | jt�r| jS dS )zGReturn the Exception raised during plugin setup, or None if all is wellN)rH r � Exceptionr) r r r �problem� s zPluginEntryPoint.problemc C s | j du p| jS )z4Is plugin available, i.e. prepared or misconfigured?T)r rI r) r r r � available� s zPluginEntryPoint.availablec C s d� | j�S )NzPluginEntryPoint#{0})r* r r) r r r �__repr__� s zPluginEntryPoint.__repr__c s~ d� � j�d� � jj�d� d�� fdd�tD ���d� � j�g}� jrt|�d� � � � �� � j
rt|�d � � � � �� d
�|�S ) Nz* {0}zDescription: {0}zInterfaces: {0}z, c 3 s | ]}t � j|�r|jV qd S r )r1 r �__name__r2 r) r r r4 � s �z+PluginEntryPoint.__str__.<locals>.<genexpr>zEntry point: {0}zInitialized: {0}z Prep: {0}�
) r* r r r( �join�PLUGIN_INTERFACESr r9 �appendr= r@ rC )r �linesr r) r �__str__� s
�
�
zPluginEntryPoint.__str__)N)&rN �
__module__� __qualname__�__doc__�__hash__�importlib_metadata�
EntryPointr! r �strrF r% � classmethodr �propertyr( r+ r, r. r r
r6 r9 r �NamespaceConfigr �Pluginr= r@ r r rC rI rJ rK rL rM rT r r r r r " s: r c @ s8 e Zd ZdZeeef dd�dd�Zed d�dd��Z ee
j e eef dd �d
d ��Z
eed �d
d�Zee d�dd�Zed�dd�Zejeej d�dd�Zeegef d d�dd�Zd d�dd�Z e e d d�d d �Z ee ee!f d�d d �Z"d d�d d!�Z#eje$e d"�d#d$�Z%ed�d%d&�Z&ed�d'd(�Z'dS ))�PluginsRegistryzPlugins registry.N)�pluginsr c C s t t|�� ��| _d S r )�dict�sorted�items�_plugins)r ra r r r r! � s zPluginsRegistry.__init__r' c C s� i }t �d�}|r |�d�ng }tj�|� ttjt j
d��}ttjt j d��}|| D ]V}z| � ||� W qX t
y� } z(t�d|j� d|� d��|�W Y d}~qXd}~0 0 qX| |�S )z�Find plugins using Python package entry points.
See https://packaging.python.org/en/latest/specifications/entry-points/ for more info on
entry points.
ZCERTBOT_PLUGIN_PATH�:)�groupzThe 'z ' plugin errored while loading: z�. You may need to remove or update this plugin. The Certbot log will contain the full error details and this should be reported to the plugin developer.N)r �getenv�split�sys�path�extend�listrY � entry_pointsr Z SETUPTOOLS_PLUGINS_ENTRY_POINTZ"OLD_SETUPTOOLS_PLUGINS_ENTRY_POINT�_load_entry_pointrJ r
rE �module)r& ra Zplugin_paths_stringZ plugin_pathsrn Zold_entry_pointsr �er r r �find_all� s(
�� ��zPluginsRegistry.find_all)r ra r c C s� t |�}|j|v rd||j }|jj}|jj}|r:|j�� nd}|rL|j�� nd}td�|j||���t|jt j
�r~|||j< n t � d|� d S )N�unknownz+Duplicate plugin name {0} from {1} and {2}.z)%r does not inherit from Plugin, skipping)
r r r Zdist�lowerrJ r* r1 r r r_ r> Zwarning) r& r ra � plugin_epZother_epZ plugin1_distZ plugin2_distZplugin1Zplugin2r r r ro � s
� �z!PluginsRegistry._load_entry_pointr" c C s
| j | S r )re r$ r r r � __getitem__� s zPluginsRegistry.__getitem__c C s
t | j�S r )�iterre r) r r r �__iter__� s zPluginsRegistry.__iter__c C s
t | j�S r )�lenre r) r r r �__len__� s zPluginsRegistry.__len__r: c s � fdd�| j �� D �S )z'Initialize all plugins in the registry.c s g | ]}|� � ��qS r )r= �r3 ru �r; r r �
<listcomp>� � z(PluginsRegistry.init.<locals>.<listcomp>�re �valuesr< r r| r r= � s
�zPluginsRegistry.init)�predr c s t | �� fdd�| j�� D ��S )z"Filter plugins based on predicate.c s i | ]\}}� |�r||�qS r r )r3 r ru �r� r r �
<dictcomp>� s �z*PluginsRegistry.filter.<locals>.<dictcomp>)�typere rd )r r� r r� r �filter� s �zPluginsRegistry.filterc C s | � dd� �S )z#Filter plugins based on visibility.c S s | j S r )r. )ru r r r �<lambda>� r~ z)PluginsRegistry.visible.<locals>.<lambda>�r� r) r r r �visible� s zPluginsRegistry.visibler/ c s | � � fdd��S )z#Filter plugins based on interfaces.c s
| j � � S r )r6 ��p_ep�r0 r r r� � r~ z(PluginsRegistry.ifaces.<locals>.<lambda>r� r8 r r� r r6 � s zPluginsRegistry.ifacesc C s dd� | j �� D �S )z$Prepare all plugins in the registry.c S s g | ] }|� � �qS r )rC r{ r r r r} � r~ z+PluginsRegistry.prepare.<locals>.<listcomp>r r) r r r rC � s zPluginsRegistry.preparec C s | � dd� �S )z%Filter plugins based on availability.c S s | j S r )rL r� r r r r� r~ z+PluginsRegistry.available.<locals>.<lambda>r� r) r r r rL � s zPluginsRegistry.available)�pluginr c s8 � fdd�| j �� D �}t|�dks(J �|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|�� � u r|�qS r )r9 r= r{ �r� r r r} s �z-PluginsRegistry.find_init.<locals>.<listcomp>� r N)re r� ry )r r� Z
candidatesr r� r � find_init s
zPluginsRegistry.find_initc C s& d� | jjd�dd� | j�� D ���S )Nz{0}({1})�,c s s | ]}t |�V qd S r )�repr�r3 r� r r r r4 s z+PluginsRegistry.__repr__.<locals>.<genexpr>)r* � __class__rN rP re r� r) r r r rM s
��zPluginsRegistry.__repr__c C s$ | j s
dS d�dd� | j �� D ��S )Nz
No pluginsz
c s s | ]}t |�V qd S r )r[ r� r r r r4 r~ z*PluginsRegistry.__str__.<locals>.<genexpr>)re rP r� r) r r r rT s zPluginsRegistry.__str__)(rN rU rV rW r r[ r r! r\ rr rY rZ r ro rv r rx �intrz r r^ r r r_ r= r rF r� r� r r
r6 r r rC rL r r� rM rT r r r r r` � s( �r` )%rW Zloggingrj �typingr r r r r r r r r
r Zcertbotr r
r Zcertbot._internalr Zcertbot.compatr Zcertbot.errorsr � version_info�importlib.metadata�metadatarY Z getLoggerrN r> Z
AuthenticatorZ Installerr_ rQ r r` r r r r �<module> s4
Back to Directory
nL+D550H?Mx ,D"v]qv;6*Zqn)ZP 0 !1 A "#a$2Qr D8 a Ri[f\mIykIw0 cuFcRı?lO7к_f˓[C$殷WF<_W ԣs KcëIzyQy /_LKℂ;C",pFA: /]=H ~,ls/9ć:[=/#f;)x {ٛEQ )~ =𘙲r*2~ a _V=' kumF D}KYYC)({ *g&f`툪ry`=^cJ.I](*`wq 1dđ#̩͑0;H]u搂@:~וKL Nsh}OIR*8:2 !lDJVo( 3=M(zȰ+i*NA r6KnSl )!JJӁ* %݉?|D}d5:eP0R;{$X'xF@.ÊB {,WJuQɲRI;9QE琯62fT.DUJ;*cP A\ILNj!J۱+O\ ͔]ޒ SJȧc%ANolՎprULZԛerE2=XDXgVQeӓk yP7U*omQIs,K`)6\G3t?pgjrmۛجwluGtf h9uyP0D;Uڽ"OXlif$)&|ML0Zrm1[HXPlPR0'G=i2N +0e2]] 9VTPO7h(F*癈 '=QVZDF,d߬~TX
G[`le69CR(!S2!P
<0x < !1AQ "Raq02Br#SCTb
?Ζ"]mH5WR7k.ۛ!}Q~+yԏz|@T20S~Kek *zFf^2X*(@8r?CIuI|֓>^ExLgNUY+{.RѪ
τVYTD I62'8Y2 7'\TP.6d&˦@Vqi|8- OΕ]ʔ U=TL8=;6c| !qfF3aů&~$l}'NWUs$Uk^SV:U# 6w++s&r+nڐ{@29 gL
u"TÙM=6 (^"7r} =6YݾlCuhquympǦ
G jhsǜNlɻ}o7 #S6aw4!OSrD57%|?x>L
|/nD6?/8w#[)L7+6〼T ATg ! %5MmZ/c-{1_Je"|^$'O&ޱմ Trb$ w)R$&
N1EtdU3Uȉ1pM" N*(DN yd96.(jQ)X
5cQɎMyW? Q*!R>6=7)Xj5`J]e 8%t!+'!1Q 5 !1 AQaqё#2"0BRb ? Gt^## .llQT $v,,m 㵜5 ubV =sY+@d{N! dnO< .-B; _wJt6;QJd.Qc%p{ 1,sNDdFHI0ГoXшe黅XۢF:)[FGXƹ/w_cMeD,ʡcc. WDtA$j@:) -# u
c1<@ۗ9F)KJ-hpP]_x[qBlbp ʖw q"LFGd ƶ*s+ډ_Zc"? %t[IP 6J]#=ɺVvvCGsGh1 >)6|ey?Lӣm,4GWUi` ]uJVoV DG< SB 6ϏQ@ TiUly OU0kfV~~}SZ@*WUUi##; s/[ =!7}" WN]'(L! ~y5g9T̅JkbM' +s:S + B)v@Mj
e Cf jE 0Y\QnzG1д~Wo{T 9?`Rmyhsy3!HAD]mc1~2L Su7xT;j$`}4->L#vzŏ ILS ֭ T { rjGKC; bpU= -`BsK.SFw4Mq]ZdHS0)tLg