Skip to content

sok.core.adapters.media_adapters.music

Music media adapter for API response normalization.

Normalizes search results and details from music APIs (Spotify, Deezer, MusicBrainz) into a consistent format.

MusicAdapter

class MusicAdapter

Bases: BaseAdapter

Adapter for normalizing music API responses.

Source

adapt_details

def adapt_details(
content_type: ContentType,
payload: Dict[str, Any],
) -> Dict[str, Any]:

Adapt music detail response to normalized format.

Parameters

NameTypeDescription
content_typeContentTypeType of content (ALBUM, TRACK, ARTIST).
payloadDict[str, Any]Raw API detail response.

Returns

  • Dict[str, Any]Normalized music details dictionary.
Source
def adapt_search(
content_type: ContentType,
results: List[Dict[str, Any]],
) -> Dict[str, List[Dict[str, Any]]]:

Adapt music search results to normalized format.

Parameters

NameTypeDescription
content_typeContentTypeType of content (ALBUM, TRACK, ARTIST).
resultsList[Dict[str, Any]]Raw API search results.

Returns

  • Dict[str, List[Dict[str, Any]]]Dictionary with 'results' key containing normalized music items.
Source
Built with Kiln