deprecation

import os import warnings from deprecation import deprecated, fail_if_not_removed # Simulate library version for demonstration __version__ = "1.5.0" # Decorate a function as deprecated @deprecated(deprecated_in="1.0", removed_in="2.0", current_version=__version__, details="This function is old, use new_api_function() instead.") def old_api_function(): """An old function that is going to be removed.""" return "Result from old API" # To see DeprecationWarnings, Python typically needs a special flag. # For quick testing, you can uncomment the line below: # os.environ['PYTHONWARNINGS'] = 'default' print(f"Calling deprecated function: {old_api_function()}") # Example of fail_if_not_removed (typically used in a test suite) # This would cause an AssertionError if current_version >= removed_in # import unittest # class MyTests(unittest.TestCase): # @fail_if_not_removed(removed_in="2.0", current_version=__version__) # def test_old_function_is_gone(self): # # This test would fail if old_api_function still exists when version is 2.0 or higher # pass