spotapi 2.0.0b2__tar.gz → 2.1.1__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.1/.dockerignore +9 -0
- spotapi-2.1.1/.env.example +4 -0
- spotapi-2.1.1/.github/ISSUE_TEMPLATE/bug.yml +109 -0
- spotapi-2.1.1/.github/ISSUE_TEMPLATE/config.yml +11 -0
- spotapi-2.1.1/.github/ISSUE_TEMPLATE/feature.yml +66 -0
- spotapi-2.1.1/.github/pull_request_template.md +25 -0
- spotapi-2.1.1/.github/workflows/docs.yml +22 -0
- spotapi-2.1.1/.github/workflows/publish.yml +74 -0
- spotapi-2.1.1/.github/workflows/spotify-public.yml +119 -0
- {spotapi-2.0.0b2 → spotapi-2.1.1}/.gitignore +29 -1
- spotapi-2.1.1/.readthedocs.yaml +14 -0
- spotapi-2.1.1/CHANGELOG.md +159 -0
- spotapi-2.1.1/CONTRIBUTING.md +80 -0
- spotapi-2.1.1/Dockerfile.mcp +8 -0
- spotapi-2.1.1/LEGAL_NOTICE.md +36 -0
- spotapi-2.1.1/MIGRATION.md +197 -0
- {spotapi-2.0.0b2 → spotapi-2.1.1}/PKG-INFO +149 -176
- spotapi-2.1.1/README.es.md +189 -0
- spotapi-2.1.1/README.fr.md +189 -0
- spotapi-2.1.1/README.md +189 -0
- spotapi-2.1.1/README.pt-BR.md +189 -0
- spotapi-2.1.1/SECURITY.md +25 -0
- spotapi-2.1.1/SPONSORSHIP.md +75 -0
- spotapi-2.1.1/assets/README.md +13 -0
- spotapi-2.1.1/assets/cli-connect-demo.gif +0 -0
- spotapi-2.1.1/assets/cli-demo.gif +0 -0
- spotapi-2.1.1/assets/logo-inverse.svg +38 -0
- spotapi-2.1.1/assets/logo-mono.svg +38 -0
- spotapi-2.1.1/assets/lyrics-sync-demo.gif +0 -0
- spotapi-2.1.1/assets/social-preview.png +0 -0
- spotapi-2.1.1/assets/spotapi-color.svg +48 -0
- spotapi-2.1.1/assets/spotapi-inverse.svg +48 -0
- spotapi-2.1.1/assets/spotapi-mono.svg +48 -0
- spotapi-2.1.1/assets/spotapi-reversed.svg +48 -0
- spotapi-2.1.1/assets/studio-demo.gif +0 -0
- spotapi-2.1.1/benchmarks/review.py +408 -0
- spotapi-2.1.1/docs/account.md +119 -0
- spotapi-2.1.1/docs/api-layout.md +75 -0
- spotapi-2.1.1/docs/catalogue.md +93 -0
- spotapi-2.1.1/docs/connect.md +163 -0
- spotapi-2.1.1/docs/discovery.md +245 -0
- spotapi-2.1.1/docs/from-spotipy.md +84 -0
- spotapi-2.1.1/docs/index.md +73 -0
- spotapi-2.1.1/docs/player-coverage.md +54 -0
- spotapi-2.1.1/docs/player.md +205 -0
- spotapi-2.1.1/docs/quickstart.md +143 -0
- spotapi-2.1.1/docs/reference.md +79 -0
- spotapi-2.1.1/docs/release-checks.md +78 -0
- spotapi-2.1.1/docs/studio.md +76 -0
- spotapi-2.1.1/docs/stylesheets/extra.css +7 -0
- spotapi-2.1.1/docs/transport.md +93 -0
- spotapi-2.1.1/docs/troubleshooting.md +78 -0
- spotapi-2.1.1/examples/README.md +43 -0
- spotapi-2.1.1/examples/__init__.py +1 -0
- spotapi-2.1.1/examples/credit_trail.py +48 -0
- spotapi-2.1.1/examples/credits.py +16 -0
- spotapi-2.1.1/examples/custom_transport.py +17 -0
- spotapi-2.1.1/examples/discover.py +8 -0
- spotapi-2.1.1/examples/export.py +16 -0
- spotapi-2.1.1/examples/lookup.py +17 -0
- spotapi-2.1.1/examples/lyrics.py +21 -0
- spotapi-2.1.1/examples/mix_map.py +66 -0
- spotapi-2.1.1/examples/overlap.py +31 -0
- spotapi-2.1.1/examples/pagination.py +23 -0
- spotapi-2.1.1/examples/player.py +35 -0
- spotapi-2.1.1/examples/playlist_audit.py +178 -0
- spotapi-2.1.1/examples/playlist_crate.py +31 -0
- spotapi-2.1.1/examples/public_search.py +29 -0
- spotapi-2.1.1/examples/quickstart.py +16 -0
- spotapi-2.1.1/examples/skip_next.py +17 -0
- spotapi-2.1.1/examples/studio/__init__.py +1 -0
- spotapi-2.1.1/examples/studio/__main__.py +5 -0
- spotapi-2.1.1/examples/studio/preview.png +0 -0
- spotapi-2.1.1/examples/taste.py +29 -0
- spotapi-2.1.1/examples/taste_lab/README.md +196 -0
- spotapi-2.1.1/examples/taste_lab/VALIDATION.md +82 -0
- spotapi-2.1.1/examples/taste_lab/__init__.py +1 -0
- spotapi-2.1.1/examples/taste_lab/__main__.py +309 -0
- spotapi-2.1.1/examples/taste_lab/audio.py +142 -0
- spotapi-2.1.1/examples/taste_lab/engine.py +310 -0
- spotapi-2.1.1/examples/taste_lab/evaluate.py +98 -0
- spotapi-2.1.1/examples/taste_lab/extract.py +124 -0
- spotapi-2.1.1/examples/taste_lab/models.py +83 -0
- spotapi-2.1.1/examples/taste_lab/observe.py +88 -0
- spotapi-2.1.1/examples/taste_lab/requirements-audio.txt +7 -0
- spotapi-2.1.1/examples/taste_lab/smoke_audio.py +65 -0
- spotapi-2.1.1/examples/taste_lab/spotify.py +256 -0
- spotapi-2.1.1/examples/taste_lab/store.py +205 -0
- spotapi-2.1.1/examples/taste_lab/youtube.py +312 -0
- spotapi-2.1.1/mkdocs.yml +83 -0
- spotapi-2.1.1/pyproject.toml +132 -0
- spotapi-2.1.1/requirements-docs.txt +4 -0
- spotapi-2.1.1/requirements.txt +1 -0
- spotapi-2.1.1/spotapi/__init__.py +143 -0
- spotapi-2.1.1/spotapi/__main__.py +6 -0
- spotapi-2.1.1/spotapi/_connect/__init__.py +1 -0
- spotapi-2.1.1/spotapi/_connect/app.py +838 -0
- spotapi-2.1.1/spotapi/_connect/auth.py +28 -0
- spotapi-2.1.1/spotapi/_connect/commands.py +127 -0
- spotapi-2.1.1/spotapi/_connect/presentation.py +101 -0
- spotapi-2.1.1/spotapi/_connect/queue.py +62 -0
- spotapi-2.1.1/spotapi/_connect/session.py +144 -0
- spotapi-2.1.1/spotapi/_connect/style.tcss +290 -0
- spotapi-2.1.1/spotapi/_connect/suggestions.py +51 -0
- spotapi-2.1.1/spotapi/_decoding.py +221 -0
- spotapi-2.1.1/spotapi/_demo/__init__.py +1 -0
- spotapi-2.1.1/spotapi/_demo/details.py +323 -0
- spotapi-2.1.1/spotapi/_demo/discover.py +780 -0
- spotapi-2.1.1/spotapi/_parsing.py +40 -0
- spotapi-2.1.1/spotapi/_protocol/__init__.py +1 -0
- spotapi-2.1.1/spotapi/_protocol/bundles.py +69 -0
- spotapi-2.1.1/spotapi/_protocol/collection.py +56 -0
- spotapi-2.1.1/spotapi/_protocol/embeds.py +46 -0
- spotapi-2.1.1/spotapi/_protocol/protobuf.py +120 -0
- spotapi-2.1.1/spotapi/_protocol/routes.py +66 -0
- spotapi-2.1.1/spotapi/_protocol/totp.py +81 -0
- spotapi-2.1.1/spotapi/_protocol/user_agent.py +231 -0
- spotapi-2.1.1/spotapi/_studio/__init__.py +1 -0
- spotapi-2.1.1/spotapi/_studio/actions.py +110 -0
- spotapi-2.1.1/spotapi/_studio/app.js +1195 -0
- spotapi-2.1.1/spotapi/_studio/assets/logo.ico +0 -0
- spotapi-2.1.1/spotapi/_studio/assets/logo.png +0 -0
- spotapi-2.1.1/spotapi/_studio/assets/logo.svg +48 -0
- spotapi-2.1.1/spotapi/_studio/desktop.py +239 -0
- spotapi-2.1.1/spotapi/_studio/index.html +325 -0
- spotapi-2.1.1/spotapi/_studio/lyrics.py +91 -0
- spotapi-2.1.1/spotapi/_studio/service.py +631 -0
- spotapi-2.1.1/spotapi/_studio/style.css +1371 -0
- spotapi-2.1.1/spotapi/account.py +280 -0
- spotapi-2.1.1/spotapi/account_session.py +152 -0
- spotapi-2.1.1/spotapi/batch.py +52 -0
- spotapi-2.1.1/spotapi/blend.py +70 -0
- spotapi-2.1.1/spotapi/cache.py +173 -0
- spotapi-2.1.1/spotapi/captcha.py +42 -0
- spotapi-2.1.1/spotapi/catalogue.py +1514 -0
- spotapi-2.1.1/spotapi/charts.py +22 -0
- spotapi-2.1.1/spotapi/cli.py +571 -0
- spotapi-2.1.1/spotapi/client.py +641 -0
- spotapi-2.1.1/spotapi/command_state.py +87 -0
- spotapi-2.1.1/spotapi/connect.py +55 -0
- spotapi-2.1.1/spotapi/connection/__init__.py +12 -0
- spotapi-2.1.1/spotapi/connection/client.py +8 -0
- spotapi-2.1.1/spotapi/connection/http.py +744 -0
- spotapi-2.1.1/spotapi/connection/types.py +83 -0
- spotapi-2.1.1/spotapi/connection/websocket.py +519 -0
- spotapi-2.1.1/spotapi/datastruct/__init__.py +7 -0
- spotapi-2.1.1/spotapi/datastruct/event_handler.py +173 -0
- spotapi-2.1.1/spotapi/datastruct/object_dict.py +196 -0
- spotapi-2.1.1/spotapi/datastruct/pool.py +235 -0
- spotapi-2.1.1/spotapi/devices.py +193 -0
- spotapi-2.1.1/spotapi/embeds.py +55 -0
- spotapi-2.1.1/spotapi/history.py +97 -0
- spotapi-2.1.1/spotapi/library.py +291 -0
- spotapi-2.1.1/spotapi/login.py +133 -0
- spotapi-2.1.1/spotapi/lyrics.py +75 -0
- spotapi-2.1.1/spotapi/mcp.py +254 -0
- spotapi-2.1.1/spotapi/media.py +165 -0
- spotapi-2.1.1/spotapi/models/__init__.py +118 -0
- spotapi-2.1.1/spotapi/models/account.py +122 -0
- spotapi-2.1.1/spotapi/models/batch.py +33 -0
- spotapi-2.1.1/spotapi/models/blend.py +42 -0
- spotapi-2.1.1/spotapi/models/catalogue/__init__.py +65 -0
- spotapi-2.1.1/spotapi/models/catalogue/album.py +71 -0
- spotapi-2.1.1/spotapi/models/catalogue/album_details.py +242 -0
- spotapi-2.1.1/spotapi/models/catalogue/artist.py +73 -0
- spotapi-2.1.1/spotapi/models/catalogue/artist_details.py +223 -0
- spotapi-2.1.1/spotapi/models/catalogue/common.py +95 -0
- spotapi-2.1.1/spotapi/models/catalogue/credits.py +39 -0
- spotapi-2.1.1/spotapi/models/catalogue/entities.py +194 -0
- spotapi-2.1.1/spotapi/models/catalogue/playlist.py +79 -0
- spotapi-2.1.1/spotapi/models/catalogue/playlist_details.py +52 -0
- spotapi-2.1.1/spotapi/models/catalogue/playlist_track.py +119 -0
- spotapi-2.1.1/spotapi/models/catalogue/podcast.py +55 -0
- spotapi-2.1.1/spotapi/models/catalogue/podcast_episode.py +136 -0
- spotapi-2.1.1/spotapi/models/catalogue/profile_attributes.py +35 -0
- spotapi-2.1.1/spotapi/models/catalogue/track.py +105 -0
- spotapi-2.1.1/spotapi/models/catalogue/track_details.py +206 -0
- spotapi-2.1.1/spotapi/models/discovery.py +213 -0
- spotapi-2.1.1/spotapi/models/embeds.py +44 -0
- spotapi-2.1.1/spotapi/models/history.py +76 -0
- spotapi-2.1.1/spotapi/models/library.py +148 -0
- spotapi-2.1.1/spotapi/models/lyrics.py +126 -0
- spotapi-2.1.1/spotapi/models/notifications.py +77 -0
- spotapi-2.1.1/spotapi/models/playback.py +292 -0
- spotapi-2.1.1/spotapi/models/profiles.py +20 -0
- spotapi-2.1.1/spotapi/models/search.py +91 -0
- spotapi-2.1.1/spotapi/models/sessions.py +11 -0
- spotapi-2.1.1/spotapi/models/stats.py +24 -0
- spotapi-2.1.1/spotapi/models/transcripts.py +64 -0
- spotapi-2.1.1/spotapi/notifications.py +88 -0
- spotapi-2.1.1/spotapi/operations.py +480 -0
- spotapi-2.1.1/spotapi/password.py +84 -0
- spotapi-2.1.1/spotapi/player.py +728 -0
- spotapi-2.1.1/spotapi/playlist.py +681 -0
- spotapi-2.1.1/spotapi/profiles.py +250 -0
- spotapi-2.1.1/spotapi/public.py +742 -0
- spotapi-2.1.1/spotapi/queries.py +409 -0
- spotapi-2.1.1/spotapi/query.py +637 -0
- spotapi-2.1.1/spotapi/resources.py +142 -0
- spotapi-2.1.1/spotapi/serialization.py +70 -0
- spotapi-2.1.1/spotapi/session.py +997 -0
- spotapi-2.1.1/spotapi/stats.py +108 -0
- spotapi-2.1.1/spotapi/status.py +845 -0
- spotapi-2.1.1/spotapi/sync.py +369 -0
- spotapi-2.1.1/spotapi/transcripts.py +37 -0
- spotapi-2.1.1/spotapi/types/__init__.py +46 -0
- spotapi-2.1.1/spotapi/types/exceptions.py +53 -0
- {spotapi-2.0.0b2/spotapi/v2 → spotapi-2.1.1/spotapi}/types/logger.py +254 -176
- spotapi-2.1.1/spotapi/utils/__init__.py +6 -0
- spotapi-2.1.1/spotapi/utils/cache.py +149 -0
- spotapi-2.1.1/spotapi/utils/random.py +28 -0
- spotapi-2.1.1/tests/README.md +29 -0
- spotapi-2.1.1/tests/conftest.py +39 -0
- spotapi-2.1.1/tests/fixtures/connect/message-1.json +100 -0
- spotapi-2.1.1/tests/fixtures/connect/message-2.json +382 -0
- spotapi-2.1.1/tests/fixtures/connect/message-3.json +393 -0
- spotapi-2.1.1/tests/fixtures/connect/message-4.json +146 -0
- spotapi-2.1.1/tests/test_account.py +276 -0
- spotapi-2.1.1/tests/test_account_content.py +461 -0
- spotapi-2.1.1/tests/test_artist_details_model.py +27 -0
- spotapi-2.1.1/tests/test_auth_recovery.py +315 -0
- spotapi-2.1.1/tests/test_authorized_requests.py +101 -0
- spotapi-2.1.1/tests/test_bundle_cache.py +209 -0
- spotapi-2.1.1/tests/test_catalogue_lifecycle.py +178 -0
- spotapi-2.1.1/tests/test_cli.py +207 -0
- spotapi-2.1.1/tests/test_connect_presentation.py +294 -0
- spotapi-2.1.1/tests/test_connect_terminal.py +341 -0
- spotapi-2.1.1/tests/test_data_contracts.py +228 -0
- spotapi-2.1.1/tests/test_discover_demo.py +246 -0
- spotapi-2.1.1/tests/test_discovery_parser.py +22 -0
- spotapi-2.1.1/tests/test_documentation_entrypoints.py +147 -0
- spotapi-2.1.1/tests/test_feature_parity.py +388 -0
- spotapi-2.1.1/tests/test_lifecycle.py +354 -0
- spotapi-2.1.1/tests/test_listening.py +167 -0
- spotapi-2.1.1/tests/test_live.py +103 -0
- spotapi-2.1.1/tests/test_live_account.py +39 -0
- spotapi-2.1.1/tests/test_live_catalogue.py +162 -0
- spotapi-2.1.1/tests/test_live_controls.py +199 -0
- spotapi-2.1.1/tests/test_live_discovery.py +35 -0
- spotapi-2.1.1/tests/test_live_player.py +38 -0
- spotapi-2.1.1/tests/test_live_playlists.py +124 -0
- spotapi-2.1.1/tests/test_live_studio.py +45 -0
- spotapi-2.1.1/tests/test_mutations.py +178 -0
- spotapi-2.1.1/tests/test_native_websocket.py +139 -0
- spotapi-2.1.1/tests/test_operations.py +74 -0
- spotapi-2.1.1/tests/test_optional_features.py +434 -0
- spotapi-2.1.1/tests/test_player.py +1304 -0
- spotapi-2.1.1/tests/test_playlist_audit_example.py +106 -0
- spotapi-2.1.1/tests/test_protobuf.py +35 -0
- spotapi-2.1.1/tests/test_public_api.py +627 -0
- spotapi-2.1.1/tests/test_public_catalogue.py +204 -0
- spotapi-2.1.1/tests/test_queries_parsing.py +160 -0
- spotapi-2.1.1/tests/test_review_regressions.py +174 -0
- spotapi-2.1.1/tests/test_routes.py +38 -0
- spotapi-2.1.1/tests/test_search_models.py +26 -0
- spotapi-2.1.1/tests/test_studio.py +306 -0
- spotapi-2.1.1/tests/test_studio_browser.py +449 -0
- spotapi-2.1.1/tests/test_taste_audio.py +133 -0
- spotapi-2.1.1/tests/test_taste_import.py +85 -0
- spotapi-2.1.1/tests/test_taste_lab.py +291 -0
- spotapi-2.1.1/tests/test_taste_sources.py +68 -0
- spotapi-2.1.1/tests/test_transport.py +295 -0
- spotapi-2.1.1/tests/test_user_agent.py +81 -0
- spotapi-2.1.1/tests/test_websocket_lifecycle.py +194 -0
- spotapi-2.0.0b2/CHANGELOG.md +0 -90
- spotapi-2.0.0b2/CONTRIBUTING.md +0 -247
- spotapi-2.0.0b2/LEGAL_NOTICE.md +0 -46
- spotapi-2.0.0b2/MIGRATION.md +0 -182
- spotapi-2.0.0b2/README.md +0 -239
- spotapi-2.0.0b2/docs/album.md +0 -59
- spotapi-2.0.0b2/docs/artist.md +0 -107
- spotapi-2.0.0b2/docs/creator.md +0 -56
- spotapi-2.0.0b2/docs/family.md +0 -62
- spotapi-2.0.0b2/docs/language.md +0 -90
- spotapi-2.0.0b2/docs/login.md +0 -103
- spotapi-2.0.0b2/docs/password.md +0 -38
- spotapi-2.0.0b2/docs/player.md +0 -183
- spotapi-2.0.0b2/docs/playlist.md +0 -179
- spotapi-2.0.0b2/docs/public.md +0 -143
- spotapi-2.0.0b2/docs/song.md +0 -126
- spotapi-2.0.0b2/docs/status.md +0 -148
- spotapi-2.0.0b2/docs/user.md +0 -67
- spotapi-2.0.0b2/docs/websocket.md +0 -29
- spotapi-2.0.0b2/example.py +0 -119
- spotapi-2.0.0b2/image.png +0 -0
- spotapi-2.0.0b2/pyproject.toml +0 -86
- spotapi-2.0.0b2/requirements.txt +0 -2
- spotapi-2.0.0b2/setup.py +0 -61
- spotapi-2.0.0b2/spotapi/sync/__init__.py +0 -25
- spotapi-2.0.0b2/spotapi/sync/_tests/.env.sample +0 -3
- spotapi-2.0.0b2/spotapi/sync/_tests/__init__.py +0 -1
- spotapi-2.0.0b2/spotapi/sync/_tests/annotations_test.py +0 -222
- spotapi-2.0.0b2/spotapi/sync/_tests/client_refresh_test.py +0 -224
- spotapi-2.0.0b2/spotapi/sync/_tests/features/artist_test.py +0 -196
- spotapi-2.0.0b2/spotapi/sync/_tests/features/event_test.py +0 -53
- spotapi-2.0.0b2/spotapi/sync/_tests/features/player_test.py +0 -112
- spotapi-2.0.0b2/spotapi/sync/_tests/features/private_playlist_test.py +0 -70
- spotapi-2.0.0b2/spotapi/sync/_tests/features/public_playlist_test.py +0 -32
- spotapi-2.0.0b2/spotapi/sync/_tests/features/session.py +0 -36
- spotapi-2.0.0b2/spotapi/sync/_tests/features/song_test.py +0 -67
- spotapi-2.0.0b2/spotapi/sync/_tests/features/status_test.py +0 -126
- spotapi-2.0.0b2/spotapi/sync/_tests/features/user_test.py +0 -63
- spotapi-2.0.0b2/spotapi/sync/album.py +0 -96
- spotapi-2.0.0b2/spotapi/sync/artist.py +0 -287
- spotapi-2.0.0b2/spotapi/sync/client.py +0 -314
- spotapi-2.0.0b2/spotapi/sync/creator.py +0 -203
- spotapi-2.0.0b2/spotapi/sync/exceptions/__init__.py +0 -1
- spotapi-2.0.0b2/spotapi/sync/exceptions/errors.py +0 -111
- spotapi-2.0.0b2/spotapi/sync/family.py +0 -162
- spotapi-2.0.0b2/spotapi/sync/http/__init__.py +0 -2
- spotapi-2.0.0b2/spotapi/sync/http/data.py +0 -43
- spotapi-2.0.0b2/spotapi/sync/http/request.py +0 -248
- spotapi-2.0.0b2/spotapi/sync/login.py +0 -356
- spotapi-2.0.0b2/spotapi/sync/password.py +0 -97
- spotapi-2.0.0b2/spotapi/sync/player.py +0 -348
- spotapi-2.0.0b2/spotapi/sync/playlist.py +0 -417
- spotapi-2.0.0b2/spotapi/sync/podcast.py +0 -129
- spotapi-2.0.0b2/spotapi/sync/public.py +0 -117
- spotapi-2.0.0b2/spotapi/sync/solvers/__init__.py +0 -15
- spotapi-2.0.0b2/spotapi/sync/solvers/capmonster.py +0 -145
- spotapi-2.0.0b2/spotapi/sync/solvers/capsolver.py +0 -144
- spotapi-2.0.0b2/spotapi/sync/song.py +0 -288
- spotapi-2.0.0b2/spotapi/sync/status.py +0 -226
- spotapi-2.0.0b2/spotapi/sync/types/__init__.py +0 -2
- spotapi-2.0.0b2/spotapi/sync/types/alias.py +0 -29
- spotapi-2.0.0b2/spotapi/sync/types/annotations.py +0 -201
- spotapi-2.0.0b2/spotapi/sync/types/data.py +0 -413
- spotapi-2.0.0b2/spotapi/sync/types/interfaces.py +0 -57
- spotapi-2.0.0b2/spotapi/sync/user.py +0 -128
- spotapi-2.0.0b2/spotapi/sync/utils/__init__.py +0 -3
- spotapi-2.0.0b2/spotapi/sync/utils/logger.py +0 -91
- spotapi-2.0.0b2/spotapi/sync/utils/saver.py +0 -357
- spotapi-2.0.0b2/spotapi/sync/utils/strings.py +0 -130
- spotapi-2.0.0b2/spotapi/sync/websocket.py +0 -167
- spotapi-2.0.0b2/spotapi/v2/__init__.py +0 -11
- spotapi-2.0.0b2/spotapi/v2/client.py +0 -101
- spotapi-2.0.0b2/spotapi/v2/connection/__init__.py +0 -12
- spotapi-2.0.0b2/spotapi/v2/connection/http.py +0 -288
- spotapi-2.0.0b2/spotapi/v2/connection/types.py +0 -76
- spotapi-2.0.0b2/spotapi/v2/connection/websocket.py +0 -199
- spotapi-2.0.0b2/spotapi/v2/datastruct/__init__.py +0 -9
- spotapi-2.0.0b2/spotapi/v2/datastruct/event_handler.py +0 -62
- spotapi-2.0.0b2/spotapi/v2/datastruct/object_dict.py +0 -176
- spotapi-2.0.0b2/spotapi/v2/datastruct/pool.py +0 -155
- spotapi-2.0.0b2/spotapi/v2/playlist.py +0 -225
- spotapi-2.0.0b2/spotapi/v2/public.py +0 -370
- spotapi-2.0.0b2/spotapi/v2/query.py +0 -117
- spotapi-2.0.0b2/spotapi/v2/session.py +0 -392
- spotapi-2.0.0b2/spotapi/v2/specialized/__init__.py +0 -3
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/__init__.py +0 -165
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/album.py +0 -93
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/artist.py +0 -66
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/common.py +0 -139
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/playlist.py +0 -81
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/podcast.py +0 -75
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/profile_attributes.py +0 -29
- spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/track.py +0 -113
- spotapi-2.0.0b2/spotapi/v2/specialized/totp.py +0 -66
- spotapi-2.0.0b2/spotapi/v2/types/__init__.py +0 -12
- spotapi-2.0.0b2/spotapi/v2/types/exceptions.py +0 -27
- spotapi-2.0.0b2/spotapi/v2/utils/__init__.py +0 -12
- spotapi-2.0.0b2/spotapi/v2/utils/cache.py +0 -62
- spotapi-2.0.0b2/spotapi/v2/utils/random.py +0 -22
- spotapi-2.0.0b2/spotapi/v2/utils/strings.py +0 -130
- {spotapi-2.0.0b2 → spotapi-2.1.1}/CODE_OF_CONDUCT.md +0 -0
- {spotapi-2.0.0b2 → spotapi-2.1.1}/LICENSE +0 -0
- {spotapi-2.0.0b2/spotapi/v2 → spotapi-2.1.1/spotapi}/py.typed +0 -0
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
name: Bug report
|
|
2
|
+
description: Report reproducible behavior that differs from SpotAPI's documented contract.
|
|
3
|
+
title: "[Bug]: "
|
|
4
|
+
labels: ["bug"]
|
|
5
|
+
body:
|
|
6
|
+
- type: markdown
|
|
7
|
+
attributes:
|
|
8
|
+
value: |
|
|
9
|
+
Thanks for helping improve SpotAPI. Do not include Spotify cookies, access tokens, passwords, or private playlist data.
|
|
10
|
+
Report security vulnerabilities privately using the repository's security policy.
|
|
11
|
+
|
|
12
|
+
- type: textarea
|
|
13
|
+
id: summary
|
|
14
|
+
attributes:
|
|
15
|
+
label: What happened?
|
|
16
|
+
description: Describe the problem and the user-visible effect.
|
|
17
|
+
validations:
|
|
18
|
+
required: true
|
|
19
|
+
|
|
20
|
+
- type: textarea
|
|
21
|
+
id: reproduction
|
|
22
|
+
attributes:
|
|
23
|
+
label: Minimal reproduction
|
|
24
|
+
description: Include the smallest script or command that reproduces the problem. Replace private IDs and credentials.
|
|
25
|
+
validations:
|
|
26
|
+
required: true
|
|
27
|
+
|
|
28
|
+
- type: textarea
|
|
29
|
+
id: expected
|
|
30
|
+
attributes:
|
|
31
|
+
label: Expected behavior
|
|
32
|
+
description: What did you expect SpotAPI to return or do?
|
|
33
|
+
validations:
|
|
34
|
+
required: true
|
|
35
|
+
|
|
36
|
+
- type: textarea
|
|
37
|
+
id: actual
|
|
38
|
+
attributes:
|
|
39
|
+
label: Actual behavior
|
|
40
|
+
description: Include the complete exception type and message when applicable.
|
|
41
|
+
validations:
|
|
42
|
+
required: true
|
|
43
|
+
|
|
44
|
+
- type: input
|
|
45
|
+
id: spotapi-version
|
|
46
|
+
attributes:
|
|
47
|
+
label: SpotAPI version
|
|
48
|
+
description: Run `python -m pip show spotapi` in the application's environment and paste the Version line. On Windows, use `py -m pip show spotapi` if you installed with `py`.
|
|
49
|
+
placeholder: spotapi 2.1.0
|
|
50
|
+
validations:
|
|
51
|
+
required: true
|
|
52
|
+
|
|
53
|
+
- type: input
|
|
54
|
+
id: python-version
|
|
55
|
+
attributes:
|
|
56
|
+
label: Python version
|
|
57
|
+
description: Run `python --version` in the same environment.
|
|
58
|
+
placeholder: Python 3.12.7
|
|
59
|
+
validations:
|
|
60
|
+
required: true
|
|
61
|
+
|
|
62
|
+
- type: dropdown
|
|
63
|
+
id: area
|
|
64
|
+
attributes:
|
|
65
|
+
label: Area
|
|
66
|
+
options:
|
|
67
|
+
- Public catalogue
|
|
68
|
+
- Account or library
|
|
69
|
+
- Playlists
|
|
70
|
+
- Player or live events
|
|
71
|
+
- Command-line interface
|
|
72
|
+
- Discover terminal UI
|
|
73
|
+
- Studio
|
|
74
|
+
- Transport or authentication
|
|
75
|
+
- Models, typing, or serialization
|
|
76
|
+
- Other
|
|
77
|
+
validations:
|
|
78
|
+
required: true
|
|
79
|
+
|
|
80
|
+
- type: dropdown
|
|
81
|
+
id: operating-system
|
|
82
|
+
attributes:
|
|
83
|
+
label: Operating system
|
|
84
|
+
options:
|
|
85
|
+
- Windows
|
|
86
|
+
- macOS
|
|
87
|
+
- Linux
|
|
88
|
+
- Other
|
|
89
|
+
validations:
|
|
90
|
+
required: true
|
|
91
|
+
|
|
92
|
+
- type: textarea
|
|
93
|
+
id: logs
|
|
94
|
+
attributes:
|
|
95
|
+
label: Relevant logs
|
|
96
|
+
description: Optional. Remove credentials, cookies, tokens, and private identifiers before pasting output.
|
|
97
|
+
render: shell
|
|
98
|
+
|
|
99
|
+
- type: checkboxes
|
|
100
|
+
id: checks
|
|
101
|
+
attributes:
|
|
102
|
+
label: Checklist
|
|
103
|
+
options:
|
|
104
|
+
- label: I searched existing issues and discussions for this problem.
|
|
105
|
+
required: true
|
|
106
|
+
- label: I reproduced this on the latest SpotAPI release, or explained why I could not.
|
|
107
|
+
required: true
|
|
108
|
+
- label: I removed all credentials and private account data.
|
|
109
|
+
required: true
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
blank_issues_enabled: false
|
|
2
|
+
contact_links:
|
|
3
|
+
- name: Questions and project ideas
|
|
4
|
+
url: https://github.com/Aran404/SpotAPI/discussions
|
|
5
|
+
about: Ask for help, share what you built, or discuss an idea before proposing an API change.
|
|
6
|
+
- name: Documentation
|
|
7
|
+
url: https://spotapi.readthedocs.io/
|
|
8
|
+
about: Read the quickstart, guides, migration notes, and Python API reference.
|
|
9
|
+
- name: Security vulnerability
|
|
10
|
+
url: https://github.com/Aran404/SpotAPI/security/policy
|
|
11
|
+
about: Follow the private reporting instructions instead of opening a public issue.
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
name: Feature request
|
|
2
|
+
description: Propose a focused workflow or API improvement for SpotAPI.
|
|
3
|
+
title: "[Feature]: "
|
|
4
|
+
labels: ["enhancement"]
|
|
5
|
+
body:
|
|
6
|
+
- type: markdown
|
|
7
|
+
attributes:
|
|
8
|
+
value: |
|
|
9
|
+
Start with the user problem. New surface area must earn its complexity and should reuse existing typed APIs where possible.
|
|
10
|
+
|
|
11
|
+
- type: textarea
|
|
12
|
+
id: problem
|
|
13
|
+
attributes:
|
|
14
|
+
label: What problem would this solve?
|
|
15
|
+
description: Describe the workflow that is difficult or impossible today.
|
|
16
|
+
validations:
|
|
17
|
+
required: true
|
|
18
|
+
|
|
19
|
+
- type: textarea
|
|
20
|
+
id: proposal
|
|
21
|
+
attributes:
|
|
22
|
+
label: Proposed behavior
|
|
23
|
+
description: Show the command or Python API you would expect to use.
|
|
24
|
+
validations:
|
|
25
|
+
required: true
|
|
26
|
+
|
|
27
|
+
- type: dropdown
|
|
28
|
+
id: area
|
|
29
|
+
attributes:
|
|
30
|
+
label: Area
|
|
31
|
+
options:
|
|
32
|
+
- Public catalogue
|
|
33
|
+
- Account or library
|
|
34
|
+
- Playlists
|
|
35
|
+
- Player or live events
|
|
36
|
+
- Command-line interface
|
|
37
|
+
- Discover terminal UI
|
|
38
|
+
- Studio
|
|
39
|
+
- Documentation or examples
|
|
40
|
+
- Other
|
|
41
|
+
validations:
|
|
42
|
+
required: true
|
|
43
|
+
|
|
44
|
+
- type: textarea
|
|
45
|
+
id: alternatives
|
|
46
|
+
attributes:
|
|
47
|
+
label: Alternatives considered
|
|
48
|
+
description: Explain existing SpotAPI methods or external tools you tried.
|
|
49
|
+
|
|
50
|
+
- type: textarea
|
|
51
|
+
id: scope
|
|
52
|
+
attributes:
|
|
53
|
+
label: Scope and tradeoffs
|
|
54
|
+
description: Note authentication, Premium, platform, dependency, or unofficial-endpoint requirements.
|
|
55
|
+
|
|
56
|
+
- type: checkboxes
|
|
57
|
+
id: checks
|
|
58
|
+
attributes:
|
|
59
|
+
label: Checklist
|
|
60
|
+
options:
|
|
61
|
+
- label: I searched existing issues and discussions for this request.
|
|
62
|
+
required: true
|
|
63
|
+
- label: This request describes a user workflow, not only an endpoint or feature count.
|
|
64
|
+
required: true
|
|
65
|
+
- label: I understand Spotify may not expose or permit every requested operation.
|
|
66
|
+
required: true
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
## Summary
|
|
2
|
+
|
|
3
|
+
<!-- What changed? Keep this concrete. -->
|
|
4
|
+
|
|
5
|
+
## Why
|
|
6
|
+
|
|
7
|
+
<!-- Link the issue and explain the user-visible outcome. -->
|
|
8
|
+
|
|
9
|
+
Closes #
|
|
10
|
+
|
|
11
|
+
## Verification
|
|
12
|
+
|
|
13
|
+
<!-- List the commands or manual checks you ran. -->
|
|
14
|
+
|
|
15
|
+
- [ ] Tests cover the changed behavior, or the reason they do not is explained above.
|
|
16
|
+
- [ ] `python -m pytest -q`
|
|
17
|
+
- [ ] `python -m pyright`
|
|
18
|
+
- [ ] `python -m ruff check .`
|
|
19
|
+
- [ ] `python -m black --check .`
|
|
20
|
+
- [ ] Public behavior changes include concise documentation or changelog updates.
|
|
21
|
+
- [ ] No credentials, cookies, access tokens, or private account data are included.
|
|
22
|
+
|
|
23
|
+
## Contract and lifecycle notes
|
|
24
|
+
|
|
25
|
+
<!-- For network, authentication, player, or background-task changes: describe retries, ownership, cancellation, cleanup, and mutation safety. Delete this section when it is not relevant. -->
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
name: Documentation
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
workflow_dispatch:
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
build:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
steps:
|
|
13
|
+
- uses: actions/checkout@v4
|
|
14
|
+
- uses: actions/setup-python@v5
|
|
15
|
+
with:
|
|
16
|
+
python-version: "3.12"
|
|
17
|
+
- run: python -m pip install -r requirements-docs.txt
|
|
18
|
+
- run: python -m mkdocs build --strict
|
|
19
|
+
- uses: actions/upload-artifact@v4
|
|
20
|
+
with:
|
|
21
|
+
name: documentation-site
|
|
22
|
+
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,119 @@
|
|
|
1
|
+
name: Spotify API checks
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
schedule:
|
|
8
|
+
- cron: "17 8 * * *" # Daily contract check; reports upstream breaking changes
|
|
9
|
+
workflow_dispatch:
|
|
10
|
+
|
|
11
|
+
jobs:
|
|
12
|
+
offline:
|
|
13
|
+
runs-on: ${{ matrix.os }}
|
|
14
|
+
timeout-minutes: 15
|
|
15
|
+
strategy:
|
|
16
|
+
fail-fast: false
|
|
17
|
+
matrix:
|
|
18
|
+
os: [ubuntu-latest]
|
|
19
|
+
python: ["3.11", "3.12", "3.13"]
|
|
20
|
+
include:
|
|
21
|
+
- os: windows-latest
|
|
22
|
+
python: "3.12"
|
|
23
|
+
- os: macos-latest
|
|
24
|
+
python: "3.12"
|
|
25
|
+
steps:
|
|
26
|
+
- uses: actions/checkout@v4
|
|
27
|
+
- uses: actions/setup-python@v5
|
|
28
|
+
with:
|
|
29
|
+
python-version: ${{ matrix.python }}
|
|
30
|
+
- run: python -m pip install -e '.[dev,demo]'
|
|
31
|
+
- run: python -m coverage run -m pytest -m 'not live'
|
|
32
|
+
- run: python -m coverage report
|
|
33
|
+
- run: python -m coverage xml
|
|
34
|
+
- uses: actions/upload-artifact@v4
|
|
35
|
+
with:
|
|
36
|
+
name: coverage-${{ matrix.os }}-python-${{ matrix.python }}
|
|
37
|
+
path: coverage.xml
|
|
38
|
+
- run: python -m pyright
|
|
39
|
+
- run: python -m ruff check .
|
|
40
|
+
- run: python -m black --check --diff .
|
|
41
|
+
|
|
42
|
+
installed-wheel:
|
|
43
|
+
runs-on: ${{ matrix.os }}
|
|
44
|
+
timeout-minutes: 10
|
|
45
|
+
strategy:
|
|
46
|
+
fail-fast: false
|
|
47
|
+
matrix:
|
|
48
|
+
os: [ubuntu-latest, windows-latest, macos-latest]
|
|
49
|
+
steps:
|
|
50
|
+
- uses: actions/checkout@v4
|
|
51
|
+
- uses: actions/setup-python@v5
|
|
52
|
+
with:
|
|
53
|
+
python-version: "3.12"
|
|
54
|
+
- run: python -m pip install build
|
|
55
|
+
- run: python -m build --wheel
|
|
56
|
+
- name: Install and smoke-test outside the checkout
|
|
57
|
+
shell: pwsh
|
|
58
|
+
run: |
|
|
59
|
+
$wheel = (Get-ChildItem dist/*.whl).FullName
|
|
60
|
+
python -m pip install "$($wheel)[connect]"
|
|
61
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
62
|
+
Set-Location $env:RUNNER_TEMP
|
|
63
|
+
spotapi --version
|
|
64
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
65
|
+
python -I -m spotapi --version
|
|
66
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
67
|
+
python -I -m spotapi discover --help
|
|
68
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
69
|
+
python -I -m spotapi studio --help
|
|
70
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
71
|
+
python -I -m spotapi connect --help
|
|
72
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
73
|
+
python -I -c "import textual, keyring; from spotapi._connect.app import ConnectApp; assert ConnectApp"
|
|
74
|
+
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
|
|
75
|
+
python -I -c "from importlib.resources import files; root = files('spotapi'); assert root.joinpath('py.typed').is_file(); assert root.joinpath('_studio', 'app.js').is_file()"
|
|
76
|
+
|
|
77
|
+
public-api:
|
|
78
|
+
if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
|
|
79
|
+
runs-on: ubuntu-latest
|
|
80
|
+
timeout-minutes: 15
|
|
81
|
+
steps:
|
|
82
|
+
- uses: actions/checkout@v4
|
|
83
|
+
- uses: actions/setup-python@v5
|
|
84
|
+
with:
|
|
85
|
+
python-version: "3.12"
|
|
86
|
+
- run: python -m pip install -e '.[dev]'
|
|
87
|
+
- name: Verify public Spotify contracts
|
|
88
|
+
run: python -m pytest --live=read -m "live and not authenticated" -vv -rs
|
|
89
|
+
|
|
90
|
+
account-api:
|
|
91
|
+
if: github.event_name == 'workflow_dispatch' && github.repository == 'Aran404/SpotAPI'
|
|
92
|
+
runs-on: ubuntu-latest
|
|
93
|
+
timeout-minutes: 15
|
|
94
|
+
steps:
|
|
95
|
+
- uses: actions/checkout@v4
|
|
96
|
+
- uses: actions/setup-python@v5
|
|
97
|
+
with:
|
|
98
|
+
python-version: "3.12"
|
|
99
|
+
- run: python -m pip install -e '.[dev]'
|
|
100
|
+
- name: Verify authenticated read contracts
|
|
101
|
+
env:
|
|
102
|
+
SPOTIFY_COOKIE: ${{ secrets.SPOTIFY_CANARY_COOKIE }}
|
|
103
|
+
run: |
|
|
104
|
+
if [ -z "$SPOTIFY_COOKIE" ]; then
|
|
105
|
+
echo "::notice::Authenticated canary skipped because SPOTIFY_CANARY_COOKIE is not configured."
|
|
106
|
+
exit 0
|
|
107
|
+
fi
|
|
108
|
+
python -m pytest --live=read -m "live and authenticated and not mutates" -vv -rs
|
|
109
|
+
|
|
110
|
+
studio-ui:
|
|
111
|
+
runs-on: ubuntu-latest
|
|
112
|
+
steps:
|
|
113
|
+
- uses: actions/checkout@v4
|
|
114
|
+
- uses: actions/setup-python@v5
|
|
115
|
+
with:
|
|
116
|
+
python-version: "3.12"
|
|
117
|
+
- run: python -m pip install -e '.[dev]'
|
|
118
|
+
- run: python -m playwright install --with-deps chromium
|
|
119
|
+
- run: python -m pytest tests/test_studio.py tests/test_studio_browser.py -q
|
|
@@ -163,4 +163,32 @@ cython_debug/
|
|
|
163
163
|
#.idea/
|
|
164
164
|
main.py
|
|
165
165
|
build.bat
|
|
166
|
-
sessions.json
|
|
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,159 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 2.1.1 - Pending release
|
|
4
|
+
|
|
5
|
+
- Add the installable `connect` optional extra and verify its installed wheel
|
|
6
|
+
on Linux, Windows and macOS; clarify browser sign-in requirements (#94).
|
|
7
|
+
- Add a bounded, streaming, offline-tested public playlist CSV auditor (#95).
|
|
8
|
+
- Improve the README's first Python example and make the Studio screenshot
|
|
9
|
+
lightweight; retain the lyrics animation as an optional link.
|
|
10
|
+
- Fix outdated quickstart/release documentation and avoid duplicate CI runs
|
|
11
|
+
when a feature branch has an open pull request.
|
|
12
|
+
|
|
13
|
+
- Add `Player.current_track_details()` for explicit current-track metadata.
|
|
14
|
+
- Reconnect after transient grouped cleanup failures and report `disconnect`
|
|
15
|
+
on broken dealer connections.
|
|
16
|
+
- Raise `LoginExpired` for missing or rejected Spotify cookie sessions.
|
|
17
|
+
- Emit `library_change` for server collection notifications, including changes
|
|
18
|
+
from other clients, with local/server echoes deduplicated.
|
|
19
|
+
- Add opt-in MCP playback and like tools through `--allow-player`.
|
|
20
|
+
- Preserve authentication failures when cleanup also fails, and keep permanent
|
|
21
|
+
connection failures visible alongside transient cleanup errors.
|
|
22
|
+
- Prevent late like confirmations from overriding newer collection events.
|
|
23
|
+
- Expose public search locale selection through CLI `--language` (#88).
|
|
24
|
+
|
|
25
|
+
- Send Connect commands from the registered controller to the selected player.
|
|
26
|
+
This fixes accepted commands that left playback unchanged and then timed out
|
|
27
|
+
when the active player was also used as the command source (#91).
|
|
28
|
+
|
|
29
|
+
## 2.1.0 - 2026-11-13
|
|
30
|
+
|
|
31
|
+
Engineering notes: [I wrote a Python library at 16. Here are 5 things I'd fix
|
|
32
|
+
in the async rewrite](https://dev.to/aran404/i-wrote-a-python-library-at-16-here-are-5-things-id-fix-in-the-async-rewrite-4p62).
|
|
33
|
+
|
|
34
|
+
### Added
|
|
35
|
+
|
|
36
|
+
- Launch the packaged desktop application with `spotapi studio` after installing
|
|
37
|
+
`spotapi[studio]`; its frontend and icons ship in the wheel.
|
|
38
|
+
- Keep first results and sign-in visible in Studio's minimum-size window,
|
|
39
|
+
with independently scrollable navigation.
|
|
40
|
+
- Launch the packaged terminal browser with `spotapi discover` and the demo extra.
|
|
41
|
+
- Read artist Discovered On playlists, concerts, similar albums and image palettes.
|
|
42
|
+
- Read typed podcast captions, explicit embed snapshots and public media assets.
|
|
43
|
+
- Export JSON-safe models, collect ordered partial-failure batches, optionally
|
|
44
|
+
cache anonymous responses and reuse the async core from `SyncCatalogue`.
|
|
45
|
+
- Optional browser login, OS-keyring sessions and read-only MCP integration.
|
|
46
|
+
- Read the Docs configuration, generated API reference and a Spotipy migration guide.
|
|
47
|
+
|
|
48
|
+
### Changed
|
|
49
|
+
|
|
50
|
+
- Discover the main and search-route bundles first, loading other routes on demand
|
|
51
|
+
with eight continuously scheduled workers and build-specific hash caching.
|
|
52
|
+
- Managed account scopes accept explicit proxy and language options.
|
|
53
|
+
- Keep sponsorship placements below usage material, with optional integration
|
|
54
|
+
partnerships and privately quoted scope.
|
|
55
|
+
- Report the installed distribution with `spotapi --version` so executable and
|
|
56
|
+
package mismatches are immediately visible.
|
|
57
|
+
- Require `wreq` 0.12.3 or newer within the compatible 0.12 release line for
|
|
58
|
+
corrected coroutine cancellation; 0.13 remains excluded because it changes
|
|
59
|
+
binary response types.
|
|
60
|
+
|
|
61
|
+
### Fixed
|
|
62
|
+
|
|
63
|
+
- Replace the migration page's intermediate-branch internals with verified
|
|
64
|
+
`spotapi==1.2.8` examples, feature differences and removed-workflow boundaries.
|
|
65
|
+
- Dealer disconnects wake command waiters and clear readiness; temporary device
|
|
66
|
+
loss no longer discards a valid late ACK. Quiet dealers allow one snapshot
|
|
67
|
+
refresh within the existing deadline; old snapshots cannot prove success.
|
|
68
|
+
- Playback restoration preserves its original target and primary error, and
|
|
69
|
+
does not confirm a seek that failed. Commands are never silently replayed.
|
|
70
|
+
- Failed route downloads can be retried rather than becoming permanent misses.
|
|
71
|
+
- Anonymous embed fallback preserves proxies and cannot downgrade borrowed scopes.
|
|
72
|
+
- Sync shutdown rejects nested event loops before losing resource ownership.
|
|
73
|
+
- Discover releases cached images when feed shutdown fails, and Escape/Down
|
|
74
|
+
return keyboard focus from search to results.
|
|
75
|
+
|
|
76
|
+
## 2.0.0
|
|
77
|
+
|
|
78
|
+
- Use `spotapi` for all async imports. The synchronous release remains available as `spotapi==1.2.8`.
|
|
79
|
+
- Install the `spotapi` command for anonymous track search and JSON resource lookups.
|
|
80
|
+
- Open a managed account session with `Private.from_cookies()`.
|
|
81
|
+
- Follow, unfollow and check artists by ID, URI or URL through `account.library`.
|
|
82
|
+
- Fetch multiple tracks, albums or artists through one catalogue client.
|
|
83
|
+
- Move exact playlist occurrences by UID, including duplicate tracks.
|
|
84
|
+
- Set or clear a custom JPEG playlist cover.
|
|
85
|
+
- Stream typed audiobook chapter pages for available titles.
|
|
86
|
+
- Browse Studio lyrics through LRCLIB and seek from timed lines on the matching track.
|
|
87
|
+
|
|
88
|
+
### Added
|
|
89
|
+
|
|
90
|
+
- Typed async catalogue search, lookups, credits, discovery and lazy pagination.
|
|
91
|
+
- `Public` for self-cleaning one-shot calls and `Catalogue` for connection reuse.
|
|
92
|
+
- Cookie-authenticated account, library, rankings, profiles and notifications.
|
|
93
|
+
- Existing-player controls, async listeners, occurrence-aware queue editing,
|
|
94
|
+
sleep timers and entitled lyrics.
|
|
95
|
+
- Playlist metadata editing and removal by exact occurrence UID.
|
|
96
|
+
- A provider-neutral async CAPTCHA protocol for explicit account operations.
|
|
97
|
+
- Optional Studio and terminal examples; their dependencies stay outside the core.
|
|
98
|
+
- Offline lifecycle and contract tests, opt-in live checks, and release workflows.
|
|
99
|
+
|
|
100
|
+
### Changed
|
|
101
|
+
|
|
102
|
+
- Authenticated feature requests use `authorized=True`; credential assembly,
|
|
103
|
+
renewal, destination validation and redirect policy live in `AsyncClient`.
|
|
104
|
+
- Identical artwork color and contrast-role shapes share `RGBA` and
|
|
105
|
+
`ContrastPalette` value types instead of nine duplicate dataclasses.
|
|
106
|
+
- Result types live in the `models` package, grouped by domain; importing them
|
|
107
|
+
does not load the native HTTP transport. Old implementation paths were removed.
|
|
108
|
+
- Internal endpoint templates, protobuf, bundle parsing and TOTP helpers live
|
|
109
|
+
in `_protocol`; repeated resource paths share one escaping implementation.
|
|
110
|
+
|
|
111
|
+
- Advanced searches use immutable `SearchOptions` with snake_case fields and
|
|
112
|
+
`options=`; native GraphQL variable names remain internal to serialization.
|
|
113
|
+
- Direct transport access is `client.transport` and `client.websocket`.
|
|
114
|
+
- Authenticated profile attributes expose Python field names; see the migration guide.
|
|
115
|
+
|
|
116
|
+
- Python 3.11+ and async/await are required. See [migration](MIGRATION.md) for
|
|
117
|
+
compatibility changes and v1 features that have not been ported.
|
|
118
|
+
- Hatch and `pyproject.toml` define package metadata; `requirements.txt` retains
|
|
119
|
+
the same tested transport pin.
|
|
120
|
+
- Known reads opt into bounded retries. Mutations are not replayed after
|
|
121
|
+
ambiguous failures; account CSRF rotation is handled explicitly.
|
|
122
|
+
- Query hashes use a build-bound disk cache. Cached startup fetches the main
|
|
123
|
+
bundle rather than every chunk, and discards unneeded source after parsing.
|
|
124
|
+
- Clients own refresh, socket and callback tasks and release them on shutdown.
|
|
125
|
+
- Logging defaults to the standard library without configuring application sinks.
|
|
126
|
+
|
|
127
|
+
### Fixed
|
|
128
|
+
|
|
129
|
+
- Directly constructed authentication sessions attach to their owning client,
|
|
130
|
+
so safe request renewal and shutdown behave consistently across factories.
|
|
131
|
+
- `max_attempts=1` also prevents a second request after an authorization failure.
|
|
132
|
+
- HEAD, 204 and 205 responses may be empty even with a JSON Content-Type.
|
|
133
|
+
- Accepted cleanup statuses use `expected_statuses`, preserving normal
|
|
134
|
+
authorization handling without duplicating status checks in features.
|
|
135
|
+
|
|
136
|
+
- Thread-local implicit query owners no longer share a slotted registry across threads.
|
|
137
|
+
- Managed authorization rebuilds fresh credential headers after renewal; custom header names and JSON media types are case-insensitive.
|
|
138
|
+
- The model decoder recognizes native GraphQL `__typename` fields consistently with search preflight.
|
|
139
|
+
- Profile options, profile attributes and notification identities/cursors reject malformed contracts.
|
|
140
|
+
- Exception logging respects the configured severity filter and synchronization.
|
|
141
|
+
|
|
142
|
+
- Playlist add/remove operations reject error unions such as `NotFound` instead
|
|
143
|
+
of interpreting a nonempty error object as success.
|
|
144
|
+
- Commands with `wait=True` require a matching dealer ACK or a fresh state proving
|
|
145
|
+
the result, even when the HTTP response contains no acknowledgement ID.
|
|
146
|
+
- Studio cancels timed-out sign-ins, prevents concurrent cookie imports, and
|
|
147
|
+
discards delayed data from the previous account.
|
|
148
|
+
- Library saves, pins and user follows validate Spotify's confirmation instead
|
|
149
|
+
of accepting nonempty error responses or incomplete mutation results.
|
|
150
|
+
- Playback restrictions, canonical playlist metadata reads, and optional model
|
|
151
|
+
fields are handled explicitly.
|
|
152
|
+
|
|
153
|
+
See the [release checks](docs/release-checks.md) and [player coverage](docs/player-coverage.md)
|
|
154
|
+
for supported workflows and known gaps.
|
|
155
|
+
|
|
156
|
+
## v1 history
|
|
157
|
+
|
|
158
|
+
See the [repository history](https://github.com/Aran404/SpotAPI/commits/main/)
|
|
159
|
+
for changes predating the rewrite.
|