Data source improvements

docs/source/data_sources.rst

@@ -0,0 +1,6 @@
+data_sources
+============
+
+.. automodule:: sentinelhub.data_sources
+    :members:
+    :show-inheritance:

docs/source/docs.rst

@@ -14,6 +14,7 @@ Modules
     config
     constants
     data_request
+    data_sources
     download.aws_client
     download.client
     download.request

docs/source/examples.rst

@@ -6,6 +6,7 @@ Examples
     :maxdepth: 4
 
     examples/processing_api_request.ipynb
+    examples/data_sources.ipynb
     examples/ogc_request.ipynb
     examples/large_area_utilities.ipynb
     examples/fis_request.ipynb

sentinelhub/__init__.py

@@ -14,8 +14,9 @@
 from .geopedia import GeopediaFeatureIterator, GeopediaSession
 
 from .geometry import BBox, Geometry, BBoxCollection
-from .constants import DataSource, CustomUrlParam, CRS, MimeType, SHConstants, AwsConstants, ServiceType, \
+from .constants import CustomUrlParam, CRS, MimeType, SHConstants, AwsConstants, ServiceType, \
     HistogramType
+from .data_sources import DataSource
 
 from .config import SHConfig
 

sentinelhub/areas.py

@@ -13,7 +13,8 @@
 from shapely.geometry import Polygon, MultiPolygon, GeometryCollection
 
 from .config import SHConfig
-from .constants import CRS, DataSource
+from .constants import CRS
+from .data_sources import DataSource
 from .geometry import BBox, BBoxCollection, BaseGeometry, Geometry
 from .geo_utils import transform_point
 from .ogc import WebFeatureService
@@ -358,7 +359,7 @@ class TileSplitter(AreaSplitter):
                              as `(n, n)`.
     :type split_shape: int or (int, int)
     :param data_source: Source of requested satellite data. Default is Sentinel-2 L1C data.
-    :type data_source: sentinelhub.constants.DataSource
+    :type data_source: DataSource
     :param config: A custom instance of config class to override parameters from the saved configuration.
     :type config: SHConfig or None
     :param reduce_bbox_sizes: If `True` it will reduce the sizes of bounding boxes so that they will tightly fit the

sentinelhub/aws.py

@@ -8,7 +8,8 @@
 from abc import ABC, abstractmethod
 
 from .config import SHConfig
-from .constants import AwsConstants, EsaSafeType, MimeType, DataSource
+from .constants import AwsConstants, EsaSafeType, MimeType
+from .data_sources import DataSource
 from .download import DownloadRequest
 from .download.aws_client import get_aws_json
 from .exceptions import AwsDownloadFailedException, SHUserWarning
@@ -467,7 +468,7 @@ class will try to find the index automatically. If there will be multiple choice
         :type aws_index: int or None
         :param data_source: Source of requested AWS data. Supported sources are Sentinel-2 L1C and Sentinel-2 L2A,
             default is Sentinel-2 L1C data.
-        :type data_source: constants.DataSource
+        :type data_source: DataSource
         :param parent_folder: folder where the fetched data will be saved.
         :type parent_folder: str
         :param bands: List of Sentinel-2 bands for request. If parameter is set to `None` all bands will be used.
@@ -527,8 +528,8 @@ def parse_datetime(time):
         """
         try:
             return parse_time(time)
-        except Exception:
-            raise ValueError('Time must be in format YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS')
+        except Exception as exception:
+            raise ValueError('Time must be in format YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS') from exception
 
     def get_requests(self):
         """

sentinelhub/aws_safe.py

@@ -5,7 +5,8 @@
 import warnings
 
 from .aws import AwsProduct, AwsTile
-from .constants import AwsConstants, EsaSafeType, MimeType, DataSource
+from .constants import AwsConstants, EsaSafeType, MimeType
+from .data_sources import DataSource
 from .download.aws_client import get_aws_xml
 from .exceptions import SHRuntimeWarning
 

sentinelhub/commands.py

@@ -5,7 +5,7 @@
 import click
 
 from .config import SHConfig
-from .constants import DataSource
+from .data_sources import DataSource
 from .data_request import get_safe_format, download_safe_format
 from .download import DownloadRequest, DownloadClient
 

sentinelhub/config.py

@@ -272,8 +272,8 @@ def get_sh_ogc_url(self):
         :return: An URL endpoint
         :rtype: str
         """
-        ogc_enpoint = 'v1' if self.has_eocloud_url() else 'ogc'
-        return '{}/{}'.format(self.sh_base_url, ogc_enpoint)
+        ogc_endpoint = 'v1' if self.has_eocloud_url() else 'ogc'
+        return '{}/{}'.format(self.sh_base_url, ogc_endpoint)
 
     def get_sh_rate_limit_url(self):
         """ Provides URL for Sentinel Hub rate limiting endpoint