Class: LastFM::Api::Library

Inherits:
Object
  • Object
show all
Defined in:
lib/lastfm/api/library.rb

Class Method Summary collapse

Class Method Details

.add_album(params) ⇒ Object

Add an album or collection of albums to a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artists (Array, required) —

    the artist or collection of artists to add

  • :albums (Array, required) —

    the album or collection of albums to add. the indices of the albums that you pass MUST correspond to those of the artists

See Also:



11
12
13
14
15
16
17
 
# File 'lib/lastfm/api/library.rb', line 11

def add_album( params )
  LastFM.requires_authentication
  # convert :artists and :albums to individual artist[i] and album[i]
  Array(params.delete(:artists)).each_with_index{|val, i| params["artist[#{i}]"] = val}
  Array(params.delete(:albums)).each_with_index{|val, i| params["album[#{i}]"] = val}
  LastFM.post( "library.addAlbum", params )
end

.add_artist(params) ⇒ Object

Add an artist or collection of artists to a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artists (Array, required) —

    the artist or collection of artists to add

See Also:



23
24
25
26
27
 
# File 'lib/lastfm/api/library.rb', line 23

def add_artist( params )
  LastFM.requires_authentication
  Array(params.delete(:artists)).each_with_index{|val, i| params["artist[#{i}]"] = val}
  LastFM.post( "library.addArtist", params )
end

.add_track(params) ⇒ Object

Add a track or collection of tracks to a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artists (Array, required) —

    the artist or collection of artists to add

  • :tracks (Array, required) —

    the track or collection of tracks to add. the indices of the tracks that you pass MUST correspond to those of the artists

See Also:



34
35
36
37
38
39
 
# File 'lib/lastfm/api/library.rb', line 34

def add_track( params )
  LastFM.requires_authentication
  Array(params.delete(:artists)).each_with_index{|val, i| params["artist[#{i}]"] = val}
  Array(params.delete(:tracks)).each_with_index{|val, i| params["track[#{i}]"] = val}
  LastFM.post( "library.addTrack", params )
end

.get_albums(params) ⇒ Object

A paginated list of all the albums in a user’s library, with play counts and tag counts.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :user (String, requried) —

    the user whose library you want to fetch

  • :artist (String, optional) —

    an artist by which to filter albums

  • :page (Fixnum, optional) —

    the page number to fetch. defaults to first page

  • :limit (Fixnum, optional) —

    the number of results to fetch per page. defaults to 50

See Also:



48
49
50
 
# File 'lib/lastfm/api/library.rb', line 48

def get_albums( params )
  LastFM.get( "library.getAlbums", params )
end

.get_artists(params) ⇒ Object

A paginated list of all the artists in a user’s library, with play counts and tag counts.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :user (String, requried) —

    the user whose library you want to fetch

  • :page (Fixnum, optional) —

    the page number to fetch. defaults to first page

  • :limit (Fixnum, optional) —

    the number of results to fetch per page. defaults to 50

See Also:



58
59
60
 
# File 'lib/lastfm/api/library.rb', line 58

def get_artists( params )
   LastFM.get( "library.getArtists", params )
end

.get_tracks(params) ⇒ Object

A paginated list of all the tracks in a user’s library, with play counts and tag counts.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :user (String, requried) —

    the user whose library you want to fetch

  • :artist (String, optional) —

    an artist by which to filter track

  • :album (String, optional) —

    an album by which to filter tracks (requires an associated artist)

  • :page (Fixnum, optional) —

    the page number to fetch. defaults to first page

  • :limit (Fixnum, optional) —

    the number of results to fetch per page. defaults to 50

See Also:



70
71
72
 
# File 'lib/lastfm/api/library.rb', line 70

def get_tracks( params )
  LastFM.get( "library.getTracks", params )
end

.remove_album(params) ⇒ Object

Remove an album from a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artist (String, required) —

    the artist that composed the album

  • :album (String, required) —

    the name of the album to remove

See Also:



79
80
81
82
 
# File 'lib/lastfm/api/library.rb', line 79

def remove_album( params )
  LastFM.requires_authentication
  LastFM.post( "library.removeAlbum", params )
end

.remove_artist(params) ⇒ Object

Remove an artist from a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artist (String, required) —

    the name of the artist to remove

See Also:



88
89
90
91
 
# File 'lib/lastfm/api/library.rb', line 88

def remove_artist( params )
  LastFM.requires_authentication
  LastFM.post( "library.removeArtist", params )
end

.remove_scrobble(params) ⇒ Object

Remove a scrobble from a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artist (String, required) —

    the artist that composed the album

  • :track (String, required) —

    the name of the track to remove

  • :timestamp (Time, required) —

    the unix timestamp of the scrobble to remove

See Also:



99
100
101
102
 
# File 'lib/lastfm/api/library.rb', line 99

def remove_scrobble( params )
  LastFM.requires_authentication
  LastFM.post( "library.removeScrobble", params )
end

.remove_track(params) ⇒ Object

Remove a track from a user’s Last.fm library.

Parameters:

  • params (Hash) —

    a customizable set of options

Options Hash (params):

  • :artist (String, required) —

    the artist that composed the track

  • :track (String, required) —

    the name of the track to remove

See Also:



109
110
111
112
 
# File 'lib/lastfm/api/library.rb', line 109

def remove_track( params )
  LastFM.requires_authentication
  LastFM.post( "library.removeTrack", params )
end