Add support for Subscriptions time range types

Resolves #969

Author: sgillies

CHANGES.txt

@@ -1,8 +1,8 @@
 2.1.0 (TBD)
 
 Added:
-- Support for catalog source publishing stages has been added to
-  subscription_request.catalog_source ().
+- Support for catalog source publishing stages (#977) and time range types ()
+  have been added to subscription_request.catalog_source.
 - A subscription_request.planetary_variable_source function has been added
   (#976).
 - The subscription_request.build_request function has a new option to clip to

planet/subscription_request.py

@@ -154,6 +154,7 @@ def catalog_source(
     publishing_stages: Optional[Sequence[Literal["preview",
                                                  "standard",
                                                  "finalized"]]] = None,
+    time_range_type: Optional[Literal["acquired", "published"]] = None,
 ) -> dict:
     """Construct a Catalog subscription source.
 
@@ -201,6 +202,7 @@ def catalog_source(
         ...     },
         ...     start_time=datetime(2021, 3, 1),
         ...     publishing_stages=["standard"],
+        ...     time_range_type="acquired",
         ... )
         >>> request = build_request(
         ...     "Standard PSScene Ortho Analytic",
@@ -247,6 +249,9 @@ def catalog_source(
     if publishing_stages:
         parameters['publishing_stages'] = list(set(publishing_stages))
 
+    if time_range_type:
+        parameters['time_range_type'] = time_range_type
+
     return {"type": "catalog", "parameters": parameters}
 
 

tests/unit/test_subscription_request.py

@@ -391,3 +391,16 @@ def test_catalog_source_publishing_stages(publishing_stages, geom_geojson):
 
     assert source["parameters"]["publishing_stages"] == list(
         set(publishing_stages))
+
+
+def test_catalog_source_time_range_type_acquired(geom_geojson):
+    """Configure 'acquired' time range type for a catalog source."""
+    source = subscription_request.catalog_source(
+        item_types=["PSScene"],
+        asset_types=["ortho_analytic_4b"],
+        geometry=geom_geojson,
+        start_time=datetime(2021, 3, 1),
+        time_range_type="acquired",
+    )
+
+    assert source["parameters"]["time_range_type"] == "acquired"