pylastfp

pylastfp es una interfaz de Python para la biblioteca de Last.fm acústica fingerprinting (llamado fplib) y sus servicios conexos API & nbsp;. Se lleva a cabo la extracción de huellas digitales, las operaciones de búsqueda Identificación de huellas dactilares, y la búsqueda de pista metadatos. También viene con algunos ayudantes para decodificar los archivos de audio.
Instalación
Para la instalación, se necesita un compilador y las dependencias requeridas por fplib sí: fftw (compilado para carrozas de precisión simple) y libsamplerate.
Una vez que tenga estos, se puede instalar fácilmente desde PyPI usando pip:
PIP instalar pylastfp
O, si usted no tiene pip (o easy_install), diríjase a la página de descarga. El comando instalación normal debería funcionar:
python setup.py install
Para construir desde la fuente de control de versiones (es decir, no desde un archivo comprimido de liberación), usted también necesita Cython. (Las distribuciones de código fuente incluyen el archivo generado C ++, evitando la necesidad de Cython. Setup.py de este paquete juega trucos para detectar si ha instalado Cython.)
Ejecutar
Puede ejecutar el script incluido fingerprinter / lookup, lastmatch.py, para poner a prueba su instalación:
& Nbsp; mysterious_music.mp3 lastmatch.py
Esto mostrará partidos de metadatos de base de datos de Last.fm. El script usa enlaces Python de Gstreamer para decodificar archivos MP3. También puede utilizar pymad lugar de Gstreamer (para MPEG sólo audio) mediante el suministro de la bandera -m:
& Nbsp; lastmatch.py ​​-m mysterious_music.mp3
Uso de Su Código
El guión muestra la forma habitual de utilizar pylastfp, que es la siguiente:
>>> Lastfp importación
>>> Xml = lastfp.gst_match (ApiKey, ruta)
>>> Coincidencias = lastfp.parse_metadata (xml)
>>> partidos de impresión [0] ['artista'], '-', partidos [0] ['title']
El Nacional - Emprire Fake
Este ejemplo utiliza la función de conveniencia gst_match, que utiliza Gstreamer para decodificar los datos de audio. La función importa el módulo Gstreamer cuando llamó, así que si usted no quiere depender de Gstreamer, simplemente no llamar a esta función. Otra función similar llamada mad_match lugar importa la biblioteca pymad y utiliza MAD para decodificar lugar de GStreamer.
Si usted tiene su propio modo de audio de decodificación, puede utilizar la interfaz de nivel inferior:
>>> Xml = lastfp.match (ApiKey, pcmdata, de muestreo, time_in_secs)
Por supuesto, se necesita un flujo de PCM para el audio que desea tomar las huellas dactilares. El parámetro pcmdata debe ser un iterable de Python objetos str o tampón que contienen datos PCM como matrices de valores C cortos (16 bits enteros).
Todas estas funciones (partido, gst_match y mad_match) aceptan un parámetro opcional adicional llamada metadatos. Debe ser un dict que contiene su conjetura actual en los metadatos del archivo. Last.fm podrían utilizar esta información para mejorar su base de datos. El dict debe utilizar estas teclas (todos los cuales son opcionales): "artista", "disco", y "pista".
El módulo realiza internamente API thread-safe limitar a 5 consultas por segundo, de acuerdo con TOS del API de Last.fm

¿Qué hay de nuevo en esta versión:.

• Uso audioread lugar de los decodificadores pygst y pymad incluidos.

¿Cuál es nuevo en la versión 0.5:

• Manejar respuestas vacías de la API. setup.py ahora busca el prefijo local de usuario Homebrew.

¿Qué hay de nuevo en la versión 0.4:

• bug limpieza Fix en gstdec que estaba causando archivos permanezcan abiertas .

¿Cuál es nuevo en la versión 0.3:

• Fix errata en el manejo de errores HTTP. Manejar los casos en que la línea de estado HTTP está mal formado

¿Cuál es nuevo en la versión 0.2:

• Fijar una pérdida de memoria horrible. Fallar de manera segura cuando el archivo es demasiado corto. Manejar con seguridad XML con formato incorrecto de regresar de la API. Manejar y exponer fracasos HTTP.

Requisitos

• Python