| Server IP : 209.38.156.173 / Your IP : 216.73.216.122 [ Web Server : Apache/2.4.52 (Ubuntu) System : Linux lakekumayuhotel 5.15.0-136-generic #147-Ubuntu SMP Sat Mar 15 15:53:30 UTC 2025 x86_64 User : root ( 0) PHP Version : 8.1.2-1ubuntu2.22 Disable Function : NONE Domains : 2 Domains MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/lib/python3/dist-packages/certbot/_internal/plugins/__pycache__/ |
Upload File : |
o
6��ap< � @ sT d Z ddlmZ ddlZddlZddlZddlmZ ddlmZ ddlm Z ddlm
Z
ddl Z ddl Z ddl
ZddlZddlmZ dd lmZ dd
lmZ dd lmZ dd lmZ e�e�Zg d
�Z G dd� d�Z G dd� de�Z dZ dZ dZ!dZ"de ej# de de$fdd�Z%de ej# de de$fdd �Z&d ej#de ej# de de$fd d �Z'dS ) z.Utilities for plugins discovery and selection.� )�MappingN)�Dict)�Optional)�Type)�Union)�errors)�
interfaces)� constants)�os)�Error)�certbotzcertbot-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 ZdZdZd+dejfdd�Zdd� Ze d d
� �Z
e d d � �Z e d
d� �Z
e dd� �Zejdd� �Ze dd� �Zejdd� �Zdd� Ze dd� �Zd,dd�Zdd � Ze d d � �Zd d � Ze d!d"� �Ze d#d$� �Ze d%d&� �Zd'd(� Zd)d*� ZdS )-�PluginEntryPointzPlugin entry point.NF� entry_pointc C s@ | � ||�| _|�� | _|| _d | _d | _d | _d| _d | _ d S )NF)
�entry_point_to_plugin_name�name�load�
plugin_clsr �warning_message� _initialized� _prepared�_hidden�_long_description)�selfr � with_prefix� r �A/usr/lib/python3/dist-packages/certbot/_internal/plugins/disco.py�__init__4 s
zPluginEntryPoint.__init__c C s$ || j kr| jrt�| j� dS dS )z(Check if the name refers to this plugin.TF)r r �logger�warning�r r r r r �
check_name> s
zPluginEntryPoint.check_namec C s |r |j jd |j S |jS )z)Unique plugin name for an ``entry_point``�:)�dist�keyr )�clsr r r r r r F s z+PluginEntryPoint.entry_point_to_plugin_namec C s | j jS )zDescription of the plugin.)r � description�r r r r r% M 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_nameR � z&PluginEntryPoint.description_with_namec C s | j r| j S t| jd| j�S )z Long description of the plugin.�long_description)r �getattrr r% r& r r r r* W s z!PluginEntryPoint.long_descriptionc C �
|| _ d S �N)r )r r% r r r r* ^ �
c C s | j p t| jdd�S )z%Should this plugin be hidden from UI?�hiddenF)r r+ r r& r r r r/ b s zPluginEntryPoint.hiddenc C r, r- )r )r �hider r r r/ g r. c s | p
t � 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 r- )� _implementsr )�.0�ifacer& r r � <genexpr>n s � �z4PluginEntryPoint.ifaces.<locals>.<genexpr>.<genexpr>N)�all)r2 �ifacesr& r r r4 m s � ��
�z*PluginEntryPoint.ifaces.<locals>.<genexpr>)�any�r �
ifaces_groupsr r& r r6 k s �zPluginEntryPoint.ifacesc C s
| j duS )z(Has the plugin been initialized already?N)r r& r r r � initializedr s
z PluginEntryPoint.initializedc C s& | j s| j�� | �|| j�| _| jS )z Memoized plugin initialization.)r: r �requirer r r �r �configr r r �initw s
zPluginEntryPoint.initc C s4 | j std��|D ]}t| �� | j|�s dS q dS )z<Verify that the plugin conforms to the specified interfaces.�Plugin is not initialized.FT)r: �
ValueError�_verifyr> r )r r6 r3 r r r �verify� s �zPluginEntryPoint.verifyc C s | j s t�d| � | jduS )z%Has the plugin been prepared already?z$.prepared called on uninitialized %rN)r: r �debugr r& r r r �prepared� s
zPluginEntryPoint.preparedc
C s� | j du r td��| jdu rzz| j �� W na tjy6 } ztjd| |dd� || _W Y d}~| jS d}~w tjyV } ztjd| |dd� || _W Y d}~| jS d}~w tj yv } ztjd| |dd� || _W Y d}~| jS d}~ww d| _| jS )z Memoized plugin preparation.Nr? zMisconfigured %r: %sT��exc_infozNo installation (%r): %szOther error:(%r): %s)
r r@ r �preparer �MisconfigurationErrorr rC �NoInstallationError� PluginError)r �errorr r r rG � s2
�������zPluginEntryPoint.preparec C s t | jtj�S )zIs plugin misconfigured?)�
isinstancer r rH 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)rL 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 rM r& r r r � available� r) zPluginEntryPoint.availablec C s d� | j�S )NzPluginEntryPoint#{0})r' r r& r r r �__repr__� s zPluginEntryPoint.__repr__c C s� d� | j�d� | jj�d� d�dd� | j�� D ���d� | j�g}| jr;|�d� | � � �� | j
r;|�d � | � � �� d
�|�S ) Nz* {0}zDescription: {0}zInterfaces: {0}z, c s s � | ] }|j d kr|jV qdS )zcertbot.interfacesN)�
__module__�__name__)r2 r$ r r r r4 � s � �
�z+PluginEntryPoint.__str__.<locals>.<genexpr>zEntry point: {0}zInitialized: {0}z Prep: {0}�
) r' r r r% �join�mror r: �appendr> rD rG )r �linesr r r �__str__� s
�
�
zPluginEntryPoint.__str__)Fr- ) rS rR � __qualname__�__doc__�__hash__�
pkg_resources�
EntryPointr r � classmethodr �propertyr% r( r* �setterr/ r6 r: r> rB rD rG rM rO rP rQ rY r r r r r
. sF
r
c @ s� e Zd ZdZdd� Zedd� �Zedd� �Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d!� Zd"S )#�PluginsRegistryzPlugins registry.c C s t t|�� ��| _d S r- )�dict�sorted�items�_plugins)r �pluginsr r r r � s zPluginsRegistry.__init__c
C s� i }t �d�}|r|�d�ng }tj�|� |D ]}tj�|� qt �
t� t j
�t� t j��}|D ]5}| j||dd�}|jdusBJ �|jjtvrf| j||dd�}d|_d�|j|j�} | |_d�| |j�|_q1| |�S ) z+Find plugins using setuptools entry points.�CERTBOT_PLUGIN_PATHr! F)r NTzRPlugin legacy name {0} may be removed in a future version. Please use {1} instead.z(WARNING: {0}) {1})r
�getenv�split�sys�path�extendr] � working_set� add_entry� itertools�chain�iter_entry_pointsr � SETUPTOOLS_PLUGINS_ENTRY_POINT�"OLD_SETUPTOOLS_PLUGINS_ENTRY_POINT�_load_entry_pointr" r# �PREFIX_FREE_DISTRIBUTIONSr/ r' r r r* )
r$ rg �plugin_paths_string� plugin_paths� plugin_path� entry_pointsr � plugin_ep�prefixed_plugin_ep�messager r r �find_all� s:
��� ���zPluginsRegistry.find_allc C s� t ||�}|j|v r/||j }|jjr|jjjnd}|jjr#|jjjnd}td�|j||���t|jt j
�r=|||j< |S t � d|� |S )N�unknownz+Duplicate plugin name {0} from {1} and {2}.z)%r does not inherit from Plugin, skipping)
r
r r r" r# rN r' � _providesr r �Pluginr r )r$ r rg r r{ �other_ep�plugin1�plugin2r r r ru � s
�
��z!PluginsRegistry._load_entry_pointc C s
| j | S r- )rf r r r r � __getitem__ �
zPluginsRegistry.__getitem__c C �
t | j�S r- )�iterrf r& r r r �__iter__ r� zPluginsRegistry.__iter__c C r� r- )�lenrf r& r r r �__len__ r� zPluginsRegistry.__len__c s � fdd�| j �� D �S )z'Initialize all plugins in the registry.c s g | ]}|� � ��qS r )r> �r2 r{ �r= r r �
<listcomp> s z(PluginsRegistry.init.<locals>.<listcomp>�rf �valuesr< r r� r r> s
�zPluginsRegistry.initc s t | �� fdd�| j�� D ��S )z"Filter plugins based on predicate.c s i | ] \}}� |�r||�qS r r )r2 r r{ ��predr r �
<dictcomp> s �z*PluginsRegistry.filter.<locals>.<dictcomp>)�typerf re )r r� r r� r �filter s �zPluginsRegistry.filterc C � | � dd� �S )z#Filter plugins based on visibility.c S s | j S r- )r/ )r{ r r r �<lambda> s z)PluginsRegistry.visible.<locals>.<lambda>�r� r& r r r �visible � zPluginsRegistry.visiblec � | � � fdd��S )z#Filter plugins based on interfaces.c s
| j � � S r- �r6 ��p_ep�r9 r r r� ! �
z(PluginsRegistry.ifaces.<locals>.<lambda>r� r8 r r� r r6 � zPluginsRegistry.ifacesc r� )z%Filter plugins based on verification.c s
| � � �S r- )rB r� r� r r r� % r� z(PluginsRegistry.verify.<locals>.<lambda>r� )r r6 r r� r rB # r� zPluginsRegistry.verifyc C s dd� | j �� D �S )z$Prepare all plugins in the registry.c S s g | ]}|� � �qS r )rG r� r r r r� ) s z+PluginsRegistry.prepare.<locals>.<listcomp>r� r& r r r rG ' s zPluginsRegistry.preparec C r� )z%Filter plugins based on availability.c S s | j S r- )rP r� r r r r� - s z+PluginsRegistry.available.<locals>.<lambda>r� r& r r r rP + r� zPluginsRegistry.availablec s8 � fdd�| j �� D �}t|�dksJ �|r|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 )r: r> r� ��pluginr r r� = s
�
�z-PluginsRegistry.find_init.<locals>.<listcomp>� r N)rf r� r� )r r� �
candidatesr r� r � find_init0 s
zPluginsRegistry.find_initc C s& d� | jjd�dd� | j�� D ���S )Nz{0}({1})�,c s � � | ]}t |�V qd S r- )�repr�r2 r� r r r r4 F s �
�z+PluginsRegistry.__repr__.<locals>.<genexpr>)r' � __class__rS rU rf r� r& r r r rQ D s
��zPluginsRegistry.__repr__c C s$ | j sdS d�dd� | j �� D ��S )Nz
No pluginsz
c s r� r- )�strr� r r r r4 L s � z*PluginsRegistry.__str__.<locals>.<genexpr>)rf rU r� r& r r r rY I s zPluginsRegistry.__str__N)rS rR rZ r[ r r_ r~ ru r� r� r� r> r� r� r6 rB rG rP r� rQ rY r r r r rb � s(
rb 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_classr3 �returnc C sB t | |�rdS |tjkr tj�| �r t�t� t� tt
� dS dS �NTF) �
issubclassr r� �IPluginFactory�
providedBy�loggingr �_DEPRECATION_FACTORY�warnings�warn�DeprecationWarning�r� r3 r r r r� \ s
r� c C s� t | |�rdS |tjkr tj�| �r t�t� t� tt
� dS |tj kr7tj �| �r7t�t
� t� t
t
� dS |tjkrOtj�| �rOt�t� t� tt
� dS dS r� )r� r r� �IPlugin�
implementedByr� r �_DEPRECATION_PLUGINr� r� r� �
Authenticator�IAuthenticator�_DEPRECATION_AUTHENTICATOR� Installer�
IInstaller�_DEPRECATION_INSTALLERr� r r r r1 h s
r1 �target_instancec
C s� t ||�rdS d }d}|tjkrtj}t}|tjkr tj}t}|tjkr)tj }t
}|s3t d|j � ���zt
jj�|| � t�|� t�|t� W dS t
jjjyv } z |�|�rktjd||j |dd� W Y d }~dS W Y d }~dS d }~ww )NT� zUnexpected type: z/%s implements %s but object does not verify: %srE F)r� r r� r� r� r� r� r� r� r� r� r@ rS �zope� interfacerB � verifyObjectr� r r� r� r� �
exceptions�BrokenImplementationr� r rC )r� r� r3 �
zope_ifacer} rK r r r rA ~ s>
�
���rA )(r[ �collections.abcr rp r� rk �typingr r r r r� r] �zope.interfacer� �zope.interface.verifyr r r �certbot._internalr �certbot.compatr
�certbot.errorsr � getLoggerrS r rv r
rb r� r� r� r� r� �boolr� r1 rA r r r r �<module> sH
��