Module `Lastfm_generic.Audioscrobbler_generic`Source

Generic implementation of Audioscrobbler, independent * from the Http request.

Audioscrobbler is the submission protocol as described at

http://www.audioscrobbler.net/development/protocol/

Parameters

module _ : Http_t

Signature

Types

Sourcetype source =

| User
| Broadcast
| Recommendation
| Lastfm
| Unknown

source of the track

Sourcetype rating =

| Love
| Ban
| Skip

possible rating for the track

Sourcetype action =

| NowPlaying
| Submit

type of action

Sourcetype song = {

artist : string;
track : string;
time : float option;
source : source option;
rating : rating option;
length : float option;
album : string option;
trackauth : string option;
tracknumber : int option;
musicbrainzid : string option;

}

song submission type

Sourcetype error =

| Http of string
| Banned
| Badauth
| Badtime
| Failed of string
| UnknownError of string
| Success
| Internal of string
| BadData of string

various errors

Sourceexception Error of error

Sourceval string_of_error : error -> string

Get meaning of Error e

Sourceval base_port : int ref

Base port. Default: 80

Sourceval base_host : string ref

Base host. Default: "post.audioscrobbler.com"

Common API

Functions common to both basic and advanced APIs

Source

val get_song : 
  ?time:float ->
  ?source:source ->
  ?rating:rating ->
  ?length:float ->
  ?album:string ->
  ?tracknumber:int ->
  ?musicbrainzid:string ->
  ?trackauth:string ->
  artist:string ->
  track:string ->
  unit ->
  song

get_song create a song record based on given values.

Optional records can be ommited there.

Sourceval check_song : song -> action -> unit

Check wether required song informations are supplied for given action.

Raises Error (BadData reason) if invalid data is given.

See protocol details there:

http://www.audioscrobbler.net/development/protocol/

Basic API

Using this API, all requests are done in one single step

Source

val do_np : 
  ?timeout:float ->
  ?host:(string * int) ->
  client ->
  login ->
  song ->
  unit

do_np client login song execute a nowplaying request with authentification

Optional host parameter is a pair "host",port to override the global values.

Source

val do_submit : 
  ?timeout:float ->
  ?host:(string * int) ->
  client ->
  login ->
  song list ->
  (error * song) list

do_submit client login songs execute a nowplaying request with authentification.

This functions returns a list songs for which supplied informations were incomplete, with corresponding exception (see check_song source)

Advanced API

This API is for advanced usages.

You may use it this way:

handshake : initiate session
np/submit: execute request

The module will cache session informations and avoid redundant requests, so you might always call handshake.

However, if a np or submit fails, it can be because the session has expired on server side, but the module cache still refered to it. So you might clear this session id, and try another handshake+submit/np.

Check do_no and do_submit for examples.

Source

val handshake : 
  ?timeout:float ->
  ?host:(string * int) ->
  client ->
  login ->
  string

handshake client login open session, returns session ID

Optional host parameter is a pair "host",port to override the global values.

Sourceval np : ?timeout:float -> string -> song -> unit

np sessionID track execute a nowplaying request

Sourceval submit : ?timeout:float -> string -> song list -> (error * song) list

submit sessionID tracks execute a submit request

This functions returns a list songs for which supplied informations were incomplete, with corresponding exception (see check_song)

package lastfm

Module Lastfm_generic.Audioscrobbler_genericSource

Parameters

Signature

Types

Common API

Basic API

Advanced API

Module `Lastfm_generic.Audioscrobbler_generic`Source