little 0.0.4 → 0.0.5

data/lib/little/asset.rb

@@ -0,0 +1,74 @@
+module Little
+  # add, delete and retrieve likes by user or assets
+  class Asset
+    # votes for an asset
+    # @param [String] user the user who likes the asset
+    # @param [String] asset the asset being liked
+    # @param [int] type the type of asset
+    # params [symbol] up_or_down either :up or :down
+    def self.vote(user, asset, type, up_or_down)
+      Little.post(:assets, {:user => user, :asset => asset, :type => type, :vote => up_or_down == :up}, [:user, :asset, :type], 'vote')
+    end
+    
+    # generates a signature for voting on an asset (useful when using the javascript library)
+    def self.sign_vote(user, asset, type)
+      Little.sign(:assets, {:user => user, :asset => asset, :type => type})
+    end
+    
+    # rates an asset
+    # @param [String] user the user who likes the asset
+    # @param [String] asset the asset being liked
+    # @param [int] type the type of asset
+    # params [int] rating the rating
+    def self.rate(user, asset, type, rating)
+      Little.post(:assets, {:user => user, :asset => asset, :type => type, :rate => rating}, [:user, :asset, :type], 'rate')
+    end
+    
+    # generates a signature for rating an asset (useful when using the javascript library)
+    def self.sign_rate(user, asset, type)
+      Little.sign(:assets, {:user => user, :asset => asset, :type => type})
+    end
+    
+    # does the user like the asset
+    def self.user_asset(user, asset, type)
+      Little.get(:assets, {:user => user, :asset => asset, :type => type})
+    end
+    
+    # gets all the user's assets
+    # params [bool] vote true or false to get assets voted for or against, or nil to get all
+    # params [bool] rated_only true or false to get assets the user rated, or nil to get all
+    def self.for_user(user, page, records, vote = nil, rated_only = nil)
+      Little.get(:assets, {:user => user, :page => page, :records => records, :vote => vote, :rate => rated_only})
+    end
+    
+    # gets the number of assets the user likes
+    def self.for_user_count(user, vote = nil, rated_only = nil)
+      Little.get(:assets, {:user => user, :count => true, :vote => vote, :rate => rated_only})
+    end
+    
+    # gets all the users who like an asset
+    def self.for_asset(asset, type, page, records, vote = nil, rated_only = nil)
+      Little.get(:assets, {:asset => asset, :type => type, :page => page, :records => records, :vote => vote, :rate => rated_only})
+    end
+    
+    # gets the number of users who like an asset
+    def self.for_asset_count(asset, type, vote = nil, rated_only = nil)
+      Little.get(:assets, {:asset => asset, :type => type, :count => true, :vote => vote, :rate => rated_only})
+    end
+    
+    # gets the assets liked by type, ordered by number of likes (desc)
+    def self.highest_rated(type, page, records)
+      Little.get(:assets, {:type => type, :page => page, :records => records}, nil, 'by_rate')
+    end
+
+    # gets the assets liked by type, ordered by number of likes (desc)
+    def self.most_votes(type, page, records)
+      Little.get(:assets, {:type => type, :page => page, :records => records}, nil, 'by_vote')
+    end
+    
+    # gets the number of assets for a type
+    def self.count_by_type(type)
+      Little.get(:assets, {:type => type}, nil, 'count')
+    end
+  end
+end

data/lib/little/sender.rb

@@ -11,20 +11,20 @@ module Little
       @configuration = configuration
     end
 
-    def get_request(resource, data, signature_keys)
-      query_request(:get, resource, data, signature_keys)
+    def get_request(resource, data, signature_keys, url)
+      query_request(:get, resource, data, signature_keys, url)
     end
     
-    def delete_request(resource, data, signature_keys)
-      query_request(:delete, resource, data, signature_keys)
+    def delete_request(resource, data, signature_keys, url)
+      query_request(:delete, resource, data, signature_keys, url)
     end
     
-    def post_request(resource, data, signature_keys)
-      form_request(:post, resource, data, signature_keys)
+    def post_request(resource, data, signature_keys, url)
+      form_request(:post, resource, data, signature_keys, url)
     end
     
-    def put_request(resource, data, signature_keys)
-      form_request(:put, resource, data, signature_keys)
+    def put_request(resource, data, signature_keys, url)
+      form_request(:put, resource, data, signature_keys, url)
     end
     
     private
@@ -47,22 +47,27 @@ module Little
       URI.encode_www_form(data)
     end
     
-    def query_request(method, resource, data, signature_keys)
+    def query_request(method, resource, data, signature_keys, url)
       response = nil
       begin
         http = create_http(resource, data, signature_keys)
-        response = http.send(method, "#{BASE_URL}#{resource}?#{url_encode(data)}", HEADERS)
+        full_url = "#{BASE_URL}#{resource}"
+        full_url += "/#{url}" unless url.nil?
+        full_url += "?#{url_encode(data)}"
+        response = http.send(method, full_url, HEADERS)
       rescue => e
         raise Little::Error.new(-1, e)
       end
       handle_response(response) unless response.nil?
     end
     
-    def form_request(method, resource, data, signature_keys)
+    def form_request(method, resource, data, signature_keys, url)
       response = nil
       begin
         http = create_http(resource, data, signature_keys)
-        response = http.send(method, BASE_URL + resource.to_s, url_encode(data), HEADERS)
+        full_url = "#{BASE_URL}#{resource}"
+        full_url += "/#{url}" unless url.nil?
+        response = http.send(method, full_url, url_encode(data), HEADERS)
       rescue => e
         raise Little::Error.new(-2, e)
       end

data/lib/little/tag.rb

@@ -10,12 +10,12 @@ module Little
     def self.add(user, asset, type, share, data = nil)
       d = {:user => user, :asset => asset, :share => share, :type => type}
       d[:data] = data if data
-      Little.post(:tags, d, [:user])
+      Little.post(:tags, d, [:user, :asset, :type])
     end
     
     # generates a signature for adding a tag (useful when using the javascript library)
-    def self.sign_add(user)
-      Little.sign(:tags, {:user => user})
+    def self.sign_add(user, asset, type)
+      Little.sign(:tags, {:user => user, :asset => asset, :type => type})
     end
     
     # removes a tag for a user to an asset
@@ -42,46 +42,46 @@ module Little
     end
     
     # gets all the tags for a user
-    def self.user_tags(user, page, records, shared_only = true)
+    def self.for_user(user, page, records, shared_only = true)
       data = {:user => user, :page => page, :records => records}
       Little.get(:tags, data, shared_only ? nil : [:user])
     end
     
     # gets all the assets liked for a user for a specific asset
-    def self.user_tags_for_asset(user, asset, type, page, records, shared_only = true)
+    def self.for_user_and_asset(user, asset, type, page, records, shared_only = true)
       data = {:user => user, :asset => asset, :type => type, :page => page, :records => records}
       Little.get(:tags, data, shared_only ? nil : [:user, :asset, :type])
     end
     
     # gets the number of tags for a user
-    def self.user_tag_count(user, shared_only = true)
+    def self.for_user_count(user, shared_only = true)
       data = {:user => user, :count => true}
       Little.get(:tags, data, shared_only ? nil : [:user])
     end
     
     # gets all the of tags for a user for a specific asset
-    def self.user_tag_for_asset_count(user, asset, type, shared_only = true)
+    def self.for_user_and_asset_count(user, asset, type, shared_only = true)
       data = {:user => user, :asset => asset, :type => type, :count => true}
       Little.get(:tags, data, shared_only ? nil : [:user, :asset, :type])
     end
     
     # generates a signature for getting a tags for a user (useful when using the javascript library)
-    def self.sign_user_tags(user)
+    def self.sign_for_user(user)
       Little.sign(:tags, {:user => user})
     end
     
     # generates a signature for getting a for a user for a specific asset (useful when using the javascript library)
-    def self.sign_user_tags_for_asset(user, asset, type)
+    def self.sign_for_user_and_asset(user, asset, type)
       Little.sign(:tags, {:user => user, :asset => asset, :type => type})
     end
     
     # gets all the shared tags for a specific asset
-    def self.asset_tags(asset, type, page, records)
+    def self.for_asset(asset, type, page, records)
       Little.get(:tags, {:asset => asset, :type => type, :page => page, :records => records})
     end
     
     # gets the number of shared tags for a specific asset
-    def self.asset_tag_count(asset, type)
+    def self.for_asset_count(asset, type)
       Little.get(:tags, {:asset => asset, :type => type, :count => true})
     end
   end

data/lib/little/version.rb

@@ -1,3 +1,3 @@
 module Little
-  VERSION = '0.0.4'
+  VERSION = '0.0.5'
 end

data/lib/little.rb

@@ -1,7 +1,7 @@
 require 'little/version'
 require 'little/error'
 require 'little/configuration'
-require 'little/like'
+require 'little/asset'
 require 'little/tag'
 require 'little/attempt'
 require 'little/notification'
@@ -36,22 +36,25 @@ module Little #:nodoc
     end
     
     # Issues a POST request to the little.io service
-    def post(resource, data, signature_keys)
-      sender.post_request(resource, data, signature_keys)
+    # @param [String, Symbol] resource name of the resource (:tags, :likes, ...)
+    # @param [Hash] data data to send to the service
+    # @param [Array] signature_keys keys of the data used for signing (optional)
+    def post(resource, data, signature_keys, url = nil)
+      sender.post_request(resource, data, signature_keys, url)
     end
     # Issues a DELETE request to the little.io service
     # @param [String, Symbol] resource name of the resource (:tags, :likes, ...)
     # @param [Hash] data data to send to the service
     # @param [Array] signature_keys keys of the data used for signing (optional)
-    def delete(resource, data, signature_keys)
-      sender.delete_request(resource, data, signature_keys)
+    def delete(resource, data, signature_keys, url = nil)
+      sender.delete_request(resource, data, signature_keys, url)
     end
     # Issues a GET request to the little.io service
     # @param [String, Symbol] resource name of the resource (:tags, :likes, ...)
     # @param [Hash] data data to send to the service
     # @param [Array] signature_keys keys of the data used for signing (optional)
-    def get(resource, data, signature_keys = nil)
-      sender.get_request(resource, data, signature_keys)
+    def get(resource, data, signature_keys = nil, url = nil)
+      sender.get_request(resource, data, signature_keys, url)
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: little
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-30 00:00:00.000000000 Z
+date: 2011-12-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
-  requirement: &70251397271620 !ruby/object:Gem::Requirement
+  requirement: &70247362540800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 2.2.6
   type: :runtime
   prerelease: false
-  version_requirements: *70251397271620
+  version_requirements: *70247362540800
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70251397269580 !ruby/object:Gem::Requirement
+  requirement: &70247362539500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +32,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70251397269580
+  version_requirements: *70247362539500
 description: 
 email:
 - help@little.io
@@ -40,10 +40,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/little/asset.rb
 - lib/little/attempt.rb
 - lib/little/configuration.rb
 - lib/little/error.rb
-- lib/little/like.rb
 - lib/little/notification.rb
 - lib/little/sender.rb
 - lib/little/tag.rb

data/lib/little/like.rb

@@ -1,66 +0,0 @@
-module Little
-  # add, delete and retrieve likes by user or assets
-  class Like
-    # adds a like for a user to an asset
-    # @param [String] user the user who likes the asset
-    # @param [String] asset the asset being liked
-    # @param [int] type the type of asset
-    def self.add(user, asset, type)
-      Little.post(:likes, {:user => user, :asset => asset, :type => type}, [:user])
-    end
-    
-    # generates a signature for adding a like (useful when using the javascript library)
-    def self.sign_add(user)
-      Little.sign(:likes, {:user => user})
-    end
-    
-    # removes a like for a user to an asset
-    # @param [String] user the user who no longer likes the asset
-    # @param [String] asset the asset being unliked
-    # @param [int] type the type of asset
-    def self.delete(user, asset, type)
-      Little.delete(:likes, {:user => user, :asset => asset, :type => type}, [:user, :asset, :type])
-    end
-    
-    # generates a signature for deleting a like (useful when using the javascript library)
-    # @param [String] user the user who no longr likes the asset
-    def self.sign_delete(user, asset, type)
-      Little.sign(:likes, {:user => user, :asset => asset, :type => type})
-    end
-    
-    # does the user like the asset
-    def self.user_likes_asset(user, asset, type)
-      Little.get(:likes, {:user => user, :asset => asset, :type => type})
-    end
-    
-    # gets all the assets liked by the user
-    def self.user_likes(user, page, records)
-      Little.get(:likes, {:user => user, :page => page, :records => records})
-    end
-    
-    # gets the number of assets the user likes
-    def self.user_like_count(user)
-      Little.get(:likes, {:user => user, :count => true})
-    end
-    
-    # gets all the users who like an asset
-    def self.asset_liked_by(asset, type, page, records)
-      Little.get(:likes, {:asset => asset, :type => type, :page => page, :records => records})
-    end
-    
-    # gets the number of users who like an asset
-    def self.asset_like_count(asset, type)
-      Little.get(:likes, {:asset => asset, :type => type, :count => true})
-    end
-    
-    # gets the assets liked by type, ordered by number of likes (desc)
-    def self.by_type(type, page, records)
-      Little.get(:likes, {:type => type, :page => page, :records => records})
-    end
-    
-    # gets the number of assets for a type
-    def self.by_type_count(type)
-      Little.get(:likes, {:type => type, :count => true})
-    end
-  end
-end