pylastfp

pylastfp это интерфейс Python к библиотеке Last.fm в акустической дактилоскопии (так называемый fplib) и связанных с ним услуг API NBSP &;. Она выполняет извлечение отпечатков пальцев, отпечатки пальцев ID поиск и поиск метаданных дорожки. Он также поставляется с некоторыми помощниками для декодирования аудио-файлов.
Установка
Для установки вам потребуется компилятор и зависимостей, необходимых fplib себя: FFTW (скомпилирован для одинарной точности плавает) и libsamplerate.
Если у вас есть эти, вы можете легко установить с помощью PIP PyPI:
пункт установить pylastfp
Или, если у вас нет PIP (или easy_install), с головы до страницы загрузки. Нормальная установка команда должна работать:
питон setup.py установить
Чтобы построить из источника контроля версий (то есть, не с высвобождением архива), вы также должны Cython. (Распределения источников включают сгенерированный C ++ файл, избегая необходимость Cython. Setup.py этот пакет играет уловки, чтобы обнаружить установили ли вы Cython.)
Запуск
Вы можете запустить скрипт включен fingerprinter / поиска, lastmatch.py, чтобы проверить вашу установку:
& NBSP; lastmatch.py ​​mysterious_music.mp3
Это покажет матчи метаданных из базы данных Last.fm в. Скрипт использует Python привязки GStreamer для декодирования MP3. Вы также можете использовать pymad вместо Gstreamer (для MPEG аудио только) путем подачи флаг -m:
& NBSP; lastmatch.py ​​-m mysterious_music.mp3
Использование в коде
Сценарий имеет обычный способ использования pylastfp, который заключается в следующем:
>>> Импорта lastfp
>>> XML = lastfp.gst_match (apikey, путь)
>>> Матчи = lastfp.parse_metadata (XML)
>>> Печати матчи [0] ['художник'], '-', соответствует [0] ['название "]
Национальный - Поддельные Emprire
Этот пример использует функцию gst_match удобство, которое использует Gstreamer декодировать аудио данные. Функция импортирует модуль Gstreamer при вызове, так что если вы не хотите зависеть от Gstreamer, только не называйте эту функцию. Другой подобный функция называется mad_match вместо импортирует библиотеку pymad и использует MAD декодировать вместо Gstreamer.
Если у вас есть свой собственный способ декодирования аудио, вы можете использовать интерфейс нижнего уровня:
>>> XML = lastfp.match (apikey, pcmdata, частота дискретизации, time_in_secs)
Конечно, вы должны будете поток PCM для аудио вы хотите, чтобы отпечатки пальцев. Параметр pcmdata должен быть итерацию из Python ул буферных или объектов, содержащих данные PCM как массивы C коротких (16-битных целочисленных значений).
Все эти функции (матч, gst_match и mad_match) принять дополнительный параметр с именем метаданных. Это должно быть ДИКТ содержащий текущую догадываться метаданных файла. Last.fm может использовать эту информацию для улучшения их базы данных. ДИКТ должны использовать эти ключи (все из которых являются необязательными): "группа", "Альбом", и "дорожка".
Модуль выполняет внутри поточно-API предельную 5 запросов в секунду, в соответствии с API TOS Last.fm в

Что нового В этом выпуске:.

• Использование audioread вместо включенных pygst и pymad декодеров.

Что нового в версии 0.5:

• Ручка пустые ответы от API. setup.py теперь ищет доморощенного пользователя локального префикса.

Что нового в версии 0.4:

• Исправлена ​​очистка ошибка в gstdec, которая была причиной файлы остаются открытыми .

Что нового в версии 0.3:

• Исправлена ​​опечатка в обработке ошибок HTTP. Ручка случаи, когда строка состояния HTTP имеет некорректный формат

Что нового в версии 0.2:

• Исправлена ​​утечка памяти ужасный. Нормально, когда безопасно файл слишком короткий. Безопасное обрабатывать XML неправильный вернулся из API. Ручка и подвергать неудачи HTTP.

Требования

• Python