checkdin 0.2.5 → 0.2.6

data/lib/checkdin/users.rb

@@ -44,5 +44,42 @@ module Checkdin
       return_error_or_body(response)
     end
 
+    # Retrieve a list of a user's authentications to external services (Facebook, Foursquare, etc.)
+    #
+    # param [Integer] id The ID of the user
+
+    def user_authentications(id)
+      response = connection.get("users/#{id}/authentications")
+      return_error_or_body(response)
+    end
+
+    # Retrieve information about a user's specific authentication to an external service
+    #
+    # param [Integer] user_id The ID of the user
+    # param [Integer] id The ID of the authentication
+
+    def user_authentication(user_id, id)
+      response = connection.get("users/#{user_id}/authentications/#{id}")
+      return_error_or_body(response)
+    end
+
+    # Create an authentication for a user
+    #
+    # param [Integer] id The ID of the user
+    # @param [Hash]  options
+    # @option options String :provider - The name of the provider for the authentication (twitter, facebook, foursquare, linkedin, instagram)
+    # @option options String :uid - The user's id for the provider (on the provider's service, not your internal identifier)
+    # @option options String :oauth_token - The user's oauth token or access token that can be used to retrieve data on their behalf on the service.
+    # @option options String :oauth_token_secret - The user's oauth token secret or access token secret that is used in combination with the oauth token (required for twitter)
+    # @option options String :nickname - The user's nickname on the provider's service.
+
+    def create_user_authentication(id, options={})
+      response = connection.post do |req|
+        req.url "users/#{id}/authentications", options
+      end
+      return_error_or_body(response)
+    end
+
+
   end
 end

data/lib/checkdin/version.rb

@@ -1,3 +1,3 @@
 module Checkdin
-  VERSION = '0.2.5'
+  VERSION = '0.2.6'
 end

data/lib/checkdin/won_rewards.rb

@@ -15,6 +15,7 @@ module Checkdin
     # @param [Hash]  options
     # @option options Integer :campaign_id - Only return won rewards for this campaign.
     # @option options Integer :user_id - Only return won rewards for this user.
+    # @option options Integer :promotion_id - Only return won rewards for this promotion.
     # @option options Integer :limit - The maximum number of records to return.
 
     def won_rewards(options={})

data/spec/checkdin/users_spec.rb

@@ -55,4 +55,55 @@ describe Checkdin::Users do
       end
     end
   end
+
+  context "viewing a single user's list of authentications" do
+    use_vcr_cassette
+    let(:result) { @client.user_authentications(7835) }
+
+    it "should make a list of authentications available" do
+      result.authentications.collect{ |a| a.authentication.provider }.should == ["twitter","facebook","foursquare"]
+    end
+
+    it "should include the user's uid" do
+      result.authentications.collect{ |a| a.authentication.uid }.should == ["5930881311","1000038776937901","19125491"]
+    end
+  end
+
+  context "viewing a single user's specific authentication" do
+    use_vcr_cassette
+    let(:result) { @client.user_authentication(7835, 19479) }
+
+    it "should make a single authentication available" do
+      result.authentication.provider.should == "twitter"
+      result.authentication.uid.should == "5930881311"
+      result.authentication.nickname.should == "demo"
+    end
+  end
+
+  context "creating an authentication" do
+    context "with valid parameters" do
+      use_vcr_cassette
+      let(:result) { @client.create_user_authentication(7887, 
+                                                        :provider    => "foursquare",
+                                                        :uid         => "1234",
+                                                        :oauth_token => "111",
+                                                        :nickname    => "foursquare_name") }
+
+      it "should return the new authentication's information" do
+        result.authentication.provider.should == "foursquare"
+        result.authentication.uid.should == "1234"
+        result.authentication.nickname.should == "foursquare_name"
+      end
+    end
+
+    context "with invalid parameters" do
+      use_vcr_cassette
+
+      it "should return an error 400" do
+        expect do
+          @client.create_user_authentication(7887)
+        end.to raise_error(Checkdin::APIError, /400/)
+      end
+    end
+  end
 end

metadata

@@ -2,7 +2,7 @@
 name: checkdin
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.2.5
+  version: 0.2.6
 platform: ruby
 authors: 
 - Matt Mueller