libera_utils.aws.l1a_join.request_l1a_processing#

libera_utils.aws.l1a_join.request_l1a_processing(apid: int | LiberaApid, applicable_date: str | date | datetime, *, boto_session: Session, force: bool = False, ground_data: bool = False, reason: str | None = None) → date#

Request L1A day assembly for one APID and one applicable date.

Parameters:

  • apid (int or LiberaApid) – APID to assemble into day products.

  • applicable_date (str, datetime.date, or datetime) – UTC calendar day to process.

  • boto_session (boto3.Session) – Boto3 session used for all AWS interactions. The CLI handler builds it from the --profile profile, or the default profile, and assumes no role.

  • force (bool, optional) – When False (default), the Preprocessor re-evaluates the completeness check – the way to retry a day without waiting for new L0 to arrive. When True, it skips the check and assembles whatever overlapping L0 is already indexed.

  • ground_data (bool, optional) – When True, assemble in ground CCSDS mode. Default False (flight PDS).

  • reason (str, optional) – Free text carried on the event for ops and audit logging.

Returns:

The normalized applicable date the event was emitted for.

Return type:

datetime.date

Raises:

  • ValueError – If apid is not a LiberaApid member or has no packet configuration, the date string is not ISO 8601, or the account does not hold exactly one event bus matching LiberaSDCEventBus.

  • RuntimeError – If EventBridge rejects the event.