--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mercurial/interfaces/misc.py	Sat Feb 08 18:12:29 2025 +0100
@@ -0,0 +1,26 @@
+# misc.py - Various Interface that did not deserve a dedicated module (yet)
+#
+# Copyright 2025 Octobus, contact@octobus.net
+from __future__ import annotations
+
+import abc
+
+from typing import (
+    Callable,
+    List,
+    Protocol,
+)
+
+
+class IHooks(Protocol):
+    """A collection of hook functions that can be used to extend a
+    function's behavior. Hooks are called in lexicographic order,
+    based on the names of their sources."""
+
+    @abc.abstractmethod
+    def add(self, source: bytes, hook: Callable):
+        ...
+
+    @abc.abstractmethod
+    def __call__(self, *args) -> List:
+        ...