mixpanel-ruby 0.3.1 → 0.3.2

data/Readme.rdoc

@@ -28,6 +28,11 @@ The primary class you will use to track events is Mixpanel::Tracker. An instance
 Mixpanel::Tracker is enough to send events directly to \Mixpanel, and get you integrated
 right away.
 
+== Additional Information
 
+For more information please visit:
 
+* Our Ruby API Integration page[https://mixpanel.com/help/reference/ruby#introduction]
+* The usage demo[https://github.com/mixpanel/mixpanel-ruby/tree/master/demo]
+* The docuemntation[http://mixpanel.github.io/mixpanel-ruby/]
 

data/lib/mixpanel-ruby/people.rb

@@ -89,7 +89,7 @@ module Mixpanel
     # will be added to zero.
     #
     #    tracker = Mixpanel::Tracker.new
-    #    tracker.people.set("12345", {
+    #    tracker.people.increment("12345", {
     #        'Coins Spent' => 7,
     #        'Coins Earned' => -7, # Use a negative number to subtract
     #    });
@@ -108,6 +108,17 @@ module Mixpanel
       update(message)
     end
 
+    # Convenience method- increases the value of a numeric property
+    # by one. Calling #plus_one(distinct_id, property_name) is the same as calling
+    # #increment(distinct_id, { property_name => 1 })
+    #
+    #    tracker = Mixpanel::Tracker.new
+    #    tracker.people.plus_one("12345", "Albums Released")
+    #
+    def plus_one(distinct_id, property_name, ip=nil)
+      increment(distinct_id, { property_name => 1 }, ip)
+    end
+
     # Appends a values to the end of list-valued properties.
     # If the given properties don't exist, a new list-valued
     # property will be created.
@@ -154,7 +165,7 @@ module Mixpanel
       update(message)
     end
 
-    # Removes a property and it's value from a profile.
+    # Removes a property and its value from a profile.
     #
     #    tracker = Mixpanel::Tracker.new
     #    tracker.people.unset("12345", "Overdue Since")
@@ -205,7 +216,7 @@ module Mixpanel
     # method might be useful if you want to use very new
     # or experimental features of people analytics from Ruby
     # The \Mixpanel HTTP tracking API is documented at
-    # http://joe.dev.mixpanel.org/help/reference/http
+    # https://mixpanel.com/help/reference/http
     def update(message)
       message = {
           '$token' => @token,

data/lib/mixpanel-ruby/version.rb

@@ -1,3 +1,3 @@
 module Mixpanel
-  VERSION = '0.3.1'
+  VERSION = '0.3.2'
 end

data/spec/mixpanel-ruby/people_spec.rb

@@ -58,6 +58,18 @@ describe Mixpanel::People do
     }]])
   end
 
+  it 'should send an engage/add message with a value of 1' do
+    @people.plus_one("TEST ID", 'Albums Released')
+    @log.should eq([[ :profile_update, {
+        '$token' => 'TEST TOKEN',
+        '$distinct_id' => 'TEST ID',
+        '$time' => 76695784000,
+        '$add' => {
+            'Albums Released' => 1
+        }
+    }]])
+  end
+
   it 'should send a well formed engage/append message' do
     @people.append("TEST ID", { 'Albums' => 'Diamond Dogs' })
     @log.should eq([[ :profile_update, {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mixpanel-ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-28 00:00:00.000000000 Z
+date: 2013-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake