unlisted
ubuntu2004o
��c � @ sP d Z ddlmZ ddlZddlmZ dd� Zddd �ZG d
d � d �Zd d
� Z dS )z}
Convenience tools for handling deprecations.
Most of the code is taken from the SageMath source code in misc/superseded.py
� )�warnN)�lazy_attributec C s
d� | �S )Nz=https://gitlab.com/modulispaces/admcycles/-/merge_requests/{})�format)�num� r �8/home/user/Introduction lectures/admcycles/superseded.py�merge_request_url s
r � c C s* |d7 }|d� t| ��7 }t|t|� d S )N�
zSee {} for details.)r r r �DeprecationWarning)�
merge_request�message�
stacklevelr r r � deprecation s r c @ s8 e Zd ZdZd dd�Zedd� �Z dd� Zd d d
�ZdS )
�DeprecatedFunctionAliasze
A wrapper around methods or functions which automatically prints a
deprecation message.
Nc C s� z | j �|j � W n ty Y nw || _|| _|| _|| _|| _t|t t
��r,d}nd}d}|d| d | jj d 7 }|d� t
|��7 }|| _d S )N�func�methz Deprecated: zUse :z:`z ` instead.
zSee {} for details.
)�__dict__�update�AttributeErrorr r �instance�unbound�
__module__�
isinstance�typer �__name__r r �__doc__)�selfr r �moduler r �
sphinxrole�docr r r �__init__, s" �
z DeprecatedFunctionAlias.__init__c C s� t �� D ]}|d j�� D ]\}}|| u r| S q
qdd l}dd l}|�� dd� }| jd u r4| n| j}|�|�D ]#}||�r_|| j ur_|�|�} | �� D ]\}
} | |u r^|
S qPq<t
d��)Nr c S s. t | t�sdS d| v pd| v }d| v }|p|S )NFr � __package__�__new__)r �dict)�gc_ref�is_python_class�is_cython_classr r r �is_classK s
z2DeprecatedFunctionAlias.__name__.<locals>.is_classz9The name of this deprecated function cannot be determined) �inspect�stack� f_globals�items�gc�copy�collectr �
get_referrersr r ) r �frame�name�objr- r. r( �
search_for�ref�ref_copy�key�valr r r r ? s( ��
��z DeprecatedFunctionAlias.__name__c O s� | j d u r| j| jjkr| jjd | jj }n| jj}t| jd�| j|�� | j d u r3| j|i |��S | j| j g|�R i |��S )N�.z({} is deprecated. Please use {} instead.)r r r r r r r )r �args�kwds�otherr r r �__call__Z s ��
z DeprecatedFunctionAlias.__call__c C s$ |d u r| S t | j| j| j|| d�S )N)r r )r r r r )r �inst�clsr r r �__get__h s
�z DeprecatedFunctionAlias.__get__)NN)N)r r � __qualname__r r! r r= r@ r r r r r & s
r c C s@ d}t �� }|r|j}|rt �|jj�}|du rd}t| ||�S )a;
Create an aliased version of a function or a method which raises a
deprecation warning message.
If f is a function or a method, write
``g = deprecated_function_alias(merge_request, f)``
to make a deprecated aliased version of f.
INPUT:
- ``merge_request`` -- integer. The merge request number where the
deprecation is introduced.
- ``func`` -- the function or method to be aliased
EXAMPLES::
sage: from admcycles.superseded import deprecated_function_alias
sage: g = deprecated_function_alias(13, number_of_partitions)
sage: g(5)
doctest:...: DeprecationWarning: g is deprecated. Please use sage.combinat.partition.number_of_partitions instead.
See https://gitlab.com/modulispaces/admcycles/-/merge_requests/13 for details.
7
N�__main__)r) � currentframe�f_back�
getmodulename�f_code� co_filenamer )r r � module_name�frame0�frame1r r r �deprecated_function_aliasr s rK )r )
r �warningsr r) �sage.misc.lazy_attributer r r r rK r r r r �<module> s
L