rees46 0.0.1.2 → 0.0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b251633a47ec300432c4e03b4dda9bebf8c09285
-  data.tar.gz: 1b793605c8b0bb8d034cc0530ad460031799b5e8
+  metadata.gz: 36e3efd1ab3953c01cd2d2ea9f82fce9035ef679
+  data.tar.gz: c0158a1f2f3f5a5f68faa45fa8c89144d3c2c577
 SHA512:
-  metadata.gz: cc500a2eacd29bf9f72aee4920b79ce2f5daf287d053632800c37160bc9dcf60032cf4f7d8a25e014b8735100de3c416dc3268a3cc0c856a7ac355ec5b0b7053
-  data.tar.gz: 082e61ade5c57fc60d655f11b9459697647fa3e67ce7ffd84f80a1ef3ba8f264932bba7e4354b5c54e75e0343da0376355626212511223b174cf3b9993c8c898
+  metadata.gz: 5c23f50acb6324d8ba68be37bd08ee4ecdddcde78c3824c2cffc53f9a585f1c59b203fdfa9de1aa7d9074365739580c10643603c3daa7cf8f3383f1fb74f95bd
+  data.tar.gz: fa6f00152dc4306ada8c4ac1b71a9cde9b968327933501cbc34318848bb3d4a1b11e57bda92ae1da08924976e46aa45349ad1640560110894680a17ec0f5b906

data/README.md

@@ -17,7 +17,7 @@ bundle
 ```ruby
 REES46.configure do |config|
   config.shop_id = "КОД_ВАШЕГО_МАГАЗИНА"
-  config.user_id = ID_ТЕКУЩЕГО_ПОЛЬЗОВАТЕЛЯ
+  config.user_id = "ID_ТЕКУЩЕГО_ПОЛЬЗОВАТЕЛЯ"
   config.session_id = "ID_СЕССИИ_ТЕКУЩЕГО_ПОЛЬЗОВАТЕЛЯ"
 end
 ```
@@ -64,9 +64,47 @@ REES46::Tracker.rate(item: { item_id: 5, price: 1499.99, is_available: true }, r
 Все действия необходимо производить только после инициализации модуля.
 Запросы возвращают массив ID товаров.
 
+Все рекомендеры принимают опциональные параметры:
+```item``` - означает текущий просматриваемый товар.
+
+```cart``` - означает текущее содержимое корзины.
+
+Лучше всего их передавать всегда, это повысит качество рекомендаций.
+
+
 ### Вас это заинтересует
 ```ruby
 REES46::Recommender.interesting(item: 4291, cart: [2,5,6])
 ```
-```item``` - опциональный параметр, означает текущий просматриваемый товар.
-```cart``` - опциональный параметр, означает текущее содержимое корзины.
+
+### Популярные
+```ruby
+REES46::Recommender.popular(category: 256)
+```
+Здесь передается ID просматриваемой категории. Если не передать этот параметр - будут рекомендации по всем категориям.
+
+
+### С этим товаром покупают
+```ruby
+REES46::Recommender.also_bought(item: 23)
+```
+В данном случае item - обязательный параметр.
+
+### Посмотрите также
+```ruby
+REES46::Recommender.see_also(cart: [5, 23])
+```
+В данном случае cart - обязательный параметр.
+
+### Вы недавно смотрели
+```ruby
+REES46::Recommender.recently_viewed
+```
+Не требует дополнительных параметров
+
+### Прямо сейчас покупают
+```ruby
+REES46::Recommender.buying_now
+```
+
+[Дополнительная информация](http://rees46.com/integration)

data/lib/rees46/recommender.rb

@@ -10,6 +10,8 @@ module REES46
       end
 
       def recommend(recommender_type, params)
+        raise REES46::NotConfiguredError.new('REES46 should be configured first') unless REES46.configured?
+        
         result = REES46::Requester.recommend(normalize(params, recommender_type))
 
         if result.code == 200

data/lib/rees46/version.rb

@@ -1,3 +1,3 @@
 module REES46
-  VERSION = "0.0.1.2"
+  VERSION = "0.0.2.0"
 end

data/rees46.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_dependency 'httparty', '~> 0.13'
-  s.add_dependency 'activesupport', '~> 0'
+  s.add_dependency 'activesupport', '> 3'
 
   s.add_development_dependency 'bundler', '~> 1.6'
   s.add_development_dependency 'rake', '~> 10.3'

data/spec/workflow_spec.rb

@@ -1,18 +1,142 @@
 require 'spec_helper'
 require 'rees46'
 
-describe 'workflow' do
-  it 'pushes the event' do
-    REES46.configure do |c|
-      c.shop_id = test_shop_id
-      c.user_id = test_user_id
-      c.session_id = test_session_id
+describe 'Примеры использования' do
+  let(:shop_id) { 'b6ef5e0003904ba8245eb7aac0c286' }
+  let(:session_id) { '7b710da8-9b32-4a7b-ba2c-a8f14e635c98' }
+  let(:user_id) { 46 }
+  before(:each) { WebMock.allow_net_connect! }
+
+  describe 'Инициализация' do
+    context 'ID магазина' do
+      it 'Необходимо передавать всегда' do
+        REES46.configure do |c|
+          c.shop_id = shop_id
+        end
+
+        expect(REES46.configuration.shop_id).to be_present
+      end
+    end
+
+    context 'ID сессии' do
+      context 'Когда нет' do
+        it 'Модуль генерирует ID сессии' do
+          REES46.configure do |c|
+            c.shop_id = shop_id
+          end
+
+          expect(REES46.configuration.session_id).to be_a(String)
+        end
+      end
+
+      context 'Когда есть' do
+        it 'Необходимо передать ее в модуль' do
+          REES46.configure do |c|
+            c.shop_id = shop_id
+            c.session_id = session_id
+            c.user_id = user_id
+          end
+
+          expect(REES46.configuration.user_id).to be_present
+        end
+      end
+    end
+
+    context 'ID пользователя' do
+      it 'Необходимо передавать в модуль' do
+        REES46.configure do |c|
+          c.shop_id = shop_id
+          c.session_id = session_id
+          c.user_id = user_id
+        end
+      end
+    end
+  end
+
+  describe 'Отслеживание событий' do
+    it 'Возможно только после инициализации модуля' do
+      expect{
+        REES46::Tracker.view(item: { item_id: 15 })
+      }.to raise_error(REES46::NotConfiguredError)
     end
 
-    # REES46::Tracker.view(item: {})
-    # REES46::Tracker.cart(item: {})
-    # REES46::Tracker.cart(item: {})
-    # REES46::Tracker.remove_from_cart(item: {})
-    # REES46::Tracker.purchase(items: {})
+    context 'Типы событий' do
+      before(:each) do
+        REES46.configure do |c|
+          c.shop_id = shop_id
+          c.session_id = session_id
+          c.user_id = user_id
+        end
+      end
+
+      let(:item1) { { item_id: 5, price: 10_999.99, is_available: true, category: 15 } }
+      let(:item2) { { item_id: 39, price: 458.10, is_available: true, category: 4 } }
+
+      it 'Просмотр товара' do
+        expect(REES46::Tracker.view(item: item1)).to eq({'status' => 'success'})
+      end
+
+      it 'Добавление товара в корзину' do
+        expect(REES46::Tracker.cart(item: item1)).to eq({'status' => 'success'})
+      end
+
+      it 'Удаление товара из корзины' do
+        expect(REES46::Tracker.remove_from_cart(item: item1)).to eq({'status' => 'success'})
+      end
+
+      it 'Покупка' do
+        expect(REES46::Tracker.purchase(items: [item1.merge(amount: 2), item2.merge(amount: 5)], order_id: 91)).to eq({'status' => 'success'})
+      end
+
+      it 'Оценка' do
+        expect(REES46::Tracker.rate(item: item1, rating: 3)).to eq({'status' => 'success'})
+      end
+    end
+  end
+
+  describe 'Запрос рекомендаций' do
+    it 'Возможен только после инициализации модуля' do
+      expect{
+        REES46::Recommender.interesting
+      }.to raise_error(REES46::NotConfiguredError)
+    end
+
+    context 'Виды рекомендаций' do
+      before(:each) do
+        REES46.configure do |c|
+          c.shop_id = shop_id
+          c.session_id = session_id
+          c.user_id = user_id
+        end
+      end
+
+      it 'Возможно, вас это заинтересует' do
+        expect(REES46::Recommender.interesting).to be_an(Array)
+      end
+
+      it 'Популярные товары' do
+        expect(REES46::Recommender.popular(category: 4)).to be_an(Array)
+      end
+
+      it 'Вы недавно смотрели' do
+        expect(REES46::Recommender.recently_viewed).to be_an(Array)
+      end
+
+      it 'Похожие товары' do
+        expect(REES46::Recommender.similar(item: 5)).to be_an(Array)
+      end
+
+      it 'С этим также покупают' do
+        expect(REES46::Recommender.also_bought(item: 5)).to be_an(Array)
+      end
+
+      it 'Посмотрите также' do
+        expect(REES46::Recommender.see_also(cart: [5, 39])).to be_an(Array)
+      end
+
+      it 'Прямо сейчас покупают' do
+        expect(REES46::Recommender.buying_now).to be_an(Array)
+      end
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rees46
 version: !ruby/object:Gem::Version
-  version: 0.0.1.2
+  version: 0.0.2.0
 platform: ruby
 authors:
 - Anton Zhavoronkov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-07 00:00:00.000000000 Z
+date: 2014-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -28,16 +28,16 @@ dependencies:
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement