pylastfp

pylastfp est une interface Python à acoustiques empreintes bibliothèque de Last.fm (appelé fplib) et ses services connexes de l'API. & Nbsp; Il effectue l'extraction d'empreintes digitales, empreintes digitales ID recherche, et les métadonnées de la piste recherche. Il est également livré avec quelques aides pour décoder des fichiers audio.
Installation
Pour l'installer, vous aurez besoin d'un compilateur et les dépendances requises par lui-même fplib: fftw (compilé pour les flotteurs simple précision) et libsamplerate.
Une fois que vous avez cela, vous pouvez facilement l'installer à partir PyPI utilisant pip:
pip installer pylastfp
Ou, si vous ne disposez pas de pépins (ou easy_install), la tête de la page de téléchargement. La commande d'installation normal devrait fonctionner:
python setup.py install
Pour construire à partir de la source de contrôle de version (ie, pas d'une version archive), vous aurez également besoin Cython. (Les distributions source incluent le C ++ fichier généré, en évitant la nécessité d'Cython. La setup.py de ce package joue des tours de détecter si vous avez installé Cython.)
Running
Vous pouvez exécuter le script inclus fingerprinter / de recherche, lastmatch.py, pour tester votre installation:
& Nbsp; mysterious_music.mp3 lastmatch.py
Cela montrera matchs de métadonnées à partir de la base de données de Last.fm. Le script utilise les bindings Python de Gstreamer pour décoder des fichiers MP3. Vous pouvez également utiliser pymad lieu de Gstreamer (pour MPEG audio seulement) en fournissant le drapeau -m:
& Nbsp; lastmatch.py ​​-m mysterious_music.mp3
Utilisation de votre code
Le script présente de la manière habituelle d'utiliser pylastfp, qui est la suivante:
>>> Lastfp d'importation
>>> Xml = lastfp.gst_match (apikey, path)
>>> Matchs = lastfp.parse_metadata (xml)
>>> matchs d'impression [0] ['artiste'], '-', allumettes [0] ['title']
The National - Faux Emprire
Cet exemple utilise la fonction de confort gst_match, qui utilise Gstreamer pour décoder des données audio. La fonction importe le module Gstreamer lorsqu'il est appelé, donc si vous ne voulez pas compter sur Gstreamer, juste ne pas appeler cette fonction. Une autre fonction similaire appelée mad_match importe la place de la bibliothèque de pymad et utilise MAD pour décoder la place de Gstreamer.
Si vous avez votre propre moyen de décodage audio, vous pouvez utiliser l'interface de niveau inférieur:
>>> Xml = lastfp.match (apikey, pcmdata, échantillonnage, time_in_secs)
Bien sûr, vous aurez besoin d'un flux de PCM pour l'audio que vous voulez prendre les empreintes digitales. Le paramètre doit être un pcmdata iterable des objets Python str ou tampons contenant des données PCM comme des tableaux de (entiers de 16 bits) des valeurs C courts.
Toutes ces fonctions (match gst_match et mad_match) acceptent un paramètre facultatif additionnel appelé métadonnées. Il devrait être un dict contenant votre proposition actuelle à les métadonnées du fichier. Last.fm pourrait utiliser cette information pour améliorer leur base de données. Le dict devrait utiliser ces touches (qui sont tous en option): "artiste", "album", et "plage".
Le module effectue en interne thread-safe API limitant à 5 requêtes par seconde, en conformité avec les TOS de l'API de Last.fm

Ce qui est nouveau dans cette version:.

• Utiliser audioread place des pygst et pymad décodeurs inclus.

Quoi de neuf dans la version 0.5:

• Poignée réponses vides de l'API. setup.py cherche maintenant le préfixe local de l'utilisateur Homebrew.

Ce qui est nouveau dans la version 0.4:

• Correction d'un bug de nettoyage dans gstdec qui a été à l'origine des fichiers restent ouverts .

Quoi de neuf dans la version 0.3:

• Correction de typo dans la manipulation des erreurs HTTP. Traiter les cas lorsque la ligne d'état HTTP est malformé

Quoi de neuf dans la version 0.2:

• Correction d'une fuite de mémoire horrible. Fail en toute sécurité lorsque le fichier est trop court. Manipuler en toute sécurité XML malformé rentrer de l'API. Manipuler et exposer les échecs HTTP.

Exigences :

• Python