unloq 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 94a280dda4b4c3f7cacaa84a69ac967338e71c46
-  data.tar.gz: 0a4eb6f0d22a3a0572d5a12ae21ee82203990548
+  metadata.gz: d7897418f6ca8c9fc33545aae4d46bccb0b54e56
+  data.tar.gz: 39d379fe3dbc9d56baaa4ea646757e59484e1d70
 SHA512:
-  metadata.gz: 59ca0165dd20edcddf0fcfbca4906e3289df3d8fa7cae99974f42ec61ed957a67f92f391aa44212dd6d40467704275e0253a5de97341e5a5a9b9060d2ec2f089
-  data.tar.gz: 265f1581b9ca612941d84834a6fae99796096e6d5a842ff14ab97fcfce7a0e387b0921aa46b8e63b508b69780be11b3ebe76f2fcdcbf944bdffd4ccba991e766
+  metadata.gz: bdde0af33b9ca715b957d9a42bb45d3c74b0257e167a4752e3f096d10d0207c83ade10c0a84ab071acef278d996b8fe1b2e47ffd8e0f33c4053618fd163a4e34
+  data.tar.gz: ce701c4a86e4739aa93f9bc7483c3edf60c23015be138bf65cd797251fdcc7de36688f1c27ebaf8d510f0877621f7855860fb63d01da54dd5fa08568329c76c2

data/lib/unloq.rb

@@ -9,4 +9,5 @@ require 'unloq/entity'
 require 'unloq/entities/author'
 require 'unloq/entities/recipient'
 require 'unloq/events'
+require 'unloq/achievements'
 require 'unloq/client'

data/lib/unloq/achievements.rb

@@ -0,0 +1,37 @@
+module Unloq
+  module Achievements
+
+    # Create an achievement via the Unloq API
+    #
+    # @param verb [String] verb The verb for which this achievement should be unlocked
+    # @param observation_count [Integer] observation_count The number of times the event must occur to unlock this achievement
+    # @param author [Unloq::Entity] An individual author, if passed this achievement will only be attainable by this author. Required if author_type is not defined.
+    # @param recipient [Unloq::Entity] An individual recipient that must be acted on to attain this achievement. Required if recipient_type is not defined.
+    # @param author_type [String] An individual author type, if passed this achievement will only be attaintable by authors of this type. Required if author is not defined.
+    # @param recipient_type [String] An individual recipient type that must be acted on to attain this achievement. Required if recipient is not defined.
+    # @param points [Integer] The number of points that will be awarded when this achievement is attained.
+    # @param image_path [String] An image path representing this achievement.
+
+    def create_achievement verb, observation_count, 
+                           author: nil, recipient: nil, author_type: nil, recipient_type: nil, 
+                           points: nil, image_path: nil
+
+      author_type, author_id       = extract_entity_details(author, author_type)
+      recipient_type, recipient_id = extract_entity_details(recipient, recipient_type)
+
+      body_to_post = {
+        verb: verb,
+        observation_count: observation_count,
+        author_id: author_id,
+        author_type: author_type,
+        recipient_id: recipient_id,
+        recipient_type: recipient_type,
+        points: points,
+        image_path: image_path
+      }
+
+      post('/achievements', body_to_post)
+    end
+
+  end
+end

data/lib/unloq/client.rb

@@ -2,6 +2,7 @@ module Unloq
   class Client
 
     include Events
+    include Achievements
 
     attr_reader :api_key, :namespace
 
@@ -46,6 +47,19 @@ module Unloq
       raise ArgumentError.new("Recipient must be an Unloq::Author or Unloq::Recipient") unless recipient.is_a?(Unloq::Entity)
     end
 
+    #Extract entity type and ID from inclusion of either an Unloq::Entity or a *_type argument
+    def extract_entity_details entity = nil, entity_type = nil
+      if entity
+        validate_author(entity)
+        return [entity.type, entity.id]
+      else
+        unless entity_type
+          raise ArgumentError.new("Must include an author/recipient as an Unloq::Entity instance or include an author_type or recipient_type")
+        end
+        return [entity_type, nil]
+      end
+    end
+
     private
 
     # Return either the response body or raise a helpful error

data/lib/unloq/version.rb

@@ -1,3 +1,3 @@
 module Unloq
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unloq
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Matt Mueller
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-22 00:00:00.000000000 Z
+date: 2014-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -133,6 +133,7 @@ files:
 - LICENSE
 - README.md
 - lib/unloq.rb
+- lib/unloq/achievements.rb
 - lib/unloq/api_error.rb
 - lib/unloq/client.rb
 - lib/unloq/entities/author.rb