pylastfp

pylastfp er en Python interface til Last.fm akustiske fingeraftryk bibliotek (kaldet fplib) og dets tilknyttede API-tjenester. & Nbsp; Det udfører fingeraftryk udvinding, fingeraftryk ID opslag, og track metadata opslag. Det leveres også med nogle hjælpere til at afkode lydfiler.
Installation
For at installere, skal du bruge en compiler og afhængigheder kræves af fplib selv: FFTW (udarbejdet for single-præcision flåd) og libsamplerate.
Når du har disse, kan du nemt installere fra PyPI hjælp pip:
pip installere pylastfp
Eller, hvis du ikke har pip (eller easy_install), leder til download siden. Den normale installation kommando bør arbejde:
python setup.py installere
At bygge fra den version kontrol kilde (dvs. ikke fra en release tarball), vil du også brug Cython. (Kilden distributioner inkluderer den genererede C ++ fil, så man undgår behovet for Cython. Denne pakke er setup.py spiller tricks fastslå om du har Cython installeret.)
Løb
Du kan køre den medfølgende fingerprinter / opslag script, lastmatch.py, at teste din installation:
& Nbsp; lastmatch.py ​​mysterious_music.mp3
Dette vil vise metadata kampe fra Last.fm database. Scriptet bruger GStreamer er Pythonbindinger at afkode MP3. Du kan også bruge pymad stedet for Gstreamer (for MPEG-lyd kun) ved at levere den -m flag:
& Nbsp; lastmatch.py ​​-m mysterious_music.mp3
Brug i din kode
Scriptet udviser den sædvanlige måde at bruge pylastfp, som er dette:
>>> Import lastfp
>>> Xml = lastfp.gst_match (apikey, sti)
>>> Tændstikker = lastfp.parse_metadata (xml)
>>> print kampe [0] ['kunstner'], '-', matcher [0] ['title']
The National - Fake Emprire
I dette eksempel anvendes gst_match bekvemmelighed funktion, som bruger Gstreamer at dekode lyddata. Importerer funktionen Gstreamer modulet, når kaldes, så hvis du ikke ønsker at være afhængig af Gstreamer, bare ikke kalde denne funktion. En anden lignende funktion kaldet mad_match stedet importerer pymad biblioteket og bruger MAD at afkode i stedet for Gstreamer.
Hvis du har din egen måde at afkode lyd, kan du bruge det lavere niveau interface:
>>> Xml = lastfp.match (apikey, pcmdata, sampleRate, time_in_secs)
Selvfølgelig skal du have en PCM stream for lyden, du ønsker at fingeraftryk. Den pcmdata parameter skal være en Iterable af Python str eller buffer objekter indeholdende PCM data arrays af C kort (heltal 16-bit) værdier.
Alle disse funktioner (match, gst_match og mad_match) acceptere en ekstra valgfri parameter kaldet metadata. Det bør være en dict indeholde dine aktuelle gæt på filens metadata. Last.fm måske bruge disse oplysninger til at forbedre deres database. Den dict skal bruge disse taster (som alle er valgfri): "kunstner", "album", og "spor".
Modulet internt udfører tråd-safe API begrænsende til 5 forespørgsler i sekundet, i overensstemmelse med Last.fm API TOS

Hvad er nyt i denne udgivelse:.

• Brug audioread stedet for de inkluderede pygst og pymad dekodere.

Hvad er nyt i version 0.5:

• Håndtag tomme svar fra API. setup.py søger nu Homebrew bruger-lokal præfiks.

Hvad er nyt i version 0.4:

• Fix oprydning fejl i gstdec der var årsag filer til at forblive åben .

Hvad er nyt i version 0.3:

• Fix slåfejl i håndtering af HTTP-fejl. Håndtere tilfælde, hvor HTTP status linje er misdannet

Hvad er nyt i version 0.2:

• Løs et forfærdelig hukommelsesfejl. Fail sikkert, når filen er for kort. Sikker håndtere forkert udformet XML returneret fra API. Håndtere og afsløre HTTP fiaskoer.

Krav :

• Python