OxideHTTP/OxideSpotify
1
0
Fork 0
Code Pull Requests Actions Packages Activity

Compare commits

base: OxideHTTP:dev
Branches Tags
OxideHTTP:latest OxideHTTP:dev
..
compare: OxideHTTP:0640ab9242140d02e3a69e0378ca95088f7e8313
Branches Tags
OxideHTTP:latest OxideHTTP:dev

2 Commits
dev ... 0640ab9242

Author SHA1 Message Date
Miwory
0640ab9242 Merge pull request '0.2.0' (#2) from dev into latest
All checks were successful
Build And Publish Package / publish (push) Successful in 33s
Details 
Reviewed-on: #2
 2026-03-08 10:14:35 +03:00
Miwory
b921cf9138 Merge pull request '0.1.1' (#1) from dev into latest
All checks were successful
Build And Publish Package / publish (push) Successful in 31s
Details 
Reviewed-on: #1
 2026-03-08 08:06:46 +03:00
4 changed files with 246 additions and 1084 deletions
Expand all files Collapse all files

4
pyproject.toml
View File

@ -1,11 +1,11 @@
[project]
name = "oxidespotify"
version = "1.0.2"
version = "0.2.0"
description = "Client for Spotify API"
readme = "README.md"
authors = [{ name = "Miwory", email = "miwory.uwu@gmail.com" }]
requires-python = ">=3.14"
dependencies = ["oxidehttp>=1.4.0,<=2.0.0", "pydantic>=2.12,<=2.13"]
dependencies = ["oxidehttp>=1.0.3,<=2.0.0", "pydantic>=2.12,<=2.13"]
[build-system]
requires = ["uv_build>=0.9.2,<0.11.0"]

914
src/oxidespotify/api.py
View File

File diff suppressed because it is too large Load Diff

3
src/oxidespotify/auth.py
View File

@ -41,8 +41,7 @@ class SpotifyAuthClient(OxideHTTP):
data = await req.json()
if req.status_code >= 400:
err = f'{data["error"]}: {data["error_description"]}'
raise s.ClientError(req.status_code, err)
raise s.ClientError(req.status_code, data['error'])
return schema.model_validate(data)

409
src/oxidespotify/schema.py
View File

@ -1,13 +1,7 @@
from datetime import date, datetime
from typing import Annotated, Literal
from datetime import datetime
from typing import Literal
from pydantic import (
BaseModel,
BeforeValidator,
HttpUrl,
RootModel,
field_validator,
)
from pydantic import BaseModel, HttpUrl, field_validator
class Error(Exception):
@ -28,21 +22,6 @@ class InternalError(Error):
pass
def normalize_spotify_date(v: str) -> str:
parts = v.split('-')
if len(parts) == 1:
return f'{v}-01-01'
if len(parts) == 2:
return f'{v}-01'
return v
PrecisionedReleaseDate = Annotated[
date, BeforeValidator(normalize_spotify_date)
]
class Token(BaseModel):
token_type: Literal['Bearer']
access_token: str
@ -83,20 +62,6 @@ class Image(BaseModel):
return v
class Cursors(BaseModel):
after: int
before: int
class Paginated(BaseModel):
href: HttpUrl
limit: int
next: HttpUrl | None
offset: int = 0
previous: HttpUrl | None = None
total: int = 0
class ExternalUrls(BaseModel):
spotify: HttpUrl
@ -107,16 +72,6 @@ class ExternalIDs(BaseModel):
upc: str | None = None
class Copyright(BaseModel):
text: str
type: Literal['C', 'P']
class ResumePoint(BaseModel):
fully_played: bool
resume_position_ms: int
class Artist(BaseModel):
external_urls: ExternalUrls
href: HttpUrl
@ -126,11 +81,71 @@ class Artist(BaseModel):
uri: str
class BaseTrack(BaseModel):
class Cursor(BaseModel):
after: int
before: int
class Context(BaseModel):
type: Literal['artist', 'playlist', 'album', 'show', 'collection']
href: HttpUrl
external_urls: ExternalUrls
uri: str
class Album(BaseModel):
album_type: Literal['album', 'single', 'compilation']
total_tracks: int
external_urls: ExternalUrls
href: HttpUrl
id: str
images: list[Image]
name: str
release_date: datetime
release_date_precision: Literal['year', 'month', 'day']
restrictions: Restriction | None = None
type: Literal['album']
uri: str
artists: list[Artist]
class PlaylistOwner(BaseModel):
external_urls: ExternalUrls
href: HttpUrl
id: str
type: Literal['user']
uri: str
display_name: str | None
class PlaylistTracks(BaseModel):
href: HttpUrl
total: int
class Playlist(BaseModel):
collaborative: bool
description: str
external_urls: ExternalUrls
href: HttpUrl
id: str
images: list[Image]
name: str
owner: PlaylistOwner
public: bool
snapshot_id: str
items: PlaylistTracks
type: Literal['playlist']
uri: str
class Track(BaseModel):
album: Album
artists: list[Artist]
disc_number: int
duration_ms: int
explicit: bool
external_ids: ExternalIDs
external_urls: ExternalUrls
href: HttpUrl
id: str
@ -143,47 +158,54 @@ class BaseTrack(BaseModel):
is_local: bool
class AlbumTracks(Paginated):
items: list[BaseTrack]
class EpisodeResumePoint(BaseModel):
fully_played: bool
resume_position_ms: int
class BaseAlbum(BaseModel):
album_type: Literal['album', 'single', 'compilation']
total_tracks: int
class Copyright(BaseModel):
text: str
type: Literal['C', 'P']
class Show(BaseModel):
copyrights: list[Copyright]
description: str
html_description: str
explicit: bool
external_ids: ExternalIDs | None = None
href: HttpUrl
id: str
images: list[Image]
is_externally_hosted: bool
languages: list[str]
media_type: str
name: str
type: Literal['show']
uri: str
total_episodes: int
class Episode(BaseModel):
description: str
html_description: str
duration_ms: int
explicit: bool
external_urls: ExternalUrls
href: HttpUrl
id: str
images: list[Image]
is_externally_hosted: bool
is_playable: bool
languages: list[str]
name: str
release_date: PrecisionedReleaseDate
release_date: datetime
release_date_precision: Literal['year', 'month', 'day']
restrictions: Restriction | None = None
type: Literal['album']
resume_point: EpisodeResumePoint
type: Literal['episode']
uri: str
artists: list[Artist]
class Album(BaseAlbum):
external_ids: ExternalIDs
copyrights: list[Copyright]
tracks: AlbumTracks
class Track(BaseTrack):
album: BaseAlbum
class UserSavedAlbum(BaseModel):
added_at: datetime
album: Album
class UserSavedAlbums(Paginated):
items: list[UserSavedAlbum]
class ArtistsAlbums(Paginated):
items: list[Album]
restrictions: Restriction | None = None
show: Show | None = None
class AudioBookAuthor(BaseModel):
@ -214,79 +236,17 @@ class AudioBook(BaseModel):
total_chapters: int
class AudioBookChapter(BaseModel):
chapter_number: int
description: str
html_description: str
duration_ms: int
explicit: bool
external_urls: ExternalUrls
href: HttpUrl
id: str
images: list[Image]
is_playable: bool
languages: list[str]
name: str
release_date: PrecisionedReleaseDate
release_date_precision: Literal['year', 'month', 'day']
resume_point: ResumePoint
type: Literal['episode']
uri: str
restrictions: Restriction
class AudiobookChapters(BaseModel):
items: list[AudioBookChapter]
class UserSavedAudiobooks(Paginated):
items: list[AudioBook]
class Chapter(AudioBookChapter):
audiobook: AudioBook
class Show(BaseModel):
copyrights: list[Copyright]
description: str
html_description: str
explicit: bool
external_ids: ExternalIDs | None = None
href: HttpUrl
id: str
images: list[Image]
is_externally_hosted: bool
languages: list[str]
media_type: str
name: str
type: Literal['show']
uri: str
total_episodes: int
class Episode(AudioBookChapter):
show: Show
class UsedSavedEpisode(BaseModel):
added_at: datetime
episode: Episode
class UserSavedEpisodes(Paginated):
items: list[UsedSavedEpisode]
class CheckUserSavedItems(RootModel[list[bool]]):
pass
class Context(BaseModel):
type: Literal['artist', 'playlist', 'album', 'show', 'collection']
href: HttpUrl
external_urls: ExternalUrls
uri: str
class PlaybackStateActions(BaseModel):
interrupting_playback: bool | None = None
pausing: bool | None = None
resuming: bool | None = None
seeking: bool | None = None
skipping_next: bool | None = None
skipping_prev: bool | None = None
toggling_repeat_context: bool | None = None
toggling_shuffle: bool | None = None
toggling_repeat_track: bool | None = None
transferring_playback: bool | None = None
class PlaybackState(BaseModel):
@ -299,94 +259,35 @@ class PlaybackState(BaseModel):
is_playing: bool
item: Track | Episode | None
currently_playing_type: Literal['track', 'episode', 'ad', 'unknown']
# TODO: allows has 'disallows' inside? not sure about that
# actions: PlaybackStateActions
class Devices(BaseModel):
devices: list[Device]
class RecentlyPlayedTrack(BaseModel):
class PlayHistoryObject(BaseModel):
track: Track
played_at: datetime
context: Context | None = None
class RecentlyPlayedTracks(Paginated):
cursors: Cursors
items: list[RecentlyPlayedTrack]
class UsersQueue(BaseModel):
currently_playing: Track | Episode | None
queue: list[Track | Episode]
class PlaylistOwner(BaseModel):
external_urls: ExternalUrls
class RecentlyPlayed(BaseModel):
href: HttpUrl
id: str
type: Literal['user']
uri: str
display_name: str | None
limit: int
next: HttpUrl | None
cursors: Cursor
total: int | None = None
items: list[PlayHistoryObject]
class PlaylistTrack(BaseModel):
added_at: datetime
added_by: PlaylistOwner
is_local: bool
item: Track | Episode
class PlaylistTracks(Paginated):
class SearchData(BaseModel):
href: HttpUrl
item: PlaylistTrack
limit: int
next: HttpUrl | None
offset: int
previous: int | None
total: int
class SimplifiedPlaylistTracks(Paginated):
href: HttpUrl
total: int = 0
class Playlist(BaseModel):
type: Literal['playlist']
uri: str
collaborative: bool
description: str
external_urls: ExternalUrls
href: HttpUrl
id: str
images: list[Image]
name: str
owner: PlaylistOwner
public: bool
snapshot_id: str
items: PlaylistTracks | None = None
class SimplifiedPlaylist(BaseModel):
type: Literal['playlist']
uri: str
collaborative: bool
external_urls: ExternalUrls
href: HttpUrl
id: str
images: list[Image]
name: str
owner: PlaylistOwner
public: bool
snapshot_id: str
items: SimplifiedPlaylistTracks
class UserPlaylists(Paginated):
items: list[Playlist]
class PlaylistImages(RootModel[list[Image]]):
pass
class SearchAlbumData(Paginated):
class SearchAlbumData(SearchData):
items: list[Album]
@ -394,7 +295,7 @@ class SearchAlbum(BaseModel):
albums: SearchAlbumData
class SearchArtistData(Paginated):
class SearchArtistData(SearchData):
items: list[Artist]
@ -402,7 +303,7 @@ class SearchArtist(BaseModel):
artists: SearchArtistData
class SearchPlaylistData(Paginated):
class SearchPlaylistData(SearchData):
items: list[Playlist | None]
@ -410,7 +311,7 @@ class SearchPlaylist(BaseModel):
playlists: SearchPlaylistData
class SearchTrackData(Paginated):
class SearchTrackData(SearchData):
items: list[Track]
@ -418,7 +319,7 @@ class SearchTrack(BaseModel):
tracks: SearchTrackData
class SearchShowData(Paginated):
class SearchShowData(SearchData):
items: list[Show]
@ -426,7 +327,7 @@ class SearchShow(BaseModel):
shows: SearchShowData
class SearchEpisodeData(Paginated):
class SearchEpisodeData(SearchData):
items: list[Episode]
@ -434,7 +335,7 @@ class SearchEpisode(BaseModel):
episodes: SearchEpisodeData
class SearchAudiobookData(Paginated):
class SearchAudiobookData(SearchData):
items: list[AudioBook]
@ -442,28 +343,6 @@ class SearchAudiobook(BaseModel):
audiobooks: SearchAudiobookData
class ShowEpisodes(Paginated):
items: list[AudioBookChapter]
class SavedShow(BaseModel):
added_at: datetime
show: Show
class SavedShows(Paginated):
items: list[SavedShow]
class SavedTrack(BaseModel):
added_at: datetime
track: Track
class SavedTracks(Paginated):
items: list[SavedTrack]
class UserProfile(BaseModel):
id: str
display_name: str
@ -472,19 +351,3 @@ class UserProfile(BaseModel):
images: list[Image]
type: Literal['user']
uri: str
class UsersTopItemsTracks(Paginated):
items: list[Track]
class UsersTopItemsArtists(Paginated):
items: list[Artist]
class FollowedArtistsData(Paginated):
items: list[Artist]
class FollowedArtists(BaseModel):
artists: FollowedArtistsData