Edit File: disco.cpython-36.pyc
3 گa�A � @ 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/d0�Z+ej(e ej( e e)d1�d2d3�Z,dS )4z.Utilities for plugins discovery and selection.� N)�Callable)�cast)�Dict)�Iterable)�Iterator)�List)�Mapping)�Optional)�Type)�Union)� configuration)�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 ZdZdZd2ejedd�dd�Ze e ed�dd �Z e ejee d�d d ��Z ee d �d d��Zee d �dd��Zee d �dd��Zeje dd�dd��Zeed �dd��Zejedd�dd��Zee ed�dd�Zeed �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 �d0d1�Z'dS )4�PluginEntryPointzPlugin entry point.NF)� entry_point� with_prefix�returnc C s@ | j ||�| _|j� | _|| _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 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 �logger�warning)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| 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 | j r | j S t| jd| j�S )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| jdd�S )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 )�.0�iface)r r! r" � <genexpr>w s z4PluginEntryPoint.ifaces.<locals>.<genexpr>.<genexpr>N)�all)r4 �ifaces)r r! r" r6 w s z*PluginEntryPoint.ifaces.<locals>.<genexpr>)�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 std��x"|D ]}t| j� | j|�sdS qW dS )z<Verify that the plugin conforms to the specified interfaces.zPlugin is not initialized.FT)r: � ValueError�_verifyr< r )r r8 r5 r! r! r" �verify� s zPluginEntryPoint.verifyc C s | j stjd| � | jdk S )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 dkrtd��| jdkr�y| j j� W n� tjk rf } z tjd| |dd� || _W Y dd}~X n| tjk r� } z tjd| |dd� || _W Y dd}~X nB tj k r� } z tjd| |dd� || _W Y dd}~X nX 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 r= r �preparer �MisconfigurationErrorr$ r@ ZNoInstallationErrorZ PluginErrorr r �boolr )r �errorr! r! r" rC � 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)rG r � Exception)r r! r! r" �problem� s zPluginEntryPoint.problemc C s | j dkp| jS )z4Is plugin available, i.e. prepared or misconfigured?T)r rH )r r! r! r" � available� s zPluginEntryPoint.availablec C s dj | j�S )NzPluginEntryPoint#{0})r, r )r r! r! r" �__repr__� s zPluginEntryPoint.__repr__c C s� dj | j�dj | jj�dj djdd� | jj� D ���dj | j�g}| jrv|jdj | j � �� | j rv|jd j | j � �� d j|�S ) Nz* {0}zDescription: {0}zInterfaces: {0}z, c s s | ]}|j d kr|jV qdS )zcertbot.interfacesN)� __module__�__name__)r4 r* r! r! r" r6 � s z+PluginEntryPoint.__str__.<locals>.<genexpr>zEntry point: {0}zInitialized: {0}z Prep: {0}� ) r, r r r+ �join�mror 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 dd�dd�Zed d�dd��Z ee j e eef e ed �d d ��Zeed �d d�Zee d�dd�Zed�dd�Zejeej d�dd�Zeege f d d�dd�Zd d�dd�Z e e d d�d d �Z e e d d �d d �Z ee!e e"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|j� ��| _d S )N)�dict�sorted�items�_plugins)r ra r! r! r" r# � s zPluginsRegistry.__init__)r c C s� i }t jd�}|r |jd�ng }tjj|� x|D ]}tjj|� q2W t j tj t j �tj t j��}xr|D ]j}| j||dd�}|jdk s�t�|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 �getenv�split�sys�path�extendrX Z working_setZ add_entry� itertools�chainZiter_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_ep�messager! 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 )N�unknownz+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 | j�S )N)�iterre )r r! r! r" �__iter__ s zPluginsRegistry.__iter__c C s t | j�S )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" � <listcomp> s z(PluginsRegistry.init.<locals>.<listcomp>)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" � <dictcomp>$ s z*PluginsRegistry.filter.<locals>.<dictcomp>)�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" �<lambda>) s z)PluginsRegistry.visible.<locals>.<lambda>)r )r r! r! r" �visible' s zPluginsRegistry.visible)r2 r c s | j � fdd��S )z#Filter plugins based on interfaces.c s | j � � S )N)r8 )�p_ep)r2 r! r" r� - s z(PluginsRegistry.ifaces.<locals>.<lambda>)r )r r2 r! )r2 r" r8 + s zPluginsRegistry.ifaces)r8 r c s | j � fdd��S )z%Filter plugins based on verification.c s | j � �S )N)r? )r� )r8 r! r" r� 1 s z(PluginsRegistry.verify.<locals>.<lambda>)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.<locals>.<listcomp>)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.<locals>.<lambda>)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.<locals>.<listcomp>� 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__.<locals>.<genexpr>)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__.<locals>.<genexpr>)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 providedBy�loggingr% �_DEPRECATION_FACTORY�warnings�warn�DeprecationWarning)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 |tjkr�tjj| �r�tjt� tj tt � dS dS )NTF)r� r r_ �IPlugin� implementedByr� r% �_DEPRECATION_PLUGINr� r� r� � Authenticator�IAuthenticator�_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|�r�tjd||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" �<module> sj $
Back to File Manager