MarshalX/yandex-music-api — reverse-engineered prompt

Build me an unofficial Python library for working with Yandex Music, aimed at people who want to script against the service without dealing with raw requests. It should support normal sync code and async code, work on modern Python, and expose simple high level objects so common tasks feel easy. I want to be able to sign in with an existing token, and also get a token through the Yandex device login flow. Don’t auto save or refresh tokens for me, just return the token data clearly so my code can store it.

The library should let me initialize a client, read things like tracks, albums, playlists, and liked songs, fetch full track info from lighter objects, and download tracks. Unauthenticated access can be limited, that is fine. Please include examples, basic docs, and tests, plus optional proxy support where it makes sense. Keep the API clean and Pythonic so it’s good for small scripts and bigger apps. If anything is unclear, look up the current docs online and fill in sensible gaps.