badgeville_berlin 1.0.0 → 1.0.1

data/README.md

@@ -85,7 +85,17 @@ This is an open source Ruby wrapper for interacting with the [Badgeville RESTful
         success = new_player.save
 ```
 
-### 7. Register a player behavior.
+### 7. Find existing players by email.
+<ul> 
+  <li>Here we find an existing player by email.</li>
+  <li>To get all players on the network that match the email, we have passed :all.</li>
+  <li>You can alternatively pass :first or :last in the place of :all.</li>
+</ul>
+``` ruby
+        @existing_player = Player.find(:all, :params => {:email => "revised_visitor@emailserver.com"})
+```
+
+### 8. Register a player behavior.
 <ul>
   <li>Here we record the fact that the newly created player performed a "share" behavior.</li>
   <li>See the API Explorer for required and optional parameters.</li>

data/lib/badgeville_berlin/version.rb

@@ -1,3 +1,3 @@
 module BadgevilleBerlin
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/spec/use_case/readme_use_case_spec.rb

@@ -13,8 +13,9 @@ module BadgevilleBerlin
       FakeWeb.allow_net_connect = true
 
       # Configure the gem with the host site and the API Key
-      my_api_key     = "myapikey"
-      my_hostname = "http://myhostname.com"
+      my_api_key = "<myapikey>"
+      my_hostname = "<http://myhostname.com>"
+
       Config.conf(:host_name => my_hostname, :api_key => my_api_key)
 
       # Basic README: Create a new site
@@ -42,6 +43,7 @@ module BadgevilleBerlin
       @attr_specific_err = @new_user2.errors[:email]
 
       # Basic README: Create a player
+      # Basic README: Find existing players that match the given email
       @new_player = Player.new(
         :site_id      => @new_site.id,
         :user_id      => @new_user.id ,
@@ -138,6 +140,24 @@ module BadgevilleBerlin
       @new_player.user_id.should == @new_user.id
     end
 
+    # FIND Players by email (:all matches)
+    it "should return all players that match the email address as a collection", :affects_bv_server => true do
+      @existing_player = Player.find(:all, :params => {:email => "visitor#{@rand1}@emailserver.com"})
+      @existing_player.first.email.should == "visitor#{@rand1}@emailserver.com"
+    end
+
+    # FIND Player by email (:first match)
+    it "should return the first player that matches the email address as a single record", :affects_bv_server => true do
+      @existing_player = Player.find(:first, :params => {:email => "visitor#{@rand1}@emailserver.com"})
+      @existing_player.email.should == "visitor#{@rand1}@emailserver.com"
+    end
+
+    # FIND Player by email (:last match)
+    it "should return the first player that matches the email address as a single record", :affects_bv_server => true do
+      @existing_player = Player.find(:last, :params => {:email => "visitor#{@rand1}@emailserver.com"})
+      @existing_player.email.should == "visitor#{@rand1}@emailserver.com"
+    end
+
     # CREATE Activity (share)
     it "should have created a 1st activity", :affects_bv_server => true do
       @share_activity_created.should == true
@@ -273,7 +293,7 @@ module BadgevilleBerlin
       lambda { Site.find(@new_site.id) }.should raise_error(ActiveResource::ResourceNotFound)
     end
 
-    #FIND Group
+    # FIND Group (a.k.a. Mission)
     # Not integration test!
     it "should parse correctly a group index call which includes rewards keyed under reward definitions", :affects_bv_server => true do
       BadgevilleBerlinJsonFormat.stub!(:decode).and_return([JSON.parse(BadgevilleBerlin.response_json["valid_group_all"])])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: badgeville_berlin
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-08 00:00:00.000000000 Z
+date: 2012-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-debug19