§
    cÌc^X  ã                   óŒ  — d Z 	 ddlZddlZddlZddlmZ ddlZddlm	Z	m
Z
mZmZ dZdZd2d„Zd3d
„Zd„ Zd„ Zd„ Z G d„ de¦  «        Zd„ Zd4d„Zd5d„Zd6d„Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Z d7d„Z!d „ Z"d!„ Z#d"„ Z$d#„ Z%d$„ Z&d%„ Z'd&„ Z(d'„ Z)d(„ Z*d2d)„Z+ G d*„ d+¦  «        Z, G d,„ d-¦  «        Z- G d.„ d/¦  «        Z. G d0„ d1¦  «        Z/dS )8Úgoogleé    N)Úutilé   )ÚdebugÚerrorsÚosutilsÚtracezbreezy.plugins.z.pycc                 ó>   — | €t          j        ¦   «         } i | _        dS )z Disable loading plugins.

    Future calls to load_plugins() will be ignored.

    Args:
      state: The library state object that records loaded plugins.
    N)ÚbreezyÚget_global_stateÚplugins)Ústates    ú//usr/lib/python3/dist-packages/breezy/plugin.pyÚdisable_pluginsr   :   s"   € ð €}ÝÔ'Ñ)Ô)ˆØ€E„M€M€Mó    Tc                 ór  — |€t          j        ¦   «         }t          |dd¦  «        �dS | €ddlm}  i |_        t          || ¦  «         dt          ¦   «         v rt          |¦  «         t          ¦   «         |_	        |r9|j         
                    ¦   «         D ]!\  }}|D ]}t          j        d|¦  «         ŒŒ dS dS )a×  Load breezy plugins.

    The environment variable BRZ_PLUGIN_PATH is considered a delimited
    set of paths to look through. Each entry is searched for `*.py`
    files (and whatever other extensions are used in the platform,
    such as `*.pyd`).

    Args:
      path: The list of paths to search for plugins.  By default,
        it is populated from the __path__ of the breezy.plugins package.
      state: The library state object that records loaded plugins.
    Nr   r   )Ú__path__)NÚentrypointsz%s)r   r   ÚgetattrÚbreezy.pluginsr   Úplugin_warningsÚ_load_plugins_from_pathÚ_env_plugin_pathÚ_load_plugins_from_entrypointsr   Úitemsr	   Úwarning)Úpathr   Úwarn_load_problemsÚpluginr   Úerrors         r   Úload_pluginsr!   G   sï   € ð €}ÝÔ'Ñ)Ô)ˆÝˆu�i Ñ&Ô&Ð2àˆà€|à3Ð3Ð3Ð3Ð3Ð3à€EÔÝ˜E 4Ñ(Ô(Ð(ØÕ 0Ñ 2Ô 2Ð2Ð2Ý& uÑ-Ô-Ð-Ý‘I”I€E„MØð +Ø#Ô3×9Ò9Ñ;Ô;ð 	+ð 	+‰NˆF�FØð +ð +�Ý”˜d EÑ*Ô*Ð*Ð*ð+ð+ð +ð	+ð 	+r   c                 óF  — 	 ddl m} 	  |d¬¦  «        }n6# t          $ r) d„  |¦   «                              ¦   «         D ¦   «         }Y nw xY w|D ]A}t          |j        z   }|t          j        v rŒ |                     ¦   «         t          j        |<   ŒBd S # t          $ r Y d S w xY w)Nr   )Úentry_pointsúbreezy.plugin©Úgroupc                 ó@   — g | ]}|d          j         dk    ¯|d          ‘ŒS )r   r$   r%   )Ú.0Úeps     r   ú
<listcomp>z2_load_plugins_from_entrypoints.<locals>.<listcomp>s   s6   € ð 7ð 7ð 7˜RØ˜!”u”{ oÒ5Ð5ð �a”5Ø5Ð5Ð5r   )
Úimportlib.metadatar#   Ú	TypeErrorÚvaluesÚ_MODULE_PREFIXÚnameÚsysÚmodulesÚloadÚModuleNotFoundError)r   r#   Úepsr)   Úfullnames        r   r   r   i   sò   € ð.Ø3Ð3Ð3Ð3Ð3Ð3ð
	7Ø�, _Ð5Ñ5Ô5ˆCˆCøÝð 	7ð 	7ð 	7ð7ð 7 < <¡>¤>×#8Ò#8Ñ#:Ô#:ð 7ñ 7ô 7ˆCˆCˆCð	7øøøð ð 	.ð 	.ˆBÝ%¨¬Ñ/ˆHØ�3œ;Ð&Ð&ØØ$&§G¢G¡I¤I�CŒK˜Ñ!Ð!ð		.ð 	.øõ ð ð ð àˆˆðøøøs    ‚B ‰ –0A	ÁA	Â
B ÂB c                 óš   — |                       t          ¦  «        r0|                      d¦  «        }t          |¦  «        dk    r|d         S dS )z/Gives unprefixed name from module_name or None.ú.é   N)Ú
startswithr.   ÚsplitÚlen)Úmodule_nameÚpartss     r   Úplugin_namer>   |   sH   € à×Ò�nÑ-Ô-ð Ø×!Ò! #Ñ&Ô&ˆÝˆu‰:Œ:˜Š>ˆ>Ø˜”8ˆOØˆ4r   c                 óÒ   — t          ¦   «         }t          |¦  «         t          ¦   «         }t          |¦  «         t	          t          ¦   «         | ¦  «        }t          ||||¦  «        S )aE  Helper so breezy.plugins can be a sort of namespace package.

    To be used in similar fashion to pkgutil.extend_path:

        from breezy.plugins import extend_path
        __path__ = extend_path(__path__, __name__)

    Inspects the BRZ_PLUGIN* envvars, sys.path, and the filesystem to find
    plugins. May mutate sys.modules in order to block plugin loading, and may
    append a new meta path finder to sys.meta_path for plugins@ loading.

    Returns a list of paths to import from, as an enhanced object that also
    contains details of the other configuration used.
    )Ú_env_disable_pluginsÚ_block_pluginsÚ_env_plugins_atÚ_install_importer_if_neededÚ_iter_plugin_pathsr   Ú_Path)r   r/   ÚblocksÚextra_detailsÚpathss        r   Úextend_pathrI   …   s`   € õ "Ñ#Ô#€FÝ�6ÑÔÐå#Ñ%Ô%€MÝ Ñ.Ô.Ð.åÕ/Ñ1Ô1°4Ñ8Ô8€Eå��v˜}¨eÑ4Ô4Ð4r   c                   ó(   ‡ — e Zd ZdZˆ fd„Zd„ Zˆ xZS )rE   z�List type to use as __path__ but containing additional details.

    Python 3 allows any iterable for __path__ but Python 2 is more fussy.
    c                 ót   •— t          ¦   «                              |¦  «         || _        || _        || _        d S ©N)ÚsuperÚ__init__Úpackage_nameÚblocked_namesrG   )ÚselfrO   ÚblockedÚextrarH   Ú	__class__s        €r   rN   z_Path.__init__¥   s9   ø€ Ý‰Œ×Ò˜ÑÔÐØ(ˆÔØ$ˆÔØ"ˆÔÐÐr   c           	      ó–   — d                      | j        j        | j        | j        | j        t                               | ¦  «        ¦  «        S )Nz{}({!r}, {!r}, {!r}, {}))ÚformatrT   Ú__name__rO   rP   rG   ÚlistÚ__repr__©rQ   s    r   rY   z_Path.__repr__«   s@   € Ø)×0Ò0ØŒNÔ# TÔ%6¸Ô8JØÔ¥§¢¨dÑ 3Ô 3ñ5ô 5ð 	5r   )rW   Ú
__module__Ú__qualname__Ú__doc__rN   rY   Ú__classcell__)rT   s   @r   rE   rE   Ÿ   sQ   ø€ € € € € ðð ð
#ð #ð #ð #ð #ð5ð 5ð 5ð 5ð 5ð 5ð 5r   rE   c                 ó|   — t          j        d| ¦  «        €t          j        d| ||¦  «         dS t	          | ¦  «        S )a  Validate given name from envvar is usable as a Python identifier.

    Returns the name as a native str, or None if it was invalid.

    Per PEP 3131 this is no longer strictly correct for Python 3, but as MvL
    didn't include a neat way to check except eval, this enforces ascii.
    z^[A-Za-z_][A-Za-z0-9_]*$NzInvalid name '%s' in %s='%s')ÚreÚmatchr	   r   Ústr)r/   Úenv_keyÚ	env_values      r   Ú_expect_identifierre   ±   s?   € õ 
„xÐ+¨TÑ2Ô2Ð:ÝŒÐ4°d¸GÀYÑOÔOÐOØˆtÝˆt‰9Œ9Ðr   ÚBRZ_DISABLE_PLUGINSc                 óà   — g }t           j                             | ¦  «        }|rJ|                     t           j        ¦  «        D ]*}t          || |¦  «        }|�|                     |¦  «         Œ+|S )z<Gives list of names for plugins to disable from environ key.)ÚosÚenvironÚgetr:   Úpathsepre   Úappend)ÚkeyÚdisabled_namesÚenvr/   s       r   r@   r@   ¿   sq   € à€NÝ
Œ*�.Š.˜Ñ
Ô
€CØ
ð ,Ø—I’I�bœjÑ)Ô)ð 	,ð 	,ˆDÝ% d¨C°Ñ5Ô5ˆDØÐØ×%Ò% dÑ+Ô+Ð+øØÐr   ÚBRZ_PLUGINS_ATc                 óº  — g }t           j                             | ¦  «        }|r·|                     t           j        ¦  «        D ]—}d|v r|                     dd¦  «        \  }}n0|}t          j        |¦  «                             dd¦  «        d         }t          || |¦  «        }|�4|                     |t           j	         
                    |¦  «        f¦  «         Œ˜|S )zCGives list of names and paths of specific plugins from environ key.ú@r   r7   r   )rh   ri   rj   r:   rk   r   Úbasenamere   rl   r   Úabspath)rm   Úplugin_detailsro   Úpairr/   r   s         r   rB   rB   Ë   sÓ   € à€NÝ
Œ*�.Š.˜Ñ
Ô
€CØ
ð 	EØ—I’I�bœjÑ)Ô)ð 	Eð 	EˆDØ�dˆ{ˆ{Ø!ŸZšZ¨¨QÑ/Ô/‘
��d�dà�ÝÔ'¨Ñ-Ô-×3Ò3°C¸Ñ;Ô;¸AÔ>�Ý% d¨C°Ñ5Ô5ˆDØÐØ×%Ò% t­R¬W¯_ª_¸TÑ-BÔ-BÐ&CÑDÔDÐDøØÐr   ÚBRZ_PLUGIN_PATHc                 ó¤  — g }t           j                             | ¦  «        }| ddddœ}|r€|                     t           j        ¦  «        D ]`}|dd…         |dd…         }}|dv r/||v r+|dk    r||         �|                     d|f¦  «         d||<   ŒI|                     |df¦  «         Œad	D ]!}||         r|                     d|f¦  «         Œ"|S )
záGives list of paths and contexts for plugins from environ key.

    Each entry is either a specific path to load plugins from and the value
    'path', or None and one of the values 'user', 'core', 'entrypoints', 'site'.
    TF)ÚuserÚcoreÚsiter   Nr   )ú+ú-r|   r   )ry   rz   r   r{   )rh   ri   rj   r:   rk   rl   )rm   Úpath_detailsro   ÚdefaultsÚpÚflagr/   s          r   r   r   Ü   s  € ð €LÝ
Œ*�.Š.˜Ñ
Ô
€Cà�ØØØð	
ð 
€Hð ð 	1à—’�2œ:Ñ&Ô&ð 	1ð 	1ˆAØ˜2˜A˜2œ  ! " "¤�$ˆDØ�zÐ!Ð! d¨hÐ&6Ð&6Ø˜3’;�; 8¨D¤>Ð#=Ø ×'Ò'¨¨t¨Ñ5Ô5Ð5Ø!%�˜‘�à×#Ò# Q¨ KÑ0Ô0Ð0Ð0ð 8ð .ð .ˆØ�DŒ>ð 	.Ø×Ò  t Ñ-Ô-Ð-øàÐr   c              #   óž  K  — | D ]Ç\  }}|dk    r"t           j                             |¦  «        V — Œ-|dk    r2t          ¦   «         }t           j                             |¦  «        r|V — Œe|dk    rt          |¦  «        D ]}|V — ŒŒ‚|dk    r?t          t          j        ¦  «        D ]%}t           j                             |¦  «        r|V — Œ&ŒÈdS )z3Generate paths using paths_from_env and core_paths.r   ry   rz   r{   N)rh   r   rt   Úget_user_plugin_pathÚisdirÚ_get_core_plugin_pathsÚ_get_site_plugin_pathsr0   )Úpaths_from_envÚ
core_pathsr   Úcontexts       r   rD   rD   ý   sú   è è € ð (ð ð ‰ˆˆgØ�fÒÐÝ”'—/’/ $Ñ'Ô'Ð'Ð'Ð'Ð'Ø˜ÒÐÝ'Ñ)Ô)ˆDÝŒw�}Š}˜TÑ"Ô"ð Ø�
�
�
øØ˜ÒÐÝ.¨zÑ:Ô:ð ð �Ø�
�
�
�
ðà˜ÒÐÝ.­s¬xÑ8Ô8ð ð �Ý”7—=’= Ñ&Ô&ð Ø�J�J�Jøøðð r   c                 óx   — | r7t          t          | ¦  «        }t          j                             d|¦  «         dS dS )z;Install a meta path finder to handle plugin_details if any.r8   N)Ú_PluginsAtFinderr.   r0   Ú	meta_pathÚinsert)ru   Úfinders     r   rC   rC     sA   € àð (Ý!¥.°.ÑAÔAˆåŒ×Ò˜Q Ñ'Ô'Ð'Ð'Ð'ð(ð (r   c           
      óx  — t          ¦   «         }t          |¦  «        D ]›\  }}||vr’t          |¦  «        s.t          |¦  «        }t	          j        d|›d|›d|›d�¦  «         ŒFt          ||¦  «        }|�.| j                             |g ¦  «         	                    |¦  «         | 
                    |¦  «         ŒœdS )z(Do the importing all plugins from paths.zUnable to load z in zQ as a plugin because the file path isn't a valid module name; try renaming it to r7   N)ÚsetÚ_iter_possible_pluginsÚvalid_plugin_nameÚsanitise_plugin_namer	   r   Ú_load_plugin_moduler   Ú
setdefaultrl   Úadd)r   rH   Úimported_namesr/   r   Úsanitised_nameÚmsgs          r   r   r     sß   € å‘U”U€NÝ,¨UÑ3Ô3ð %ð %‰
ˆˆdØ�~Ð%Ð%Ý$ TÑ*Ô*ð Ý!5°dÑ!;Ô!;�Ý”�à-1¨T¨T°4°4°4¸¸¸ðIñ Jô Jð Jð Ý% d¨DÑ1Ô1ˆCØˆØÔ%×0Ò0°°rÑ:Ô:×AÒAÀ#ÑFÔFÐFØ×Ò˜tÑ$Ô$Ð$øð%ð %r   c                 óª   — | D ]O}t           |z   }t          j                             |¦  «        �t	          j        d|¦  «         dt          j        |<   ŒPdS )z1Add names to sys.modules to block future imports.Nz!Blocked plugin %s already loaded.)r.   r0   r1   rj   r	   Úmutter)Únamesr/   rO   s      r   rA   rA   )  s[   € àð )ð )ˆÝ%¨Ñ,ˆÝŒ;�?Š?˜<Ñ(Ô(Ð4ÝŒLÐ<¸dÑCÔCÐCØ$(�Œ�LÑ!Ð!ð	)ð )r   c                 óØ   — t          j        | d¦  «        }t          j                             |¦  «        r|S |dd…         t
          z   }t          j                             |¦  «        r|S dS )zEGet path of __init__ file from package_path or None if not a package.z__init__.pyNéýÿÿÿ)r   Úpathjoinrh   r   ÚexistsÚCOMPILED_EXT)Úpackage_pathÚ	init_paths     r   Ú_get_package_initr¤   2  sc   € åÔ  ¨}Ñ=Ô=€IÝ	„w‡~‚~�iÑ Ô ð ØÐØ˜#˜2˜#”¥Ñ-€IÝ	„w‡~‚~�iÑ Ô ð ØÐØˆ4r   c              #   óþ   K  — t          | dd¦  «        E d{V —† | D ]`}t          j                             |¦  «        r*|                     d¦  «        rt          j        d¦  «         ŒKt          |¦  «        E d{V —† ŒadS )z?Generate names and paths of possible plugins from plugin_paths.rG   © Nz.zipz+Don't yet support loading plugins from zip.)r   rh   r   ÚisfileÚendswithr	   r›   Ú_walk_modules)Úplugin_pathsr   s     r   r‘   r‘   =  s¥   è è € õ �| _°bÑ9Ô9Ð9Ð9Ð9Ð9Ð9Ð9Ð9àð +ð +ˆÝŒ7�>Š>˜$ÑÔð 	+Ø�}Š}˜VÑ$Ô$ð LÝ”ÐJÑKÔKÐKøå$ TÑ*Ô*Ð*Ð*Ð*Ð*Ð*Ð*Ð*Ð*ð+ð +r   c              #   ó¶  K  — t          j        | ¦  «        D ]Á\  }}}|                     ¦   «          |D ]L}|dd…         dk    r<|                     dt          f¦  «        r |                     dd¦  «        d         |fV — ŒM|                     ¦   «          |D ]<}|dd…         dk    r,t          j        ||¦  «        }t          |¦  «        }|�||fV — Œ=|dd…= ŒÂdS )z7Generate name and path of modules and packages on path.Nr8   Ú__ú.pyr7   r   r   )	rh   ÚwalkÚsortr¨   r¡   Úrsplitr   rŸ   r¤   )r   ÚrootÚdirsÚfilesÚfÚdÚpackage_dirÚfullpaths           r   r©   r©   J  s	  è è € åœW T™]œ]ð ð Ñˆˆd�EØ�
Š
‰ŒˆØð 	4ð 	4ˆAØ��!�Œu˜Š}ˆ}Ø—:’:˜u¥lÐ3Ñ4Ô4ð 4ØŸ(š( 3¨Ñ*Ô*¨1Ô-¨tÐ3Ð3Ð3Ð3øØ�	Š	‰ŒˆØð 	)ð 	)ˆAØ��!�Œu˜Š}ˆ}Ý%Ô.¨t°QÑ7Ô7�Ý,¨[Ñ9Ô9�ØÐ'Ø˜[˜.Ð(Ð(Ð(øà���ˆGˆGðð r   Fc              #   ó~  K  — |€t          j        ¦   «         }t          |di ¦  «        }t          t          |dg ¦  «        ¦  «        }t	          t          |                     ¦   «         ¦  «                             |¦  «        ¦  «        }|D ]²}||v r~||         }|j        }|dk    rd}d                     ||¦  «        V — |j	        j
        }|r|                     d¦  «        d         }	nd	}	d
|	z  V — | rd|                     ¦   «         z  V — nd|z  V — ||j        v r|j        |         D ]}
d|
z   dz   V — ŒdV — Œ³dS )a&  Generate text description of plugins.

    Includes both those that have loaded, and those that failed to load.

    Args:
      show_paths: If true, include the plugin path.
      state: The library state object to inspect.

    Returns:
      Iterator of text lines (including newlines.)
    Nr   r   ÚunknownÚ z{} {}
ú
r   z(no description)z  %s
z   %s
z%s (failed to load)
z  ** )r   r   r   r�   ÚsortedÚkeysÚunionÚ__version__rV   Úmoduler]   r:   r   r   )Ú
show_pathsr   Úloaded_pluginsr   Ú	all_namesr/   r   Úversionrµ   ÚdocÚlines              r   Údescribe_pluginsrÇ   ]  s�  è è € ð €}ÝÔ'Ñ)Ô)ˆÝ˜U I¨rÑ2Ô2€NÝ�' %Ð):¸BÑ?Ô?Ñ@Ô@€OÝ•s˜>×.Ò.Ñ0Ô0Ñ1Ô1×7Ò7¸ÑHÔHÑIÔI€IØð ð ˆØ�>Ð!Ð!Ø# DÔ)ˆFØÔ(ˆGØ˜)Ò#Ð#Ø�Ø×"Ò" 4¨Ñ1Ô1Ð1Ð1Ð1Ø”Ô%ˆAØð )Ø—g’g˜d‘m”m AÔ&��à(�Ø˜c‘>Ð"Ð"Ð"Øð 2Ø  6§;¢;¡=¤=Ñ0Ð1Ð1Ð1øà)¨DÑ0Ð0Ð0Ð0Ø�5Ô(Ð(Ð(ØÔ-¨dÔ3ð ,ð ,�Ø ‘n tÑ+Ð+Ð+Ð+Ð+Øˆ
ˆ
ˆ
ˆ
ð)ð r   c              #   óð   K  — t          t          dd¦  «        rBt          j        t          j        t          j        t          ¦  «        d¦  «        ¦  «        V — dS | D ]}t          j        |¦  «        V — ŒdS )z@Generate possible locations for plugins based on existing_paths.ÚfrozenFz../../../pluginsN)r   r0   r   rt   rŸ   ÚdirnameÚ__file__)Úexisting_pathsr   s     r   r…   r…   …  s—   è è € å�s�H˜eÑ$Ô$ð (õ Œo�gÔ.ÝŒO�HÑ%Ô%Ð'9ñ;ô ;ñ <ô <ð 	<ð 	<ð 	<ð 	<ð 	<ð #ð 	(ð 	(ˆDÝ”/ $Ñ'Ô'Ð'Ð'Ð'Ð'ð	(ð 	(r   c              #   ó†   K  — | D ];}t           j                             |¦  «        dv rt          j        |dd¦  «        V — Œ<dS )z=Generate possible locations for plugins from given sys_paths.)zdist-packageszsite-packagesr   r   N)rh   r   rs   r   rŸ   )Ú	sys_pathsr   s     r   r†   r†   ™  sW   è è € àð >ð >ˆÝŒ7×Ò˜DÑ!Ô!Ð%GÐGÐGÝÔ" 4¨°9Ñ=Ô=Ð=Ð=Ð=øð>ð >r   c                  óH   — ddl m}  t          j         | ¦   «         d¦  «        S )Nr   ©Ú
config_dirr   )Úbreezy.beddingrÑ   r   rŸ   rÐ   s    r   rƒ   rƒ      s-   € Ø)Ð)Ð)Ð)Ð)Ð)ÝÔ˜J˜J™LœL¨)Ñ4Ô4Ð4r   c                 ó.   — t          j        | ¦  «         | S rL   )r	   r›   )Úwarning_messages    r   Úrecord_plugin_warningrÕ   ¥  s   € Ý	„L�Ñ!Ô!Ð!ØÐr   c                 ó.   — t          j        d| ¦  «         S )Nz\.|-| )r`   Úsearch)r/   s    r   r’   r’   ª  s   € ÝŒy˜ DÑ)Ô)Ð)Ð)r   c                 óŠ   — t          j        dd| ¦  «        }|                     d¦  «        r|t          d¦  «        d …         }|S )Nz[-. ]Ú_Úbrz_)r`   Úsubr9   r;   )r/   r˜   s     r   r“   r“   ®  sE   € Ý”V˜G S¨$Ñ/Ô/€NØ× Ò  Ñ(Ô(ð 6Ø'­¨F©¬¨¨Ô5ˆØÐr   c           	      ó  — t           | z   t          j        v rdS 	 t          t           | z   ¦  «         dS # t          j        $ r;}d| ›d|j        j        ›d|j        ›d|j	        ›�}t          |¦  «        cY d}~S d}~wt          $ r}t          j        ¦   «          dt          j        v r0t          j        t          j        ¦   «         t          j        ¦  «         t          d                     | ||¦  «        ¦  «        cY d}~S d}~ww xY w)z¨Load plugin by name.

    Args:
      name: The plugin name in the breezy.plugins namespace.
      dir: The directory the plugin is loaded from for error messages.
    NzUnable to load plugin z. It supports z
 versions z but the current version is r    z(Unable to load plugin {!r} from {!r}: {})r.   r0   r1   Ú
__import__r   ÚIncompatibleVersionÚapirW   ÚwantedÚcurrentrÕ   Ú	Exceptionr	   Úlog_exception_quietlyr   Údebug_flagsÚprint_exceptionÚexc_infoÚstderrrV   )r/   ÚdirÚerÔ   s       r   r”   r”   µ  sE  € õ ˜Ñ¥¤Ð+Ð+ØˆðMÝ•> DÑ(Ñ)Ô)Ð)Ð)Ð)øÝÔ%ð 6ð 6ð 6ð 6ð ˆTˆT�1”5”>�>�> 1¤8 8 8¨Q¬Y¨Yð8ð 	õ % _Ñ5Ô5Ð5Ð5Ð5Ð5Ð5Ð5øøøøÝð Mð Mð MÝÔ#Ñ%Ô%Ð%Ø•eÔ'Ð'Ð'ÝÔ!¥#¤,¡.¤.µ#´*Ñ=Ô=Ð=Ý$Ø6×=Ò=¸dÀCÈÑKÔKñMô Mð 	Mð 	Mð 	Mð 	Mð 	Mð 	Møøøøð	Møøøs.   š3 ³DÁ0A8Á2DÁ8DÂA4C?Ã9DÃ?Dc                  ó  — i } t           j        D ]q}|                     t          ¦  «        rU|t	          t          ¦  «        d…         }d|vr5t           j        |         �#t          |t           j        |         ¦  «        | |<   Œr| S )z]Return a dictionary of the plugins.

    Each item in the dictionary is a PlugIn object.
    Nr7   )r0   r1   r9   r.   r;   ÚPlugIn)Úresultr5   r/   s      r   r   r   Î  s€   € ð
 €FÝ”Kð Cð CˆØ×Ò�~Ñ.Ô.ð 	CØ�C¥Ñ/Ô/Ð0Ð0Ô1ˆDØ˜$ˆˆ¥3¤;¨xÔ#8Ð#DÝ% d­C¬K¸Ô,AÑBÔB��t‘øØ€Mr   c                 ó„   — 	 t           j        t          | z            }n# t          $ r Y dS w xY w|€dS t	          | |¦  «        S )z[Retrieve an already loaded plugin.

    Returns None if there is no such plugin loaded
    N)r0   r1   r.   ÚKeyErrorrë   ©r/   rÀ   s     r   Úget_loaded_pluginrð   Ü  sV   € ð
Ý”�^¨dÑ2Ô3ˆˆøÝð ð ð Øˆtˆtðøøøà€~ØˆtÝ�$˜ÑÔÐs   ‚ �
+ª+c                 ó  — | €t          j        ¦   «         } g }t          t          | di ¦  «                             ¦   «         ¦  «        D ]%\  }}|                     |›d|j        ›d�¦  «         Œ&d                     |¦  «        S )zIReturn a string holding a concise list of plugins and their version.
    Nr   ú[ú]z, )r   r   r¼   r   r   rl   r¿   Újoin)r   r   r/   Úa_plugins       r   Úformat_concise_plugin_liströ   ê  s“   € ð €}ÝÔ'Ñ)Ô)ˆØ€EÝ ¥¨°	¸2Ñ!>Ô!>×!DÒ!DÑ!FÔ!FÑGÔGð 3ð 3‰ˆˆhØ�ŠØ�d�d˜HÔ0Ð0Ð0ð2ñ 	3ô 	3ð 	3ð 	3à�9Š9�UÑÔÐr   c                   ó   — e Zd ZdZd„ Zd„ ZdS )ÚPluginsHelpIndexz2A help index that returns help topics for plugins.c                 ó   — d| _         d S )Nzplugins/)ÚprefixrZ   s    r   rN   zPluginsHelpIndex.__init__ù  s   € Ø ˆŒˆˆr   c                 óô   — |sg S |                      | j        ¦  «        r|t          | j        ¦  «        d…         }t          |z   }	 t          j        |         }t          |¦  «        gS # t          $ r g cY S w xY w)a  Search for topic in the loaded plugins.

        This will not trigger loading of new plugins.

        Args:
          topic: A topic to search for.

        Returns:
          A list which is either empty or contains a single
          RegisteredTopic entry.
        N)r9   rú   r;   r.   r0   r1   ÚModuleHelpTopicrî   )rQ   ÚtopicÚplugin_module_namerÀ   s       r   Ú
get_topicszPluginsHelpIndex.get_topicsü  s™   € ð ð 	ØˆIØ×Ò˜DœKÑ(Ô(ð 	-Ø�#˜dœkÑ*Ô*Ð+Ð+Ô,ˆEÝ+¨eÑ3Ðð	-Ý”[Ð!3Ô4ˆFõ $ FÑ+Ô+Ð,Ð,øõ ð 	ð 	ð 	ØˆIˆIˆIð	øøøs   ÁA( Á(A7Á6A7N)rW   r[   r\   r]   rN   rÿ   r¦   r   r   rø   rø   ö  s8   € € € € € Ø<Ð<ð!ð !ð !ð-ð -ð -ð -ð -r   rø   c                   ó&   — e Zd ZdZd„ Zdd„Zd„ ZdS )rü   z6A help topic which returns the docstring for a module.c                 ó   — || _         dS )zeConstructor.

        Args:
          module: The module for which help should be generated.
        N)rÀ   )rQ   rÀ   s     r   rN   zModuleHelpTopic.__init__  s   € ð ˆŒˆˆr   NTc                 ó´   — ddl m} | j        j        sd| j        j        z  }n| j        j        }|d         dk    r|dz  }||                     |¦  «        z  }|S )zŸReturn a string with the help for this topic.

        Args:
          additional_see_also: Additional help topics to be
            cross-referenced.
        r   )Úhelp_topicszPlugin '%s' has no docstring.
éÿÿÿÿr»   )rº   r  rÀ   r]   rW   Ú_format_see_also)rQ   Úadditional_see_alsoÚverboser  rì   s        r   Úget_help_textzModuleHelpTopic.get_help_text   st   € ð 	"Ð!Ð!Ð!Ð!Ð!ØŒ{Ô"ð 	)Ø6¸¼Ô9MÑMˆFˆFà”[Ô(ˆFØ�"Œ:˜ÒÐØ�d‰NˆFØ�+×.Ò.Ð/BÑCÔCÑCˆØˆr   c                 óN   — | j         j        t          t          ¦  «        d…         S )z+Return the module help topic: its basename.N)rÀ   rW   r;   r.   rZ   s    r   Úget_help_topiczModuleHelpTopic.get_help_topic1  s    € àŒ{Ô#¥C­Ñ$7Ô$7Ð$8Ð$8Ô9Ð9r   )NT)rW   r[   r\   r]   rN   r  r
  r¦   r   r   rü   rü     sL   € € € € € Ø@Ð@ðð ð ðð ð ð ð":ð :ð :ð :ð :r   rü   c                   óL   — e Zd ZdZd„ Zd„ Zd„ Zd„ Zd„ Zd„ Z	e
d„ ¦   «         Zd	S )
rë   zvThe breezy representation of a plugin.

    The PlugIn object provides a way to manipulate a given plugin module.
    c                 ó"   — || _         || _        dS )zConstruct a plugin for module.Nrï   )rQ   r/   rÀ   s      r   rN   zPlugIn.__init__<  s   € àˆŒ	ØˆŒˆˆr   c                 ó¸  — t          | j        dd¦  «        �/t          j                             | j        j        d         ¦  «        S t          | j        dd¦  «        �lt          j                             | j        j        ¦  «        }|dd…         t          k    r.|dd…         dz   }t          j                             |¦  «        r|}|S t          | j        ¦  «        S )z.Get the path that this plugin was loaded from.r   Nr   rË   éüÿÿÿr­   )
r   rÀ   rh   r   rt   r   rË   r¡   r§   Úrepr)rQ   r   Úpypaths      r   r   zPlugIn.pathA  sµ   € å�4”; 
¨DÑ1Ô1Ð=Ý”7—?’? 4¤;Ô#7¸Ô#:Ñ;Ô;Ð;Ý�T”[ *¨dÑ3Ô3Ð?Ý”7—?’? 4¤;Ô#7Ñ8Ô8ˆDØ�B�C�CŒy�LÒ(Ð(Ø˜c˜r˜cœ UÑ*�Ý”7—>’> &Ñ)Ô)ð "Ø!�DØˆKå˜œÑ$Ô$Ð$r   c                 ón   — d                      | j        j        | j        j        | j        | j        ¦  «        S )Nz<{}.{} name={}, module={}>)rV   rT   r[   rW   r/   rÀ   rZ   s    r   rY   zPlugIn.__repr__O  s2   € Ø+×2Ò2ØŒNÔ% t¤~Ô'>ØŒI�t”{ñ$ô $ð 	$r   c                 ód   — t          | j        dd¦  «        �| j                             ¦   «         S dS )zReturn the plugin's test suite.Ú
test_suiteN)r   rÀ   r  rZ   s    r   r  zPlugIn.test_suiteT  s/   € å�4”; ¨dÑ3Ô3Ð?Ø”;×)Ò)Ñ+Ô+Ð+à�4r   c                 óf   — t          | j        dd¦  «        �|                     | j        ¦  «        S dS )z�Return the adapted plugin's test suite.

        Args:
          loader: The custom loader that should be used to load additional
            tests.
        Ú
load_testsN)r   rÀ   ÚloadTestsFromModule)rQ   Úloaders     r   Úload_plugin_testszPlugIn.load_plugin_tests[  s3   € õ �4”; ¨dÑ3Ô3Ð?Ø×-Ò-¨d¬kÑ:Ô:Ð:à�4r   c                 ó&  — t          | j        dd¦  «        }|�x	 t          |t          ¦  «        r|                     d¦  «        }n%t          |¦  «        dk    rt          |¦  «        dz   }n&# t          $ r t          j	        ¦   «          |f}Y nw xY w|S )z5Return the plugin's version_tuple or None if unknown.Úversion_infoNr7   é   )Úfinalr   )
r   rÀ   Ú
isinstancerb   r:   r;   Útupler,   r	   rã   )rQ   r  s     r   r  zPlugIn.version_infog  s«   € å˜tœ{¨N¸DÑAÔAˆØÐ#ð/Ý˜l­CÑ0Ô0ð FØ#/×#5Ò#5°cÑ#:Ô#:�L�LÝ˜Ñ&Ô&¨!Ò+Ð+Ý#(¨Ñ#6Ô#6¸Ñ#E�LøøÝð /ð /ð /åÔ+Ñ-Ô-Ð-Ø ,˜���ð/øøøð Ðs   šAA+ Á+ BÂBc                 ó8  — |                       ¦   «         }|�t          |¦  «        dk    rdS 	 t          j        |¦  «        }nX# t          t
          t          f$ r> t          j        ¦   «          d 	                    t          t          |¦  «        ¦  «        }Y nw xY w|S )Nr   r¹   r7   )r  r;   r   Ú_format_version_tupleÚ
ValueErrorr,   Ú
IndexErrorr	   rã   rô   Úmaprb   )rQ   r  Úversion_strings      r   r¿   zPlugIn.__version__v  sŸ   € à×(Ò(Ñ*Ô*ˆØÐ¥3 |Ñ#4Ô#4¸Ò#9Ð#9Ø�9ð	>Ý#Ô9¸,ÑGÔGˆNˆNøÝ�I¥zÐ2ð 	>ð 	>ð 	>ÝÔ'Ñ)Ô)Ð)à ŸXšX¥c­#¨|Ñ&<Ô&<Ñ=Ô=ˆNˆNˆNð	>øøøð Ðs   ­A ÁABÂBN)rW   r[   r\   r]   rN   r   rY   r  r  r  Úpropertyr¿   r¦   r   r   rë   rë   6  s“   € € € € € ðð ð
ð ð ð
%ð %ð %ð$ð $ð $ð
ð ð ð
ð 
ð 
ðð ð ð ð
ð 
ñ „Xð
ð 
ð 
r   rë   c                   ó&   — e Zd ZdZd„ Zd„ Zdd„ZdS )r‹   z9Meta path finder to support BRZ_PLUGINS_AT configuration.c                 ó<   ‡— ‰| _         ˆfd„|D ¦   «         | _        d S )Nc                 ó"   •— i | ]\  }}‰|z   |“ŒS r¦   r¦   )r(   Únr€   rú   s      €r   ú
<dictcomp>z-_PluginsAtFinder.__init__.<locals>.<dictcomp>‰  s#   ø€ ÐHÐHÐH±°°1˜f q™j¨!ÐHÐHÐHr   )rú   Únames_to_path)rQ   rú   Únames_and_pathss    ` r   rN   z_PluginsAtFinder.__init__‡  s,   ø€ ØˆŒØHÐHÐHÐH¸ÐHÑHÔHˆÔÐÐr   c                 óL   — d                      | j        j        | j        ¦  «        S )Nz	<{} {!r}>)rV   rT   rW   rú   rZ   s    r   rY   z_PluginsAtFinder.__repr__‹  s   € Ø×!Ò! $¤.Ô"9¸4¼;ÑGÔGÐGr   Nc                 ó  — || j         vrdS | j         |         }t          j                             |¦  «        r4t	          |¦  «        }|€#t          d                     ||¦  «        ¦  «        ‚t          j        ||¦  «        S )z&New module spec returning find method.Nz&Not loading namespace package {} as {})	r+  rh   r   r„   r¤   ÚImportErrorrV   Úimportlib_utilÚspec_from_file_location)rQ   r5   rH   Útargetr   s        r   Ú	find_specz_PluginsAtFinder.find_specŽ  s‰   € à˜4Ô-Ð-Ð-Ø�4ØÔ! (Ô+ˆÝŒ7�=Š=˜ÑÔð 	%Ý$ TÑ*Ô*ˆDØˆ|õ "Ð"J×"QÒ"QØ˜(ñ#$ô #$ñ %ô %ð %åÔ5°hÀÑEÔEÐEr   rL   )rW   r[   r\   r]   rN   rY   r3  r¦   r   r   r‹   r‹   „  sX   € € € € € ØCÐCðIð Ið IðHð Hð HðFð Fð Fð Fð Fð Fr   r‹   rL   )NNT)rf   )rp   )rw   )FN)0Ú__docformat__rh   r`   r0   Ú	importlibr   r0  r   rº   r   r   r   r	   r.   r¡   r   r!   r   r>   rI   rX   rE   re   r@   rB   r   rD   rC   r   rA   r¤   r‘   r©   rÇ   r…   r†   rƒ   rÕ   r’   r“   r”   r   rð   rö   rø   rü   rë   r‹   r¦   r   r   ú<module>r6     s7  ðð" €ðð( 
€	€	€	Ø 	€	€	€	Ø 
€
€
€
à ,Ð ,Ð ,Ð ,Ð ,Ð ,à €€€ðð ð ð ð ð ð ð ð ð ð ð ð #€à€ð
ð 
ð 
ð 
ð+ð +ð +ð +ðD.ð .ð .ð&ð ð ð5ð 5ð 5ð45ð 5ð 5ð 5ð 5ˆDñ 5ô 5ð 5ð$ð ð ð	ð 	ð 	ð 	ðð ð ð ð"ð ð ð ðBð ð ð&(ð (ð (ð%ð %ð %ð")ð )ð )ðð ð ð
+ð 
+ð 
+ðð ð ð&%ð %ð %ð %ðP(ð (ð (ð(>ð >ð >ð5ð 5ð 5ð
ð ð ð
*ð *ð *ðð ð ðMð Mð Mð2ð ð ð ð  ð  ð	ð 	ð 	ð 	ð-ð -ð -ð -ð -ñ -ô -ð -ð>:ð :ð :ð :ð :ñ :ô :ð :ðBKð Kð Kð Kð Kñ Kô Kð Kð\Fð Fð Fð Fð Fñ Fô Fð Fð Fð Fr   