Added deprecation Warning for STAC API Client (#161)

* added deprecation warnings to stacapi.py and stacapi_io.py

* added deprecation warnings to stacapi.py and stacapi_io.py and changed NotImplementedErrors in data.py

* added deprecation warnings to stacapi.py and stacapi_io.py and changed NotImplementedErrors in data.py

* added deprecation warnings to stacapi.py and stacapi_io.py and changed NotImplementedErrors in data.py

Co-authored-by: Maxi Lehner <github@maxliehner.de>

CHANGELOG.rst

@@ -1,5 +1,15 @@
 Changelog
 =========
+[1.3.4] (2022-01-11)
+---------------------
+Added
+^^^^^
+- added deprecation warnings in stacapi.py and stacapi_io.py
+
+Changed
+^^^^^^^
+- changed NotImplementedErrors in data.py
+
 [1.3.3] (2021-10-11)
 ---------------------
 Added

ukis_pysat/__init__.py

@@ -1 +1 @@
-__version__ = "1.3.3"
+__version__ = "1.3.4"

ukis_pysat/data.py

@@ -155,10 +155,7 @@ def query_metadata(self, platform, date, aoi, cloud_cover=None, kwargs=None):
                     yield item
 
         elif self.src == Datahub.STAC_API:
-            raise NotImplementedError(
-                f"Do this directly with our StacApi functionalities, see "
-                f"https://ukis-pysat.readthedocs.io/en/latest/api/stacapi.html."
-            )
+            raise NotImplementedError(f"Do this directly with the pystac-client functionalities.")
 
         elif self.src == Datahub.EarthExplorer:
             # query EarthExplorer for metadata
@@ -205,10 +202,7 @@ def query_metadata_srcid(self, platform, srcid):
                     yield item
 
         elif self.src == Datahub.STAC_API:
-            raise NotImplementedError(
-                f"Do this directly with our StacApi functionalities, see "
-                f"https://ukis-pysat.readthedocs.io/en/latest/api/stacapi.html."
-            )
+            raise NotImplementedError(f"Do this directly with the pystac-client functionalities.")
 
         elif self.src == Datahub.EarthExplorer:
             from landsatxplore.util import guess_dataset

ukis_pysat/stacapi.py

@@ -1,4 +1,7 @@
 import os
+
+import warnings
+
 from urllib.parse import urljoin
 
 try:
@@ -22,6 +25,7 @@ class StacApiError(Exception):
 
 class StacApi:
     def __init__(self, url=os.getenv("STAC_API_URL", None)):
+        warnings.warn("This feature is going to be deleted. Please use the pystac-client.", DeprecationWarning)
         """API to query STAC as part of ukis-pysat.data
         :param url: STAC Server endpoint, reads from STAC_API_URL environment variable by default
         """

ukis_pysat/stacapi_io.py

@@ -1,8 +1,11 @@
 from pystac import Item
 
+import warnings
+
 
 class STACAPI_IO:
     def default_item_method(feature):
+        warnings.warn("This feature is going to be deleted. Please use the pystac-client.", DeprecationWarning)
         return Item.from_dict(feature)
 
     read_item_method = default_item_method