Move decorator to separate private helper module to prevent circular dependencies

Author: bruno-f-cruz

harp/__init__.py

@@ -1,26 +1,6 @@
 from harp.io import REFERENCE_EPOCH, MessageType, read
 from harp.reader import create_reader
 from harp.schema import read_schema
-import warnings
-import functools
 
 
 __all__ = ["REFERENCE_EPOCH", "MessageType", "read", "create_reader", "read_schema"]
-
-
-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

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

harp/reader.py

@@ -9,7 +9,7 @@
 from typing import Any, BinaryIO, Callable, Iterable, Mapping, Optional, Protocol, Union
 
 import requests
-from harp import deprecated
+from harp._helpers import deprecated
 from numpy import dtype
 from pandas import DataFrame, Series
 from pandas._typing import Axes