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.
Files changed (367) hide show
  1. spotapi-2.1.1/.dockerignore +9 -0
  2. spotapi-2.1.1/.env.example +4 -0
  3. spotapi-2.1.1/.github/ISSUE_TEMPLATE/bug.yml +109 -0
  4. spotapi-2.1.1/.github/ISSUE_TEMPLATE/config.yml +11 -0
  5. spotapi-2.1.1/.github/ISSUE_TEMPLATE/feature.yml +66 -0
  6. spotapi-2.1.1/.github/pull_request_template.md +25 -0
  7. spotapi-2.1.1/.github/workflows/docs.yml +22 -0
  8. spotapi-2.1.1/.github/workflows/publish.yml +74 -0
  9. spotapi-2.1.1/.github/workflows/spotify-public.yml +119 -0
  10. {spotapi-2.0.0b2 → spotapi-2.1.1}/.gitignore +29 -1
  11. spotapi-2.1.1/.readthedocs.yaml +14 -0
  12. spotapi-2.1.1/CHANGELOG.md +159 -0
  13. spotapi-2.1.1/CONTRIBUTING.md +80 -0
  14. spotapi-2.1.1/Dockerfile.mcp +8 -0
  15. spotapi-2.1.1/LEGAL_NOTICE.md +36 -0
  16. spotapi-2.1.1/MIGRATION.md +197 -0
  17. {spotapi-2.0.0b2 → spotapi-2.1.1}/PKG-INFO +149 -176
  18. spotapi-2.1.1/README.es.md +189 -0
  19. spotapi-2.1.1/README.fr.md +189 -0
  20. spotapi-2.1.1/README.md +189 -0
  21. spotapi-2.1.1/README.pt-BR.md +189 -0
  22. spotapi-2.1.1/SECURITY.md +25 -0
  23. spotapi-2.1.1/SPONSORSHIP.md +75 -0
  24. spotapi-2.1.1/assets/README.md +13 -0
  25. spotapi-2.1.1/assets/cli-connect-demo.gif +0 -0
  26. spotapi-2.1.1/assets/cli-demo.gif +0 -0
  27. spotapi-2.1.1/assets/logo-inverse.svg +38 -0
  28. spotapi-2.1.1/assets/logo-mono.svg +38 -0
  29. spotapi-2.1.1/assets/lyrics-sync-demo.gif +0 -0
  30. spotapi-2.1.1/assets/social-preview.png +0 -0
  31. spotapi-2.1.1/assets/spotapi-color.svg +48 -0
  32. spotapi-2.1.1/assets/spotapi-inverse.svg +48 -0
  33. spotapi-2.1.1/assets/spotapi-mono.svg +48 -0
  34. spotapi-2.1.1/assets/spotapi-reversed.svg +48 -0
  35. spotapi-2.1.1/assets/studio-demo.gif +0 -0
  36. spotapi-2.1.1/benchmarks/review.py +408 -0
  37. spotapi-2.1.1/docs/account.md +119 -0
  38. spotapi-2.1.1/docs/api-layout.md +75 -0
  39. spotapi-2.1.1/docs/catalogue.md +93 -0
  40. spotapi-2.1.1/docs/connect.md +163 -0
  41. spotapi-2.1.1/docs/discovery.md +245 -0
  42. spotapi-2.1.1/docs/from-spotipy.md +84 -0
  43. spotapi-2.1.1/docs/index.md +73 -0
  44. spotapi-2.1.1/docs/player-coverage.md +54 -0
  45. spotapi-2.1.1/docs/player.md +205 -0
  46. spotapi-2.1.1/docs/quickstart.md +143 -0
  47. spotapi-2.1.1/docs/reference.md +79 -0
  48. spotapi-2.1.1/docs/release-checks.md +78 -0
  49. spotapi-2.1.1/docs/studio.md +76 -0
  50. spotapi-2.1.1/docs/stylesheets/extra.css +7 -0
  51. spotapi-2.1.1/docs/transport.md +93 -0
  52. spotapi-2.1.1/docs/troubleshooting.md +78 -0
  53. spotapi-2.1.1/examples/README.md +43 -0
  54. spotapi-2.1.1/examples/__init__.py +1 -0
  55. spotapi-2.1.1/examples/credit_trail.py +48 -0
  56. spotapi-2.1.1/examples/credits.py +16 -0
  57. spotapi-2.1.1/examples/custom_transport.py +17 -0
  58. spotapi-2.1.1/examples/discover.py +8 -0
  59. spotapi-2.1.1/examples/export.py +16 -0
  60. spotapi-2.1.1/examples/lookup.py +17 -0
  61. spotapi-2.1.1/examples/lyrics.py +21 -0
  62. spotapi-2.1.1/examples/mix_map.py +66 -0
  63. spotapi-2.1.1/examples/overlap.py +31 -0
  64. spotapi-2.1.1/examples/pagination.py +23 -0
  65. spotapi-2.1.1/examples/player.py +35 -0
  66. spotapi-2.1.1/examples/playlist_audit.py +178 -0
  67. spotapi-2.1.1/examples/playlist_crate.py +31 -0
  68. spotapi-2.1.1/examples/public_search.py +29 -0
  69. spotapi-2.1.1/examples/quickstart.py +16 -0
  70. spotapi-2.1.1/examples/skip_next.py +17 -0
  71. spotapi-2.1.1/examples/studio/__init__.py +1 -0
  72. spotapi-2.1.1/examples/studio/__main__.py +5 -0
  73. spotapi-2.1.1/examples/studio/preview.png +0 -0
  74. spotapi-2.1.1/examples/taste.py +29 -0
  75. spotapi-2.1.1/examples/taste_lab/README.md +196 -0
  76. spotapi-2.1.1/examples/taste_lab/VALIDATION.md +82 -0
  77. spotapi-2.1.1/examples/taste_lab/__init__.py +1 -0
  78. spotapi-2.1.1/examples/taste_lab/__main__.py +309 -0
  79. spotapi-2.1.1/examples/taste_lab/audio.py +142 -0
  80. spotapi-2.1.1/examples/taste_lab/engine.py +310 -0
  81. spotapi-2.1.1/examples/taste_lab/evaluate.py +98 -0
  82. spotapi-2.1.1/examples/taste_lab/extract.py +124 -0
  83. spotapi-2.1.1/examples/taste_lab/models.py +83 -0
  84. spotapi-2.1.1/examples/taste_lab/observe.py +88 -0
  85. spotapi-2.1.1/examples/taste_lab/requirements-audio.txt +7 -0
  86. spotapi-2.1.1/examples/taste_lab/smoke_audio.py +65 -0
  87. spotapi-2.1.1/examples/taste_lab/spotify.py +256 -0
  88. spotapi-2.1.1/examples/taste_lab/store.py +205 -0
  89. spotapi-2.1.1/examples/taste_lab/youtube.py +312 -0
  90. spotapi-2.1.1/mkdocs.yml +83 -0
  91. spotapi-2.1.1/pyproject.toml +132 -0
  92. spotapi-2.1.1/requirements-docs.txt +4 -0
  93. spotapi-2.1.1/requirements.txt +1 -0
  94. spotapi-2.1.1/spotapi/__init__.py +143 -0
  95. spotapi-2.1.1/spotapi/__main__.py +6 -0
  96. spotapi-2.1.1/spotapi/_connect/__init__.py +1 -0
  97. spotapi-2.1.1/spotapi/_connect/app.py +838 -0
  98. spotapi-2.1.1/spotapi/_connect/auth.py +28 -0
  99. spotapi-2.1.1/spotapi/_connect/commands.py +127 -0
  100. spotapi-2.1.1/spotapi/_connect/presentation.py +101 -0
  101. spotapi-2.1.1/spotapi/_connect/queue.py +62 -0
  102. spotapi-2.1.1/spotapi/_connect/session.py +144 -0
  103. spotapi-2.1.1/spotapi/_connect/style.tcss +290 -0
  104. spotapi-2.1.1/spotapi/_connect/suggestions.py +51 -0
  105. spotapi-2.1.1/spotapi/_decoding.py +221 -0
  106. spotapi-2.1.1/spotapi/_demo/__init__.py +1 -0
  107. spotapi-2.1.1/spotapi/_demo/details.py +323 -0
  108. spotapi-2.1.1/spotapi/_demo/discover.py +780 -0
  109. spotapi-2.1.1/spotapi/_parsing.py +40 -0
  110. spotapi-2.1.1/spotapi/_protocol/__init__.py +1 -0
  111. spotapi-2.1.1/spotapi/_protocol/bundles.py +69 -0
  112. spotapi-2.1.1/spotapi/_protocol/collection.py +56 -0
  113. spotapi-2.1.1/spotapi/_protocol/embeds.py +46 -0
  114. spotapi-2.1.1/spotapi/_protocol/protobuf.py +120 -0
  115. spotapi-2.1.1/spotapi/_protocol/routes.py +66 -0
  116. spotapi-2.1.1/spotapi/_protocol/totp.py +81 -0
  117. spotapi-2.1.1/spotapi/_protocol/user_agent.py +231 -0
  118. spotapi-2.1.1/spotapi/_studio/__init__.py +1 -0
  119. spotapi-2.1.1/spotapi/_studio/actions.py +110 -0
  120. spotapi-2.1.1/spotapi/_studio/app.js +1195 -0
  121. spotapi-2.1.1/spotapi/_studio/assets/logo.ico +0 -0
  122. spotapi-2.1.1/spotapi/_studio/assets/logo.png +0 -0
  123. spotapi-2.1.1/spotapi/_studio/assets/logo.svg +48 -0
  124. spotapi-2.1.1/spotapi/_studio/desktop.py +239 -0
  125. spotapi-2.1.1/spotapi/_studio/index.html +325 -0
  126. spotapi-2.1.1/spotapi/_studio/lyrics.py +91 -0
  127. spotapi-2.1.1/spotapi/_studio/service.py +631 -0
  128. spotapi-2.1.1/spotapi/_studio/style.css +1371 -0
  129. spotapi-2.1.1/spotapi/account.py +280 -0
  130. spotapi-2.1.1/spotapi/account_session.py +152 -0
  131. spotapi-2.1.1/spotapi/batch.py +52 -0
  132. spotapi-2.1.1/spotapi/blend.py +70 -0
  133. spotapi-2.1.1/spotapi/cache.py +173 -0
  134. spotapi-2.1.1/spotapi/captcha.py +42 -0
  135. spotapi-2.1.1/spotapi/catalogue.py +1514 -0
  136. spotapi-2.1.1/spotapi/charts.py +22 -0
  137. spotapi-2.1.1/spotapi/cli.py +571 -0
  138. spotapi-2.1.1/spotapi/client.py +641 -0
  139. spotapi-2.1.1/spotapi/command_state.py +87 -0
  140. spotapi-2.1.1/spotapi/connect.py +55 -0
  141. spotapi-2.1.1/spotapi/connection/__init__.py +12 -0
  142. spotapi-2.1.1/spotapi/connection/client.py +8 -0
  143. spotapi-2.1.1/spotapi/connection/http.py +744 -0
  144. spotapi-2.1.1/spotapi/connection/types.py +83 -0
  145. spotapi-2.1.1/spotapi/connection/websocket.py +519 -0
  146. spotapi-2.1.1/spotapi/datastruct/__init__.py +7 -0
  147. spotapi-2.1.1/spotapi/datastruct/event_handler.py +173 -0
  148. spotapi-2.1.1/spotapi/datastruct/object_dict.py +196 -0
  149. spotapi-2.1.1/spotapi/datastruct/pool.py +235 -0
  150. spotapi-2.1.1/spotapi/devices.py +193 -0
  151. spotapi-2.1.1/spotapi/embeds.py +55 -0
  152. spotapi-2.1.1/spotapi/history.py +97 -0
  153. spotapi-2.1.1/spotapi/library.py +291 -0
  154. spotapi-2.1.1/spotapi/login.py +133 -0
  155. spotapi-2.1.1/spotapi/lyrics.py +75 -0
  156. spotapi-2.1.1/spotapi/mcp.py +254 -0
  157. spotapi-2.1.1/spotapi/media.py +165 -0
  158. spotapi-2.1.1/spotapi/models/__init__.py +118 -0
  159. spotapi-2.1.1/spotapi/models/account.py +122 -0
  160. spotapi-2.1.1/spotapi/models/batch.py +33 -0
  161. spotapi-2.1.1/spotapi/models/blend.py +42 -0
  162. spotapi-2.1.1/spotapi/models/catalogue/__init__.py +65 -0
  163. spotapi-2.1.1/spotapi/models/catalogue/album.py +71 -0
  164. spotapi-2.1.1/spotapi/models/catalogue/album_details.py +242 -0
  165. spotapi-2.1.1/spotapi/models/catalogue/artist.py +73 -0
  166. spotapi-2.1.1/spotapi/models/catalogue/artist_details.py +223 -0
  167. spotapi-2.1.1/spotapi/models/catalogue/common.py +95 -0
  168. spotapi-2.1.1/spotapi/models/catalogue/credits.py +39 -0
  169. spotapi-2.1.1/spotapi/models/catalogue/entities.py +194 -0
  170. spotapi-2.1.1/spotapi/models/catalogue/playlist.py +79 -0
  171. spotapi-2.1.1/spotapi/models/catalogue/playlist_details.py +52 -0
  172. spotapi-2.1.1/spotapi/models/catalogue/playlist_track.py +119 -0
  173. spotapi-2.1.1/spotapi/models/catalogue/podcast.py +55 -0
  174. spotapi-2.1.1/spotapi/models/catalogue/podcast_episode.py +136 -0
  175. spotapi-2.1.1/spotapi/models/catalogue/profile_attributes.py +35 -0
  176. spotapi-2.1.1/spotapi/models/catalogue/track.py +105 -0
  177. spotapi-2.1.1/spotapi/models/catalogue/track_details.py +206 -0
  178. spotapi-2.1.1/spotapi/models/discovery.py +213 -0
  179. spotapi-2.1.1/spotapi/models/embeds.py +44 -0
  180. spotapi-2.1.1/spotapi/models/history.py +76 -0
  181. spotapi-2.1.1/spotapi/models/library.py +148 -0
  182. spotapi-2.1.1/spotapi/models/lyrics.py +126 -0
  183. spotapi-2.1.1/spotapi/models/notifications.py +77 -0
  184. spotapi-2.1.1/spotapi/models/playback.py +292 -0
  185. spotapi-2.1.1/spotapi/models/profiles.py +20 -0
  186. spotapi-2.1.1/spotapi/models/search.py +91 -0
  187. spotapi-2.1.1/spotapi/models/sessions.py +11 -0
  188. spotapi-2.1.1/spotapi/models/stats.py +24 -0
  189. spotapi-2.1.1/spotapi/models/transcripts.py +64 -0
  190. spotapi-2.1.1/spotapi/notifications.py +88 -0
  191. spotapi-2.1.1/spotapi/operations.py +480 -0
  192. spotapi-2.1.1/spotapi/password.py +84 -0
  193. spotapi-2.1.1/spotapi/player.py +728 -0
  194. spotapi-2.1.1/spotapi/playlist.py +681 -0
  195. spotapi-2.1.1/spotapi/profiles.py +250 -0
  196. spotapi-2.1.1/spotapi/public.py +742 -0
  197. spotapi-2.1.1/spotapi/queries.py +409 -0
  198. spotapi-2.1.1/spotapi/query.py +637 -0
  199. spotapi-2.1.1/spotapi/resources.py +142 -0
  200. spotapi-2.1.1/spotapi/serialization.py +70 -0
  201. spotapi-2.1.1/spotapi/session.py +997 -0
  202. spotapi-2.1.1/spotapi/stats.py +108 -0
  203. spotapi-2.1.1/spotapi/status.py +845 -0
  204. spotapi-2.1.1/spotapi/sync.py +369 -0
  205. spotapi-2.1.1/spotapi/transcripts.py +37 -0
  206. spotapi-2.1.1/spotapi/types/__init__.py +46 -0
  207. spotapi-2.1.1/spotapi/types/exceptions.py +53 -0
  208. {spotapi-2.0.0b2/spotapi/v2 → spotapi-2.1.1/spotapi}/types/logger.py +254 -176
  209. spotapi-2.1.1/spotapi/utils/__init__.py +6 -0
  210. spotapi-2.1.1/spotapi/utils/cache.py +149 -0
  211. spotapi-2.1.1/spotapi/utils/random.py +28 -0
  212. spotapi-2.1.1/tests/README.md +29 -0
  213. spotapi-2.1.1/tests/conftest.py +39 -0
  214. spotapi-2.1.1/tests/fixtures/connect/message-1.json +100 -0
  215. spotapi-2.1.1/tests/fixtures/connect/message-2.json +382 -0
  216. spotapi-2.1.1/tests/fixtures/connect/message-3.json +393 -0
  217. spotapi-2.1.1/tests/fixtures/connect/message-4.json +146 -0
  218. spotapi-2.1.1/tests/test_account.py +276 -0
  219. spotapi-2.1.1/tests/test_account_content.py +461 -0
  220. spotapi-2.1.1/tests/test_artist_details_model.py +27 -0
  221. spotapi-2.1.1/tests/test_auth_recovery.py +315 -0
  222. spotapi-2.1.1/tests/test_authorized_requests.py +101 -0
  223. spotapi-2.1.1/tests/test_bundle_cache.py +209 -0
  224. spotapi-2.1.1/tests/test_catalogue_lifecycle.py +178 -0
  225. spotapi-2.1.1/tests/test_cli.py +207 -0
  226. spotapi-2.1.1/tests/test_connect_presentation.py +294 -0
  227. spotapi-2.1.1/tests/test_connect_terminal.py +341 -0
  228. spotapi-2.1.1/tests/test_data_contracts.py +228 -0
  229. spotapi-2.1.1/tests/test_discover_demo.py +246 -0
  230. spotapi-2.1.1/tests/test_discovery_parser.py +22 -0
  231. spotapi-2.1.1/tests/test_documentation_entrypoints.py +147 -0
  232. spotapi-2.1.1/tests/test_feature_parity.py +388 -0
  233. spotapi-2.1.1/tests/test_lifecycle.py +354 -0
  234. spotapi-2.1.1/tests/test_listening.py +167 -0
  235. spotapi-2.1.1/tests/test_live.py +103 -0
  236. spotapi-2.1.1/tests/test_live_account.py +39 -0
  237. spotapi-2.1.1/tests/test_live_catalogue.py +162 -0
  238. spotapi-2.1.1/tests/test_live_controls.py +199 -0
  239. spotapi-2.1.1/tests/test_live_discovery.py +35 -0
  240. spotapi-2.1.1/tests/test_live_player.py +38 -0
  241. spotapi-2.1.1/tests/test_live_playlists.py +124 -0
  242. spotapi-2.1.1/tests/test_live_studio.py +45 -0
  243. spotapi-2.1.1/tests/test_mutations.py +178 -0
  244. spotapi-2.1.1/tests/test_native_websocket.py +139 -0
  245. spotapi-2.1.1/tests/test_operations.py +74 -0
  246. spotapi-2.1.1/tests/test_optional_features.py +434 -0
  247. spotapi-2.1.1/tests/test_player.py +1304 -0
  248. spotapi-2.1.1/tests/test_playlist_audit_example.py +106 -0
  249. spotapi-2.1.1/tests/test_protobuf.py +35 -0
  250. spotapi-2.1.1/tests/test_public_api.py +627 -0
  251. spotapi-2.1.1/tests/test_public_catalogue.py +204 -0
  252. spotapi-2.1.1/tests/test_queries_parsing.py +160 -0
  253. spotapi-2.1.1/tests/test_review_regressions.py +174 -0
  254. spotapi-2.1.1/tests/test_routes.py +38 -0
  255. spotapi-2.1.1/tests/test_search_models.py +26 -0
  256. spotapi-2.1.1/tests/test_studio.py +306 -0
  257. spotapi-2.1.1/tests/test_studio_browser.py +449 -0
  258. spotapi-2.1.1/tests/test_taste_audio.py +133 -0
  259. spotapi-2.1.1/tests/test_taste_import.py +85 -0
  260. spotapi-2.1.1/tests/test_taste_lab.py +291 -0
  261. spotapi-2.1.1/tests/test_taste_sources.py +68 -0
  262. spotapi-2.1.1/tests/test_transport.py +295 -0
  263. spotapi-2.1.1/tests/test_user_agent.py +81 -0
  264. spotapi-2.1.1/tests/test_websocket_lifecycle.py +194 -0
  265. spotapi-2.0.0b2/CHANGELOG.md +0 -90
  266. spotapi-2.0.0b2/CONTRIBUTING.md +0 -247
  267. spotapi-2.0.0b2/LEGAL_NOTICE.md +0 -46
  268. spotapi-2.0.0b2/MIGRATION.md +0 -182
  269. spotapi-2.0.0b2/README.md +0 -239
  270. spotapi-2.0.0b2/docs/album.md +0 -59
  271. spotapi-2.0.0b2/docs/artist.md +0 -107
  272. spotapi-2.0.0b2/docs/creator.md +0 -56
  273. spotapi-2.0.0b2/docs/family.md +0 -62
  274. spotapi-2.0.0b2/docs/language.md +0 -90
  275. spotapi-2.0.0b2/docs/login.md +0 -103
  276. spotapi-2.0.0b2/docs/password.md +0 -38
  277. spotapi-2.0.0b2/docs/player.md +0 -183
  278. spotapi-2.0.0b2/docs/playlist.md +0 -179
  279. spotapi-2.0.0b2/docs/public.md +0 -143
  280. spotapi-2.0.0b2/docs/song.md +0 -126
  281. spotapi-2.0.0b2/docs/status.md +0 -148
  282. spotapi-2.0.0b2/docs/user.md +0 -67
  283. spotapi-2.0.0b2/docs/websocket.md +0 -29
  284. spotapi-2.0.0b2/example.py +0 -119
  285. spotapi-2.0.0b2/image.png +0 -0
  286. spotapi-2.0.0b2/pyproject.toml +0 -86
  287. spotapi-2.0.0b2/requirements.txt +0 -2
  288. spotapi-2.0.0b2/setup.py +0 -61
  289. spotapi-2.0.0b2/spotapi/sync/__init__.py +0 -25
  290. spotapi-2.0.0b2/spotapi/sync/_tests/.env.sample +0 -3
  291. spotapi-2.0.0b2/spotapi/sync/_tests/__init__.py +0 -1
  292. spotapi-2.0.0b2/spotapi/sync/_tests/annotations_test.py +0 -222
  293. spotapi-2.0.0b2/spotapi/sync/_tests/client_refresh_test.py +0 -224
  294. spotapi-2.0.0b2/spotapi/sync/_tests/features/artist_test.py +0 -196
  295. spotapi-2.0.0b2/spotapi/sync/_tests/features/event_test.py +0 -53
  296. spotapi-2.0.0b2/spotapi/sync/_tests/features/player_test.py +0 -112
  297. spotapi-2.0.0b2/spotapi/sync/_tests/features/private_playlist_test.py +0 -70
  298. spotapi-2.0.0b2/spotapi/sync/_tests/features/public_playlist_test.py +0 -32
  299. spotapi-2.0.0b2/spotapi/sync/_tests/features/session.py +0 -36
  300. spotapi-2.0.0b2/spotapi/sync/_tests/features/song_test.py +0 -67
  301. spotapi-2.0.0b2/spotapi/sync/_tests/features/status_test.py +0 -126
  302. spotapi-2.0.0b2/spotapi/sync/_tests/features/user_test.py +0 -63
  303. spotapi-2.0.0b2/spotapi/sync/album.py +0 -96
  304. spotapi-2.0.0b2/spotapi/sync/artist.py +0 -287
  305. spotapi-2.0.0b2/spotapi/sync/client.py +0 -314
  306. spotapi-2.0.0b2/spotapi/sync/creator.py +0 -203
  307. spotapi-2.0.0b2/spotapi/sync/exceptions/__init__.py +0 -1
  308. spotapi-2.0.0b2/spotapi/sync/exceptions/errors.py +0 -111
  309. spotapi-2.0.0b2/spotapi/sync/family.py +0 -162
  310. spotapi-2.0.0b2/spotapi/sync/http/__init__.py +0 -2
  311. spotapi-2.0.0b2/spotapi/sync/http/data.py +0 -43
  312. spotapi-2.0.0b2/spotapi/sync/http/request.py +0 -248
  313. spotapi-2.0.0b2/spotapi/sync/login.py +0 -356
  314. spotapi-2.0.0b2/spotapi/sync/password.py +0 -97
  315. spotapi-2.0.0b2/spotapi/sync/player.py +0 -348
  316. spotapi-2.0.0b2/spotapi/sync/playlist.py +0 -417
  317. spotapi-2.0.0b2/spotapi/sync/podcast.py +0 -129
  318. spotapi-2.0.0b2/spotapi/sync/public.py +0 -117
  319. spotapi-2.0.0b2/spotapi/sync/solvers/__init__.py +0 -15
  320. spotapi-2.0.0b2/spotapi/sync/solvers/capmonster.py +0 -145
  321. spotapi-2.0.0b2/spotapi/sync/solvers/capsolver.py +0 -144
  322. spotapi-2.0.0b2/spotapi/sync/song.py +0 -288
  323. spotapi-2.0.0b2/spotapi/sync/status.py +0 -226
  324. spotapi-2.0.0b2/spotapi/sync/types/__init__.py +0 -2
  325. spotapi-2.0.0b2/spotapi/sync/types/alias.py +0 -29
  326. spotapi-2.0.0b2/spotapi/sync/types/annotations.py +0 -201
  327. spotapi-2.0.0b2/spotapi/sync/types/data.py +0 -413
  328. spotapi-2.0.0b2/spotapi/sync/types/interfaces.py +0 -57
  329. spotapi-2.0.0b2/spotapi/sync/user.py +0 -128
  330. spotapi-2.0.0b2/spotapi/sync/utils/__init__.py +0 -3
  331. spotapi-2.0.0b2/spotapi/sync/utils/logger.py +0 -91
  332. spotapi-2.0.0b2/spotapi/sync/utils/saver.py +0 -357
  333. spotapi-2.0.0b2/spotapi/sync/utils/strings.py +0 -130
  334. spotapi-2.0.0b2/spotapi/sync/websocket.py +0 -167
  335. spotapi-2.0.0b2/spotapi/v2/__init__.py +0 -11
  336. spotapi-2.0.0b2/spotapi/v2/client.py +0 -101
  337. spotapi-2.0.0b2/spotapi/v2/connection/__init__.py +0 -12
  338. spotapi-2.0.0b2/spotapi/v2/connection/http.py +0 -288
  339. spotapi-2.0.0b2/spotapi/v2/connection/types.py +0 -76
  340. spotapi-2.0.0b2/spotapi/v2/connection/websocket.py +0 -199
  341. spotapi-2.0.0b2/spotapi/v2/datastruct/__init__.py +0 -9
  342. spotapi-2.0.0b2/spotapi/v2/datastruct/event_handler.py +0 -62
  343. spotapi-2.0.0b2/spotapi/v2/datastruct/object_dict.py +0 -176
  344. spotapi-2.0.0b2/spotapi/v2/datastruct/pool.py +0 -155
  345. spotapi-2.0.0b2/spotapi/v2/playlist.py +0 -225
  346. spotapi-2.0.0b2/spotapi/v2/public.py +0 -370
  347. spotapi-2.0.0b2/spotapi/v2/query.py +0 -117
  348. spotapi-2.0.0b2/spotapi/v2/session.py +0 -392
  349. spotapi-2.0.0b2/spotapi/v2/specialized/__init__.py +0 -3
  350. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/__init__.py +0 -165
  351. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/album.py +0 -93
  352. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/artist.py +0 -66
  353. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/common.py +0 -139
  354. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/playlist.py +0 -81
  355. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/podcast.py +0 -75
  356. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/profile_attributes.py +0 -29
  357. spotapi-2.0.0b2/spotapi/v2/specialized/data_wrappers/track.py +0 -113
  358. spotapi-2.0.0b2/spotapi/v2/specialized/totp.py +0 -66
  359. spotapi-2.0.0b2/spotapi/v2/types/__init__.py +0 -12
  360. spotapi-2.0.0b2/spotapi/v2/types/exceptions.py +0 -27
  361. spotapi-2.0.0b2/spotapi/v2/utils/__init__.py +0 -12
  362. spotapi-2.0.0b2/spotapi/v2/utils/cache.py +0 -62
  363. spotapi-2.0.0b2/spotapi/v2/utils/random.py +0 -22
  364. spotapi-2.0.0b2/spotapi/v2/utils/strings.py +0 -130
  365. {spotapi-2.0.0b2 → spotapi-2.1.1}/CODE_OF_CONDUCT.md +0 -0
  366. {spotapi-2.0.0b2 → spotapi-2.1.1}/LICENSE +0 -0
  367. {spotapi-2.0.0b2/spotapi/v2 → spotapi-2.1.1/spotapi}/py.typed +0 -0
@@ -0,0 +1,9 @@
1
+ *
2
+ !spotapi/
3
+ !spotapi/**
4
+ !pyproject.toml
5
+ !README.md
6
+ !LICENSE
7
+ !Dockerfile.mcp
8
+ spotapi/**/__pycache__/
9
+ spotapi/**/*.pyc
@@ -0,0 +1,4 @@
1
+ # Optional personal session. Never commit a real cookie.
2
+ SPOTIFY_COOKIE=""
3
+
4
+ # Live tests: pytest --live=read (reads), pytest --live=all (playback and temporary-playlist changes).
@@ -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,14 @@
1
+ version: 2
2
+
3
+ build:
4
+ os: ubuntu-24.04
5
+ tools:
6
+ python: "3.12"
7
+
8
+ mkdocs:
9
+ configuration: mkdocs.yml
10
+ fail_on_warning: true
11
+
12
+ python:
13
+ install:
14
+ - requirements: requirements-docs.txt
@@ -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.