spotipy-dev/spotipy
Spotipy
Spotipy est une bibliothèque cliente Python pour interagir avec l'API Web de Spotify. Elle fournit une interface programmatique pour gérer les données musicales, les comptes utilisateurs et la lecture multimédia.
La bibliothèque implémente un client OAuth 2.0 complet capable de gérer les codes d'autorisation, les identifiants client et les flux implicites. Elle inclut un gestionnaire de jetons qui supporte le rafraîchissement automatique des jetons et des backends de cache enfichables pour maintenir des sessions avec état.
Le projet couvre la récupération et la recherche de métadonnées musicales, permettant de consulter des artistes, albums et pistes via des identifiants de ressources et des URI. Il fournit également des capacités pour la gestion de la file d'attente de lecture et la récupération de données privées de compte utilisateur.
Features
- Music Metadata Retrieval - Provides programmatic retrieval of detailed music metadata for tracks, artists, and albums.
- Spotify Client Libraries - Provides a comprehensive Python client library for interacting with the Spotify Web API.
- API Request Authentication - Verifies user identity and secures outgoing requests using OAuth 2.0 tokens.
- Authentication Management - Manages user identity verification and authentication lifecycles to secure API access.
- OAuth 2.0 Authorization Flows - Implements standard OAuth 2.0 flows including authorization codes, client credentials, and implicit grants for API access.
- Spotify OAuth Integrations - Implements Spotify-specific OAuth 2.0 integrations to securely access private user data.
- Multi-Grant Type Flows - Supports multiple OAuth 2.0 grant types, including authorization code and client credentials flows.
- User Profile Retrieval - Provides authenticated endpoints for fetching the current user's identity, profile, and saved library content.
- REST Clients - Provides a Pythonic wrapper that maps high-level methods to Spotify's REST API endpoints.
- Playback Queues - Enables adding specific media tracks to a user's active playback queue on a target device.
- Playback Queue Managers - Manages the runtime sequential playback ordering by adding songs to the active queue.
- Media Playback Controls - Controls media playback state and manages active playback queues on connected devices.
- Music Collection Organization - Enables gathering and organizing large sets of music metadata for processing in Python.
- Music Content Search - Allows searching for music-related entities like songs, albums, and artists via API queries.
- Automatic Token Refreshes - Implements automatic renewal of expired access tokens to maintain continuous API sessions.
- Client-to-Server Authentication - Supports client credentials flow for secure server-to-server authentication to public endpoints.
- Session State Management - Tracks authentication status and active tokens across requests to ensure session continuity.
- Token Lifecycle Management - Manages the full lifecycle of API tokens, including automated refreshing and storage.
- Authorization Code Flow Handlers - Implements the authorization code flow to obtain refreshable access tokens for user accounts.
- OAuth Token Management - Provides a dedicated system for managing the lifecycle and persistence of OAuth tokens.
- Authentication Token Caching - Provides pluggable caching for authentication tokens using local files or in-memory stores.
- Music Metadata Integration - Provides interfaces for retrieving and organizing music-specific metadata from Spotify's external database.
