officialfm 0.1.2 → 0.2.0

data/lib/officialfm/users.rb

@@ -1,251 +0,0 @@
-require 'cgi'
-
-module OfficialFM
-  module Users
-
-    # Search for users
-    #
-    # @param [String] search_param: a search parameter (eg. name of the user)
-    # @param [Integer] limit (50) limit per page
-    # @return [Hashie::Mash] User list
-    def users(search_param, options={})
-      response = connection.get do |req|
-        req.url "/search/users/#{CGI::escape(search_param)}", simple_params(options)
-      end
-      response.body
-    end
-
-    # Retrieve information about a specific user
-    #
-    # @param [String] user_id: id or login
-    # @return [Hashie::Mash] User
-    def user(user_id)
-      response = connection.get do |req|
-        req.url "/user/#{user_id}", simple_params
-      end
-      response.body[0]
-    end
-
-    # Retrieve a list of the tracks of a given user
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @param [Bool] embed (false) should embed codes be included in the response
-    # @return [Hashie::Mash] Track list
-    def user_tracks(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/tracks", simple_params(options)
-      end
-      response.body
-    end
-    
-    # Retrieve a list of the tracks a given user has voted for
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @param [Bool] embed (false) should embed codes be included in the response
-    # @return [Hashie::Mash] Track list
-    def voted_tracks(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/voted_tracks", simple_params(options)
-      end
-      response.body
-    end
-    
-    # Retrieve a list of the playlists of a given user
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @param [Bool] embed (false) should embed codes be included in the response
-    # @return [Hashie::Mash] Playlist list
-    def user_playlists(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/playlists", simple_params(options)
-      end
-      response.body
-    end
-    
-    # Retrieve a list of the playlists a given user has voted for
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @param [Bool] embed (false) should embed codes be included in the response
-    # @return [Hashie::Mash] Playlist list
-    def voted_playlists(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/voted_playlists", simple_params(options)
-      end
-      response.body
-    end
-    
-    # Retrieve a list of the contacts of a given user
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @return [Hashie::Mash] User list
-    def user_contacts(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/contacts", simple_params(options)
-      end
-      response.body
-    end
-    
-    # Retrieve a list of the subscribers of a given user
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @return [Hashie::Mash] User list
-    def user_subscribers(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/subscribers", simple_params(options)
-      end
-      response.body
-    end
-    
-    # Retrieve a list of the subscriptions of a given user
-    #
-    # @param [String] user_id: id or login
-    # @param [Integer] limit (50) limit per page
-    # @return [Hashie::Mash] User list
-    def user_subscriptions(user_id, options={})
-      response = connection.get do |req|
-        req.url "/user/#{user_id}/subscriptions", simple_params(options)
-      end
-      response.body
-    end
-    
-    ####################################################################
-    ######################### Advanced API methods #####################
-    ####################################################################
-
-    # Retrieve information about the logged in user
-    #
-    # @return [Hashie::Mash] User
-    def profile
-      check_auth :profile
-    
-      response = connection.post do |req|
-        req.url '/user/profile'
-        req.body = { :format => @format }
-      end
-      response.body[0]
-    end
-    
-    # Retrieve tracks of the logged in user
-    #
-    # @return [Hashie::Mash] Track list
-    def own_tracks
-      check_auth :own_tracks
-      
-      response = connection.post do |req|
-        req.url '/user/tracks'
-        req.body = { :format => @format }
-      end
-      response
-    end
-    
-    # Retrieve dropbox tracks of the logged in user
-    #
-    # @return [Hashie::Mash] Track list
-    def dropbox
-      check_auth :dropbox
-      
-      response = connection.post do |req|
-        req.url '/user/dropbox'
-        req.body = { :format => @format }
-      end
-      response
-    end
-    
-    # Retrieve playlists of the logged in user
-    #
-    # @return [Hashie::Mash] Playlist list
-    def own_playlists
-      check_auth :own_playlists
-      
-      response = connection.post do |req|
-        req.url '/user/playlists'
-        req.body = { :format => @format }
-      end
-      response
-    end
-    
-    # Retrieve events of the logged in user's newsfeed
-    #
-    # @return [Hashie::Mash] Event list
-    def newsfeed
-      check_auth :newsfeed
-      
-      response = connection.post do |req|
-        req.url '/user/newsfeed'
-        req.body = { :format => @format }
-      end
-      response
-    end
-    
-    # Update information of the logged in user
-    #
-    # @param [String] email (optional)
-    # @param [String] city (optional)
-    # @param [String] country_id (optional)
-    # @param [String] url (optional)
-    # @param [String] profile (optional)
-    # @param [String] birthdate (optional)
-    # @param [String] gender (optional)
-    # @return [Hashie::Mash] User
-    def update_profile! (data = {})
-      check_auth :update
-    
-      response = connection.put do |req|
-        req.url '/user/update'
-        req.body = { :format => @format }.merge(data)
-      end
-      response
-    end
-    
-    # Subscribe the logged in user to a given user
-    #
-    # @param [String] user_id: the user to subscribe to
-    # @return [Hashie::Mash] Success or error message
-    def subscribe! (user_id)
-      check_auth :subscribe
-    
-      response = connection.post  do |req|
-        req.url "/user/subscribe/#{user_id}"
-        req.body = { :format => @format }
-      end
-      response
-    end
-    
-    # Unsubscribe the logged in user from a given user
-    #
-    # @param [String] user_id: the user to unsubscribe from
-    # @return [Hashie::Mash] Success or error message
-    def unsubscribe! (user_id)
-      check_auth :unsubscribe
-    
-      response = connection.post  do |req|
-        req.url "/user/unsubscribe/#{user_id}"
-        req.body = { :format => @format }
-      end
-      response
-    end
-    
-    # Upload a picture for authenticated user
-    #
-    # @param [String] path: path to a picture
-    # @param [String] mime: the mime-type of the picture (e.g. image/jpeg, image/png, etc.)
-    # @return [Hashie::Mash] Success or error message
-    def picture! (path, mime)
-      check_auth :picture
-    
-      response = connection.post  do |req|
-        req.url "/user/picture"
-        req.body = { :file => Faraday::UploadIO.new(path, mime), :format => @format }
-      end
-      response
-    end
-
-  end
-end
-