|
|
# ----------------------------------------------------
|
|
|
# Simple MusicBrainz API wrapper
|
|
|
# ----------------------------------------------------
|
|
|
# 1. Install the musicbrainzngs package (pip install musicbrainzngs)
|
|
|
# 2. Run this script – it will show how to query the API
|
|
|
# ----------------------------------------------------
|
|
|
|
|
|
import musicbrainzngs
|
|
|
import time
|
|
|
|
|
|
# ----------------------------------------------------
|
|
|
# Configuration
|
|
|
# ----------------------------------------------------
|
|
|
musicbrainzngs.set_useragent(
|
|
|
name="getDiscography",
|
|
|
version="0.1",
|
|
|
contact="akros@voxelixia.com"
|
|
|
)
|
|
|
|
|
|
# ----------------------------------------------------
|
|
|
# Rate‑limit helper
|
|
|
# ----------------------------------------------------
|
|
|
# MusicBrainz allows 1 request per second for anonymous users.
|
|
|
# The wrapper below throttles requests to stay within the limit.
|
|
|
class RateLimitedClient:
|
|
|
def __init__(self, client, min_interval=1.0):
|
|
|
self.client = client
|
|
|
self.min_interval = min_interval
|
|
|
self.last_call = 0.0
|
|
|
|
|
|
def _wait(self):
|
|
|
elapsed = time.time() - self.last_call
|
|
|
if elapsed < self.min_interval:
|
|
|
time.sleep(self.min_interval - elapsed)
|
|
|
|
|
|
def get_artist(self, artist_id):
|
|
|
self._wait()
|
|
|
return self.client.get_artist_by_id(artist_id)
|
|
|
|
|
|
def search_artists(self, query, limit=10):
|
|
|
self._wait()
|
|
|
return self.client.search_artists(query, limit=limit)
|
|
|
|
|
|
def get_release(self, release_id):
|
|
|
self._wait()
|
|
|
return self.client.get_release_by_id(release_id)
|
|
|
|
|
|
def search_releases(self, query, limit=10):
|
|
|
self._wait()
|
|
|
return self.client.search_releases(query, limit=limit)
|
|
|
|
|
|
# ----------------------------------------------------
|
|
|
# Wrapper instance
|
|
|
# ----------------------------------------------------
|
|
|
client = RateLimitedClient(musicbrainzngs)
|
|
|
|
|
|
|
|
|
# ----------------------------------------------------
|
|
|
# Example usage
|
|
|
# ----------------------------------------------------
|
|
|
# if __name__ == "__main__":
|
|
|
# # 1. Search for an artist by name
|
|
|
# print("Searching for 'Radiohead'...")
|
|
|
# result = client.search_artists("Radiohead")
|
|
|
# for artist in result["artist-list"]:
|
|
|
# print(f"- {artist['name']} (ID: {artist['id']})")
|
|
|
#
|
|
|
# # 2. Retrieve a specific artist by MBID (example ID)
|
|
|
# artist_id = "c8f0b6e9-73e2-4d3a-9bb2-2a0d9d1a5f9a" # Radiohead
|
|
|
# print(f"\nGetting details for artist ID {artist_id}...")
|
|
|
# artist = client.get_artist(artist_id)
|
|
|
# print(artist)
|
|
|
#
|
|
|
# # 3. Search for releases by the artist
|
|
|
# print("\nSearching releases for 'Radiohead'...")
|
|
|
# releases = client.search_releases("Radiohead")
|
|
|
# for release in releases["release-list"]:
|
|
|
# print(f"- {release['title']} (ID: {release['id']})") |
