sok.media.music.playlist
Playlist class for music playlists.
Playlist
class Playlist( name: str, language: str, media_manager: UniversalMediaManager, owner: str = '',)Bases: BaseMedia
Class for managing music playlists.
Represents a collection of tracks organized in a playlist.
Initialize a Playlist instance.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | Playlist name. | |
language | str | Language code. | |
media_manager | UniversalMediaManager | The API manager. | |
owner | str | '' | Playlist owner name. |
Attributes
| Name | Type | Description |
|---|---|---|
created_at | Optional[datetime] | Playlist creation date. |
duration_total | int | Total duration in seconds. |
is_public | bool | Whether the playlist is public. |
owner | Playlist owner/creator. | |
track_count | int | Total number of tracks. |
tracks | List[Dict[str, Any]] | List of tracks in the playlist. |
updated_at | Optional[datetime] | Last update date. |
add_track
def add_track(track: Dict[str, Any]) -> None:Add a track to the playlist.
Parameters
| Name | Type | Description |
|---|---|---|
track | Dict[str, Any] | Track data dictionary. |
from_dictclassmethod
def from_dict( data: Dict[str, Any], media_manager: UniversalMediaManager,) -> Playlist:Create a Playlist instance from a dictionary.
Parameters
| Name | Type | Description |
|---|---|---|
data | Dict[str, Any] | Playlist data. |
media_manager | UniversalMediaManager | The API manager. |
Returns
PlaylistPlaylist instance.
get_detailsasync
async def get_details() -> None:Retrieve detailed playlist information.
Fills attributes: tracks, owner, dates, etc.
Sourceget_duration_formatted
def get_duration_formatted() -> str:Return formatted total duration (HH:MM:SS).
Returns
strFormatted duration string.
get_formatted_name
def get_formatted_name() -> str:Return the formatted playlist name.
Returns
strFormatted playlist name with track count.
remove_track
def remove_track(track_id: str) -> bool:Remove a track from the playlist.
Parameters
| Name | Type | Description |
|---|---|---|
track_id | str | ID of the track to remove. |
Returns
boolTrue if track was removed, False otherwise.
to_dict
def to_dict() -> Dict[str, Any]:Convert the playlist to a dictionary.
Returns
Dict[str, Any]Playlist data as dictionary.