cecil 0.0.14__py3-none-any.whl → 0.0.16__py3-none-any.whl

cecil/__init__.py

@@ -1 +1,3 @@
 from .client import Client
+from .errors import Error
+from .version import __version__

cecil/client.py

@@ -1,18 +1,25 @@
 import os
-from typing import Dict, List
-
 import requests
 import snowflake.connector
+
 from pydantic import BaseModel
 from requests import auth
+from typing import Dict, List
+
+from .errors import (
+    Error,
+    _handle_bad_request,
+    _handle_not_found,
+    _handle_unprocessable_entity,
+)
 
 from .models import (
     AOI,
     AOICreate,
     DataRequest,
     DataRequestCreate,
-    Reprojection,
-    ReprojectionCreate,
+    Transformation,
+    TransformationCreate,
     RecoverAPIKey,
     RecoverAPIKeyRequest,
     RotateAPIKey,
@@ -20,8 +27,7 @@ from .models import (
     SnowflakeCredentials,
 )
 
-# TODO: find a way to get this version from __about__.py
-SDK_VERSION = "0.0.14"
+from .version import __version__
 
 # TODO: Documentation (Google style)
 # TODO: Add HTTP retries
@@ -31,9 +37,7 @@ class Client:
     def __init__(self, env=None):
         self._api_auth = None
         self._base_url = (
-            "https://api.cecil.earth"
-            if env is None
-            else f"https://{env}-api.cecil.earth"
+            "https://api.cecil.earth" if env is None else f"https://{env}.cecil.earth"
         )
         self._snowflake_creds = None
 
@@ -65,27 +69,27 @@ class Client:
         res = self._get(url="/v0/data-requests")
         return [DataRequest(**record) for record in res["records"]]
 
-    def create_reprojection(
-        self, data_request_id: str, crs: str, resolution: float
-    ) -> Reprojection:
-        # TODO: check if data request is completed before creating reprojection
+    def create_transformation(
+        self, data_request_id: str, crs: str, spatial_resolution: float
+    ) -> Transformation:
+        # TODO: check if data request is completed before creating transformation
         res = self._post(
-            url="/v0/reprojections",
-            model=ReprojectionCreate(
+            url="/v0/transformations",
+            model=TransformationCreate(
                 data_request_id=data_request_id,
                 crs=crs,
-                resolution=resolution,
+                spatial_resolution=spatial_resolution,
             ),
         )
-        return Reprojection(**res)
+        return Transformation(**res)
 
-    def get_reprojection(self, id: str) -> Reprojection:
-        res = self._get(url=f"/v0/reprojections/{id}")
-        return Reprojection(**res)
+    def get_transformation(self, id: str) -> Transformation:
+        res = self._get(url=f"/v0/transformations/{id}")
+        return Transformation(**res)
 
-    def list_reprojections(self) -> List[Reprojection]:
-        res = self._get(url="/v0/reprojections")
-        return [Reprojection(**record) for record in res["records"]]
+    def list_transformations(self) -> List[Transformation]:
+        res = self._get(url="/v0/transformations")
+        return [Transformation(**record) for record in res["records"]]
 
     def query(self, sql):
         if self._snowflake_creds is None:
@@ -121,7 +125,7 @@ class Client:
         if skip_auth is False:
             self._set_auth()
 
-        headers = {"cecil-python-sdk-version": SDK_VERSION}
+        headers = {"cecil-python-sdk-version": __version__}
 
         try:
             r = requests.request(
@@ -135,14 +139,25 @@ class Client:
             r.raise_for_status()
             return r.json()
 
-        except requests.exceptions.ConnectionError as err:
-            raise ValueError("Connection error") from err
+        except requests.exceptions.ConnectionError:
+            raise Error("failed to connect to the Cecil Platform")
         except requests.exceptions.HTTPError as err:
-            message = f"Request failed with status code {err.response.status_code}"
-            if err.response.text != "":
-                message += f": {err.response.text}"
-
-            raise ValueError(message) from err
+            match err.response.status_code:
+                case 400:
+                    _handle_bad_request(err.response)
+                case 401:
+                    raise Error("unauthorised")
+                case 404:
+                    _handle_not_found(err.response)
+                case 422:
+                    _handle_unprocessable_entity(err.response)
+                case 500:
+                    raise Error("internal server error")
+                case _:
+                    raise Error(
+                        f"request failed with code {err.response.status_code}",
+                        err.response.text,
+                    )
 
     def _get(self, url: str, **kwargs) -> Dict:
         return self._request(method="get", url=url, **kwargs)

cecil/errors.py

@@ -0,0 +1,62 @@
+import json
+
+
+class Error(Exception):
+    def __init__(self, message: str, details=None):
+        self.message = message
+        self.details = details
+
+        if self.details is not None:
+            super().__init__(f"{self.message} \n{json.dumps(self.details, indent=2)}")
+            return
+
+        super().__init__(self.message)
+
+
+def _format_json_key(value: str):
+    return "".join(["_" + i.lower() if i.isupper() else i for i in value]).lstrip("_")
+
+
+def _is_json(value: str):
+    try:
+        json.loads(value)
+        return True
+    except ValueError:
+        return False
+
+
+def _handle_bad_request(response):
+    if not _is_json(response.text):
+        raise Error("bad request")
+
+    details = {}
+    for key, value in response.json().items():
+        details[_format_json_key(key)] = value
+
+    raise Error("bad request", details)
+
+
+def _handle_not_found(response):
+    if not _is_json(response.text):
+        raise Error("resource not found")
+
+    details = {}
+    for key, value in response.json().items():
+        details[_format_json_key(key)] = value
+
+    raise Error("resource not found", details)
+
+
+def _handle_unprocessable_entity(response):
+    if not _is_json(response.text):
+        raise Error(f"failed to process request")
+
+    res_body = response.json()
+    if "params" not in res_body:
+        raise Error(f"failed to process request")
+
+    details = {}
+    for key, value in res_body["params"].items():
+        details[_format_json_key(key)] = value
+
+    raise Error(f"failed to process request", details)

cecil/models.py

@@ -1,23 +1,10 @@
 import datetime
-from enum import Enum
-from typing import Dict, List, Optional
+from typing import Dict
 
 from pydantic import BaseModel, ConfigDict, SecretStr
 from pydantic.alias_generators import to_camel
 
 
-class SubRequestStatus(str, Enum):
-    COMPLETED = "completed"
-    FAILED = "failed"
-    PROCESSING = "processing"
-
-
-class DataRequestStatus(str, Enum):
-    COMPLETED = "completed"
-    FAILED = "failed"
-    PROCESSING = "processing"
-
-
 class AOI(BaseModel):
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
     id: str
@@ -34,21 +21,11 @@ class AOICreate(BaseModel):
     geometry: Dict
 
 
-class SubRequest(BaseModel):
-    model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
-    external_id: str
-    description: str
-    status: SubRequestStatus
-    error_message: Optional[str]
-
-
 class DataRequest(BaseModel):
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
     id: str
     aoi_id: str
     dataset_id: str
-    sub_requests: List[SubRequest]
-    status: DataRequestStatus
     created_at: datetime.datetime
     created_by: str
 
@@ -78,21 +55,21 @@ class RotateAPIKeyRequest(BaseModel):
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
 
 
-class Reprojection(BaseModel):
+class Transformation(BaseModel):
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
     id: str
     data_request_id: str
     crs: str
-    resolution: float
+    spatial_resolution: float
     created_at: datetime.datetime
     created_by: str
 
 
-class ReprojectionCreate(BaseModel):
+class TransformationCreate(BaseModel):
     model_config = ConfigDict(alias_generator=to_camel, populate_by_name=True)
     data_request_id: str
     crs: str
-    resolution: float
+    spatial_resolution: float
 
 
 class SnowflakeCredentials(BaseModel):

cecil/version.py

@@ -0,0 +1 @@
+__version__ = "0.0.16"

{cecil-0.0.14.dist-info → cecil-0.0.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: cecil
-Version: 0.0.14
+Version: 0.0.16
 Summary: Python SDK for Cecil Earth
 License-Expression: MIT
 License-File: LICENSE.txt
@@ -71,30 +71,30 @@ my_data_request = client.create_data_request(
     dataset_id=planet_forest_carbon_diligence_id,
 )
 
-print(client.get_data_request(my_data_request.id).status)
+print(client.get_data_request(my_data_request.id))
 ```
 
-### Create a reprojection using the Cecil client (once data request is completed)
+### Create a transformation using the Cecil client
 
 ```python
-my_reprojection = client.create_reprojection(
+my_transformation = client.create_transformation(
     data_request_id=my_data_request.id,
     crs="EPSG:4326",
-    resolution=0.005,
+    spatial_resolution=0.005,
 )
 
-print(client.get_reprojection(my_reprojection.id).status)
+print(client.get_transformation(my_transformation.id))
 ```
 
-### Query data (once reprojection is completed)
+### Query data (once transformation is completed)
 
 ```python
 df = client.query(f'''
     SELECT *
-    FROM 
+    FROM
         planet.forest_carbon_diligence
     WHERE
-        reprojection_id = '{my_reprojection.id}'
+        transformation_id = '{my_transformation.id}'
 ''')
 ```
 
@@ -109,9 +109,9 @@ client.list_data_requests()
 
 client.get_data_request(my_data_request.id)
 
-client.list_reprojections()
+client.list_transformations()
 
-client.get_reprojection(my_reprojection.id)
+client.get_transformation(my_transformation.id)
 ```
 
 ## License

cecil-0.0.16.dist-info/RECORD

@@ -0,0 +1,9 @@
+cecil/__init__.py,sha256=AEcRl73BDSAQe6W0d1PDD87IEcumARtREl7dCVa_YQY,86
+cecil/client.py,sha256=hykvGQrpuAEQR_TawLKCwc_mWsjD72uxAZHaOTZjf1M,5764
+cecil/errors.py,sha256=r9NNRtv_oO_hblnh-VOlAf767cJqmlnbJfHB63OA_zY,1538
+cecil/models.py,sha256=xkjrLAOenJboRtzRPihT-C8jpadngePz4KzLNJoemHM,2012
+cecil/version.py,sha256=8ss7zPyQ3YfaQJw9IIGX35NOL7ASZ7-LErAxKnQDN7c,23
+cecil-0.0.16.dist-info/METADATA,sha256=7f2D9tc10goXMoeFgZqjHWeENrVyUq6H0OXmma75eWY,2659
+cecil-0.0.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+cecil-0.0.16.dist-info/licenses/LICENSE.txt,sha256=mUexcmfYx3bG1VIzAdQTOf_NzStYw6-QkKVdUY_d4i4,1066
+cecil-0.0.16.dist-info/RECORD,,

{cecil-0.0.14.dist-info → cecil-0.0.16.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.25.0
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any

cecil-0.0.14.dist-info/RECORD

@@ -1,7 +0,0 @@
-cecil/__init__.py,sha256=MF64bwUCd4sm3dvcxZnkb4ujHtxT_KeuXdD0nVieEt4,27
-cecil/client.py,sha256=86TRdEGdxgO5nmoKpxdIIU6xeR9EjcOht7ZcKg7tInI,5237
-cecil/models.py,sha256=6p9AedCDdkK-ptK2r5pc9AKG8rgZHw-YYDvRgXPAQqI,2544
-cecil-0.0.14.dist-info/METADATA,sha256=xzTRj3FnDLmzk9pA11-YI3xBMMGKJ7p1e6rZlxO4YVw,2677
-cecil-0.0.14.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
-cecil-0.0.14.dist-info/licenses/LICENSE.txt,sha256=mUexcmfYx3bG1VIzAdQTOf_NzStYw6-QkKVdUY_d4i4,1066
-cecil-0.0.14.dist-info/RECORD,,