Issue deprecation warnings for STAC_IO

Author: lossyrob

pystac/stac_io.py

@@ -12,6 +12,7 @@
     Type,
     Union,
 )
+import warnings
 
 from urllib.parse import urlparse
 from urllib.request import urlopen
@@ -256,11 +257,21 @@ class STAC_IO:
 
     @staticmethod
     def read_text_method(uri: str) -> str:
+        warnings.warn(
+            "STAC_IO is deprecated. "
+            "Please use instances of StacIO (e.g. StacIO.default()).",
+            DeprecationWarning,
+        )
         return StacIO.default().read_text(uri)
 
     @staticmethod
     def write_text_method(uri: str, txt: str) -> None:
         """Default method for writing text."""
+        warnings.warn(
+            "STAC_IO is deprecated. "
+            "Please use instances of StacIO (e.g. StacIO.default()).",
+            DeprecationWarning,
+        )
         return StacIO.default().write_text(uri, txt)
 
     @staticmethod
@@ -269,6 +280,11 @@ def stac_object_from_dict(
         href: Optional[str] = None,
         root: Optional["Catalog_Type"] = None,
     ) -> "STACObject_Type":
+        warnings.warn(
+            "STAC_IO is deprecated. "
+            "Please use instances of StacIO (e.g. StacIO.default()).",
+            DeprecationWarning,
+        )
         return pystac.serialization.stac_object_from_dict(d, href, root)
 
     # This is set in __init__.py

tests/test_stac_io.py

@@ -0,0 +1,20 @@
+import unittest
+import warnings
+
+from pystac.stac_io import STAC_IO
+from tests.utils import TestCases
+
+
+class StacIOTest(unittest.TestCase):
+    def test_stac_io_issues_warnings(self):
+        with warnings.catch_warnings(record=True) as w:
+            # Cause all warnings to always be triggered.
+            warnings.simplefilter("always")
+            # Trigger a warning.
+            STAC_IO.read_text(
+                TestCases.get_path("data-files/collections/multi-extent.json")
+            )
+
+            # Verify some things
+            self.assertEqual(len(w), 1)
+            self.assertTrue(issubclass(w[-1].category, DeprecationWarning))