pylastfp

pylastfp é uma interface Python à biblioteca de Last.fm acústico impressões digitais (chamado fplib) e seus serviços relacionados API & nbsp;. Ele executa a extração de impressão digital, impressão digital de pesquisa de ID, e pesquisa metadados pista. Ele também vem com alguns ajudantes para decodificar arquivos de áudio.
Instalação
Para instalar, você vai precisar de um compilador e as dependências exigidas pela fplib si: fftw (compilado por carros alegóricos de precisão simples) e libsamplerate.
Uma vez que você tem estes, você pode facilmente instalar a partir PyPI usando pip:
pip instalar pylastfp
Ou, se você não tem pip (ou easy_install), siga para a página de download. O comando instalação normal deve funcionar:
python setup.py install
Para construir a partir da fonte de controle de versão (ou seja, não a partir de um arquivo tar release), você também vai precisar de Cython. (As distribuições fonte incluir o arquivo gerado C ++, evitando a necessidade de Cython. Setup.py deste pacote prega peças para detectar se você tiver Cython instalado.)
Executar
Você pode executar o script incluído fingerprinter / pesquisa, lastmatch.py, para testar sua instalação:
& Nbsp; mysterious_music.mp3 lastmatch.py
Isto irá mostrar jogos de metadados de banco de dados da Last.fm. O script usa vínculos Python do GStreamer para decodificar MP3s. Você também pode usar pymad em vez de Gstreamer (MPEG áudio), fornecendo a bandeira -m:
& Nbsp; lastmatch.py ​​-m mysterious_music.mp3
Usar no seu código
O script exibe a maneira usual de usar pylastfp, que é a seguinte:
>>> Lastfp importação
>>> Xml = lastfp.gst_match (apiKey, path)
>>> Matches = lastfp.parse_metadata (xml)
>>> partidas de impressão [0] ['artista'], '-', jogos [0] ['title']
The National - Emprire Falso
Este exemplo utiliza a função de conveniência gst_match, que utiliza Gstreamer para descodificar os dados de áudio. A função importa o módulo Gstreamer quando chamado, por isso, se você não quer depender de Gstreamer, só não chamar esta função. Outra função semelhante chamada mad_match vez importa a biblioteca pymad e usa MAD para decodificar em vez de Gstreamer.
Se você tem sua própria maneira de decodificar áudio, você pode usar a interface de nível inferior:
>>> Xml = lastfp.match (apiKey, pcmdata, samplerate, time_in_secs)
Claro, você vai precisar de um fluxo PCM para o áudio que deseja impressão digital. O parâmetro pcmdata deve ser um iterável de objetos Python str ou tampão contendo dados de PCM como matrizes de valores C curtos (de 16 bits inteiro).
Todas essas funções (fósforo, gst_match, e mad_match) aceitam um parâmetro opcional adicional chamado de metadados. Ele deve ser um dicionário que contém o seu palpite atual em metadados do arquivo. Last.fm pode usar esta informação para melhorar a sua base de dados. O dict deve usar essas chaves (todos os quais são opcionais): "artista", "disco", e "faixa".
O módulo executa internamente thread-safe API limitando a 5 consultas por segundo, de acordo com TOS API Last.fm

O que é novo nesta versão:.

• Use audioread em vez dos pygst e pymad decodificadores incluídos.

O que é novo na versão 0.5:

• Lidar com respostas vazias da API. setup.py agora procura o prefixo local pelo usuário Homebrew.

O que é novo na versão 0.4:

• Fix limpeza bug em gstdec que estava causando arquivos para permanecer aberto .

O que é novo na versão 0.3:

• Fix erro de digitação no manuseio de erros de HTTP. Lidar com casos quando a linha de status HTTP está malformado

O que é novo na versão 0.2:

• Corrigir um vazamento de memória horrível. Falha em segurança quando o arquivo é muito curto. Manusear XML malformado retornado do API. Manusear e expor falhas de HTTP.

Requisitos :

• Python