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