kobotoolbox / kpi / 27623220260 / 4

82%

master: 76%

push

github

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.

5180 of 12165 branches covered (42.58%)

19937 of 36360 relevant lines covered (54.83%)

0.55 hits per line