satorbis_kit.pgstac.clients.base module

Abstract base class for STAC ingestion clients.

class satorbis_kit.pgstac.clients.base.AbstractSTACClient

Bases: ABC

Abstract base class for STAC ingestion clients.

This class defines the interface that all STAC ingestion clients must implement, whether they communicate with Airflow directly or through an intermediary service.

abstractmethod get_job_status(job_id: str) → Dict[str, Any]

Get status of an ingestion job.

Parameters:

job_id – Job ID returned from submit_ingestion

Returns:

Dictionary with job status information

Raises:

APIError – If API request fails

abstractmethod submit_ingestion(config: IngestionConfig) → IngestionResponse

Submit raster stacking and STAC ingestion request.

Parameters:

config – IngestionConfig object with job parameters

Returns:

IngestionResponse with job ID and status

Raises:

APIError – If API request fails