spotapi 2.0.0b1__tar.gz → 2.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- spotapi-2.1.0/.dockerignore +9 -0
- spotapi-2.1.0/.env.example +4 -0
- spotapi-2.1.0/.github/workflows/docs.yml +21 -0
- spotapi-2.1.0/.github/workflows/publish.yml +74 -0
- spotapi-2.1.0/.github/workflows/spotify-public.yml +62 -0
- {spotapi-2.0.0b1 → spotapi-2.1.0}/.gitignore +194 -166
- spotapi-2.1.0/.readthedocs.yaml +14 -0
- spotapi-2.1.0/CHANGELOG.md +126 -0
- {spotapi-2.0.0b1 → spotapi-2.1.0}/CODE_OF_CONDUCT.md +128 -128
- spotapi-2.1.0/CONTRIBUTING.md +66 -0
- spotapi-2.1.0/Dockerfile.mcp +8 -0
- {spotapi-2.0.0b1 → spotapi-2.1.0}/LEGAL_NOTICE.md +43 -45
- {spotapi-2.0.0b1 → spotapi-2.1.0}/LICENSE +674 -674
- spotapi-2.1.0/MIGRATION.md +97 -0
- {spotapi-2.0.0b1 → spotapi-2.1.0}/PKG-INFO +206 -178
- spotapi-2.1.0/README.md +247 -0
- spotapi-2.1.0/SPONSORSHIP.md +65 -0
- spotapi-2.1.0/assets/README.md +10 -0
- spotapi-2.1.0/assets/cli-demo.gif +0 -0
- spotapi-2.1.0/assets/logo-inverse.svg +38 -0
- spotapi-2.1.0/assets/logo-mono.svg +38 -0
- spotapi-2.1.0/assets/spotapi-color.svg +48 -0
- spotapi-2.1.0/assets/spotapi-inverse.svg +48 -0
- spotapi-2.1.0/assets/spotapi-mono.svg +48 -0
- spotapi-2.1.0/assets/spotapi-reversed.svg +48 -0
- spotapi-2.1.0/benchmarks/review.py +408 -0
- spotapi-2.1.0/docs/account.md +98 -0
- spotapi-2.1.0/docs/api-layout.md +76 -0
- spotapi-2.1.0/docs/catalogue.md +83 -0
- spotapi-2.1.0/docs/discovery.md +227 -0
- spotapi-2.1.0/docs/from-spotipy.md +84 -0
- spotapi-2.1.0/docs/index.md +72 -0
- spotapi-2.1.0/docs/player-coverage.md +103 -0
- spotapi-2.1.0/docs/player.md +165 -0
- spotapi-2.1.0/docs/quickstart.md +134 -0
- spotapi-2.1.0/docs/reference.md +79 -0
- spotapi-2.1.0/docs/release-checks.md +129 -0
- spotapi-2.1.0/docs/studio.md +92 -0
- spotapi-2.1.0/docs/stylesheets/extra.css +7 -0
- spotapi-2.1.0/docs/transport.md +83 -0
- spotapi-2.1.0/examples/__init__.py +1 -0
- spotapi-2.1.0/examples/credit_trail.py +48 -0
- spotapi-2.1.0/examples/credits.py +16 -0
- spotapi-2.1.0/examples/custom_transport.py +17 -0
- spotapi-2.1.0/examples/discover.py +8 -0
- spotapi-2.1.0/examples/export.py +16 -0
- spotapi-2.1.0/examples/lookup.py +17 -0
- spotapi-2.1.0/examples/lyrics.py +21 -0
- spotapi-2.1.0/examples/mix_map.py +66 -0
- spotapi-2.1.0/examples/overlap.py +31 -0
- spotapi-2.1.0/examples/pagination.py +23 -0
- spotapi-2.1.0/examples/player.py +35 -0
- spotapi-2.1.0/examples/playlist_crate.py +31 -0
- spotapi-2.1.0/examples/public_search.py +29 -0
- spotapi-2.1.0/examples/quickstart.py +16 -0
- spotapi-2.1.0/examples/studio/__init__.py +1 -0
- spotapi-2.1.0/examples/studio/__main__.py +5 -0
- spotapi-2.1.0/examples/studio/preview.png +0 -0
- spotapi-2.1.0/examples/taste.py +29 -0
- spotapi-2.1.0/mkdocs.yml +82 -0
- {spotapi-2.0.0b1 → spotapi-2.1.0}/pyproject.toml +131 -86
- spotapi-2.1.0/requirements-docs.txt +4 -0
- spotapi-2.1.0/requirements.txt +1 -0
- spotapi-2.1.0/spotapi/__init__.py +141 -0
- spotapi-2.1.0/spotapi/_decoding.py +211 -0
- spotapi-2.1.0/spotapi/_demo/__init__.py +1 -0
- spotapi-2.1.0/spotapi/_demo/details.py +323 -0
- spotapi-2.1.0/spotapi/_demo/discover.py +767 -0
- spotapi-2.1.0/spotapi/_parsing.py +40 -0
- spotapi-2.1.0/spotapi/_protocol/__init__.py +1 -0
- spotapi-2.1.0/spotapi/_protocol/bundles.py +69 -0
- spotapi-2.1.0/spotapi/_protocol/embeds.py +46 -0
- spotapi-2.1.0/spotapi/_protocol/protobuf.py +120 -0
- spotapi-2.1.0/spotapi/_protocol/routes.py +66 -0
- spotapi-2.1.0/spotapi/_protocol/totp.py +81 -0
- spotapi-2.1.0/spotapi/_studio/__init__.py +1 -0
- spotapi-2.1.0/spotapi/_studio/actions.py +110 -0
- spotapi-2.1.0/spotapi/_studio/app.js +1109 -0
- spotapi-2.1.0/spotapi/_studio/assets/logo.ico +0 -0
- spotapi-2.1.0/spotapi/_studio/assets/logo.png +0 -0
- spotapi-2.1.0/spotapi/_studio/assets/logo.svg +48 -0
- spotapi-2.1.0/spotapi/_studio/desktop.py +235 -0
- spotapi-2.1.0/spotapi/_studio/index.html +325 -0
- spotapi-2.1.0/spotapi/_studio/lyrics.py +91 -0
- spotapi-2.1.0/spotapi/_studio/service.py +636 -0
- spotapi-2.1.0/spotapi/_studio/style.css +1361 -0
- spotapi-2.1.0/spotapi/account.py +280 -0
- spotapi-2.1.0/spotapi/account_session.py +152 -0
- spotapi-2.1.0/spotapi/batch.py +52 -0
- spotapi-2.1.0/spotapi/blend.py +70 -0
- spotapi-2.1.0/spotapi/cache.py +173 -0
- spotapi-2.1.0/spotapi/captcha.py +42 -0
- spotapi-2.1.0/spotapi/catalogue.py +1514 -0
- spotapi-2.1.0/spotapi/charts.py +22 -0
- spotapi-2.1.0/spotapi/cli.py +302 -0
- spotapi-2.1.0/spotapi/client.py +637 -0
- spotapi-2.1.0/spotapi/command_state.py +70 -0
- spotapi-2.1.0/spotapi/connect.py +55 -0
- spotapi-2.1.0/spotapi/connection/__init__.py +12 -0
- spotapi-2.1.0/spotapi/connection/client.py +8 -0
- spotapi-2.1.0/spotapi/connection/http.py +680 -0
- spotapi-2.1.0/spotapi/connection/types.py +84 -0
- spotapi-2.1.0/spotapi/connection/websocket.py +519 -0
- spotapi-2.1.0/spotapi/datastruct/__init__.py +7 -0
- spotapi-2.1.0/spotapi/datastruct/event_handler.py +167 -0
- spotapi-2.1.0/spotapi/datastruct/object_dict.py +196 -0
- spotapi-2.1.0/spotapi/datastruct/pool.py +235 -0
- spotapi-2.1.0/spotapi/devices.py +192 -0
- spotapi-2.1.0/spotapi/embeds.py +55 -0
- spotapi-2.1.0/spotapi/history.py +97 -0
- spotapi-2.1.0/spotapi/library.py +291 -0
- spotapi-2.1.0/spotapi/login.py +123 -0
- spotapi-2.1.0/spotapi/lyrics.py +75 -0
- spotapi-2.1.0/spotapi/mcp.py +157 -0
- spotapi-2.1.0/spotapi/media.py +140 -0
- spotapi-2.1.0/spotapi/models/__init__.py +118 -0
- spotapi-2.1.0/spotapi/models/account.py +122 -0
- spotapi-2.1.0/spotapi/models/batch.py +33 -0
- spotapi-2.1.0/spotapi/models/blend.py +42 -0
- spotapi-2.1.0/spotapi/models/catalogue/__init__.py +65 -0
- spotapi-2.1.0/spotapi/models/catalogue/album.py +71 -0
- spotapi-2.1.0/spotapi/models/catalogue/album_details.py +242 -0
- spotapi-2.1.0/spotapi/models/catalogue/artist.py +73 -0
- spotapi-2.1.0/spotapi/models/catalogue/artist_details.py +223 -0
- spotapi-2.1.0/spotapi/models/catalogue/common.py +95 -0
- spotapi-2.1.0/spotapi/models/catalogue/credits.py +39 -0
- spotapi-2.1.0/spotapi/models/catalogue/entities.py +194 -0
- spotapi-2.1.0/spotapi/models/catalogue/playlist.py +79 -0
- spotapi-2.1.0/spotapi/models/catalogue/playlist_details.py +52 -0
- spotapi-2.1.0/spotapi/models/catalogue/playlist_track.py +119 -0
- spotapi-2.1.0/spotapi/models/catalogue/podcast.py +55 -0
- spotapi-2.1.0/spotapi/models/catalogue/podcast_episode.py +136 -0
- spotapi-2.1.0/spotapi/models/catalogue/profile_attributes.py +35 -0
- spotapi-2.1.0/spotapi/models/catalogue/track.py +105 -0
- spotapi-2.1.0/spotapi/models/catalogue/track_details.py +206 -0
- spotapi-2.1.0/spotapi/models/discovery.py +213 -0
- spotapi-2.1.0/spotapi/models/embeds.py +44 -0
- spotapi-2.1.0/spotapi/models/history.py +76 -0
- spotapi-2.1.0/spotapi/models/library.py +148 -0
- spotapi-2.1.0/spotapi/models/lyrics.py +126 -0
- spotapi-2.1.0/spotapi/models/notifications.py +77 -0
- spotapi-2.1.0/spotapi/models/playback.py +292 -0
- spotapi-2.1.0/spotapi/models/profiles.py +20 -0
- spotapi-2.1.0/spotapi/models/search.py +91 -0
- spotapi-2.1.0/spotapi/models/sessions.py +11 -0
- spotapi-2.1.0/spotapi/models/stats.py +24 -0
- spotapi-2.1.0/spotapi/models/transcripts.py +64 -0
- spotapi-2.1.0/spotapi/notifications.py +88 -0
- spotapi-2.1.0/spotapi/operations.py +480 -0
- spotapi-2.1.0/spotapi/password.py +84 -0
- spotapi-2.1.0/spotapi/player.py +703 -0
- spotapi-2.1.0/spotapi/playlist.py +681 -0
- spotapi-2.1.0/spotapi/profiles.py +250 -0
- spotapi-2.1.0/spotapi/public.py +742 -0
- spotapi-2.1.0/spotapi/queries.py +409 -0
- spotapi-2.1.0/spotapi/query.py +613 -0
- spotapi-2.1.0/spotapi/resources.py +142 -0
- spotapi-2.1.0/spotapi/serialization.py +48 -0
- spotapi-2.1.0/spotapi/session.py +943 -0
- spotapi-2.1.0/spotapi/stats.py +108 -0
- spotapi-2.1.0/spotapi/status.py +769 -0
- spotapi-2.1.0/spotapi/sync.py +369 -0
- spotapi-2.1.0/spotapi/transcripts.py +37 -0
- spotapi-2.1.0/spotapi/types/__init__.py +44 -0
- spotapi-2.1.0/spotapi/types/exceptions.py +48 -0
- {spotapi-2.0.0b1/spotapi/v2 → spotapi-2.1.0/spotapi}/types/logger.py +802 -724
- spotapi-2.1.0/spotapi/utils/__init__.py +6 -0
- spotapi-2.1.0/spotapi/utils/cache.py +149 -0
- spotapi-2.1.0/spotapi/utils/random.py +28 -0
- spotapi-2.1.0/tests/README.md +29 -0
- spotapi-2.1.0/tests/conftest.py +39 -0
- spotapi-2.1.0/tests/fixtures/connect/message-1.json +100 -0
- spotapi-2.1.0/tests/fixtures/connect/message-2.json +382 -0
- spotapi-2.1.0/tests/fixtures/connect/message-3.json +393 -0
- spotapi-2.1.0/tests/fixtures/connect/message-4.json +146 -0
- spotapi-2.1.0/tests/test_account.py +276 -0
- spotapi-2.1.0/tests/test_account_content.py +461 -0
- spotapi-2.1.0/tests/test_artist_details_model.py +27 -0
- spotapi-2.1.0/tests/test_auth_recovery.py +233 -0
- spotapi-2.1.0/tests/test_authorized_requests.py +101 -0
- spotapi-2.1.0/tests/test_bundle_cache.py +209 -0
- spotapi-2.1.0/tests/test_catalogue_lifecycle.py +178 -0
- spotapi-2.1.0/tests/test_cli.py +128 -0
- spotapi-2.1.0/tests/test_data_contracts.py +218 -0
- spotapi-2.1.0/tests/test_discover_demo.py +196 -0
- spotapi-2.1.0/tests/test_discovery_parser.py +22 -0
- spotapi-2.1.0/tests/test_feature_parity.py +388 -0
- spotapi-2.1.0/tests/test_lifecycle.py +317 -0
- spotapi-2.1.0/tests/test_listening.py +167 -0
- spotapi-2.1.0/tests/test_live.py +103 -0
- spotapi-2.1.0/tests/test_live_account.py +39 -0
- spotapi-2.1.0/tests/test_live_catalogue.py +152 -0
- spotapi-2.1.0/tests/test_live_controls.py +199 -0
- spotapi-2.1.0/tests/test_live_discovery.py +35 -0
- spotapi-2.1.0/tests/test_live_player.py +38 -0
- spotapi-2.1.0/tests/test_live_playlists.py +124 -0
- spotapi-2.1.0/tests/test_live_studio.py +45 -0
- spotapi-2.1.0/tests/test_mutations.py +178 -0
- spotapi-2.1.0/tests/test_native_websocket.py +109 -0
- spotapi-2.1.0/tests/test_operations.py +74 -0
- spotapi-2.1.0/tests/test_optional_features.py +282 -0
- spotapi-2.1.0/tests/test_player.py +966 -0
- spotapi-2.1.0/tests/test_protobuf.py +35 -0
- spotapi-2.1.0/tests/test_public_api.py +627 -0
- spotapi-2.1.0/tests/test_public_catalogue.py +204 -0
- spotapi-2.1.0/tests/test_queries_parsing.py +132 -0
- spotapi-2.1.0/tests/test_review_regressions.py +174 -0
- spotapi-2.1.0/tests/test_routes.py +38 -0
- spotapi-2.1.0/tests/test_search_models.py +26 -0
- spotapi-2.1.0/tests/test_studio.py +272 -0
- spotapi-2.1.0/tests/test_studio_browser.py +258 -0
- spotapi-2.1.0/tests/test_transport.py +295 -0
- spotapi-2.1.0/tests/test_websocket_lifecycle.py +194 -0
- spotapi-2.0.0b1/CHANGELOG.md +0 -90
- spotapi-2.0.0b1/CONTRIBUTING.md +0 -247
- spotapi-2.0.0b1/MIGRATION.md +0 -182
- spotapi-2.0.0b1/README.md +0 -239
- spotapi-2.0.0b1/docs/album.md +0 -59
- spotapi-2.0.0b1/docs/artist.md +0 -107
- spotapi-2.0.0b1/docs/creator.md +0 -56
- spotapi-2.0.0b1/docs/family.md +0 -62
- spotapi-2.0.0b1/docs/language.md +0 -90
- spotapi-2.0.0b1/docs/login.md +0 -103
- spotapi-2.0.0b1/docs/password.md +0 -38
- spotapi-2.0.0b1/docs/player.md +0 -183
- spotapi-2.0.0b1/docs/playlist.md +0 -179
- spotapi-2.0.0b1/docs/public.md +0 -143
- spotapi-2.0.0b1/docs/song.md +0 -126
- spotapi-2.0.0b1/docs/status.md +0 -148
- spotapi-2.0.0b1/docs/user.md +0 -67
- spotapi-2.0.0b1/docs/websocket.md +0 -29
- spotapi-2.0.0b1/example.py +0 -116
- spotapi-2.0.0b1/image.png +0 -0
- spotapi-2.0.0b1/requirements.txt +0 -2
- spotapi-2.0.0b1/setup.py +0 -61
- spotapi-2.0.0b1/spotapi/sync/__init__.py +0 -25
- spotapi-2.0.0b1/spotapi/sync/_tests/.env.sample +0 -3
- spotapi-2.0.0b1/spotapi/sync/_tests/__init__.py +0 -1
- spotapi-2.0.0b1/spotapi/sync/_tests/annotations_test.py +0 -222
- spotapi-2.0.0b1/spotapi/sync/_tests/client_refresh_test.py +0 -224
- spotapi-2.0.0b1/spotapi/sync/_tests/features/artist_test.py +0 -196
- spotapi-2.0.0b1/spotapi/sync/_tests/features/event_test.py +0 -53
- spotapi-2.0.0b1/spotapi/sync/_tests/features/player_test.py +0 -112
- spotapi-2.0.0b1/spotapi/sync/_tests/features/private_playlist_test.py +0 -70
- spotapi-2.0.0b1/spotapi/sync/_tests/features/public_playlist_test.py +0 -32
- spotapi-2.0.0b1/spotapi/sync/_tests/features/session.py +0 -36
- spotapi-2.0.0b1/spotapi/sync/_tests/features/song_test.py +0 -67
- spotapi-2.0.0b1/spotapi/sync/_tests/features/status_test.py +0 -126
- spotapi-2.0.0b1/spotapi/sync/_tests/features/user_test.py +0 -63
- spotapi-2.0.0b1/spotapi/sync/album.py +0 -96
- spotapi-2.0.0b1/spotapi/sync/artist.py +0 -287
- spotapi-2.0.0b1/spotapi/sync/client.py +0 -314
- spotapi-2.0.0b1/spotapi/sync/creator.py +0 -203
- spotapi-2.0.0b1/spotapi/sync/exceptions/__init__.py +0 -1
- spotapi-2.0.0b1/spotapi/sync/exceptions/errors.py +0 -111
- spotapi-2.0.0b1/spotapi/sync/family.py +0 -162
- spotapi-2.0.0b1/spotapi/sync/http/__init__.py +0 -2
- spotapi-2.0.0b1/spotapi/sync/http/data.py +0 -43
- spotapi-2.0.0b1/spotapi/sync/http/request.py +0 -248
- spotapi-2.0.0b1/spotapi/sync/login.py +0 -356
- spotapi-2.0.0b1/spotapi/sync/password.py +0 -97
- spotapi-2.0.0b1/spotapi/sync/player.py +0 -348
- spotapi-2.0.0b1/spotapi/sync/playlist.py +0 -417
- spotapi-2.0.0b1/spotapi/sync/podcast.py +0 -129
- spotapi-2.0.0b1/spotapi/sync/public.py +0 -117
- spotapi-2.0.0b1/spotapi/sync/solvers/__init__.py +0 -15
- spotapi-2.0.0b1/spotapi/sync/solvers/capmonster.py +0 -145
- spotapi-2.0.0b1/spotapi/sync/solvers/capsolver.py +0 -144
- spotapi-2.0.0b1/spotapi/sync/song.py +0 -288
- spotapi-2.0.0b1/spotapi/sync/status.py +0 -226
- spotapi-2.0.0b1/spotapi/sync/types/__init__.py +0 -2
- spotapi-2.0.0b1/spotapi/sync/types/alias.py +0 -29
- spotapi-2.0.0b1/spotapi/sync/types/annotations.py +0 -201
- spotapi-2.0.0b1/spotapi/sync/types/data.py +0 -413
- spotapi-2.0.0b1/spotapi/sync/types/interfaces.py +0 -57
- spotapi-2.0.0b1/spotapi/sync/user.py +0 -128
- spotapi-2.0.0b1/spotapi/sync/utils/__init__.py +0 -3
- spotapi-2.0.0b1/spotapi/sync/utils/logger.py +0 -91
- spotapi-2.0.0b1/spotapi/sync/utils/saver.py +0 -357
- spotapi-2.0.0b1/spotapi/sync/utils/strings.py +0 -130
- spotapi-2.0.0b1/spotapi/sync/websocket.py +0 -167
- spotapi-2.0.0b1/spotapi/v2/__init__.py +0 -5
- spotapi-2.0.0b1/spotapi/v2/base.py +0 -100
- spotapi-2.0.0b1/spotapi/v2/client.py +0 -101
- spotapi-2.0.0b1/spotapi/v2/connection/__init__.py +0 -12
- spotapi-2.0.0b1/spotapi/v2/connection/http.py +0 -263
- spotapi-2.0.0b1/spotapi/v2/connection/types.py +0 -76
- spotapi-2.0.0b1/spotapi/v2/connection/websocket.py +0 -199
- spotapi-2.0.0b1/spotapi/v2/datastruct/__init__.py +0 -9
- spotapi-2.0.0b1/spotapi/v2/datastruct/event_handler.py +0 -62
- spotapi-2.0.0b1/spotapi/v2/datastruct/object_dict.py +0 -129
- spotapi-2.0.0b1/spotapi/v2/datastruct/pool.py +0 -156
- spotapi-2.0.0b1/spotapi/v2/public.py +0 -151
- spotapi-2.0.0b1/spotapi/v2/session.py +0 -361
- spotapi-2.0.0b1/spotapi/v2/specialized/__init__.py +0 -3
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/__init__.py +0 -163
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/album.py +0 -93
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/artist.py +0 -66
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/common.py +0 -139
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/playlist.py +0 -81
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/podcast.py +0 -75
- spotapi-2.0.0b1/spotapi/v2/specialized/data_wrappers/track.py +0 -113
- spotapi-2.0.0b1/spotapi/v2/specialized/totp.py +0 -66
- spotapi-2.0.0b1/spotapi/v2/types/__init__.py +0 -15
- spotapi-2.0.0b1/spotapi/v2/types/exceptions.py +0 -22
- spotapi-2.0.0b1/spotapi/v2/utils/__init__.py +0 -15
- spotapi-2.0.0b1/spotapi/v2/utils/cache.py +0 -62
- spotapi-2.0.0b1/spotapi/v2/utils/random.py +0 -22
- spotapi-2.0.0b1/spotapi/v2/utils/strings.py +0 -131
- {spotapi-2.0.0b1/spotapi/v2 → spotapi-2.1.0/spotapi}/py.typed +0 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
name: Documentation
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
pull_request:
|
|
6
|
+
workflow_dispatch:
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
build:
|
|
10
|
+
runs-on: ubuntu-latest
|
|
11
|
+
steps:
|
|
12
|
+
- uses: actions/checkout@v4
|
|
13
|
+
- uses: actions/setup-python@v5
|
|
14
|
+
with:
|
|
15
|
+
python-version: "3.12"
|
|
16
|
+
- run: python -m pip install -r requirements-docs.txt
|
|
17
|
+
- run: python -m mkdocs build --strict
|
|
18
|
+
- uses: actions/upload-artifact@v4
|
|
19
|
+
with:
|
|
20
|
+
name: documentation-site
|
|
21
|
+
path: site/
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
name: Publish a tagged release
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
tags: ["v*"]
|
|
6
|
+
|
|
7
|
+
jobs:
|
|
8
|
+
build:
|
|
9
|
+
runs-on: ubuntu-latest
|
|
10
|
+
steps:
|
|
11
|
+
- uses: actions/checkout@v4
|
|
12
|
+
- uses: actions/setup-python@v5
|
|
13
|
+
with:
|
|
14
|
+
python-version: "3.11"
|
|
15
|
+
- name: Check the tag matches package metadata
|
|
16
|
+
run: |
|
|
17
|
+
python - <<'PY'
|
|
18
|
+
import os, tomllib
|
|
19
|
+
from pathlib import Path
|
|
20
|
+
version = tomllib.loads(Path("pyproject.toml").read_text())["project"]["version"]
|
|
21
|
+
assert os.environ["GITHUB_REF_NAME"] == f"v{version}", "Tag and package versions differ"
|
|
22
|
+
PY
|
|
23
|
+
- run: python -m pip install build twine
|
|
24
|
+
- run: python -m pip install -e '.[dev,demo]'
|
|
25
|
+
- run: python -m playwright install --with-deps chromium
|
|
26
|
+
- run: python -m pytest -m 'not live' -q
|
|
27
|
+
- run: python -m pyright
|
|
28
|
+
- run: python -m ruff check .
|
|
29
|
+
- run: python -m black --check .
|
|
30
|
+
- run: python -m build
|
|
31
|
+
- run: python -m twine check dist/*
|
|
32
|
+
- run: python -m pip install --force-reinstall --no-deps dist/*.whl
|
|
33
|
+
- name: Smoke-test the installed wheel outside the checkout
|
|
34
|
+
working-directory: /tmp
|
|
35
|
+
run: |
|
|
36
|
+
spotapi --help
|
|
37
|
+
spotapi discover --help
|
|
38
|
+
spotapi studio --help
|
|
39
|
+
python -I - <<'PY'
|
|
40
|
+
import os
|
|
41
|
+
from importlib.util import find_spec
|
|
42
|
+
from pathlib import Path
|
|
43
|
+
import spotapi
|
|
44
|
+
from spotapi import Private, Public
|
|
45
|
+
from spotapi.models import PlaylistTrack
|
|
46
|
+
assert not Path(spotapi.__file__).resolve().is_relative_to(Path(os.environ["GITHUB_WORKSPACE"]).resolve())
|
|
47
|
+
assert find_spec("spotapi.v2") is None
|
|
48
|
+
assert callable(Private.from_cookies)
|
|
49
|
+
assert find_spec("spotapi._demo.discover") is not None
|
|
50
|
+
assert find_spec("spotapi._demo.details") is not None
|
|
51
|
+
from spotapi._studio.desktop import page
|
|
52
|
+
assert "STUDIO_SCRIPT" not in page()
|
|
53
|
+
from importlib.resources import files
|
|
54
|
+
for asset in ("logo.svg", "logo.png", "logo.ico"):
|
|
55
|
+
assert files("spotapi._studio").joinpath("assets", asset).is_file()
|
|
56
|
+
assert Public.parse_url("spotify:track:abc").id == "abc"
|
|
57
|
+
PY
|
|
58
|
+
- uses: actions/upload-artifact@v4
|
|
59
|
+
with:
|
|
60
|
+
name: python-distributions
|
|
61
|
+
path: dist/
|
|
62
|
+
|
|
63
|
+
publish:
|
|
64
|
+
needs: build
|
|
65
|
+
runs-on: ubuntu-latest
|
|
66
|
+
environment: pypi
|
|
67
|
+
permissions:
|
|
68
|
+
id-token: write
|
|
69
|
+
steps:
|
|
70
|
+
- uses: actions/download-artifact@v4
|
|
71
|
+
with:
|
|
72
|
+
name: python-distributions
|
|
73
|
+
path: dist/
|
|
74
|
+
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
name: Spotify API checks
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
pull_request:
|
|
6
|
+
schedule:
|
|
7
|
+
- cron: "17 8 * * *" # Daily contract check; reports upstream breaking changes
|
|
8
|
+
workflow_dispatch:
|
|
9
|
+
|
|
10
|
+
jobs:
|
|
11
|
+
offline:
|
|
12
|
+
runs-on: ${{ matrix.os }}
|
|
13
|
+
timeout-minutes: 15
|
|
14
|
+
strategy:
|
|
15
|
+
fail-fast: false
|
|
16
|
+
matrix:
|
|
17
|
+
os: [ubuntu-latest]
|
|
18
|
+
python: ["3.11", "3.12", "3.13"]
|
|
19
|
+
include:
|
|
20
|
+
- os: windows-latest
|
|
21
|
+
python: "3.12"
|
|
22
|
+
- os: macos-latest
|
|
23
|
+
python: "3.12"
|
|
24
|
+
steps:
|
|
25
|
+
- uses: actions/checkout@v4
|
|
26
|
+
- uses: actions/setup-python@v5
|
|
27
|
+
with:
|
|
28
|
+
python-version: ${{ matrix.python }}
|
|
29
|
+
- run: python -m pip install -e '.[dev,demo]'
|
|
30
|
+
- run: python -m coverage run -m pytest -m 'not live'
|
|
31
|
+
- run: python -m coverage report
|
|
32
|
+
- run: python -m coverage xml
|
|
33
|
+
- uses: actions/upload-artifact@v4
|
|
34
|
+
with:
|
|
35
|
+
name: coverage-${{ matrix.os }}-python-${{ matrix.python }}
|
|
36
|
+
path: coverage.xml
|
|
37
|
+
- run: python -m pyright
|
|
38
|
+
- run: python -m ruff check .
|
|
39
|
+
- run: python -m black --check .
|
|
40
|
+
|
|
41
|
+
public-api:
|
|
42
|
+
if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
|
|
43
|
+
runs-on: ubuntu-latest
|
|
44
|
+
timeout-minutes: 15
|
|
45
|
+
steps:
|
|
46
|
+
- uses: actions/checkout@v4
|
|
47
|
+
- uses: actions/setup-python@v5
|
|
48
|
+
with:
|
|
49
|
+
python-version: "3.12"
|
|
50
|
+
- run: python -m pip install -e '.[dev]'
|
|
51
|
+
- run: python -m pytest --live=read -m live -vv
|
|
52
|
+
|
|
53
|
+
studio-ui:
|
|
54
|
+
runs-on: ubuntu-latest
|
|
55
|
+
steps:
|
|
56
|
+
- uses: actions/checkout@v4
|
|
57
|
+
- uses: actions/setup-python@v5
|
|
58
|
+
with:
|
|
59
|
+
python-version: "3.12"
|
|
60
|
+
- run: python -m pip install -e '.[dev]'
|
|
61
|
+
- run: python -m playwright install --with-deps chromium
|
|
62
|
+
- run: python -m pytest tests/test_studio.py tests/test_studio_browser.py -q
|
|
@@ -1,166 +1,194 @@
|
|
|
1
|
-
# Byte-compiled / optimized / DLL files
|
|
2
|
-
__pycache__/
|
|
3
|
-
*.py[cod]
|
|
4
|
-
*$py.class
|
|
5
|
-
|
|
6
|
-
# C extensions
|
|
7
|
-
*.so
|
|
8
|
-
|
|
9
|
-
# Distribution / packaging
|
|
10
|
-
.vscode/
|
|
11
|
-
.Python
|
|
12
|
-
build/
|
|
13
|
-
develop-eggs/
|
|
14
|
-
dist/
|
|
15
|
-
downloads/
|
|
16
|
-
eggs/
|
|
17
|
-
.eggs/
|
|
18
|
-
lib/
|
|
19
|
-
lib64/
|
|
20
|
-
parts/
|
|
21
|
-
sdist/
|
|
22
|
-
var/
|
|
23
|
-
wheels/
|
|
24
|
-
share/python-wheels/
|
|
25
|
-
*.egg-info/
|
|
26
|
-
.installed.cfg
|
|
27
|
-
*.egg
|
|
28
|
-
MANIFEST
|
|
29
|
-
|
|
30
|
-
# PyInstaller
|
|
31
|
-
# Usually these files are written by a python script from a template
|
|
32
|
-
# before PyInstaller builds the exe, so as to inject date/other infos into it.
|
|
33
|
-
*.manifest
|
|
34
|
-
*.spec
|
|
35
|
-
|
|
36
|
-
# Installer logs
|
|
37
|
-
pip-log.txt
|
|
38
|
-
pip-delete-this-directory.txt
|
|
39
|
-
|
|
40
|
-
# Unit test / coverage reports
|
|
41
|
-
htmlcov/
|
|
42
|
-
.tox/
|
|
43
|
-
.nox/
|
|
44
|
-
.coverage
|
|
45
|
-
.coverage.*
|
|
46
|
-
.cache
|
|
47
|
-
nosetests.xml
|
|
48
|
-
coverage.xml
|
|
49
|
-
*.cover
|
|
50
|
-
*.py,cover
|
|
51
|
-
.hypothesis/
|
|
52
|
-
.pytest_cache/
|
|
53
|
-
cover/
|
|
54
|
-
|
|
55
|
-
# Translations
|
|
56
|
-
*.mo
|
|
57
|
-
*.pot
|
|
58
|
-
|
|
59
|
-
# Django stuff:
|
|
60
|
-
*.log
|
|
61
|
-
local_settings.py
|
|
62
|
-
db.sqlite3
|
|
63
|
-
db.sqlite3-journal
|
|
64
|
-
|
|
65
|
-
# Flask stuff:
|
|
66
|
-
instance/
|
|
67
|
-
.webassets-cache
|
|
68
|
-
|
|
69
|
-
# Scrapy stuff:
|
|
70
|
-
.scrapy
|
|
71
|
-
|
|
72
|
-
# Sphinx documentation
|
|
73
|
-
docs/_build/
|
|
74
|
-
|
|
75
|
-
# PyBuilder
|
|
76
|
-
.pybuilder/
|
|
77
|
-
target/
|
|
78
|
-
|
|
79
|
-
# Jupyter Notebook
|
|
80
|
-
.ipynb_checkpoints
|
|
81
|
-
|
|
82
|
-
# IPython
|
|
83
|
-
profile_default/
|
|
84
|
-
ipython_config.py
|
|
85
|
-
|
|
86
|
-
# pyenv
|
|
87
|
-
# For a library or package, you might want to ignore these files since the code is
|
|
88
|
-
# intended to run in multiple environments; otherwise, check them in:
|
|
89
|
-
# .python-version
|
|
90
|
-
|
|
91
|
-
# pipenv
|
|
92
|
-
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
|
|
93
|
-
# However, in case of collaboration, if having platform-specific dependencies or dependencies
|
|
94
|
-
# having no cross-platform support, pipenv may install dependencies that don't work, or not
|
|
95
|
-
# install all needed dependencies.
|
|
96
|
-
#Pipfile.lock
|
|
97
|
-
|
|
98
|
-
# poetry
|
|
99
|
-
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
|
|
100
|
-
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
|
101
|
-
# commonly ignored for libraries.
|
|
102
|
-
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
|
|
103
|
-
#poetry.lock
|
|
104
|
-
|
|
105
|
-
# pdm
|
|
106
|
-
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
|
|
107
|
-
#pdm.lock
|
|
108
|
-
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
|
|
109
|
-
# in version control.
|
|
110
|
-
# https://pdm.fming.dev/latest/usage/project/#working-with-version-control
|
|
111
|
-
.pdm.toml
|
|
112
|
-
.pdm-python
|
|
113
|
-
.pdm-build/
|
|
114
|
-
|
|
115
|
-
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
|
|
116
|
-
__pypackages__/
|
|
117
|
-
|
|
118
|
-
# Celery stuff
|
|
119
|
-
celerybeat-schedule
|
|
120
|
-
celerybeat.pid
|
|
121
|
-
|
|
122
|
-
# SageMath parsed files
|
|
123
|
-
*.sage.py
|
|
124
|
-
|
|
125
|
-
# Environments
|
|
126
|
-
.env
|
|
127
|
-
.venv
|
|
128
|
-
env/
|
|
129
|
-
venv/
|
|
130
|
-
ENV/
|
|
131
|
-
env.bak/
|
|
132
|
-
venv.bak/
|
|
133
|
-
|
|
134
|
-
# Spyder project settings
|
|
135
|
-
.spyderproject
|
|
136
|
-
.spyproject
|
|
137
|
-
|
|
138
|
-
# Rope project settings
|
|
139
|
-
.ropeproject
|
|
140
|
-
|
|
141
|
-
# mkdocs documentation
|
|
142
|
-
/site
|
|
143
|
-
|
|
144
|
-
# mypy
|
|
145
|
-
.mypy_cache/
|
|
146
|
-
.dmypy.json
|
|
147
|
-
dmypy.json
|
|
148
|
-
|
|
149
|
-
# Pyre type checker
|
|
150
|
-
.pyre/
|
|
151
|
-
|
|
152
|
-
# pytype static type analyzer
|
|
153
|
-
.pytype/
|
|
154
|
-
|
|
155
|
-
# Cython debug symbols
|
|
156
|
-
cython_debug/
|
|
157
|
-
|
|
158
|
-
# PyCharm
|
|
159
|
-
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
|
|
160
|
-
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
|
|
161
|
-
# and can be added to the global gitignore or merged into this file. For a more nuclear
|
|
162
|
-
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
|
|
163
|
-
#.idea/
|
|
164
|
-
main.py
|
|
165
|
-
build.bat
|
|
166
|
-
sessions.json
|
|
1
|
+
# Byte-compiled / optimized / DLL files
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
*$py.class
|
|
5
|
+
|
|
6
|
+
# C extensions
|
|
7
|
+
*.so
|
|
8
|
+
|
|
9
|
+
# Distribution / packaging
|
|
10
|
+
.vscode/
|
|
11
|
+
.Python
|
|
12
|
+
build/
|
|
13
|
+
develop-eggs/
|
|
14
|
+
dist/
|
|
15
|
+
downloads/
|
|
16
|
+
eggs/
|
|
17
|
+
.eggs/
|
|
18
|
+
lib/
|
|
19
|
+
lib64/
|
|
20
|
+
parts/
|
|
21
|
+
sdist/
|
|
22
|
+
var/
|
|
23
|
+
wheels/
|
|
24
|
+
share/python-wheels/
|
|
25
|
+
*.egg-info/
|
|
26
|
+
.installed.cfg
|
|
27
|
+
*.egg
|
|
28
|
+
MANIFEST
|
|
29
|
+
|
|
30
|
+
# PyInstaller
|
|
31
|
+
# Usually these files are written by a python script from a template
|
|
32
|
+
# before PyInstaller builds the exe, so as to inject date/other infos into it.
|
|
33
|
+
*.manifest
|
|
34
|
+
*.spec
|
|
35
|
+
|
|
36
|
+
# Installer logs
|
|
37
|
+
pip-log.txt
|
|
38
|
+
pip-delete-this-directory.txt
|
|
39
|
+
|
|
40
|
+
# Unit test / coverage reports
|
|
41
|
+
htmlcov/
|
|
42
|
+
.tox/
|
|
43
|
+
.nox/
|
|
44
|
+
.coverage
|
|
45
|
+
.coverage.*
|
|
46
|
+
.cache
|
|
47
|
+
nosetests.xml
|
|
48
|
+
coverage.xml
|
|
49
|
+
*.cover
|
|
50
|
+
*.py,cover
|
|
51
|
+
.hypothesis/
|
|
52
|
+
.pytest_cache/
|
|
53
|
+
cover/
|
|
54
|
+
|
|
55
|
+
# Translations
|
|
56
|
+
*.mo
|
|
57
|
+
*.pot
|
|
58
|
+
|
|
59
|
+
# Django stuff:
|
|
60
|
+
*.log
|
|
61
|
+
local_settings.py
|
|
62
|
+
db.sqlite3
|
|
63
|
+
db.sqlite3-journal
|
|
64
|
+
|
|
65
|
+
# Flask stuff:
|
|
66
|
+
instance/
|
|
67
|
+
.webassets-cache
|
|
68
|
+
|
|
69
|
+
# Scrapy stuff:
|
|
70
|
+
.scrapy
|
|
71
|
+
|
|
72
|
+
# Sphinx documentation
|
|
73
|
+
docs/_build/
|
|
74
|
+
|
|
75
|
+
# PyBuilder
|
|
76
|
+
.pybuilder/
|
|
77
|
+
target/
|
|
78
|
+
|
|
79
|
+
# Jupyter Notebook
|
|
80
|
+
.ipynb_checkpoints
|
|
81
|
+
|
|
82
|
+
# IPython
|
|
83
|
+
profile_default/
|
|
84
|
+
ipython_config.py
|
|
85
|
+
|
|
86
|
+
# pyenv
|
|
87
|
+
# For a library or package, you might want to ignore these files since the code is
|
|
88
|
+
# intended to run in multiple environments; otherwise, check them in:
|
|
89
|
+
# .python-version
|
|
90
|
+
|
|
91
|
+
# pipenv
|
|
92
|
+
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
|
|
93
|
+
# However, in case of collaboration, if having platform-specific dependencies or dependencies
|
|
94
|
+
# having no cross-platform support, pipenv may install dependencies that don't work, or not
|
|
95
|
+
# install all needed dependencies.
|
|
96
|
+
#Pipfile.lock
|
|
97
|
+
|
|
98
|
+
# poetry
|
|
99
|
+
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
|
|
100
|
+
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
|
101
|
+
# commonly ignored for libraries.
|
|
102
|
+
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
|
|
103
|
+
#poetry.lock
|
|
104
|
+
|
|
105
|
+
# pdm
|
|
106
|
+
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
|
|
107
|
+
#pdm.lock
|
|
108
|
+
# pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
|
|
109
|
+
# in version control.
|
|
110
|
+
# https://pdm.fming.dev/latest/usage/project/#working-with-version-control
|
|
111
|
+
.pdm.toml
|
|
112
|
+
.pdm-python
|
|
113
|
+
.pdm-build/
|
|
114
|
+
|
|
115
|
+
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
|
|
116
|
+
__pypackages__/
|
|
117
|
+
|
|
118
|
+
# Celery stuff
|
|
119
|
+
celerybeat-schedule
|
|
120
|
+
celerybeat.pid
|
|
121
|
+
|
|
122
|
+
# SageMath parsed files
|
|
123
|
+
*.sage.py
|
|
124
|
+
|
|
125
|
+
# Environments
|
|
126
|
+
.env
|
|
127
|
+
.venv
|
|
128
|
+
env/
|
|
129
|
+
venv/
|
|
130
|
+
ENV/
|
|
131
|
+
env.bak/
|
|
132
|
+
venv.bak/
|
|
133
|
+
|
|
134
|
+
# Spyder project settings
|
|
135
|
+
.spyderproject
|
|
136
|
+
.spyproject
|
|
137
|
+
|
|
138
|
+
# Rope project settings
|
|
139
|
+
.ropeproject
|
|
140
|
+
|
|
141
|
+
# mkdocs documentation
|
|
142
|
+
/site
|
|
143
|
+
|
|
144
|
+
# mypy
|
|
145
|
+
.mypy_cache/
|
|
146
|
+
.dmypy.json
|
|
147
|
+
dmypy.json
|
|
148
|
+
|
|
149
|
+
# Pyre type checker
|
|
150
|
+
.pyre/
|
|
151
|
+
|
|
152
|
+
# pytype static type analyzer
|
|
153
|
+
.pytype/
|
|
154
|
+
|
|
155
|
+
# Cython debug symbols
|
|
156
|
+
cython_debug/
|
|
157
|
+
|
|
158
|
+
# PyCharm
|
|
159
|
+
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
|
|
160
|
+
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
|
|
161
|
+
# and can be added to the global gitignore or merged into this file. For a more nuclear
|
|
162
|
+
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
|
|
163
|
+
#.idea/
|
|
164
|
+
main.py
|
|
165
|
+
build.bat
|
|
166
|
+
sessions.json
|
|
167
|
+
|
|
168
|
+
# Local planning, review notes, and exploratory captures
|
|
169
|
+
/docs/growth-and-coverage.md
|
|
170
|
+
/docs/research/
|
|
171
|
+
/ARCHITECTURE_REVIEW.md
|
|
172
|
+
/PUBLIC_FEATURES.md
|
|
173
|
+
/REVIEW_REPORT.md
|
|
174
|
+
/V2_REVIEW.md
|
|
175
|
+
/docs/independent-review.md
|
|
176
|
+
/docs/release-audit.md
|
|
177
|
+
/benchmarks/*.json
|
|
178
|
+
|
|
179
|
+
# Local credentials and tool artifacts
|
|
180
|
+
.env.*
|
|
181
|
+
!.env.example
|
|
182
|
+
.ruff_cache/
|
|
183
|
+
.idea/
|
|
184
|
+
.DS_Store
|
|
185
|
+
Thumbs.db
|
|
186
|
+
|
|
187
|
+
# Session-specific audit notes (keep contributor guides and regression tests)
|
|
188
|
+
/docs/code-quality-review.md
|
|
189
|
+
|
|
190
|
+
# Generated anonymous demo snapshots
|
|
191
|
+
/credit-atlas.html
|
|
192
|
+
|
|
193
|
+
# Optional public metadata response cache
|
|
194
|
+
.spotapi-cache/
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 2.1.0 - 2026-11-13
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- Launch the packaged desktop application with `spotapi studio` after installing
|
|
8
|
+
`spotapi[studio]`; its frontend and icons ship in the wheel.
|
|
9
|
+
- Keep first results and sign-in visible in Studio's minimum-size window,
|
|
10
|
+
with independently scrollable navigation.
|
|
11
|
+
- Launch the packaged terminal browser with `spotapi discover` and the demo extra.
|
|
12
|
+
- Read artist Discovered On playlists, concerts, similar albums and image palettes.
|
|
13
|
+
- Read typed podcast captions, explicit embed snapshots and public media assets.
|
|
14
|
+
- Export JSON-safe models, collect ordered partial-failure batches, optionally
|
|
15
|
+
cache anonymous responses and reuse the async core from `SyncCatalogue`.
|
|
16
|
+
- Optional browser login, OS-keyring sessions and read-only MCP integration.
|
|
17
|
+
- Read the Docs configuration, generated API reference and a Spotipy migration guide.
|
|
18
|
+
|
|
19
|
+
### Changed
|
|
20
|
+
|
|
21
|
+
- Discover the main and search-route bundles first, loading other routes on demand
|
|
22
|
+
with eight continuously scheduled workers and build-specific hash caching.
|
|
23
|
+
- Managed account scopes accept explicit proxy and language options.
|
|
24
|
+
- Keep sponsorship placements below usage material, with optional integration
|
|
25
|
+
partnerships and privately quoted scope.
|
|
26
|
+
- Require `wreq` 0.12.3 or newer within the compatible 0.12 release line for
|
|
27
|
+
corrected coroutine cancellation; 0.13 remains excluded because it changes
|
|
28
|
+
binary response types.
|
|
29
|
+
|
|
30
|
+
### Fixed
|
|
31
|
+
|
|
32
|
+
- Dealer disconnects wake command waiters and clear readiness; temporary device
|
|
33
|
+
loss no longer discards a valid late ACK. Quiet dealers allow one snapshot
|
|
34
|
+
refresh within the existing deadline; old snapshots cannot prove success.
|
|
35
|
+
- Playback restoration preserves its original target and primary error, and
|
|
36
|
+
does not confirm a seek that failed. Commands are never silently replayed.
|
|
37
|
+
- Failed route downloads can be retried rather than becoming permanent misses.
|
|
38
|
+
- Anonymous embed fallback preserves proxies and cannot downgrade borrowed scopes.
|
|
39
|
+
- Sync shutdown rejects nested event loops before losing resource ownership.
|
|
40
|
+
- Discover releases cached images when feed shutdown fails, and Escape/Down
|
|
41
|
+
return keyboard focus from search to results.
|
|
42
|
+
|
|
43
|
+
## 2.0.0
|
|
44
|
+
|
|
45
|
+
- Use `spotapi` for all async imports. The synchronous release remains available as `spotapi==1.2.8`.
|
|
46
|
+
- Install the `spotapi` command for anonymous track search and JSON resource lookups.
|
|
47
|
+
- Open a managed account session with `Private.from_cookies()`.
|
|
48
|
+
- Follow, unfollow and check artists by ID, URI or URL through `account.library`.
|
|
49
|
+
- Fetch multiple tracks, albums or artists through one catalogue client.
|
|
50
|
+
- Move exact playlist occurrences by UID, including duplicate tracks.
|
|
51
|
+
- Set or clear a custom JPEG playlist cover.
|
|
52
|
+
- Stream typed audiobook chapter pages for available titles.
|
|
53
|
+
- Browse Studio lyrics through LRCLIB and seek from timed lines on the matching track.
|
|
54
|
+
|
|
55
|
+
### Added
|
|
56
|
+
|
|
57
|
+
- Typed async catalogue search, lookups, credits, discovery and lazy pagination.
|
|
58
|
+
- `Public` for self-cleaning one-shot calls and `Catalogue` for connection reuse.
|
|
59
|
+
- Cookie-authenticated account, library, rankings, profiles and notifications.
|
|
60
|
+
- Existing-player controls, async listeners, occurrence-aware queue editing,
|
|
61
|
+
sleep timers and entitled lyrics.
|
|
62
|
+
- Playlist metadata editing and removal by exact occurrence UID.
|
|
63
|
+
- A provider-neutral async CAPTCHA protocol for explicit account operations.
|
|
64
|
+
- Optional Studio and terminal examples; their dependencies stay outside the core.
|
|
65
|
+
- Offline lifecycle and contract tests, opt-in live checks, and release workflows.
|
|
66
|
+
|
|
67
|
+
### Changed
|
|
68
|
+
|
|
69
|
+
- Authenticated feature requests use `authorized=True`; credential assembly,
|
|
70
|
+
renewal, destination validation and redirect policy live in `AsyncClient`.
|
|
71
|
+
- Identical artwork color and contrast-role shapes share `RGBA` and
|
|
72
|
+
`ContrastPalette` value types instead of nine duplicate dataclasses.
|
|
73
|
+
- Result types live in the `models` package, grouped by domain; importing them
|
|
74
|
+
does not load the native HTTP transport. Old implementation paths were removed.
|
|
75
|
+
- Internal endpoint templates, protobuf, bundle parsing and TOTP helpers live
|
|
76
|
+
in `_protocol`; repeated resource paths share one escaping implementation.
|
|
77
|
+
|
|
78
|
+
- Advanced searches use immutable `SearchOptions` with snake_case fields and
|
|
79
|
+
`options=`; native GraphQL variable names remain internal to serialization.
|
|
80
|
+
- Direct transport access is `client.transport` and `client.websocket`.
|
|
81
|
+
- Authenticated profile attributes expose Python field names; see the migration guide.
|
|
82
|
+
|
|
83
|
+
- Python 3.11+ and async/await are required. See [migration](MIGRATION.md) for
|
|
84
|
+
compatibility changes and v1 features that have not been ported.
|
|
85
|
+
- Hatch and `pyproject.toml` define package metadata; `requirements.txt` retains
|
|
86
|
+
the same tested transport pin.
|
|
87
|
+
- Known reads opt into bounded retries. Mutations are not replayed after
|
|
88
|
+
ambiguous failures; account CSRF rotation is handled explicitly.
|
|
89
|
+
- Query hashes use a build-bound disk cache. Cached startup fetches the main
|
|
90
|
+
bundle rather than every chunk, and discards unneeded source after parsing.
|
|
91
|
+
- Clients own refresh, socket and callback tasks and release them on shutdown.
|
|
92
|
+
- Logging defaults to the standard library without configuring application sinks.
|
|
93
|
+
|
|
94
|
+
### Fixed
|
|
95
|
+
|
|
96
|
+
- Directly constructed authentication sessions attach to their owning client,
|
|
97
|
+
so safe request renewal and shutdown behave consistently across factories.
|
|
98
|
+
- `max_attempts=1` also prevents a second request after an authorization failure.
|
|
99
|
+
- HEAD, 204 and 205 responses may be empty even with a JSON Content-Type.
|
|
100
|
+
- Accepted cleanup statuses use `expected_statuses`, preserving normal
|
|
101
|
+
authorization handling without duplicating status checks in features.
|
|
102
|
+
|
|
103
|
+
- Thread-local implicit query owners no longer share a slotted registry across threads.
|
|
104
|
+
- Managed authorization rebuilds fresh credential headers after renewal; custom header names and JSON media types are case-insensitive.
|
|
105
|
+
- The model decoder recognizes native GraphQL `__typename` fields consistently with search preflight.
|
|
106
|
+
- Profile options, profile attributes and notification identities/cursors reject malformed contracts.
|
|
107
|
+
- Exception logging respects the configured severity filter and synchronization.
|
|
108
|
+
|
|
109
|
+
- Playlist add/remove operations reject error unions such as `NotFound` instead
|
|
110
|
+
of interpreting a nonempty error object as success.
|
|
111
|
+
- Commands with `wait=True` require a matching dealer ACK or a fresh state proving
|
|
112
|
+
the result, even when the HTTP response contains no acknowledgement ID.
|
|
113
|
+
- Studio cancels timed-out sign-ins, prevents concurrent cookie imports, and
|
|
114
|
+
discards delayed data from the previous account.
|
|
115
|
+
- Library saves, pins and user follows validate Spotify's confirmation instead
|
|
116
|
+
of accepting nonempty error responses or incomplete mutation results.
|
|
117
|
+
- Playback restrictions, canonical playlist metadata reads, and optional model
|
|
118
|
+
fields are handled explicitly.
|
|
119
|
+
|
|
120
|
+
See the [release checks](docs/release-checks.md) and [player coverage](docs/player-coverage.md)
|
|
121
|
+
for supported workflows and known gaps.
|
|
122
|
+
|
|
123
|
+
## v1 history
|
|
124
|
+
|
|
125
|
+
See the [repository history](https://github.com/Aran404/SpotAPI/commits/main/)
|
|
126
|
+
for changes predating the rewrite.
|