appboy 0.0.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b9b08323e1d2602a33183a99f18a06a7bb59ad1e
-  data.tar.gz: 984094644be733e86940bb0e4b6d2c0dcf397d36
+  metadata.gz: 9222a09ffa3f7d75b06a1366c1845b02c42ccef8
+  data.tar.gz: 45ada71360cdd58a539e7d4763e6a9cd2b4cf1f7
 SHA512:
-  metadata.gz: 4f39f353d4618c26b0b340ea7580d535042f40baf1b03e74c578d80066db094b70e65f283e1a408a54b6946087a436417788da032265e2e4168131fcce10fc8c
-  data.tar.gz: ec645bebf908780c2d633bdb18b7e211b72d304024ccf5afcb02e519921db65b49373bd3626489e4dd8573779a6ae2fcc2427fa29502800d901535907c1cbc8b
+  metadata.gz: 7811017c20de7850940245f6e8d6b921fd454d4fe8c007d7628c6622c4f0b86a2297151562c73beebbc6f8adb64c56417446a21396aca68611aa4b1e0fea0c64
+  data.tar.gz: db42fb17c83fa3fa23a14fb23d86bd1a7517c1e1e746c8732dc376511cba5c9e6f9e95f88ba08c11ed24c0186803f6832701fdf515b964d5a9421b80d450bb8a

data/.gitignore

@@ -3,6 +3,8 @@
 .bundle
 .config
 .yardoc
+.ruby-version
+.env
 Gemfile.lock
 InstalledFiles
 _yardoc

data/.rspec

@@ -0,0 +1 @@
+--color

data/README.md

@@ -1,6 +1,6 @@
 # Appboy
 
-A wrapper for the Appboy REST API using HTTParty
+A wrapper for the Appboy REST API.
 
 ## Installation
 
@@ -21,51 +21,141 @@ Or install it yourself as:
 ### Initializing API
 
 ```ruby
-api = Appboy::API.new('<secret>', '<app-group-id>')
+api = Appboy::API.new('<app-group-id>')
 ```
 
-### Track User
+### Track User Attributes
+
+See: [User Attributes Object Specification](https://documentation.appboy.com/REST_APIs/User_Data#user-attribute-object)
 
 ```ruby
-api.track [{external_id: 123,
-            first_name: 'John',
-            last_name: 'Smith',
-            gender: 'male',
-            email: 'jsmith@example.com'}]
+api.track_users(attributes: [{
+  external_id: 123,
+  first_name: 'John',
+  last_name: 'Smith',
+  gender: 'male',
+  email: 'jsmith@example.com'
+}])
+```
+
+##### Track Attributes for Single User
+
+```ruby
+api.track_attribute(external_id: 123, first_name: 'John', ...)
 ```
 
 ### Track Event
 
+See: [Event Object Specification](https://documentation.appboy.com/REST_APIs/User_Data#event-object)
+
+```ruby
+api.track_users(events: [{
+  external_id: 123,
+  name: 'add-to-cart',
+  time: Time.now
+}]
+```
+
+##### Track Events for Single User
+
 ```ruby
-events = [
-  {external_id: 123, name: 'add-to-cart', time: Time.now}
-]
-api.track [], events
+api.track_event(external_id: 123, name: 'Event', ...)
 ```
 
 ### Track Purchase
+
+See: [Purchase Object Specfication](https://documentation.appboy.com/REST_APIs/User_Data#purchase-object)
+
+```ruby
+api.track_users(purchases: [{
+  external_id: 123,
+  product_id: 456,
+  currency: 'CAD',
+  price: 1.99,
+  time: Time.now
+}]
+```
+
+##### Track Purchases for Single User
+
+```ruby
+api.track_purchase(external_id: 123, product_id: 456, ...)
+```
+
+### Track Everything for Everyone All at Once
+
+```ruby
+api.track_users(purchases: purchases, events: events, attributes: attributes)
+```
+
 ### Send Message
 
+See: [Platform Push Object Specifications](https://documentation.appboy.com/REST_APIs/Messaging#platform-push-object)
+
+##### Messages Payload
+
+```ruby
+messages = {
+  android_push: { alert: 'Hello Android' },
+  apple_push:   { alert: "Hello iOS" }
+}
+```
+
+##### Option A, Using External User IDs
+
 ```ruby
-message  = {android_push: {alert: 'Hello Android'},
-            apple_push:   {alert: "Hello iOS"}}
+api.send_messages(messages: messages, external_user_ids: [123, 456])
+```
 
-user_ids = [123, 456]
+##### Option B, Using Segment ID
 
-api.send_message(message, user_ids)
+```ruby
+api.send_messages(messages: messages, segment_id: '<segment-id>')
 ```
 
+
 ### Schedule Message
 
+See: [Platform Push Object Specifications](https://documentation.appboy.com/REST_APIs/Messaging#platform-push-object)
+
 ```ruby
-message    = {android_push: {alert: 'Hello Android'},
-              apple_push:   {alert: "Hello iOS"}}
-segment_id = '<segment id>'
-send_at    = Time.new(2014, 3, 12)
+api.schedule_messages(send_at: 1.hour.since, messages: messages, segment_id: '<segment-id>')
+```
 
-api.schedule_message(send_at, message, segment_id)
+### Changing Email Subscription
+
+See: [Changing Email Subscription Status](https://documentation.appboy.com/REST_APIs/Email_Sync#post)
+
+```ruby
+api.email_status(email: 'john@example.com', status: :opted_in)
 ```
 
+### List Segments
+
+See: [Segment Export](https://documentation.appboy.com/REST_APIs/Export)
+
+```ruby
+api.list_segments
+```
+
+### Export Users
+
+See: [User Export](https://documentation.appboy.com/REST_APIs/Export#user-export)
+
+#### By IDs
+
+```ruby
+api.export_users(external_ids: [1])
+```
+
+#### By Segment
+
+```ruby
+api.export_users(segment_id: segment_id, callback_endpoint: 'https://example.com')
+```
+
+
+
 ## Contributing
 
 1. Fork it

data/appboy.gemspec

@@ -4,22 +4,30 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'appboy/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "appboy"
+  spec.name          = 'appboy'
   spec.version       = Appboy::VERSION
-  spec.authors       = ["Josh Nussbaum"]
-  spec.email         = ["josh@godynamo.com"]
+  spec.authors       = ['Josh Nussbaum', 'Hugo Bastien']
+  spec.email         = %w(josh@godynamo.com hugo@godynamo.com)
   spec.description   = %q{Appboy wrapper}
   spec.summary       = %q{A wrapper for the Appboy REST API, track users/events/purchases, send & schedule messages}
-  spec.homepage      = "http://appboy.com"
-  spec.license       = "MIT"
+  spec.homepage      = 'http://appboy.com'
+  spec.license       = 'MIT'
 
   spec.files         = `git ls-files`.split($/)
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_dependency 'httparty'
-  spec.add_development_dependency "bundler", "~> 1.3"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec"
+  spec.add_dependency 'virtus'
+  spec.add_dependency 'faraday'
+  spec.add_dependency 'faraday_middleware'
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'dotenv'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'activesupport'
+  spec.add_development_dependency 'factory_girl'
 end

data/lib/appboy.rb

@@ -1,6 +1,8 @@
-require "appboy/version"
-require 'httparty'
+require 'json'
+require 'virtus'
+require 'appboy/version'
 
 module Appboy
-  autoload :API, "appboy/api"
+  autoload :API, 'appboy/api'
+  autoload :REST, 'appboy/rest'
 end

data/lib/appboy/api.rb

@@ -1,42 +1,30 @@
+require 'appboy/deprecated'
+require 'appboy/endpoints/track_users'
+require 'appboy/endpoints/send_messages'
+require 'appboy/endpoints/schedule_messages'
+require 'appboy/endpoints/email_status'
+
 module Appboy
   class API
-    include HTTParty
-
-    base_uri 'https://api.appboy.com'
+    include Appboy::Deprecated
 
-    def initialize(secret, app_group_id)
-      @secret, @app_group_id = secret, app_group_id
-    end
+    include Appboy::Endpoints::TrackUsers
+    include Appboy::Endpoints::SendMessages
+    include Appboy::Endpoints::ScheduleMessages
+    include Appboy::Endpoints::EmailStatus
 
-    def track(attributes, events=[], purchases=[])
-      post '/users/track', company_secret: @secret,
-                           app_group_id:   @app_group_id,
-                           attributes:     attributes,
-                           events:         events,
-                           purchases:      purchases
+    def export_users(**payload)
+      Appboy::REST::ExportUsers.new.perform(app_group_id, payload)
     end
 
-    def send_message(message, user_ids, segment_id = nil)
-      post '/messages/send', company_secret:    @secret,
-                             app_group_id:      @app_group_id,
-                             messages:          message,
-                             external_user_ids: user_ids,
-                             segment_ids:       [segment_id].compact
+    def list_segments
+      Appboy::REST::ListSegments.new.perform(app_group_id)
     end
 
-    def schedule_message(date, message, segment_id, local_timezone=false)
-      post '/messages/schedule', company_secret:            @secret,
-                                 segment_ids:               [segment_id],
-                                 send_at:                   date,
-                                 deliver_in_local_timezone: local_timezone,
-                                 messages:                  message
-    end
+    attr_reader :app_group_id
 
-  private
-    def post(url, payload)
-      response = self.class.post(url, query: payload)
-      puts response.inspect
-      response['message'] == 'success'
+    def initialize(app_group_id)
+      @app_group_id = app_group_id
     end
   end
 end

data/lib/appboy/deprecated.rb

@@ -0,0 +1,19 @@
+module Appboy
+  module Deprecated
+    def track(attribute, events = [], purchases = [])
+      warn('[Appboy] `track` is deprecated. Please use `track_users` instead.')
+      track_users(attribute: attribute, events: events, purchases: purchases)
+    end
+
+    def send_message(message, user_ids, segment_ids = nil)
+      warn('[Appboy] `send_message` is deprecated. Please use `send_messages` instead.')
+      send_messages(messages: message, user_ids: user_ids, segment_ids: segment_ids)
+    end
+
+    def schedule_message(date, message, segment_id, local_timezone = false)
+      warn('[Appboy] `schedule_message` is deprecated. Please use `schedule_messages` instead.')
+      schedule_messages(send_at: date, messages: message,
+        segment_id: segment_id, local_timezone: local_timezone)
+    end
+  end
+end

data/lib/appboy/endpoints/email_status.rb

@@ -0,0 +1,13 @@
+module Appboy
+  module Endpoints
+    module EmailStatus
+      def email_status(**payload)
+        email_status_service.new(app_group_id, payload).perform
+      end
+
+      def email_status_service
+        Appboy::REST::EmailStatus
+      end
+    end
+  end
+end

data/lib/appboy/endpoints/schedule_messages.rb

@@ -0,0 +1,15 @@
+module Appboy
+  module Endpoints
+    module ScheduleMessages
+      def schedule_messages(**payload)
+        schedule_messages_service.new(app_group_id, payload).perform
+      end
+
+      private
+
+      def schedule_messages_service
+        Appboy::REST::ScheduleMessages
+      end
+    end
+  end
+end

data/lib/appboy/endpoints/send_messages.rb

@@ -0,0 +1,15 @@
+module Appboy
+  module Endpoints
+    module SendMessages
+      def send_messages(**payload)
+        send_messages_service.new(app_group_id, payload).perform
+      end
+
+      private
+
+      def send_messages_service
+        Appboy::REST::SendMessages
+      end
+    end
+  end
+end

data/lib/appboy/endpoints/track_users.rb

@@ -0,0 +1,29 @@
+module Appboy
+  module Endpoints
+    module TrackUsers
+      attr_writer :track_users_service
+
+      def track_users(**payload)
+        track_users_service.perform(app_group_id, payload)
+      end
+
+      def track_purchase(payload)
+        track_users(purchases: [payload])
+      end
+
+      def track_event(payload)
+        track_users(events: [payload])
+      end
+
+      def track_attribute(payload)
+        track_users(attributes: [payload])
+      end
+
+      private
+
+      def track_users_service
+        @track_users_service ||= Appboy::REST::TrackUsers.new
+      end
+    end
+  end
+end

data/lib/appboy/http.rb

@@ -0,0 +1,24 @@
+require 'faraday'
+require 'faraday_middleware'
+
+module Appboy
+  class HTTP
+    def post(path, payload)
+      connection.post path do |request|
+        request.body = payload
+      end
+    end
+
+    def get(path, query)
+      connection.get path, query
+    end
+
+    def connection
+      @connection ||= Faraday.new(url: 'https://api.appboy.com') do |connection|
+        connection.request :json
+
+        connection.adapter Faraday.default_adapter
+      end
+    end
+  end
+end

data/lib/appboy/rest.rb

@@ -0,0 +1,7 @@
+require 'appboy/rest/base'
+require 'appboy/rest/track_users'
+require 'appboy/rest/send_messages'
+require 'appboy/rest/schedule_messages'
+require 'appboy/rest/email_status'
+require 'appboy/rest/export_users'
+require 'appboy/rest/list_segments'

data/lib/appboy/rest/base.rb

@@ -0,0 +1,15 @@
+require 'appboy/http'
+
+module Appboy
+  module REST
+    class Base
+      attr_writer :http
+
+      private
+
+      def http
+        @http ||= Appboy::HTTP.new
+      end
+    end
+  end
+end