pylastfp

pylastfp je Python rozhraní pro Last.fm je akustické otisků prstů knihovny (tzv fplib) a souvisejících rozhraní API služby. & Nbsp; to provádí extrakce otisků prstů, identifikační otisk vyhledávání a vyhledávání metadat skladby. Je také přichází s některými pomocníky pro dekódování audio souborů.
Instalace
Pro instalaci, budete potřebovat kompilátor a závislostí vyžadované fplib sebe: FFTW (sestaven pro jednoduchou přesností plave) a libsamplerate.
Jakmile budete mít tyto, můžete snadno nainstalovat z PyPI pomocí PIP:
PiP nainstalovat pylastfp
Nebo, pokud nemáte PIP (nebo easy_install), vedoucí na stránku pro stažení. Normální instalační příkaz by měl fungovat:
python setup.py nainstalovat
Chcete-li vytvořit ze zdroje pro správu verzí (tedy nikoli z uvolňovací tarballu), budete také potřebovat Cython. (Zdroj distribuce patří vygenerovaný soubor C ++, vyhnout se nutnosti Cython. Tento balíček je setup.py hraje triky zjistit, zda jste nainstalovali Cython.)
Běh
Můžete spustit zahrnuty fingerprinter / vyhledávání skript, lastmatch.py, která prověří vaši instalaci:
& Nbsp; lastmatch.py ​​mysterious_music.mp3
To se projeví metadata zápasy od Last.fm ve své databázi. Skript používá Pythonu GStreamer k dekódování MP3. Můžete také použít pymad místo GStreameru (pro MPEG pouze audio) dodáváním -m:
& Nbsp; lastmatch.py ​​-m mysterious_music.mp3
Používání ve svém kódu
Skript vykazuje obvyklý způsob, jak používat pylastfp, což je toto:
>>> Import lastfp
>>> Xml = lastfp.gst_match (apikey, cesta)
>>> Zápasy = lastfp.parse_metadata (xml)
>>> print zápasy [0] ['umělce'], "-", odpovídá [0] ['titul']
Národní - Fake Emprire
Tento příklad používá gst_match funkci pohodlí, který používá GStreamer pro dekódování zvukových dat. Funkce importuje modul GStreamer, když volal, takže pokud nechcete spoléhat na GStreameru, prostě nemají tuto funkci volat. Další podobné funkce nazývá mad_match namísto importuje knihovnu pymad a používá MAD dekódovat místo GStreameru.
Pokud máte svůj vlastní způsob dekódování zvuku, můžete použít rozhraní nižší úrovně:
>>> Xml = lastfp.match (apikey, pcmdata, vzorkovací, time_in_secs)
Samozřejmě, budete potřebovat PCM proud pro audio, kterou chcete otisky prstů. Parametr pcmdata musí být iterable Python STR nebo nárazníkových předmětů obsahujících PCM data jako pole C krátkých (16-bitové celočíselné hodnoty).
Všechny tyto funkce (zápas, gst_match, a mad_match) přijmout dodatečnou volitelný parametr nazývá metadata. Mělo by to být dict obsahující aktuální odhad na metadat souboru. Last.fm může použít tyto informace ke zlepšení jejich databázi. Dict by měl používat tyto klávesy (z nichž všechny jsou volitelné): "umělec", "Album", a "skladba".
Modul vnitřně provádí thread-safe API omezení na 5 dotazů za sekundu, v souladu s TOS API Last.fm je

Co je nového v této verzi:.

• Používání audioread namísto zahrnutých pygst a pymad dekodéry.

Co je nového ve verzi 0.5:

• Handle prázdné odpoví API. setup.py nyní prohledává Homebrew uživatelské místní prefix.

Co je nového ve verzi 0.4:

• Fix vyčištění chyba v gstdec, který byl příčinou soubory zůstat otevřené .

Co je nového ve verzi 0.3:

• Fix překlep v manipulaci s chyb protokolu HTTP. Zacházejte s případy, kdy stav HTTP linka je poškozen

Co je nového ve verzi 0.2:

• Fix hroznou nevracení paměti. Fail bezpečně, když soubor je příliš krátká. Bezpečně zacházet s chybně XML vrátil z API. Rukojeť a vystavit selhání HTTP.

Požadavky na :

• Python