stac-fastapi.types 3.0.4__tar.gz → 4.0.0__tar.gz

{stac_fastapi_types-3.0.4 → stac_fastapi_types-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: stac-fastapi.types
-Version: 3.0.4
+Version: 4.0.0
 Summary: An implementation of STAC API based on the FastAPI framework.
 Home-page: https://github.com/stac-utils/stac-fastapi
 Author: Arturo Engineering
@@ -10,14 +10,13 @@ Keywords: STAC FastAPI COG
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: MIT License
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: fastapi>=0.109.0
 Requires-Dist: attrs>=23.2.0
@@ -34,3 +33,14 @@ Provides-Extra: docs
 Requires-Dist: mkdocs; extra == "docs"
 Requires-Dist: mkdocs-material; extra == "docs"
 Requires-Dist: pdocs; extra == "docs"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

{stac_fastapi_types-3.0.4 → stac_fastapi_types-4.0.0}/setup.py

@@ -30,12 +30,11 @@ setup(
     description="An implementation of STAC API based on the FastAPI framework.",
     long_description=desc,
     long_description_content_type="text/markdown",
-    python_requires=">=3.8",
+    python_requires=">=3.9",
     classifiers=[
         "Intended Audience :: Developers",
         "Intended Audience :: Information Technology",
         "Intended Audience :: Science/Research",
-        "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",

{stac_fastapi_types-3.0.4 → stac_fastapi_types-4.0.0}/stac_fastapi/types/core.py

@@ -1,7 +1,6 @@
 """Base clients."""
 
 import abc
-import warnings
 from typing import Any, Dict, List, Optional, Union
 from urllib.parse import urljoin
 
@@ -19,7 +18,6 @@ from stac_fastapi.types.config import ApiSettings
 from stac_fastapi.types.conformance import BASE_CONFORMANCE_CLASSES
 from stac_fastapi.types.extension import ApiExtension
 from stac_fastapi.types.requests import get_base_url
-from stac_fastapi.types.rfc3339 import DateTimeType
 from stac_fastapi.types.search import BaseSearchPostRequest
 
 __all__ = [
@@ -342,20 +340,6 @@ class BaseCoreClient(LandingPageMixin, abc.ABC):
         factory=lambda: BASE_CONFORMANCE_CLASSES
     )
     extensions: List[ApiExtension] = attr.ib(default=attr.Factory(list))
-    post_request_model = attr.ib(default=None)
-
-    @post_request_model.validator
-    def _deprecate_post_model(self, attribute, value):
-        """Check and raise warning if `post_request_model` is set."""
-        if value is not None:
-            warnings.warn(
-                "`post_request_model` attribute is deprecated and will be removed in 3.1",
-                DeprecationWarning,
-            )
-
-    def __attrs_post_init__(self):
-        """Set default value for post_request_model."""
-        self.post_request_model = self.post_request_model or BaseSearchPostRequest
 
     def conformance_classes(self) -> List[str]:
         """Generate conformance classes by adding extension conformance to base
@@ -497,7 +481,7 @@ class BaseCoreClient(LandingPageMixin, abc.ABC):
         ids: Optional[List[str]] = None,
         bbox: Optional[BBox] = None,
         intersects: Optional[Geometry] = None,
-        datetime: Optional[DateTimeType] = None,
+        datetime: Optional[str] = None,
         limit: Optional[int] = 10,
         **kwargs,
     ) -> stac.ItemCollection:
@@ -555,7 +539,7 @@ class BaseCoreClient(LandingPageMixin, abc.ABC):
         self,
         collection_id: str,
         bbox: Optional[BBox] = None,
-        datetime: Optional[DateTimeType] = None,
+        datetime: Optional[str] = None,
         limit: int = 10,
         token: str = None,
         **kwargs,
@@ -587,20 +571,6 @@ class AsyncBaseCoreClient(LandingPageMixin, abc.ABC):
         factory=lambda: BASE_CONFORMANCE_CLASSES
     )
     extensions: List[ApiExtension] = attr.ib(default=attr.Factory(list))
-    post_request_model = attr.ib(default=None)
-
-    @post_request_model.validator
-    def _deprecate_post_model(self, attribute, value):
-        """Check and raise warning if `post_request_model` is set."""
-        if value is not None:
-            warnings.warn(
-                "`post_request_model` attribute is deprecated and will be removed in 3.1",
-                DeprecationWarning,
-            )
-
-    def __attrs_post_init__(self):
-        """Set default value for post_request_model."""
-        self.post_request_model = self.post_request_model or BaseSearchPostRequest
 
     def conformance_classes(self) -> List[str]:
         """Generate conformance classes by adding extension conformance to base
@@ -733,7 +703,7 @@ class AsyncBaseCoreClient(LandingPageMixin, abc.ABC):
         ids: Optional[List[str]] = None,
         bbox: Optional[BBox] = None,
         intersects: Optional[Geometry] = None,
-        datetime: Optional[DateTimeType] = None,
+        datetime: Optional[str] = None,
         limit: Optional[int] = 10,
         **kwargs,
     ) -> stac.ItemCollection:
@@ -791,7 +761,7 @@ class AsyncBaseCoreClient(LandingPageMixin, abc.ABC):
         self,
         collection_id: str,
         bbox: Optional[BBox] = None,
-        datetime: Optional[DateTimeType] = None,
+        datetime: Optional[str] = None,
         limit: int = 10,
         token: str = None,
         **kwargs,

{stac_fastapi_types-3.0.4 → stac_fastapi_types-4.0.0}/stac_fastapi/types/search.py

@@ -1,7 +1,7 @@
 """stac_fastapi.types.search module.
 
 """
-
+from datetime import datetime as dt
 from typing import Dict, List, Optional, Union
 
 import attr
@@ -83,22 +83,9 @@ def _bbox_converter(
     return str2bbox(val)
 
 
-def _datetime_converter(
-    val: Annotated[
-        Optional[str],
-        Query(
-            description="""Only return items that have a temporal property that intersects this value.\n
-Either a date-time or an interval, open or closed. Date and time expressions adhere to RFC 3339. Open intervals are expressed using double-dots.""",  # noqa: E501
-            openapi_examples={
-                "datetime": {"value": "2018-02-12T23:20:50Z"},
-                "closed-interval": {"value": "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z"},
-                "open-interval-from": {"value": "2018-02-12T00:00:00Z/.."},
-                "open-interval-to": {"value": "../2018-03-18T12:31:12Z"},
-            },
-        ),
-    ] = None,
-):
-    return str_to_interval(val)
+def _validate_datetime(instance, attribute, value):
+    """Validate Datetime."""
+    _ = str_to_interval(value)
 
 
 # Be careful: https://github.com/samuelcolvin/pydantic/issues/1423#issuecomment-642797287
@@ -106,6 +93,21 @@ NumType = Union[float, int]
 Limit = Annotated[PositiveInt, AfterValidator(crop)]
 
 
+DateTimeQueryType = Annotated[
+    Optional[str],
+    Query(
+        description="""Only return items that have a temporal property that intersects this value.\n
+Either a date-time or an interval, open or closed. Date and time expressions adhere to RFC 3339. Open intervals are expressed using double-dots.""",  # noqa: E501
+        openapi_examples={
+            "datetime": {"value": "2018-02-12T23:20:50Z"},
+            "closed-interval": {"value": "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z"},
+            "open-interval-from": {"value": "2018-02-12T00:00:00Z/.."},
+            "open-interval-to": {"value": "../2018-03-18T12:31:12Z"},
+        },
+    ),
+]
+
+
 @attr.s
 class APIRequest:
     """Generic API Request base class."""
@@ -117,7 +119,36 @@ class APIRequest:
 
 
 @attr.s
-class BaseSearchGetRequest(APIRequest):
+class DatetimeMixin:
+    """Datetime Mixin."""
+
+    datetime: DateTimeQueryType = attr.ib(default=None, validator=_validate_datetime)
+
+    def parse_datetime(self) -> Optional[DateTimeType]:
+        """Return Datetime objects."""
+        return str_to_interval(self.datetime)
+
+    @property
+    def start_date(self) -> Optional[dt]:
+        """Start Date."""
+        parsed = self.parse_datetime()
+        if parsed is None:
+            return None
+
+        return parsed[0] if isinstance(parsed, tuple) else parsed
+
+    @property
+    def end_date(self) -> Optional[dt]:
+        """End Date."""
+        parsed = self.parse_datetime()
+        if parsed is None:
+            return None
+
+        return parsed[1] if isinstance(parsed, tuple) else None
+
+
+@attr.s
+class BaseSearchGetRequest(APIRequest, DatetimeMixin):
     """Base arguments for GET Request."""
 
     collections: Optional[List[str]] = attr.ib(
@@ -170,9 +201,7 @@ class BaseSearchGetRequest(APIRequest):
             },
         ),
     ] = attr.ib(default=None)
-    datetime: Optional[DateTimeType] = attr.ib(
-        default=None, converter=_datetime_converter
-    )
+    datetime: DateTimeQueryType = attr.ib(default=None, validator=_validate_datetime)
     limit: Annotated[
         Optional[Limit],
         Query(

{stac_fastapi_types-3.0.4 → stac_fastapi_types-4.0.0}/stac_fastapi/types/version.py

@@ -1,3 +1,3 @@
 """Library version."""
 
-__version__ = "3.0.4"
+__version__ = "4.0.0"

{stac_fastapi_types-3.0.4 → stac_fastapi_types-4.0.0}/stac_fastapi.types.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: stac-fastapi.types
-Version: 3.0.4
+Version: 4.0.0
 Summary: An implementation of STAC API based on the FastAPI framework.
 Home-page: https://github.com/stac-utils/stac-fastapi
 Author: Arturo Engineering
@@ -10,14 +10,13 @@ Keywords: STAC FastAPI COG
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
 Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: MIT License
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: fastapi>=0.109.0
 Requires-Dist: attrs>=23.2.0
@@ -34,3 +33,14 @@ Provides-Extra: docs
 Requires-Dist: mkdocs; extra == "docs"
 Requires-Dist: mkdocs-material; extra == "docs"
 Requires-Dist: pdocs; extra == "docs"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary