python_warnings_module_deprecation_warning_quickstart.py

1import warnings
2
3def legacy_function():
4    warnings.warn(
5        "legacy_function() is deprecated and will be removed in a future version. Use new_function() instead.",
6        category=DeprecationWarning,
7        stacklevel=2
8    )
9    # Function logic continues here
10    print("Executing legacy logic...")
11
12def new_function():
13    print("Executing new logic...")
14
15if __name__ == "__main__":
16    # Note: DeprecationWarnings are ignored by default in Python 
17    # unless triggered directly by code in __main__ or configured otherwise.
18    legacy_function()