Move decorator to separate private helper module to prevent circular dependencies

Author: bruno-f-cruz

harp/__init__.py

@@ -1,8 +1,6 @@
 from harp.io import REFERENCE_EPOCH, MessageType, read, to_buffer, to_file
 from harp.reader import create_reader
 from harp.schema import read_schema
-import warnings
-import functools
 
 
 __all__ = ["REFERENCE_EPOCH", "MessageType", "read", "to_buffer", "to_file", "create_reader", "read_schema"]

harp/_helpers.py

@@ -0,0 +1,20 @@
+import warnings
+import functools
+
+
+def deprecated(message):
+    # This decorator is only available from the stdlib warnings module in Python 3.13
+    # Making it available here for compatibility with older versions
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            warnings.warn(
+                f"Call to deprecated function {func.__name__}: {message}",
+                category=DeprecationWarning,
+                stacklevel=1,
+            )
+            return func(*args, **kwargs)
+
+        return wrapper
+
+    return decorator