unlisted
ubuntu2004a
��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 n0 || _|| _|| _|| _|| _t|t t
��rXd}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 ]0}|d j�� D ] \}}|| u r| S qqdd l}dd l}|�� dd� }| jd u rh| n| j}|�|�D ]F}||�rx|| j urx|�|�} | �� D ] \}
} | |u r�|
S q�qxt
d��d S )Nr c S s. t | t�sdS d| v p d| 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 rf| j|i |��S | j| j g|�R i |��S d 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 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}|r(t �|jj�}|du r4d}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