From 397bfd23ebc865d74016b1e63bb27f1cebaf6fde Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Fri, 6 Jun 2025 18:04:00 +0200
Subject: [PATCH] added deprecation warnings

---
 client/ayon_core/host/interfaces/workfiles.py | 35 ++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/client/ayon_core/host/interfaces/workfiles.py b/client/ayon_core/host/interfaces/workfiles.py
index d5f17b9acb..b300adc308 100644
--- a/client/ayon_core/host/interfaces/workfiles.py
+++ b/client/ayon_core/host/interfaces/workfiles.py
@@ -4,6 +4,8 @@ import os
 import platform
 import shutil
 import typing
+import warnings
+import functools
 from abc import abstractmethod
 from dataclasses import dataclass, asdict
 from typing import Optional, Any
@@ -21,6 +23,26 @@ WORKFILE_OPEN_REASON = "workfile.opened"
 WORKFILE_SAVE_REASON = "workfile.saved"
 
 
+def deprecated(reason):
+    def decorator(func):
+        message = f"Call to deprecated function {func.__name__} ({reason})."
+
+        @functools.wraps(func)
+        def new_func(*args, **kwargs):
+            warnings.simplefilter("always", DeprecationWarning)
+            warnings.warn(
+                message,
+                category=DeprecationWarning,
+                stacklevel=2
+            )
+            warnings.simplefilter("default", DeprecationWarning)
+            return func(*args, **kwargs)
+
+        return new_func
+
+    return decorator
+
+
 @dataclass
 class WorkfileOpenData:
     filepath: str
@@ -876,6 +898,7 @@ class IWorkfileHost:
         )
 
     # --- Deprecated method names ---
+    @deprecated("Use 'get_workfile_extensions' instead")
     def file_extensions(self):
         """Deprecated variant of 'get_workfile_extensions'.
 
@@ -885,40 +908,44 @@ class IWorkfileHost:
         """
         return self.get_workfile_extensions()
 
+    @deprecated("Use 'save_workfile' instead")
     def save_file(self, dst_path=None):
         """Deprecated variant of 'save_workfile'.
 
         Todo:
-            Remove when all usages are replaced.
+            Remove when all usages are replaced
 
         """
         self.save_workfile(dst_path)
 
+    @deprecated("Use 'open_workfile' instead")
     def open_file(self, filepath):
         """Deprecated variant of 'open_workfile'.
 
         Todo:
             Remove when all usages are replaced.
-        """
 
+        """
         return self.open_workfile(filepath)
 
+    @deprecated("Use 'get_current_workfile' instead")
     def current_file(self):
         """Deprecated variant of 'get_current_workfile'.
 
         Todo:
             Remove when all usages are replaced.
-        """
 
+        """
         return self.get_current_workfile()
 
+    @deprecated("Use 'workfile_has_unsaved_changes' instead")
     def has_unsaved_changes(self):
         """Deprecated variant of 'workfile_has_unsaved_changes'.
 
         Todo:
             Remove when all usages are replaced.
-        """
 
+        """
         return self.workfile_has_unsaved_changes()
 
     def _fetch_published_workfile_entities(