kobotoolbox / kpi / 27623220260

82%

master: 76%

Build Type

push

github

Committed by web-flow

Commit Message

feat(api): add endpoint to return the total length of all audio DEV-2254 (#7151)

### 📣 Summary
This PR adds a new endpoint that returns the duration of audio
attachments, allowing the front-end to calculate total transcription
time without downloading and processing each file.

### 📖 Description
This PR introduces a new endpoint, `POST
/api/v2/assets/{asset_uid}/attachments/audio-duration/`, which accepts a
list of attachment UIDs and returns the duration of each audio file
along with the total duration.

A new `audio_length` field has been added to the `Attachment` model to
cache audio durations. When a request is made:

* If `Attachment.audio_length` is already populated, the stored value is
returned directly.
* Otherwise, the duration is extracted using `ffprobe`, saved to
`audio_length`, and then returned in the response.

This caching mechanism improves performance and avoids repeatedly
processing the same files. The endpoint also returns per-attachment
durations to support future front-end features that may need to display
file-level duration information.

Coverage Stats

9055 of 12291 branches covered (73.67%)

46 of 86 new or added lines in 7 files covered. (53.49%)

439 existing lines in 19 files now uncovered.

29746 of 36443 relevant lines covered (81.62%)

5.56 hits per line