pylastfp

pylastfp är en Python-gränssnitt till Last.fm akustiska fingeravtryck bibliotek (kallas fplib) och dess tillhörande API-tjänster. & Nbsp; Den utför fingeravtryck utvinning, fingeravtryck ID lookup, och spåra metadata lookup. Det kommer också med några medhjälpare för att avkoda ljudfiler.
Installation
För att installera, du behöver en kompilator och beroenden som krävs enligt fplib själv: fftw (sammanställas för enkel precision flyter) och libsamplerate.
När du har dessa, kan du enkelt installera från PyPI använder PIP:
PiP installera pylastfp
Eller, om du inte har PIP (eller easy_install), bege dig till nedladdningssidan. Den normala installera kommandot borde fungera:
python setup.py installera
Att bygga från version styrkälla (dvs inte från ett släpp tarball), du kommer också att behöva Cython. (Käll distributioner inkluderar den genererade C ++ fil, undvika behovet av Cython. Detta paket är setup.py spelar trick för att fastställa huruvida du har Cython installerat.)
Löpning
Du kan köra den medföljande fingerprinter / lookup manus, lastmatch.py, för att testa din installation:
& Nbsp; lastmatch.py ​​mysterious_music.mp3
Detta kommer att visa metadata matcher från Last.fm databas. Skriptet använder GStreamer s Python-bindningar för att avkoda MP3-filer. Du kan också använda pymad istället för Gstreamer (för MPEG-ljud endast) genom att tillföra -m flaggan:
& Nbsp; lastmatch.py ​​-m mysterious_music.mp3
Använda i din kod
Skriptet uppvisar det vanliga sättet att använda pylastfp, vilket är följande:
>>> Import lastfp
>>> Xml = lastfp.gst_match (apikey, bana)
>>> Matchade = lastfp.parse_metadata (XML)
>>> utskriftsmatcher [0] ['konstnär'], "-", tändstickor [0] ['titel']
The National - Fake Emprire
Detta exempel använder gst_match komfortfunktion, som använder Gstreamer att avkoda ljuddata. Funktionen importerar Gstreamer modulen när kallas, så om du inte vill vara beroende av Gstreamer, bara inte kalla denna funktion. En annan liknande funktion kallad mad_match istället importerar pymad biblioteket och använder MAD att avkoda istället för Gstreamer.
Om du har ditt eget sätt att avkoda ljud, kan du använda lägre nivå gränssnitt:
>>> Xml = lastfp.match (apikey, pcmdata, Sample, time_in_secs)
Naturligtvis behöver du en PCM ström för det ljud du vill fingeravtryck. Den pcmdata parametern måste vara en iterable Python str eller buffert föremål som innehåller PCM-data som grupperingar av C korta (16-bitars heltal) värden.
Alla dessa funktioner (match gst_match och mad_match) acceptera en ytterligare valfri parameter kallade metadata. Det bör vara en dict innehåller dina aktuella gissning på filens metadata. Last.fm kan använda denna information för att förbättra sin databas. Den dict bör använda dessa tangenter (vilka alla är valfria): "artist", "album", och "spår".
Modulen utför internt trådsäker API begränsning till 5 förfrågningar per sekund, i enlighet med Last.fm API TOS

Vad är nytt i den här versionen.

• Använd audioread i stället för de ingående pygst och pymad avkodare.

Vad är nytt i version 0.5:

• Hantera tomma svar från API. setup.py söker nu Homebrew användar lokalt prefix.

Vad är nytt i version 0.4:

• Fix sanering bugg i gstdec som orsakade filer förblir öppen .

Vad är nytt i version 0.3:

• Fix stavfel i hantering av HTTP-fel. Handtag fall när HTTP statusraden är missbildad

Vad är nytt i version 0.2:

• Fix en hemsk minnesläcka. Misslyckas säkert när filen är för kort. Säker hantera felaktig XML återvänt från API. Handtag och exponera HTTP fel.

Krav :

• Python