
    i=
                         S r SSKJrJr  SSKrSSKrSS\S\S\S\S\4
S	 jjrSS\S\S\S\SS4
S
 jjr	 SS\S\S\S\S\SS4S jjr
g)zDeprecation utilities    )CallableAnyN
deprecatedversionremedy
stacklevelreturnc                 <   ^ ^^^ S[         S[         4U UUU4S jjnU$ )a  Emit a warning prior to calling decorated function.
Args:
    deprecated: Function being deprecated.
    version: First release the function is deprecated.
    remedy: User action to take.
    stacklevel: The warning stackevel to use.

Returns:
    The decorated, deprecated callable.
funcr	   c                 x   >^  [         R                  " T 5      S[        S[        S[        4UU UUU4S jj5       nU$ )Nargskwargsr	   c                  >   > [        ST S3TTTS-   5        T" U 0 UD6$ )NzThe z method is deprecated   issue_deprecation_msg)r   r   r   r   r   r   r   s     ^/home/james-whalen/.local/lib/python3.13/site-packages/qiskit_ibm_runtime/utils/deprecation.pywrapper6deprecate_function.<locals>.decorator.<locals>.wrapper!   s7    !zl"78Q	 (((    )	functoolswrapsr   r   )r   r   r   r   r   r   s   ` r   	decorator%deprecate_function.<locals>.decorator    s?    			)3 	)# 	)( 	) 	) 
	) r   )r   )r   r   r   r   r   s   ```` r   deprecate_functionr      s#     X   r   c                 .    [        SU  S3UUUS-   5        g)zEmit a warning about deprecated keyword arguments.

Args:
    deprecated: Keyword arguments being deprecated.
    version: First release the function is deprecated.
    remedy: User action to take.
    stacklevel: The warning stackevel to use.
zThe 'z"' keyword arguments are deprecatedr   Nr   )r   r   r   r   s       r   deprecate_argumentsr   0   s&     

|=>Q	r   msgperiodc           	      T    [         R                  " U  SU SU SU 3[        US-   S9  g)zEmit a deprecation warning.

Args:
    msg: Deprecation message.
    version: First release the function is deprecated.
    remedy: User action to take.
    stacklevel: The warning stackevel to use.
    period: Deprecation period.
z as of qiskit-ibm-runtime z$ and will be removed no sooner than z after the release date. r   )r   N)warningswarnDeprecationWarning)r   r   r   r   r   s        r   r   r   A   s=     MM%)' 3..4X5Nvh	X>	r   )   )r$   z3 months)__doc__typingr   r   r   r!   strintr   r   r    r   r   <module>r*      s        3  c s [c 8C # s PS \` $ MW	$'58FI	r   