tamber 0.1.12 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ff938263efc3c5aa656aab523beb101c9de80e86
-  data.tar.gz: d0c573e996b8f58c27d0e9ec47f189d2691d22ec
+SHA256:
+  metadata.gz: f6874b17a7d9328f7791b912e6dd01d91c1eb86ce23b65b53ed7b1513ae311e2
+  data.tar.gz: 53473bb87d8a459214734df59185a85c4c49fb9ac994ed394c3a6710c11e5c31
 SHA512:
-  metadata.gz: babeb332768806e4d7a7d55f6dd79ab74557d75325ca7203298533727fa38680871e5d7a9519e294d433757c467cd01f5998e40b5793cca3032eb24d2ded23a4
-  data.tar.gz: 69712d840fef4413e9626e65453f9113bf5a6ac166b65aee443da4efdd9dc382dad965b60b19fd0c0844f1c6ae2630541360430f06d52366c2c0132bec1d0244
+  metadata.gz: e7bc1dc7e737156ff16bc0db8b79cd838b181a4acb56dee831ea81b05c0ea1343e9b1ed8080c44816986080d38b0ff26df5d0c80e7f76f87079098d177a69d35
+  data.tar.gz: 527dfd80c96fb25091298212f5d61baa07e70fa3ca4e395253f41454b583cc9c6798b6b48018cc32f19e72b8345f46f18dde9962fdb86a6881d196dafce09149

data/.travis.yml

@@ -4,8 +4,8 @@ before_install:
   - gem update bundler # -v 1.7.14 if a specific version is needed
 
 rvm:
-  - 1.9.3
   - 2.0.0
   - 2.1
   - 2.2
+  - 2.5
   - jruby-19mode

data/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Tamber, Inc.
+Copyright (c) 2019 Tamber, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -2,7 +2,7 @@
 
 Recommendation engines for developers, easy as π. Build blazing fast, head-scratchingly accurate hosted recommendation engines in minutes.
 
-The Tamber iOS SDK makes it easy to track events (user-item interactions) and get recommendations for your users inside your iOS app. 
+The Tamber iOS SDK makes it easy to track events (user-item interactions) and get recommendations for your users in real time. 
 
 [Get a free api key][homepage] to get started.
 
@@ -48,7 +48,10 @@ begin
     user: 'user_rlox8k927z7p',
     behavior: 'like'
     item:  'item_wmt4fn6o4zlk',
-    context: ["homepage", "featured_section"]
+    context: {
+      "page": "homepage", 
+      "section": "featured_section"
+    }
   )
 rescue TamberError => error
   puts error.message
@@ -64,7 +67,7 @@ The primary methods of discovery in Tamber are the `Discover.next` and `Discover
 
 #### Up Next
 
-Don't make an item page a deadend. Keep users engaged by creating paths 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.
+Don't make an item page a dead-end. Keep users engaged by creating paths of discovery as they navigate from item to item, always showing the right mix of items they should check out next. Just supply the user and the item that they are navigating to / looking at.
 
 ```rb
 begin
@@ -126,21 +129,21 @@ Help your users keep their fingers on the pulse of your platform by showing them
 
 ```rb
 begin
-  d = Tamber::Discover.hot() // the hottest (trending) items
+  d = Tamber::Discover.hot # the hottest (trending) items
   d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
 end
 
 begin
-  d = Tamber::Discover.popular() // the hottest (trending) items
+  d = Tamber::Discover.popular # the most popular items
 end
 
 # BETA endpoints
 begin
-  d = Tamber::Discover.uac() // the most up-and-coming items
+  d = Tamber::Discover.uac # the most up-and-coming items
 end
 
 begin
-  d = Tamber::Discover.new() // the newest items
+  d = Tamber::Discover.new # the newest items
 end
 ```
 
@@ -150,19 +153,19 @@ Tamber allows you to use lower-level methods to get lists of recommended items,
 
 ```rb
 begin
-  Tamber::Discover.basicRecommended(user: 'user_rlox8k927z7p').each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
+  Tamber::Discover::Basic.recommended(user: 'user_rlox8k927z7p').each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
 rescue TamberError => error
   puts error.message
 end
 
 begin
-  Tamber::Discover.basicSimilar(item: 'item_wmt4fn6o4zlk').each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
+  Tamber::Discover::Basic.Similar(item: 'item_wmt4fn6o4zlk').each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
 rescue TamberError => error
   puts error.message
 end
 
 begin
-  Tamber::Discover.basicRecommendedSimilar(
+  Tamber::Discover::Basic.RecommendedSimilar(
     user: 'user_rlox8k927z7p',
     item: 'item_wmt4fn6o4zlk'
   ).each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}

data/VERSION

@@ -1 +1 @@
-0.1.12
+0.2.2

data/lib/tamber.rb

@@ -13,6 +13,7 @@ require 'json'
 require 'tamber/version'
 
 require 'tamber/api_operations/create'
+require 'tamber/api_operations/save'
 require 'tamber/api_operations/update'
 require 'tamber/api_operations/remove'
 require 'tamber/api_operations/retrieve'

data/lib/tamber/api_operations/remove.rb

@@ -3,7 +3,7 @@ module Tamber
     module Remove
       def remove(params={})
         response = request(:get, url+"/remove", params)
-        # initialize_from(response, opts)
+        Util.convert_to_tamber_object(response)
       end
     end
   end

data/lib/tamber/api_operations/save.rb

@@ -0,0 +1,10 @@
+module Tamber
+  module APIOperations
+    module Save
+      def save(params={})
+        response = request(:post, url+"/save", params)
+        Util.convert_to_tamber_object(response)
+      end
+    end
+  end
+end

data/lib/tamber/api_resource.rb

@@ -10,8 +10,11 @@ module Tamber
       if self == APIResource
         raise TamberError.new('APIResource is an abstract class.  You should perform actions on its subclasses (Event, Discover, etc.)')
       end
+
       if class_name.downcase == "basic"
         "/discover/#{CGI.escape(class_name.downcase)}"
+      elsif class_name.downcase == "usertrend"
+        "/discover/user_trend"
       else
         "/#{CGI.escape(class_name.downcase)}"
       end

data/lib/tamber/discover.rb

@@ -45,7 +45,10 @@ module Tamber
       Util.convert_to_tamber_object(response)
     end
 
-    
+    def self.uac(params={})
+      response = request(:get, self.uac_url, params)
+      Util.convert_to_tamber_object(response)
+    end
 
     def self.recommended_url
       url + '/recommended'
@@ -83,18 +86,51 @@ module Tamber
       url + '/new'
     end
 
+    class UserTrend < APIResource
+      def self.popular(params={})
+        response = request(:get, self.popular_url, params)
+        Util.convert_to_tamber_object(response)
+      end 
+
+      def self.hot(params={})
+        response = request(:get, self.hot_url, params)
+        Util.convert_to_tamber_object(response)
+      end
+
+      def self.uac(params={})
+        response = request(:get, self.uac_url, params)
+        Util.convert_to_tamber_object(response)
+      end
+
+      def self.popular_url
+        url + '/popular'
+      end
+
+      def self.hot_url
+        url + '/hot'
+      end
+
+      def self.uac_url
+        url + '/uac'
+      end
+    end
+
+    # deprecated
     class Basic < APIResource
       def self.recommended(params={})
+        warn "[DEPRECATION] `Discover.Basic.recommended` is deprecated.  Please use `Discover.recommended` instead."
         response = request(:get, self.recommended_url, params)
         Util.convert_to_tamber_object(response)
       end 
 
       def self.similar(params={})
+        warn "[DEPRECATION] `Discover.Basic.similar` is deprecated.  Please use `Discover.next` instead."
         response = request(:get, self.similar_url, params)
         Util.convert_to_tamber_object(response)
       end
 
       def self.recommendedSimilar(params={})
+        warn "[DEPRECATION] `Discover.Basic.recommendedSimilar` is deprecated.  Please use `Discover.next` instead."
         response = request(:get, self.recommendedSimilar_url, params)
         Util.convert_to_tamber_object(response)
       end

data/lib/tamber/item.rb

@@ -1,10 +1,17 @@
 module Tamber
   class Item < APIResource
     extend Tamber::APIOperations::Create
+    extend Tamber::APIOperations::Save
     extend Tamber::APIOperations::Update
     extend Tamber::APIOperations::Retrieve
     extend Tamber::APIOperations::List
 
+    # hide an item from all Discover results
+    def self.batch(params={})
+      response = request(:post, self.batch_url, params)
+      Util.convert_to_tamber_object(response)
+    end
+
     # hide an item from all Discover results
     def self.hide(params={})
       response = request(:post, self.hide_url, params)
@@ -23,6 +30,10 @@ module Tamber
       Util.convert_to_tamber_object(response)
     end
 
+    def self.batch_url
+      url + '/batch'
+    end
+
     def self.hide_url
       url + '/hide'
     end

data/lib/tamber/user.rb

@@ -1,12 +1,19 @@
 module Tamber
   class User < APIResource
     extend Tamber::APIOperations::Create
-    extend Tamber::APIOperations::Update
+    extend Tamber::APIOperations::Save
     extend Tamber::APIOperations::Retrieve
     extend Tamber::APIOperations::List
 
+    def self.update(params={})
+      warn "[DEPRECATION] `User.update` is deprecated.  Please use `User.save` instead."
+      response = request(:post, url + '/update', params)
+      Util.convert_to_tamber_object(response)
+    end
+
     def self.search(params={})
-      response = request(:post, url + '/search', params)
+      warn "[DEPRECATION] `User.search` is deprecated.  Please use `User.list` instead."
+      response = request(:post, url + '/list', params)
       Util.convert_to_tamber_object(response)
     end
 
@@ -14,6 +21,18 @@ module Tamber
       response = request(:post, url + '/merge', params)
       Util.convert_to_tamber_object(response)
     end
+
+    # Deprecated in api version 2020-6-11
+    def self.update(params={})
+      warn "[DEPRECATION] `User.update` is deprecated.  Please use `User.save` instead."
+      response = request(:post, url + '/save', params)
+      Util.convert_to_tamber_object(response)
+    end
+
+    def self.tests(params={})
+      response = request(:get, url + '/tests', params)
+      Util.convert_to_tamber_object(response)
+    end
     
   end
 end

data/lib/tamber/version.rb

@@ -1,3 +1,3 @@
 module Tamber
-  VERSION = '0.1.12'
+  VERSION = '0.2.2'
 end

data/tamber.gemspec

@@ -13,8 +13,8 @@ spec = Gem::Specification.new do |s|
   s.authors = ['Alexi Robbins', 'Mark Canning']
   s.email = ['alexi@tamber.com', 'argusdusty@tamber.com']
 
-  s.add_dependency('rest-client', '~> 1.4')
-  s.add_dependency('json', '~> 1.8.1')
+  s.add_dependency('rest-client', '~> 2.0')
+  s.add_dependency('json', '>= 1.8.1')
   s.add_dependency('activesupport', '>= 4.2.4')
 
   s.add_development_dependency('mocha', '~> 0.13.2')

data/test/discover_test.rb

@@ -29,6 +29,13 @@ module Tamber
     #     d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
     #   end
     # end
+     
+    # should "return new" do
+    #   begin
+    #     d = Tamber::Discover.new()
+    #     d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
+    #   end
+    # end
 
     should "return hot" do
       begin
@@ -51,13 +58,6 @@ module Tamber
       end
     end
 
-    should "return new" do
-      begin
-        d = Tamber::Discover.new()
-        d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
-      end
-    end
-
     should "return recommendations" do
       begin
         d = Tamber::Discover.recommended(
@@ -93,5 +93,14 @@ module Tamber
       end
     end
 
+    should "return user hot" do
+      begin
+        d = Tamber::Discover::UserTrend.hot(
+          :user => 'user_jctzgisbru'
+        )
+        d.each { |rec| puts "item: #{rec.item}, score: #{rec.score}"}
+      end
+    end
+
   end
 end

data/test/event_test.rb

@@ -9,8 +9,7 @@ module Tamber
           :item =>  'item_i5gq90scc1',
           :behavior => 'mention',
           :hit => true,
-          :context => ['recommended', 'detail-view'],
-          :get_recs => {}
+          :context => {'page'=>'recommended'}
         )
         puts e
       end

data/test/test_helper.rb

@@ -9,6 +9,7 @@ class Test::Unit::TestCase
 
   setup do
     Tamber.project_key = "Mu6DUPXdDYe98cv5JIfX"
+    Tamber.api_version = "2020-6-11"
     Tamber.open_timeout = 3
     Tamber.read_timeout = 2
   end

data/test/user_test.rb

@@ -59,19 +59,19 @@ module Tamber
       end
     end
 
-    should "search user" do
-      begin
-        users = Tamber::User.search(
-          :filter => {
-            'city' => 'Mountain View, CA'
-          }
-        )
-        puts users.inspect
-        # assert users.length >= 1
-      rescue TamberError => error
-        puts error.message
-      end
-    end
+    # should "search user" do
+    #   begin
+    #     users = Tamber::User.search(
+    #       :filter => {
+    #         'city' => 'Mountain View, CA'
+    #       }
+    #     )
+    #     puts users.inspect
+    #     # assert users.length >= 1
+    #   rescue TamberError => error
+    #     puts error.message
+    #   end
+    # end
 
     # Breaks production test
     # should "merge user" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tamber
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.2.2
 platform: ruby
 authors:
 - Alexi Robbins
@@ -9,104 +9,104 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-04-21 00:00:00.000000000 Z
+date: 2020-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.8.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.8.1
 - !ruby/object:Gem::Dependency
   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
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.13.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.13.2
 - !ruby/object:Gem::Dependency
   name: shoulda
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.4.0
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: Tamber is the easiest way to put head-scratchingly accurate, real time
@@ -118,8 +118,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .travis.yml
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE
 - README.md
@@ -133,6 +133,7 @@ files:
 - lib/tamber/api_operations/remove.rb
 - lib/tamber/api_operations/request.rb
 - lib/tamber/api_operations/retrieve.rb
+- lib/tamber/api_operations/save.rb
 - lib/tamber/api_operations/update.rb
 - lib/tamber/api_resource.rb
 - lib/tamber/behavior.rb
@@ -161,17 +162,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.7.3
 signing_key: 
 specification_version: 4
 summary: Ruby bindings for the Tamber API