File: //kunden/lib/python3/dist-packages/breezy/__pycache__/symbol_versioning.cpython-39.pyc
a
�*�^�6 � @ s� d Z ddlmZ g d�ZddlZddlma ddlZdZdd� Zd d
� Z d d � Z
d
d� Z dd� Z dd� Z
dd� Zdd� Zdd� ZG dd� de�Zd&dd �Zd d � Zd d � Zd'd"d#�Zd(d$d%�ZdS ))zESymbol versioning
The methods here allow for api symbol versioning.
� )�absolute_import)�deprecated_function�
deprecated_in�deprecated_list�deprecated_method�DEPRECATED_PARAMETER�deprecated_passed�set_warning_method�warnN�r
z A deprecated parameter marker.c C s dt �| � S )z�Generate a message that something was deprecated in a release.
>>> deprecated_in((1, 4, 0))
'%s was deprecated in version 1.4.0.'
z!%%s was deprecated in version %s.)�breezyZ_format_version_tuple)Z
version_tuple� r
�:/usr/lib/python3/dist-packages/breezy/symbol_versioning.pyr - s �r c C s | a dS )z�Set the warning method to be used by this module.
It should take a message and a warning category as warnings.warn does.
Nr )�methodr
r
r r 7 s r c C sr t | dd�dur.d| jjj| jjj| jf }n<t | dd�durZd| jvrZd| j| jf }nd| j| jf }|| S )ao Generate an automatic deprecation string for a_callable.
:param a_callable: The callable to substitute into deprecation_version.
:param deprecation_version: A deprecation format warning string. This
should have a single %s operator in it. a_callable will be turned into
a nice python symbol and then substituted into deprecation_version.
�__self__N�%s.%s.%s� __qualname__�<�%s.%s)�getattrr � __class__�
__module__�__name__r )Z
a_callable�deprecation_version�symbolr
r
r �deprecation_stringF s
���r c s � fdd�}|S )z=Decorate a function so that use of it will trigger a warning.c s � �fdd�}t � �d|� |S )�<This is the function python calls to perform the decoration.c s: ddl m} |�dd� tt� ��tdd� � | i |��S )z This is the decorated function.� ��trace� zDeprecated function called� ��
stacklevel)� r �mutter_callsiter
r �DeprecationWarning)�args�kwargsr ��callabler r
r �decorated_functiona s
�zKdeprecated_function.<locals>.function_decorator.<locals>.decorated_functionZfunction��_populate_decorated)r* r+ �r �r* r �function_decorator^ s
�z/deprecated_function.<locals>.function_decoratorr
)r r0 r
r. r r [ s
r c s � fdd�}|S )z�Decorate a method so that use of it will trigger a warning.
To deprecate a static or class method, use
@staticmethod
@deprecated_function
def ...
To deprecate an entire class, decorate __init__.
c s � �fdd�}t � �d|� |S )r c sx ddl m} � jdkr,d| jj| jjf }nd| jj| jj� jf }|�dd� t�| tdd � � | g|�R i |��S )
z This is the decorated method.r r �__init__r r r zDeprecated method calledr! r" )r$ r r r r r% r
r& )�selfr' r( r r r) r
r �decorated_method} s
�� ��zEdeprecated_method.<locals>.method_decorator.<locals>.decorated_methodr r, )r* r3 r. r/ r �method_decoratorz s
�z+deprecated_method.<locals>.method_decoratorr
)r r4 r
r. r r n s r c C s | t uS )z(Return True if parameter_value was used.)r )Zparameter_valuer
r
r r � s r c C s� | j r| j �d�}ng }t|�dkr4|d| |_ nvt|�dkrb| j d d |d| d |_ nHt|d �}| j }|dd| 7 }||d| 7 }|dd| 7 }||_ d S )N�
r zThis r ���� )�__doc__�split�len)r* r �label�decorated_callableZdocstring_lines�spacesZnew_docr
r
r �_decorate_docstring� s$
��� r> c C s( t | |||� | j|_| j|_d|_dS )zMPopulate attributes like __name__ and __doc__ on the decorated callable.
TN)r> r r �
is_deprecated)r* r r; r< r
r
r r- � s �r- c s � fdd�}|S )z?Returns a closure that emits a warning and calls the superclassc sP d| j f }| j|f }| jr,|d| j 7 }t|tdd� � | g|�R i |��S )Nz access to %sr7 r! r" )�_variable_name�_deprecation_version�_advicer
r& )Zdep_dictr' r( �msg��wrapped_methodr
r �cb� s z%_dict_deprecation_wrapper.<locals>.cbr
)rE rF r
rD r �_dict_deprecation_wrapper� s rG c @ sX e Zd ZdZdZdd� Zeej�Zeej �Z eej
�Z
eej �Z eej �Z eej
�Z
dS )�DeprecatedDictz1A dictionary that complains when read or written.Tc C s" || _ || _|| _t�| |� dS )a� Create a dict that warns when read or modified.
:param deprecation_version: string for the warning format to raise,
typically from deprecated_in()
:param initial_value: The contents of the dict
:param variable_name: This allows better warnings to be printed
:param advice: String of advice on what callers should do instead
of using this variable.
N)rA r@ rB �dictr1 )r2 r �
variable_name�
initial_valueZadvicer
r
r r1 � s zDeprecatedDict.__init__N)r r r r8 r? r1 rG rI �__len__� __getitem__� __setitem__� __delitem__�keys� __contains__r
r
r
r rH � s
rH c sB d�f }| |f � |r$� d| 7 � G � �fdd�dt �}||�S )aP Create a list that warns when modified
:param deprecation_version: string for the warning format to raise,
typically from deprecated_in()
:param initial_value: The contents of the list
:param variable_name: This allows better warnings to be printed
:param extra: Extra info to print when printing a warning
z Modifying %sr7 c sd e Zd Zej� ZdZ� fdd�Z�fdd�Z�fdd�Z�fdd �Z �fd
d �Z
d�fd
d� Z d S )z(deprecated_list.<locals>._DeprecatedListTc s$ t � tdd� || g|�R i |��S )N� r" )r
r& )r2 �funcr' r( )rC r
r �_warn_deprecated
s z9deprecated_list.<locals>._DeprecatedList._warn_deprecatedc s d� f | � tj|�S )Nz appending to %s is deprecated)rT �list�append)r2 �obj�rJ r
r rV s
z/deprecated_list.<locals>._DeprecatedList.appendc s d� f | � tj||�S )Nz inserting to %s is deprecated)rT rU �insert)r2 �indexrW rX r
r rY s
z/deprecated_list.<locals>._DeprecatedList.insertc s d� f | � tj|�S )Nzextending %s is deprecated)rT rU �extend)r2 �iterablerX r
r r[ s
z/deprecated_list.<locals>._DeprecatedList.extendc s d� f | � tj|�S )Nz removing from %s is deprecated)rT rU �remove)r2 �valuerX r
r r] s
z/deprecated_list.<locals>._DeprecatedList.removeNc s, d� f |r | � tj|�S | � tj�S d S )Nz pop'ing from %s is deprecated)rT rU �pop)r2 rZ rX r
r r_ s
z,deprecated_list.<locals>._DeprecatedList.pop)N) r r r rU r8 r? rT rV rY r[ r] r_ r
�rC rJ r
r �_DeprecatedList s
ra )rU )r rJ rK ZextraZ
subst_textra r
r` r r � s
!r c C s4 t jD ](}tt|d �r| r(|d dkr dS qdS )z�Check if there is already a filter for deprecation warnings.
:param error_only: Only match an 'error' filter
:return: True if a filter is found, False otherwise
r! r �errorTF)�warnings�filters�
issubclassr& )�
error_only�filterr
r
r �_check_for_filter) s
rh c s � fdd�}|S )z�Build and returns a callable removing filter from the warnings.
:param filter: The filter to remove (can be None).
:return: A callable that will remove filter from warnings.filters.
c s0 � r,zt j�� � W n ttfy* Y n0 d S )N)rc rd r] �
ValueError�
IndexErrorr
�rg r
r �cleanup> s
z(_remove_filter_callable.<locals>.cleanupr
)rg rl r
rk r �_remove_filter_callable7 s rm Tc C s4 | st dd�rd}ntjdtd� tjd }t|�S )a� Call this function to suppress all deprecation warnings.
When this is a final release version, we don't want to annoy users with
lots of deprecation warnings. We only want the deprecation warnings when
running a dev or release candidate.
:param override: If True, always set the ignore, if False, only set the
ignore if there isn't already a filter.
:return: A callable to remove the new warnings this added.
F�rf N�ignore��categoryr �rh rc �filterwarningsr& rd rm ��overriderg r
r
r � suppress_deprecation_warningsG s
rv c C s4 | st dd�rd}ntjdtd� tjd }t|�S )a� Call this function to activate deprecation warnings.
When running in a 'final' release we suppress deprecation warnings.
However, the test suite wants to see them. So when running selftest, we
re-enable the deprecation warnings.
Note: warnings that have already been issued under 'ignore' will not be
reported after this point. The 'warnings' module has already marked them as
handled, so they don't get issued again.
:param override: If False, only add a filter if there isn't an error filter
already. (This slightly differs from suppress_deprecation_warnings, in
because it always overrides everything but -Werror).
:return: A callable to remove the new warnings this added.
Trn N�defaultrp r rr rt r
r
r � activate_deprecation_warnings] s
rx )N)T)T)r8 Z
__future__r �__all__rc r
r r r r r r r r r> r- rG rI rH r rh rm rv rx r
r
r
r �<module> s,
% $ �
4