Yu1709$!%yuyu!$%wutu!5=126+

                
____  ___       .__                 
\   \/  /  _____|  |   ______  _  __
 \     /  /  ___/  |  /  _ \ \/ \/ /
 /     \  \___ \|  |_(  <_> )     / 
/___/\  \/____  >____/\____/ \/\_/  
      \_/     \/    @ligmakokz

Editing: test_deprecate.py

from textwrap import dedent

import pytest

from pandas.util._decorators import deprecate

import pandas._testing as tm

def new_func():
    """
    This is the summary. The deprecate directive goes next.

This is the extended summary. The deprecate directive goes before this.
    """
    return "new_func called"

def new_func_no_docstring():
    return "new_func_no_docstring called"

def new_func_wrong_docstring():
    """Summary should be in the next line."""
    return "new_func_wrong_docstring called"

def new_func_with_deprecation():
    """
    This is the summary. The deprecate directive goes next.

.. deprecated:: 1.0
        Use new_func instead.

This is the extended summary. The deprecate directive goes before this.
    """

def test_deprecate_ok():
    depr_func = deprecate("depr_func", new_func, "1.0", msg="Use new_func instead.")

with tm.assert_produces_warning(FutureWarning):
        result = depr_func()

assert result == "new_func called"
    assert depr_func.__doc__ == dedent(new_func_with_deprecation.__doc__)

def test_deprecate_no_docstring():
    depr_func = deprecate(
        "depr_func", new_func_no_docstring, "1.0", msg="Use new_func instead."
    )
    with tm.assert_produces_warning(FutureWarning):
        result = depr_func()
    assert result == "new_func_no_docstring called"

def test_deprecate_wrong_docstring():
    msg = "deprecate needs a correctly formatted docstring"
    with pytest.raises(AssertionError, match=msg):
        deprecate(
            "depr_func", new_func_wrong_docstring, "1.0", msg="Use new_func instead."
        )

Name	Type	Actions
__pycache__	Directory
__init__.py	File
conftest.py	File
test_assert_almost_equal.py	File
test_assert_attr_equal.py	File
test_assert_categorical_equal.py	File
test_assert_extension_array_equal.py	File
test_assert_frame_equal.py	File
test_assert_index_equal.py	File
test_assert_interval_array_equal.py	File
test_assert_numpy_array_equal.py	File
test_assert_produces_warning.py	File
test_assert_series_equal.py	File
test_deprecate.py	File
test_deprecate_kwarg.py	File
test_deprecate_nonkeyword_arguments.py	File
test_doc.py	File
test_hashing.py	File
test_numba.py	File
test_rewrite_warning.py	File
test_shares_memory.py	File
test_show_versions.py	File
test_util.py	File
test_validate_args.py	File
test_validate_args_and_kwargs.py	File
test_validate_inclusive.py	File
test_validate_kwargs.py	File