tamber 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: af8fed11bb5f401f45c1c884abfaca26fb830959
-  data.tar.gz: e623a12f3d1b68e53c8813ab18b9007f141dd4e2
+  metadata.gz: 92bb07bf50bc996017ca5884653966e63bd24f6e
+  data.tar.gz: 7365b9bfdd9540d240fb52d9f44498d7f2152342
 SHA512:
-  metadata.gz: 887b3119d229994872f2686c20f0622e4b683ea25d829a79d8773b24a276f043ff04031030d7a3f58637f73ff63b611c561987783fbca5d8e7f48f77c7030232
-  data.tar.gz: 38428805fbce8ccdde489cd7d95c80dd2145d7d8b333b3f0657598913f9b6761e76a62f710646ffe53414c43eab2ccdce42c137ab9fa39a5ba82774f72fcb138
+  metadata.gz: b89256c171c11ae98f0970f1ac53f9d6fc7090c1ea5292c191bd0dc5c85254faa0f86f62863338749720fddcbd8598e322c46bbda0bed191bbbdcf69c5f8f58a
+  data.tar.gz: 5a430454fa735e98fd323adbc6940fe58f97e793b0c84b07c14326d2273120b118f9e038b012e6d3397e8c9893c60ffe96422f903c85e5262ee23e1ecbb0780d

data/README.md

@@ -64,7 +64,7 @@ The primary method of discovery in Tamber is the `Discover.next` method, which r
 
 #### For You
 
-To put personalized recommendations on your homepage, or in any recommended section, just call `Discover.next` with the number of recommendations you want to display (if you are calling server-side, also set the `user`).
+To put personalized recommendations on your homepage, or in any recommended section, just call `Discover.next` with the given user's id and the number of recommendations you want to display.
 
 ```rb
 Tamber.project_key = 'your_project_key'
@@ -80,20 +80,16 @@ rescue TamberError => error
 end
 ```
 
-##### `continuation`
-
-`Discover.next` is optimized for the exact moment and context of the user at the time of request, so standard pagination is not possible. Instead, `Discover.next` uses automatic continuation to allow you to 'show more' or implement infinite scrolling. 
+#### Up Next
 
-When you want to add more recommendations to those currently displayed to the user, just set the `continuation` field to `true`. Tamber will automatically generate the set of items that should be appended to the current user-session's list. The `Discover.next` user-session is reset when `Discover.next` is called without `continuation`.
+Keep users engaged by creating a path of discovery as they navigate from item to item, always showing the right mix of items they should check out next. Just add the id of the item that the user is navigating to / looking at.
 
 ```rb
-Tamber.project_key = 'your_project_key'
-
 begin
   d = Tamber::Discover.next(
     user: 'user_rlox8k927z7p',
-    number: 10,
-    continuation: true
+    item: 'item_wmt4fn6o4zlk',
+    number: 14
   )
   d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
 rescue TamberError => error
@@ -101,16 +97,21 @@ rescue TamberError => error
 end
 ```
 
-#### Up Next
 
-Keep users engaged by creating a path of discovery as they navigate from item to item. Just add the id of the item that the user is navigating to / looking at.
+##### `continuation`
+
+`Discover.next` is optimized for the exact moment and context of the user at the time of request, so standard pagination is not possible. Instead, `Discover.next` uses automatic continuation to allow you to 'show more' or implement infinite scrolling. 
+
+When you want to add more recommendations to those currently displayed to the user, just set the `continuation` field to `true`. Tamber will automatically generate the set of items that should be appended to the current user-session's list. The `Discover.next` user-session is reset when `Discover.next` is called without `continuation`.
 
 ```rb
+Tamber.project_key = 'your_project_key'
+
 begin
   d = Tamber::Discover.next(
     user: 'user_rlox8k927z7p',
-    item: 'item_wmt4fn6o4zlk',
-    number: 14
+    number: 10,
+    continuation: true
   )
   d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
 rescue TamberError => error
@@ -118,23 +119,6 @@ rescue TamberError => error
 end
 ```
 
-If you are tracking events in your backend and want to track `clicked` or `viewed` events when users request the next page, you can also get `next` for the user-item pair by adding the `get_recs` field to your `Event.track` call.
-
-```rb
-begin
-  e = Tamber::Event.track(
-    user: 'user_rlox8k927z7p',
-    behavior: 'clicked'
-    item:  'item_wmt4fn6o4zlk',
-    get_recs: {
-      number: 14
-    }
-  )
-  e.recommended.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
-rescue TamberError => error
-  puts error.message
-end
-```
 
 #### Trending
 

data/VERSION

@@ -1 +1 @@
-0.1.7
+0.1.8

data/lib/tamber.rb

@@ -16,6 +16,7 @@ require 'tamber/api_operations/create'
 require 'tamber/api_operations/update'
 require 'tamber/api_operations/remove'
 require 'tamber/api_operations/retrieve'
+require 'tamber/api_operations/list'
 require 'tamber/api_operations/request'
 
 require 'tamber/tamber_object'

data/lib/tamber/item.rb

@@ -3,6 +3,7 @@ module Tamber
     extend Tamber::APIOperations::Create
     extend Tamber::APIOperations::Update
     extend Tamber::APIOperations::Retrieve
+    extend Tamber::APIOperations::List
 
     # hide an item from all Discover results
     def self.hide(params={})

data/lib/tamber/user.rb

@@ -3,6 +3,7 @@ module Tamber
     extend Tamber::APIOperations::Create
     extend Tamber::APIOperations::Update
     extend Tamber::APIOperations::Retrieve
+    extend Tamber::APIOperations::List
 
     def self.search(params={})
       response = request(:post, url + '/search', params)

data/lib/tamber/version.rb

@@ -1,3 +1,3 @@
 module Tamber
-  VERSION = '0.1.7'
+  VERSION = '0.1.8'
 end

data/tamber.gemspec

@@ -15,7 +15,7 @@ spec = Gem::Specification.new do |s|
 
   s.add_dependency('rest-client', '~> 1.4')
   s.add_dependency('json', '~> 1.8.1')
-  s.add_dependency('activesupport', '~> 4.2.4')
+  s.add_dependency('activesupport', '>= 4.2.4')
 
   s.add_development_dependency('mocha', '~> 0.13.2')
   s.add_development_dependency('shoulda', '~> 3.4.0')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tamber
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - Alexi Robbins
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-14 00:00:00.000000000 Z
+date: 2017-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -43,14 +43,14 @@ dependencies:
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 4.2.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 4.2.4
 - !ruby/object:Gem::Dependency