wraptile 0.1.1__tar.gz → 0.2.0.dev1__tar.gz

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/.gitignore

@@ -17,7 +17,7 @@ __pycache__/
 .Python
 build/
 develop-eggs/
-dist/
+/*/dist/
 downloads/
 eggs/
 .eggs/

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wraptile
-Version: 0.1.1
+Version: 0.2.0.dev1
 Summary: FastAPI server that implements the OGC API - Processes
 Project-URL: Documentation, https://eo-tools.github.io/eozilla
 Project-URL: Repository, https://github.com/eo-tools/eozilla
@@ -28,11 +28,11 @@ Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: fastapi
-Requires-Dist: gavicore>=0.1.1
-Requires-Dist: procodile>=0.1.1
+Requires-Dist: gavicore>=0.2.0.dev1
+Requires-Dist: procodile>=0.2.0.dev1
 Requires-Dist: pydantic
 Requires-Dist: pyyaml
-Requires-Dist: typer
+Requires-Dist: typer<1,>=0.26.0
 Requires-Dist: uvicorn
 Description-Content-Type: text/markdown
 

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@
 
 [project]
 name = "wraptile"
-version = "0.1.1"
+version = "0.2.0.dev1"
 description = "FastAPI server that implements the OGC API - Processes"
 readme = "README.md"
 authors = [
@@ -43,11 +43,11 @@ dependencies = [
   "fastapi",
   "pydantic",
   "pyyaml",
-  "typer",
+  "typer >=0.26.0,<1",
   "uvicorn",
   # local dependency
-  "gavicore >=0.1.1",
-  "procodile >=0.1.1",
+  "gavicore >=0.2.0.dev1",
+  "procodile >=0.2.0.dev1",
 ]
 
 [project.scripts]

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/wraptile/app.py

@@ -12,7 +12,6 @@ from fastapi.responses import JSONResponse
 
 from .exceptions import ServiceException
 
-
 app = FastAPI()
 app.add_middleware(
     CORSMiddleware,

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/wraptile/exceptions.py

@@ -2,39 +2,49 @@
 #  Permissions are hereby granted under the terms of the Apache 2.0 License:
 #  https://opensource.org/license/apache-2-0.
 
-import traceback
 from http import HTTPStatus
 from typing import Optional
 
 from fastapi import HTTPException
 
 from gavicore.models import ApiError
+from gavicore.service.errors import (
+    ErrorTypeId,
+    create_api_error,
+    get_error_type_id,
+)
 
 
 class ServiceException(HTTPException):
     """Raised if a service error occurred."""
 
+    content: ApiError
+
     def __init__(
         self,
         status_code: int,
         detail: str,
         exception: Optional[Exception] = None,
+        type_id: ErrorTypeId | None = None,
+        is_job_problem: bool = False,
     ):
         super().__init__(status_code=status_code, detail=detail)
-        self.content = ApiError(
-            type=type(exception).__name__ if exception is not None else "ApiError",
+
+        if type_id is None:
+            type_id = get_error_type_id(
+                status_code,
+                is_job_problem=is_job_problem,
+                default="internal-server-error",
+            )
+
+        title = str(exception) if exception else HTTPStatus(status_code).phrase
+
+        self.content = create_api_error(
+            type_id,
             status=status_code,
-            title=HTTPStatus(status_code).phrase,
+            title=title,
             detail=detail,
-            **{
-                "x-traceback": (
-                    traceback.format_exception(
-                        type(exception), exception, exception.__traceback__
-                    )
-                    if exception is not None
-                    else None
-                )
-            },
+            exception=exception,
         )
 
 
@@ -42,4 +52,9 @@ class ServiceConfigException(ServiceException):
     """Raised if a service configuration error occurred."""
 
     def __init__(self, message: str):
-        super().__init__(status_code=500, detail=message, exception=self)
+        super().__init__(
+            detail=message,
+            status_code=500,
+            type_id="internal-server-config-error",
+            exception=self,
+        )

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/wraptile/services/airflow/airflow_service.py

@@ -5,11 +5,9 @@
 import datetime
 import logging
 import os
-from functools import cached_property
 from typing import Any, Optional
 
 import fastapi
-import requests
 from airflow_client.client import (
     ApiClient,
     ApiException,
@@ -38,6 +36,7 @@ from gavicore.models import (
 )
 from procodile.workflow import FINAL_STEP_ID
 from wraptile.exceptions import ServiceException
+from wraptile.services.airflow.tokens import TokenProvider, create_token_provider
 from wraptile.services.base import ServiceBase
 
 _log = logging.getLogger(__name__)
@@ -56,6 +55,8 @@ class AirflowService(ServiceBase):
         self._airflow_base_url: Optional[str] = None
         self._airflow_username: Optional[str] = None
         self._airflow_password: Optional[str] = None
+        self._token_provider_instance: Optional[TokenProvider] = None
+        self._api_client: Optional[ApiClient] = None
 
     def configure(
         self,
@@ -144,7 +145,10 @@ class AirflowService(ServiceBase):
         title = schema_dict.get("title")
         description = param_value.get("description") or schema_dict.get("description")
         nullable = bool(schema_dict.get("nullable", False))
-        schema_override: dict[str, Any] = {"default": default, "description": description}
+        schema_override: dict[str, Any] = {
+            "default": default,
+            "description": description,
+        }
         if title is not None:
             schema_override["title"] = title
         return InputDescription.model_validate(
@@ -169,7 +173,9 @@ class AirflowService(ServiceBase):
         try:
             dag_run = self.airflow_dag_run_api.trigger_dag_run(process_id, dag_run_body)
         except ApiException as e:
-            raise ServiceException(e.status, e.reason, exception=e) from e
+            raise ServiceException(
+                e.status, e.reason, exception=e, is_job_problem=True
+            ) from e
         return self.dag_run_to_job_info(dag_run)
 
     async def get_jobs(self, request: fastapi.Request, *args, **kwargs) -> JobList:
@@ -180,14 +186,18 @@ class AirflowService(ServiceBase):
                 owners=None,  # TODO important, get for current user only
             )
         except ApiException as e:
-            raise ServiceException(e.status, detail=e.reason, exception=e) from e
+            raise ServiceException(
+                e.status, detail=e.reason, exception=e, is_job_problem=True
+            ) from e
 
         jobs: list[JobInfo] = []
         for dag in dag_collection.dags:
             try:
                 dag_run_collection = self.airflow_dag_run_api.get_dag_runs(dag.dag_id)
             except ApiException as e:
-                raise ServiceException(e.status, e.reason, exception=e) from e
+                raise ServiceException(
+                    e.status, e.reason, exception=e, is_job_problem=True
+                ) from e
             jobs.extend(
                 self.dag_run_to_job_info(dag_run)
                 for dag_run in dag_run_collection.dag_runs
@@ -199,7 +209,9 @@ class AirflowService(ServiceBase):
         try:
             dag_run = self.airflow_dag_run_api.get_dag_run(dag_id, job_id)
         except ApiException as e:
-            raise ServiceException(e.status, e.reason, exception=e) from e
+            raise ServiceException(
+                e.status, e.reason, exception=e, is_job_problem=True
+            ) from e
         return self.dag_run_to_job_info(dag_run)
 
     async def dismiss_job(self, job_id: str, *args, **kwargs) -> JobInfo:
@@ -213,7 +225,9 @@ class AirflowService(ServiceBase):
                 dag_id, job_id, dag_run_patch
             )
         except ApiException as e:
-            raise ServiceException(e.status, e.reason, exception=e) from e
+            raise ServiceException(
+                e.status, e.reason, exception=e, is_job_problem=True
+            ) from e
         return self.dag_run_to_job_info(dag_run)
 
     async def get_job_results(self, job_id: str, *args, **kwargs) -> JobResults:
@@ -266,58 +280,45 @@ class AirflowService(ServiceBase):
         }
         return mapping[dag_run_state]
 
-    @cached_property
+    # NOTE: these are plain properties (not cached_property) so every call
+    # re-reads airflow_client, which refreshes the bearer token on expiry. A
+    # cached_property would pin the first token for the life of the service.
+    @property
     def airflow_dag_api(self) -> DAGApi:
         return DAGApi(self.airflow_client)
 
-    @cached_property
+    @property
     def airflow_dag_run_api(self) -> DAGRunApi:
         return DAGRunApi(self.airflow_client)
 
-    @cached_property
+    @property
     def airflow_xcom_api(self) -> XComApi:
         return XComApi(self.airflow_client)
 
-    @cached_property
+    @property
     def airflow_client(self) -> ApiClient:
         airflow_base_url: str = (
             self._airflow_base_url
             or os.getenv("AIRFLOW_API_BASE_URL")
             or DEFAULT_AIRFLOW_BASE_URL
         )
-        airflow_username: str = (
-            self._airflow_username or os.getenv("AIRFLOW_USERNAME") or "admin"
-        )
-        airflow_password = self._airflow_password or os.getenv("AIRFLOW_PASSWORD")
-        if not airflow_password:
-            raise RuntimeError(
-                "missing Airflow password; please set env var AIRFLOW_PASSWORD"
+        access_token = self._token_provider(airflow_base_url).get_token()
+        if self._api_client is None:
+            self._api_client = ApiClient(
+                Configuration(host=airflow_base_url, access_token=access_token)
             )
-        access_token = self.fetch_access_token(
-            airflow_base_url,
-            username=airflow_username,
-            password=airflow_password,
-        )
-        configuration = Configuration(host=airflow_base_url, access_token=access_token)
-        return ApiClient(configuration)
+        else:
+            # The generated Airflow client resolves the bearer header from
+            # configuration.access_token at call time, so mutating it in place
+            # refreshes auth without discarding the connection pool.
+            self._api_client.configuration.access_token = access_token
+        return self._api_client
 
-    @classmethod
-    def fetch_access_token(
-        cls,
-        base_url: str,
-        username: Optional[str] = None,
-        password: Optional[str] = None,
-    ) -> str:
-        response = requests.post(
-            f"{base_url}/auth/token",
-            json={"username": username, "password": password},
-            timeout=10,
-        )
-        try:
-            response.raise_for_status()
-            token_data = response.json()
-            return token_data.get("access_token")
-        except requests.exceptions.HTTPError as e:
-            raise ServiceException(
-                response.status_code, detail=response.reason or str(e), exception=e
-            ) from e
+    def _token_provider(self, base_url: str) -> TokenProvider:
+        if self._token_provider_instance is None:
+            self._token_provider_instance = create_token_provider(
+                base_url,
+                username=self._airflow_username,
+                password=self._airflow_password,
+            )
+        return self._token_provider_instance

wraptile-0.2.0.dev1/wraptile/services/airflow/tokens.py

@@ -0,0 +1,339 @@
+#  Copyright (c) 2025-2026 by the Eozilla team and contributors
+#  Permissions are hereby granted under the terms of the Apache 2.0 License:
+#  https://opensource.org/license/apache-2-0.
+
+"""Bearer tokens for the wraptile->airflow hop.
+
+Airflow's API accepts **only tokens Airflow itself issued**. An IdP token is not
+an Airflow bearer, even when Airflow is configured against that IdP: an auth
+manager uses the IdP to authenticate a login and to answer authorization
+queries, then mints its own JWT. Sending the IdP token to ``/api/v2/*`` yields
+``403 "Invalid JWT token"``.
+
+So the token the *gateway* wants and the token *Airflow* wants are different,
+and both travel on the same ``Authorization`` header. The hop is therefore a
+two-step exchange:
+
+1. mint an IdP token via ``client_credentials`` — the gateway validates this
+   (issuer, audience, roles) on the ``/auth/token`` request;
+2. exchange it at Airflow's ``/auth/token`` for an **Airflow** JWT, which
+   authenticates every subsequent API call.
+
+Providers, selected by
+[`TokenConfig.create_token_provider`][wraptile.services.airflow.tokens.TokenConfig.create_token_provider]:
+
+* [`AirflowGatewayTokenProvider`][wraptile.services.airflow.tokens.AirflowGatewayTokenProvider] — the two-step exchange above; the
+  correct path whenever an IdP is configured.
+* [`ClientCredentialsTokenProvider`][wraptile.services.airflow.tokens.ClientCredentialsTokenProvider] — step 1 alone. It is a *component*
+  of the exchange, not a way to talk to Airflow: its token is IdP currency.
+* [`AirflowNativeTokenProvider`][wraptile.services.airflow.tokens.AirflowNativeTokenProvider] — Airflow's ``/auth/token`` by password,
+  for deployments with neither an IdP nor a gateway.
+
+The environment is read in exactly one place,
+[`TokenConfig.from_env`][wraptile.services.airflow.tokens.TokenConfig.from_env];
+everything downstream of it takes a
+[`TokenConfig`][wraptile.services.airflow.tokens.TokenConfig] and is testable
+without touching ``os.environ``.
+
+Nothing here is specific to a particular identity provider: only the standard
+OAuth2 token endpoint and grants are used.
+"""
+
+import abc
+import os
+import time
+from collections.abc import Mapping
+from dataclasses import dataclass
+from typing import Optional
+
+import requests
+
+from wraptile.exceptions import ServiceException
+
+# Re-mint the service token this many seconds before it expires, so a request
+# never carries an already-expired bearer (a typical provider TTL is 300s).
+TOKEN_REFRESH_MARGIN = 30
+
+# Used when the token response omits "expires_in".
+DEFAULT_TOKEN_LIFETIME = 300
+
+TOKEN_REQUEST_TIMEOUT = 10
+
+DEFAULT_AUDIENCE = "airflow"
+
+DEFAULT_AIRFLOW_USERNAME = "admin"
+
+
+class TokenProvider(abc.ABC):
+    """Supplies the bearer token for calls to the Airflow API."""
+
+    @abc.abstractmethod
+    def get_token(self) -> str:
+        """Return a currently valid access token."""
+
+
+class ClientCredentialsTokenProvider(TokenProvider):
+    """OAuth2 ``client_credentials`` grant against an OIDC provider.
+
+    The token is cached and re-minted shortly before expiry so it is not
+    re-fetched on every request.
+    """
+
+    def __init__(
+        self,
+        token_url: str,
+        client_id: str,
+        client_secret: Optional[str] = None,
+        audience: Optional[str] = None,
+    ):
+        self._token_url = token_url
+        self._client_id = client_id
+        self._client_secret = client_secret
+        self._audience = audience
+        self._token: Optional[str] = None
+        self._expiry: float = 0.0
+
+    def get_token(self) -> str:
+        now = time.monotonic()
+        if self._token and now < self._expiry:
+            return self._token
+
+        data = {"grant_type": "client_credentials", "client_id": self._client_id}
+        if self._client_secret:
+            data["client_secret"] = self._client_secret
+        if self._audience:
+            # The client's audience mapper normally stamps this already;
+            # sending it explicitly is harmless and defensive.
+            data["audience"] = self._audience
+
+        response = requests.post(
+            self._token_url, data=data, timeout=TOKEN_REQUEST_TIMEOUT
+        )
+        token_data = _json_or_raise(response)
+        self._token = token_data["access_token"]
+        self._expiry = (
+            now
+            + token_data.get("expires_in", DEFAULT_TOKEN_LIFETIME)
+            - TOKEN_REFRESH_MARGIN
+        )
+        return self._token
+
+
+class AirflowGatewayTokenProvider(TokenProvider):
+    """Exchange an IdP service token for an Airflow-issued JWT.
+
+    Airflow's API rejects IdP tokens (``403 "Invalid JWT token"``) — it accepts
+    only JWTs it minted. Airflow's ``/auth/token`` performs the exchange, and a
+    gateway in front of it validates the IdP token on *that* request. Hence two
+    tokens, each authenticating a different leg:
+
+    * the IdP token goes on the ``Authorization`` header, satisfying the gateway;
+    * the client credentials go in the body, satisfying Airflow.
+
+    Both are needed simultaneously. Without a gateway the header is simply
+    ignored, so this provider is also correct when Airflow is reached directly.
+
+    The Airflow JWT is cached against **its own** expiry, which is unrelated to
+    the IdP token's: ``inner`` re-mints independently on its own schedule.
+    Deriving one lifetime from the other silently breaks the hop the moment the
+    shorter one lapses.
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        client_id: str,
+        client_secret: Optional[str],
+        inner: TokenProvider,
+    ):
+        self._base_url = base_url
+        self._client_id = client_id
+        self._client_secret = client_secret
+        self._inner = inner
+        self._token: Optional[str] = None
+        self._expiry: float = 0.0
+
+    def get_token(self) -> str:
+        now = time.monotonic()
+        if self._token and now < self._expiry:
+            return self._token
+
+        body = {"grant_type": "client_credentials", "client_id": self._client_id}
+        if self._client_secret:
+            body["client_secret"] = self._client_secret
+
+        response = requests.post(
+            f"{self._base_url}/auth/token",
+            json=body,
+            # The IdP token authenticates this request to the gateway, not to
+            # Airflow; Airflow authenticates it from the body above.
+            headers={"Authorization": f"Bearer {self._inner.get_token()}"},
+            timeout=TOKEN_REQUEST_TIMEOUT,
+        )
+        token_data = _json_or_raise(response)
+        self._token = token_data["access_token"]
+        # Airflow's response carries no "expires_in"; its lifetime comes from
+        # the server's api_auth.jwt_expiration_time. Assume the conservative
+        # default and re-mint early — an over-eager exchange costs one request,
+        # a stale JWT costs a 403 mid-flight.
+        self._expiry = (
+            now
+            + token_data.get("expires_in", DEFAULT_TOKEN_LIFETIME)
+            - TOKEN_REFRESH_MARGIN
+        )
+        return self._token
+
+
+class AirflowNativeTokenProvider(TokenProvider):
+    """Airflow's own ``/auth/token`` endpoint, authenticated by password.
+
+    Only for deployments with **no IdP and no gateway**: the password grant
+    requires direct access grants enabled on the IdP client (normally, and
+    correctly, disabled), and this sends no ``Authorization`` header, so a
+    gateway enforcing JWT on ``/auth/token`` rejects it with 401 before Airflow
+    ever sees it. When an IdP is configured, use
+    [`AirflowGatewayTokenProvider`][wraptile.services.airflow.tokens.AirflowGatewayTokenProvider]
+    instead.
+    """
+
+    def __init__(self, base_url: str, username: str, password: str):
+        self._base_url = base_url
+        self._username = username
+        self._password = password
+
+    def get_token(self) -> str:
+        response = requests.post(
+            f"{self._base_url}/auth/token",
+            json={"username": self._username, "password": self._password},
+            timeout=TOKEN_REQUEST_TIMEOUT,
+        )
+        return _json_or_raise(response)["access_token"]
+
+
+@dataclass(frozen=True)
+class TokenConfig:
+    """Everything needed to decide *how* to obtain an Airflow bearer token.
+
+    Construct it directly in tests, or via
+    [`from_env`][wraptile.services.airflow.tokens.TokenConfig.from_env] in
+    production.
+    The OIDC path wins whenever it is configured; the Airflow-native path is
+    the fallback.
+    """
+
+    airflow_base_url: str
+    oidc_token_url: Optional[str] = None
+    oidc_client_id: Optional[str] = None
+    oidc_client_secret: Optional[str] = None
+    oidc_audience: str = DEFAULT_AUDIENCE
+    airflow_username: str = DEFAULT_AIRFLOW_USERNAME
+    airflow_password: Optional[str] = None
+
+    @classmethod
+    def from_env(
+        cls,
+        base_url: str,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        env: Optional[Mapping[str, str]] = None,
+        # Airflow credentials passed by the caller take precedence over the
+        # environment; the OIDC settings are environment-only (deployment
+        # decides whether a gateway is in the path, not the call site).
+    ) -> "TokenConfig":
+        """Read the token settings from a mapping, `os.environ` by default.
+
+        Args:
+            base_url: Base URL of the Airflow web API, used by the native
+                fallback.
+            username: Airflow username, defaults to env `AIRFLOW_USERNAME`,
+                then `admin`.
+            password: Airflow password, defaults to env `AIRFLOW_PASSWORD`.
+            env: The environment to read; injected by tests.
+        """
+        env = os.environ if env is None else env
+        return cls(
+            airflow_base_url=base_url,
+            oidc_token_url=env.get("OIDC_TOKEN_URL") or None,
+            oidc_client_id=env.get("OIDC_CLIENT_ID") or None,
+            oidc_client_secret=env.get("OIDC_CLIENT_SECRET") or None,
+            oidc_audience=env.get("OIDC_AUDIENCE") or DEFAULT_AUDIENCE,
+            airflow_username=(
+                username or env.get("AIRFLOW_USERNAME") or DEFAULT_AIRFLOW_USERNAME
+            ),
+            airflow_password=password or env.get("AIRFLOW_PASSWORD") or None,
+        )
+
+    @property
+    def uses_client_credentials(self) -> bool:
+        """Whether the OIDC client-credentials grant is configured at all."""
+        return bool(self.oidc_token_url or self.oidc_client_id)
+
+    def create_token_provider(self) -> TokenProvider:
+        """Build the token provider this configuration selects.
+
+        With OIDC configured this returns
+        [`AirflowGatewayTokenProvider`][wraptile.services.airflow.tokens.AirflowGatewayTokenProvider],
+        never the bare
+        [`ClientCredentialsTokenProvider`][wraptile.services.airflow.tokens.ClientCredentialsTokenProvider] — the latter's
+        token is IdP currency, which Airflow rejects with
+        ``403 "Invalid JWT token"``. The exchange is not an extra hop to be
+        optimised away; it is the only thing Airflow's API accepts.
+
+        Raises:
+            RuntimeError: If the OIDC settings are only half-filled, or if the
+                native fallback has no Airflow password.
+        """
+        if self.uses_client_credentials:
+            if not (self.oidc_token_url and self.oidc_client_id):
+                # Half-configuring OIDC is a deployment mistake. Falling back to
+                # the native endpoint here would paper over it and send Airflow
+                # a token the gateway was meant to validate.
+                raise RuntimeError(
+                    "incomplete OIDC configuration; please set both env vars"
+                    " OIDC_TOKEN_URL and OIDC_CLIENT_ID"
+                )
+            return AirflowGatewayTokenProvider(
+                self.airflow_base_url,
+                client_id=self.oidc_client_id,
+                client_secret=self.oidc_client_secret,
+                inner=ClientCredentialsTokenProvider(
+                    token_url=self.oidc_token_url,
+                    client_id=self.oidc_client_id,
+                    client_secret=self.oidc_client_secret,
+                    audience=self.oidc_audience,
+                ),
+            )
+
+        if not self.airflow_password:
+            raise RuntimeError(
+                "missing Airflow password; please set env var AIRFLOW_PASSWORD"
+            )
+        return AirflowNativeTokenProvider(
+            self.airflow_base_url,
+            username=self.airflow_username,
+            password=self.airflow_password,
+        )
+
+
+def create_token_provider(
+    base_url: str,
+    username: Optional[str] = None,
+    password: Optional[str] = None,
+) -> TokenProvider:
+    """Select the token provider from the environment.
+
+    Convenience wrapper over ``TokenConfig.from_env(...).create_token_provider()``.
+    """
+    return TokenConfig.from_env(
+        base_url, username=username, password=password
+    ).create_token_provider()
+
+
+def _json_or_raise(response: requests.Response) -> dict:
+    try:
+        response.raise_for_status()
+    except requests.exceptions.HTTPError as e:
+        raise ServiceException(
+            response.status_code, detail=response.reason or str(e), exception=e
+        ) from e
+    return response.json()

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/wraptile/services/local/local_service.py

@@ -21,6 +21,7 @@ from gavicore.models import (
     ProcessRequest,
     ProcessSummary,
 )
+from gavicore.service.errors import ErrorTypeId
 from gavicore.util.dynimp import import_value
 from procodile import Job, Process, ProcessRegistry
 from wraptile.exceptions import ServiceException
@@ -102,6 +103,7 @@ class LocalService(ServiceBase):
                 400,
                 detail=f"Invalid parameterization for process {process_id!r}: {e}",
                 exception=e,
+                type_id="bad-request",
             ) from e
         executor = self._ensure_executor()
         use_processes = isinstance(executor, ProcessPoolExecutor)
@@ -239,7 +241,11 @@ class LocalService(ServiceBase):
     def _get_process(self, process_id: str) -> Process:
         process = self.process_registry.get(process_id)
         if process is None:
-            raise ServiceException(404, detail=f"Process {process_id!r} does not exist")
+            raise ServiceException(
+                404,
+                detail=f"Process {process_id!r} does not exist",
+                type_id="no-such-process",
+            )
         return process
 
     def _get_job(
@@ -247,10 +253,20 @@ class LocalService(ServiceBase):
     ) -> Job:
         job = self.jobs.get(job_id)
         if job is None:
-            raise ServiceException(404, detail=f"Job {job_id!r} does not exist")
+            raise ServiceException(
+                404, detail=f"Job {job_id!r} does not exist", type_id="no-such-job"
+            )
         message = forbidden_status_codes.get(job.job_info.status)
+        type_id: ErrorTypeId | None = None
+        if job.job_info.status in (JobStatus.accepted, JobStatus.running):
+            type_id = "result-not-ready"
         if message:
-            raise ServiceException(403, detail=f"Job {job_id!r} {message}")
+            raise ServiceException(
+                403,
+                detail=f"Job {job_id!r} {message}",
+                is_job_problem=True,
+                type_id=type_id,
+            )
         return job
 
 

{wraptile-0.1.1 → wraptile-0.2.0.dev1}/wraptile/services/local/testing.py

@@ -10,7 +10,7 @@ from typing import Annotated, Optional
 import pydantic
 from pydantic import Field
 
-from gavicore.models import InputDescription, Link, Schema
+from gavicore.models import InputDescription, Link, OutputDescription, Schema
 from procodile import FromMain, FromStep, JobContext
 from wraptile.services.local import LocalService
 
@@ -107,20 +107,20 @@ def primes_between(
             title="Variable names",
             description="Comma-separated list of variable names.",
             schema=Schema(),  # type: ignore[call-arg]
-            **{"x-ui:advanced": True},
         ),
         "bbox": Field(
             title="Bounding box",
             description="Bounding box in geographical coordinates.",
-            json_schema_extra={"x-ui-widget": "map"},
             min_length=4,
             max_length=4,
+            json_schema_extra={"x-ui-widget": "map"},
         ),
         "resolution": Field(
             title="Spatial resolution",
             description="Spatial resolution in degree.",
             ge=0.01,
             le=1.0,
+            json_schema_extra={"x-ui-advanced": True},
         ),
         "start_date": Field(
             title="Start date",
@@ -135,12 +135,12 @@ def primes_between(
             description="Size of time steps in days.",
             ge=1,
             le=10,
+            json_schema_extra={"x-ui-advanced": True},
         ),
         "output_path": InputDescription(
             title="Output path",
             description="Local output path or URI.",
             schema=Schema(minLength=1),  # type: ignore[call-arg]
-            **{"x-ui:advanced": True},
         ),
     },
 )
@@ -309,3 +309,107 @@ def store_data(
 ) -> tuple[tuple[str, str], str]:
     print("Storing data")
     return id, second_input
+
+
+@registry.process(
+    id="218",
+    title="L3B AOI Indicators Processor",
+    version="5.0.4",
+    description="Site Processing L3B NDVI Processor (demo from ESA Sen3CAP project).",
+    inputs={
+        "start_date": InputDescription(
+            title="Start date",
+            schema=Schema(
+                **{
+                    "type": "string",
+                    "format": "date",
+                    "nullable": False,
+                    "x-ui-order": 10,
+                }
+            ),
+        ),
+        "end_date": InputDescription(
+            title="End date",
+            schema=Schema(
+                **{
+                    "type": "string",
+                    "format": "date",
+                    "nullable": False,
+                    "x-ui-order": 11,
+                }
+            ),
+        ),
+        "geometry": InputDescription(
+            title="Geometry (WKT)",
+            schema=Schema(
+                **{
+                    "type": "string",
+                    "format": "wkt",
+                    "nullable": False,
+                    "x-ui-widget": "map",
+                    "x-ui-order": 20,
+                }
+            ),
+        ),
+        "indicator_name": InputDescription(
+            title="L3B Indicator Name",
+            schema=Schema(
+                **{
+                    "type": "string",
+                    "enum": ["NDVI", "LAI", "FAPAR", "FCOVER", "NDWI"],
+                    "nullable": True,
+                    "x-ui-widget": "radio",
+                    "x-ui-advanced": True,
+                    "x-ui-order": 30,
+                }
+            ),
+        ),
+        "site_extend": InputDescription(
+            title="Site extent",
+            schema=Schema(
+                **{
+                    "type": "string",
+                    "format": "wkt",
+                    "nullable": True,
+                    "x-ui-order": 40,
+                }
+            ),
+        ),
+    },
+    outputs={
+        "return_value": OutputDescription(
+            title="stacitemsfile",
+            schema=Schema(
+                **{
+                    "type": "string",
+                    "format": "uri",
+                    "nullable": False,
+                }
+            ),
+        )
+    },
+)
+def processor(
+    start_date: str,
+    end_date: str,
+    geometry: str,
+    indicator_name: str | None,
+    site_extend: str | None,
+) -> dict[str, str]:
+    ctx = JobContext.get()
+    ctx.report_progress(message="Started processing")
+    for i in range(10):
+        time.sleep(0.5)
+        ctx.report_progress(progress=(i + 1) * 10)
+    ctx.report_progress(message="Ended processing")
+    return {
+        k: v
+        for k, v in dict(
+            start_date=start_date,
+            end_date=end_date,
+            geometry=geometry,
+            indicator_name=indicator_name,
+            site_extend=site_extend,
+        ).items()
+        if v is not None
+    }