From 6b6c93376e18e16ebe3ef589345c121e0e2c2b06 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Fri, 15 Aug 2025 11:08:27 +0200
Subject: [PATCH] implemented abstract host class

---
 client/ayon_core/host/abstract.py | 96 +++++++++++++++++++++++++++++++
 client/ayon_core/host/typing.py   |  7 +++
 2 files changed, 103 insertions(+)
 create mode 100644 client/ayon_core/host/abstract.py
 create mode 100644 client/ayon_core/host/typing.py

diff --git a/client/ayon_core/host/abstract.py b/client/ayon_core/host/abstract.py
new file mode 100644
index 0000000000..26771aaffa
--- /dev/null
+++ b/client/ayon_core/host/abstract.py
@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+import logging
+from abc import ABC, abstractmethod
+import typing
+from typing import Optional, Any
+
+from .constants import ContextChangeReason
+
+if typing.TYPE_CHECKING:
+    from ayon_core.pipeline import Anatomy
+
+    from .typing import HostContextData
+
+
+class AbstractHost(ABC):
+    """Abstract definition of host implementation."""
+    @property
+    @abstractmethod
+    def log(self) -> logging.Logger:
+        pass
+
+    @property
+    @abstractmethod
+    def name(self) -> str:
+        """Host name."""
+        pass
+
+    @abstractmethod
+    def get_current_context(self) -> HostContextData:
+        """Get the current context of the host.
+
+        Current context is defined by project name, folder path and task name.
+
+        Returns:
+            HostContextData: The current context of the host.
+
+        """
+        pass
+
+    @abstractmethod
+    def set_current_context(
+        self,
+        folder_entity: dict[str, Any],
+        task_entity: dict[str, Any],
+        *,
+        reason: ContextChangeReason = ContextChangeReason.undefined,
+        project_entity: Optional[dict[str, Any]] = None,
+        anatomy: Optional[Anatomy] = None,
+    ) -> HostContextData:
+        """Change context of the host.
+
+        Args:
+            folder_entity (dict[str, Any]): Folder entity.
+            task_entity (dict[str, Any]): Task entity.
+            reason (ContextChangeReason): Reason for change.
+            project_entity (dict[str, Any]): Project entity.
+            anatomy (Anatomy): Anatomy entity.
+
+        """
+        pass
+
+    @abstractmethod
+    def get_current_project_name(self) -> str:
+        """Get the current project name.
+
+        Returns:
+            Optional[str]: The current project name.
+
+        """
+        pass
+
+    @abstractmethod
+    def get_current_folder_path(self) -> Optional[str]:
+        """Get the current folder path.
+
+        Returns:
+            Optional[str]: The current folder path.
+
+        """
+        pass
+
+    @abstractmethod
+    def get_current_task_name(self) -> Optional[str]:
+        """Get the current task name.
+
+        Returns:
+            Optional[str]: The current task name.
+
+        """
+        pass
+
+    @abstractmethod
+    def get_context_title(self) -> str:
+        """Get the context title used in UIs."""
+        pass
diff --git a/client/ayon_core/host/typing.py b/client/ayon_core/host/typing.py
new file mode 100644
index 0000000000..a51460713b
--- /dev/null
+++ b/client/ayon_core/host/typing.py
@@ -0,0 +1,7 @@
+from typing import Optional, TypedDict
+
+
+class HostContextData(TypedDict):
+    project_name: str
+    folder_path: Optional[str]
+    task_name: Optional[str]