a
    •˜ëjì.  ã                	   @  s  d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm	Z	 dd	lm
Z
 dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ eded�Zeddd�ZdNdddddd d!œd"d#„ZdOddddd d%œd&d'„ZdPdd(dddd d)œd*d+„ZdQdddd-d.œd/d0„ZdRddd2d3d2d4d5œd6d7„Zdd8d9d:œd;d<„Z dSddd8d4d=œd>d?„Z!d@d4dAœdBdC„Z"dddDœdEdF„Z#dTdGddddddGdHœdIdJ„Z$dUdddddd2ddKœdLdM„Z%dS )VzSHelpers related to deprecation of functions, methods, classes, other
functionality.é    )ÚannotationsN)ÚAny)ÚCallable)ÚDict)ÚMatch)ÚOptional)ÚSequence)ÚSet)ÚTuple)ÚType)ÚTypeVar)ÚUnioné   )Úcompat)Ú_hash_limit_string)Ú_warnings_warn)Ú	decorator)Úinject_docstring_text)Úinject_param_texté   )ÚexcÚ_T)ÚboundÚ_FzCallable[..., Any]ÚstrzType[exc.SADeprecationWarning]ÚintzOptional[str]ÚNone)ÚmsgÚversionÚtype_Ú
stacklevelÚcodeÚreturnc                 C  s&   || |d�}||_ t||d d� d S )N©r!   r   ©r    )Zdeprecated_sincer   )r   r   r   r    r!   Úwarn© r&   ú[/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/sqlalchemy/util/deprecations.pyÚ_warn_with_version*   s    r(   é   )r   r   r    r!   r"   c                 C  s   t | |tj||d� d S )Nr#   )r(   r   ÚSADeprecationWarning)r   r   r    r!   r&   r&   r'   Úwarn_deprecated7   s    ÿr+   zSequence[Any])r   Úargsr   r    r!   r"   c                 C  s(   |rt | d|ƒ} t| |tj||d� dS )zhIssue a deprecation warning with a parameterized string,
    limiting the number of registrations.

    é
   r#   N)r   r(   r   r*   )r   r,   r   r    r!   r&   r&   r'   Úwarn_deprecated_limited?   s
    ÿr.   Ú__init__zCallable[[Type[_T]], Type[_T]])r   ÚmessageÚconstructorr"   c                   s.   dˆˆp
df ‰dddœ‡ ‡‡‡fdd„}|S )Nú.. deprecated:: %s %sÚ úType[_T])Úclsr"   c                   s   t | ˆ tjˆtˆ d� ˆˆƒS )N©Úfunc)Ú_decorate_cls_with_warningr   r*   Údict)r5   ©r1   Úheaderr0   r   r&   r'   ÚdecorateV   s    úz deprecated_cls.<locals>.decorater&   )r   r0   r1   r<   r&   r:   r'   Údeprecated_clsQ   s    
r=   TÚboolz(Optional[Type[exc.SADeprecationWarning]]zCallable[[_F], _F])r   r0   Úadd_deprecation_to_docstringÚwarningÚenable_warningsr"   c                   s`   |rdˆˆpdf ‰nd‰ˆdu r&d‰ˆdu r4t j‰ˆdˆ 7 ‰dddœ‡ ‡‡‡‡fdd	„}|S )
aá  Decorates a function and issues a deprecation warning on use.

    :param version:
      Issue version in the warning.

    :param message:
      If provided, issue message in the warning.  A sensible default
      is used if not provided.

    :param add_deprecation_to_docstring:
      Default True.  If False, the wrapped function's __doc__ is left
      as-is.  If True, the 'message' is prepended to the docs if
      provided, or sensible default if message is omitted.

    r2   r3   Nz$Call to deprecated function %(func)sz (deprecated since: %s)r   ©Úfnr"   c                   s8   ˆd usJ ‚ˆd usJ ‚t | ˆˆt| jd� ˆˆˆ d�S )Nr6   )rA   )Ú_decorate_with_warningr9   Ú__name__)rC   ©rA   r;   r0   r   r@   r&   r'   r<   Š   s    úzdeprecated.<locals>.decorate)r   r*   )r   r0   r?   r@   rA   r<   r&   rF   r'   Ú
deprecatedc   s    þrG   r   z0Callable[[Callable[..., _T]], Callable[..., _T]])r0   Úkwr"   c                 K  s   t d| tjdœ|¤ŽS )Nú2.0©r0   r@   )rI   )rG   r   ZMovedIn20Warning)r0   rH   r&   r&   r'   Úmoved_20™   s     ÿÿÿrK   )Úapi_nameÚalternativerH   r"   c                 K  s–   t  d| ¡}|r(ddddœ| d¡ }nd}d| |d	f }d
| v rl| dd¡}|sl| d¡du slJ d|  ƒ‚|r||d| 7 }tj}td||dœ|¤ŽS )Nz^:(attr|func|meth):Ú	attributeÚfunctionÚmethod)Úattrr7   Úmethr   Z	constructzPThe %s %s is considered legacy as of the 1.x series of SQLAlchemy and %s in 2.0.zbecomes a legacy constructz:attr:Zwarn_on_attribute_accessFrA   zœattribute %s will emit a warning on read access.  If you *really* want this, add warn_on_attribute_access=True.  Otherwise please add enable_warnings=False.ú rI   rJ   )rI   )ÚreÚmatchÚgroupÚpopÚgetr   ZLegacyAPIWarningrG   )rL   rM   rH   Ztype_regr   r0   Zattribute_okZwarning_clsr&   r&   r'   Úbecame_legacy_20¡   s2    
ÿýþÿ
ýÿrY   zTuple[str, str])Úspecsr"   c                    s^   i ‰ i ‰i ‰ˆ  ¡ D ]*\}\}}|ˆ|< t|ƒˆ |< tjˆ|< qdddœ‡ ‡‡‡fdd„}|S )aK  Decorates a function to warn on use of certain parameters.

    e.g. ::

        @deprecated_params(
            weak_identity_map=(
                "0.7",
                "the :paramref:`.Session.weak_identity_map parameter "
                "is deprecated.",
            )
        )
        def some_function(**kwargs): ...

    r   rB   c              	     s  t  | ¡}|jd ur\tt|jt|jƒt|jƒ d … |jƒƒ‰tˆƒ ˆ¡‰tˆƒ 	ˆ¡‰n:|j
d urŠ|j
‰tˆƒ ˆ¡‰tˆƒ 	ˆ¡‰nd‰tˆƒ‰|j‰ tdddddœ‡ ‡‡‡‡‡‡fdd„ƒ}| jd urÔ| jpÖd}|rôt|dd	„ ˆ ¡ D ƒƒ}|| ƒ}||_|S )
Nr&   r   r   ©rC   r,   Úkwargsr"   c                   sÔ   ˆD ]T}ˆ| d u r || d us<ˆ| d ur|| ˆ| krt ˆ| ˆ| ˆ| dd� qˆ ˆv r˜t|ƒ ˆ¡r˜ˆ d us|J ‚t ˆˆ  ˆˆ  ˆˆ  dd� ˆD ](}||v rœt ˆ| ˆ| ˆ| dd� qœ| |i |¤ŽS ©Nr)   r$   )r(   ÚsetÚ
difference)rC   r,   r\   Úm)Úcheck_any_kwÚcheck_defaultsÚcheck_kwÚdefaultsÚmessagesÚversion_warningsÚversionsr&   r'   Úwarnedù   s>    
ÿÿüÿüüz3deprecated_params.<locals>.decorate.<locals>.warnedr3   c                 S  s2   i | ]*\}\}}|d |dkr dn||p(df “qS )r2   rI   z1.4r3   r&   )Ú.0Úparamr   r0   r&   r&   r'   Ú
<dictcomp>  s   
þÿz7deprecated_params.<locals>.decorate.<locals>.<dictcomp>)r   Zinspect_getfullargspecrd   r9   Úzipr,   Úlenr^   Úintersectionr_   ÚkwonlydefaultsÚvarkwr   Ú__doc__r   Úitems)rC   Úspecrh   ÚdocÚ	decorated©re   rZ   rf   rg   )ra   rb   rc   rd   r'   r<   à   s<    

þÿ
&!ýþz#deprecated_params.<locals>.decorate)rr   Ú_sanitize_restructured_textr   r*   )rZ   rj   r   r0   r<   r&   rv   r'   Údeprecated_paramsÇ   s    Irx   )Útextr"   c                 C  s0   dddœdd„}t  ddd„ | ¡} t  d	|| ¡S )
Nz
Match[str]r   )r`   r"   c                 S  s$   |   dd¡\}}|dv r |d7 }|S )Nr   r   )r7   rR   z()©rV   )r`   r   Únamer&   r&   r'   Úrepl-  s    z)_sanitize_restructured_text.<locals>.replz:ref:`(.+) <.*>`c                 S  s   d|   d¡ S )Nz"%s"r   rz   )r`   r&   r&   r'   Ú<lambda>3  ó    z-_sanitize_restructured_text.<locals>.<lambda>z\:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)rT   Úsub)ry   r|   r&   r&   r'   rw   ,  s    rw   r4   )r5   r1   Úwtyper0   r   Údocstring_headerr"   c           	   	   C  s  | j d ur| j pd}|d urþ|d ur2|t|d�; }t|tjƒrF|d7 }t||dƒ}d }t| ƒtu r®t| jƒ}||d< | dd ¡ | dd ¡ t| j	| j
|ƒ} |d urÆ|| }n|| _ |d urÆt| |ƒ}|d urþ|d usÚJ ‚|d usæJ ‚t| |t||||d ƒƒ | S )Nr3   r6   ú@ (Background on SQLAlchemy 2.0 at: :ref:`migration_20_toplevel`)r   rq   Ú__dict__Ú__weakref__)rq   r9   Ú
issubclassr   ÚBase20DeprecationWarningr   Útyperƒ   rW   rE   Ú	__bases__ÚgetattrÚsetattrrD   )	r5   r1   r€   r0   r   r�   rt   Zconstructor_fnZclsdictr&   r&   r'   r8   7  s@    ÿ



ÿýr8   )r7   r€   r0   r   r�   rA   r"   c           
        s¤   t ˆƒ‰tˆtjƒrd}nd}tdddddœ‡ ‡‡‡fdd„ƒ}| jdurP| jpRd}|dur€|t| jd	�; }||7 }t||d
ƒ}|| ƒ}	||	_‡‡‡fdd„|	_	|	S )z=Wrap a function with a warnings.warn and augmented docstring.r‚   r3   r   r   r[   c                   s4   ˆ  p|  dd¡}|s&tˆˆˆdd� | |i |¤ŽS )NZ_sa_skip_warningFr)   r$   )rW   r(   )rC   r,   r\   Zskip_warning©rA   r0   r   r€   r&   r'   rh   {  s    
ÿz&_decorate_with_warning.<locals>.warnedNr6   r   c                     s   t ˆ ˆˆdd�S r]   )r(   r&   )r0   r   r€   r&   r'   r}   Ž  s   ÿz(_decorate_with_warning.<locals>.<lambda>)
rw   r…   r   r†   r   rq   r9   rE   r   Z_sa_warn)
r7   r€   r0   r   r�   rA   Zdoc_onlyrh   rt   ru   r&   r‹   r'   rD   g  s     
ÿ rD   )N)r)   N)r)   N)r/   )NTNT)N)N)NT)&rq   Ú
__future__r   rT   Útypingr   r   r   r   r   r   r	   r
   r   r   r   r3   r   Zlanghelpersr   r   r   r   r   r   r   r   r(   r+   r.   r=   rG   rK   rY   rx   rw   r8   rD   r&   r&   r&   r'   Ú<module>	   s\    û ÿ  û ÿ    û6	 ÿ&e ú5  ú