koko-ai-ruby 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 43b75c6a75c5221b08a42c04b0e034b4911c0eaf
+  data.tar.gz: cabf0e08433f832707323633f91218952817c034
+SHA512:
+  metadata.gz: b004b011c07415e812bffc8a379fc1bbeb790ad77f93137a4774dfc1c46fe275347dcc5c874000478758d0163a104571aeaeab172f06c4c640608a66ac456267
+  data.tar.gz: 74617a6b797026b45ae707dabdab5da772752d6c9ee424c59df2e45b74478d99dc10de0bbca062e426f26dfe492d266a230653360c2295e6237bc0d646c0c398

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,65 @@
+PATH
+  remote: .
+  specs:
+    koko-ai-ruby (0.0.1)
+      commander (~> 4.4)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.22.5)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
+    addressable (2.5.1)
+      public_suffix (~> 2.0, >= 2.0.2)
+    coderay (1.1.1)
+    commander (4.4.3)
+      highline (~> 1.7.2)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    hashdiff (0.3.4)
+    highline (1.7.8)
+    i18n (0.8.4)
+    method_source (0.8.2)
+    multi_json (1.12.1)
+    pry (0.10.4)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    public_suffix (2.0.5)
+    rake (10.5.0)
+    rspec (2.99.0)
+      rspec-core (~> 2.99.0)
+      rspec-expectations (~> 2.99.0)
+      rspec-mocks (~> 2.99.0)
+    rspec-core (2.99.2)
+    rspec-expectations (2.99.2)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.99.4)
+    safe_yaml (1.0.4)
+    slop (3.6.0)
+    thread_safe (0.3.6)
+    timecop (0.8.1)
+    tzinfo (1.2.1)
+      thread_safe (~> 0.1)
+    webmock (3.0.1)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 3.0.0, < 4.0.0)
+  koko-ai-ruby!
+  pry (~> 0.10.4)
+  rake (~> 10.3)
+  rspec (~> 2.0)
+  timecop (= 0.8.1)
+  tzinfo (= 1.2.1)
+  webmock (~> 3.0.1)
+
+BUNDLED WITH
+   1.14.3

data/History.md

@@ -0,0 +1,10 @@
+
+0.0.1 / 2017-06-20
+==================
+
+  * Initial version
+
+0.0.2 / 2017-06-20
+==================
+
+  * Support all endpoints in api

data/Makefile

@@ -0,0 +1,5 @@
+test:
+	rake spec
+
+build:
+	gem build ./koko-ai.gemspec

data/README.md

@@ -0,0 +1,90 @@
+koko-ai-ruby
+==============
+
+koko-ai-ruby is a ruby client for https://docs.koko.ai
+
+## Install
+
+Into Gemfile from rubygems.org:
+```ruby
+gem 'koko-ai'
+```
+
+Into environment gems from rubygems.org:
+```ruby
+gem install 'koko-ai'
+```
+
+## Usage
+
+Create an instance of the client:
+```ruby
+koko = Koko::Tracker.new(auth: 'YOUR_AUTH_KEY')
+```
+
+Track content, see more [here](https://docs.koko.ai/#track-endpoints).
+```ruby
+koko.track_content(id: "123",
+                   created_at: Time.now,
+                   user_id: "123",
+                   type: "post",
+                   context_id: "123",
+                   content_type: "text",
+                   content: { text: "Some content" })
+
+koko.track_flag(id: "123",
+                flagger_id: "123",
+                type: "spam",
+                created_at: Time.now,
+                content: {"id":"123"})
+
+koko.track_moderation(id: "123",
+                      type: "user_warned",
+                      created_at: Time.now,
+                      content: { id:"123" })
+
+```
+
+To get behavorial classifications when tracking content, pass a block with a
+single parameter which will be populated with the results. This block will be
+called synchronously.
+```ruby
+koko.track_content(id: "123",
+                   created_at: "2016-08-29T09:12:33.001Z",
+                   user_id: "123",
+                   type: "post",
+                   context_id: "123",
+                   content_type: "text",
+                   content: { text: "Some content" }) do |classification|
+  crisis_confidence = classification.find { |c| c['label'] == 'crisis' }['confidence']
+end
+```
+
+## Testing
+
+You can use the `stub` option to Koko::Tracker.new to cause all requests to be stubbed, making it easier to test with this library.
+
+## License
+
+```
+WWWWWW||WWWWWW
+ W W W||W W W
+      ||
+    ( OO )__________
+     /  |           \
+    /o o|    MIT     \
+    \___/||_||__||_|| *
+         || ||  || ||
+        _||_|| _||_||
+       (__|__|(__|__|
+```
+
+(The MIT License)
+
+Copyright (c) 2017 Koko Inc. <us@itskoko.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/RELEASING.md

@@ -0,0 +1,10 @@
+Releasing
+=========
+
+ 1. Verify everything works with `make test build`.
+ 2. Bump version in [`version.rb`](https://github.com/itskoko/koko-ai-ruby/blob/master/lib/koko/version.rb).
+ 3. Update [`History.md`](https://github.com/itskoko/koko-ai-ruby/blob/master/History.md).
+ 4. Commit and tag `git commit -am "Release {version}" && git tag -a {version} -m "Version {version}"`.
+ 5. Build the gem with the tagged version `make build`.
+ 6. Upload to RubyGems with `gem push koko-ai-{version}.gem`.
+ 7. Upload to Github with `git push -u origin master && git push --tags`.

data/Rakefile

@@ -0,0 +1,7 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+end
+
+task :default => :spec

data/koko-ai.gemspec

@@ -0,0 +1,24 @@
+require File.expand_path('../lib/koko/tracker/version', __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name = 'koko-ai-ruby'
+  spec.version = Koko::Tracker::VERSION
+  spec.files = Dir.glob('**/*')
+  spec.require_paths = ['lib']
+  spec.summary = 'Koko AI Client'
+  spec.description = 'The Koko AI ruby client library'
+  spec.authors = ['Koko']
+  spec.email = 'us@itskoko.com'
+  spec.homepage = 'https://github.com/itskoko/koko-ai-ruby'
+  spec.license = 'MIT'
+
+  spec.add_dependency 'commander', '~> 4.4'
+
+  spec.add_development_dependency 'rake', '~> 10.3'
+  spec.add_development_dependency 'rspec', '~> 2.0'
+  spec.add_development_dependency 'tzinfo', '1.2.1'
+  spec.add_development_dependency 'timecop', '0.8.1'
+  spec.add_development_dependency 'pry', '~> 0.10.4'
+  spec.add_development_dependency 'webmock', '~> 3.0.1'
+  spec.add_development_dependency 'activesupport', '>= 3.0.0', '<4.0.0'
+end

data/lib/koko/tracker/client.rb

@@ -0,0 +1,102 @@
+require 'time'
+require 'koko/tracker/utils'
+require 'koko/tracker/defaults'
+
+module Koko
+  class Tracker
+    class Client
+      include Koko::Tracker::Utils
+
+      # public: Creates a new client
+      #
+      # attrs - Hash
+      #           :auth           - String of your authorization key
+      #           :max_queue_size - Fixnum of the max calls to remain queued (optional)
+      #           :on_error       - Proc which handles error calls from the API
+      def initialize attrs = {}
+        symbolize_keys! attrs
+
+        @auth = attrs[:auth]
+        @options = attrs
+
+        check_auth!
+      end
+
+      # public: Track content
+      #
+      # attrs - Hash (see https://docs.koko.ai/#track-endpoints)
+      def track_content attrs, &block
+        symbolize_keys! attrs
+
+        timestamp = attrs[:created_at] || Time.new
+        check_timestamp! timestamp
+        attrs[:created_at] = timestamp.to_f
+
+        response = handle_response(Request.new(path: '/track/content').post(@auth, attrs))
+
+        if block
+          block.call(response.body)
+        end
+
+        true
+      end
+
+      # public: Track flag
+      #
+      # attrs - Hash (see https://docs.koko.ai/#track-endpoints)
+      def track_flag attrs
+        symbolize_keys! attrs
+
+        timestamp = attrs[:created_at] || Time.new
+        check_timestamp! timestamp
+        attrs[:created_at] = timestamp.to_f
+
+        handle_response(Request.new(path: '/track/flag').post(@auth, attrs))
+
+        true
+      end
+
+      # public: Track moderation
+      #
+      # attrs - Hash (see https://docs.koko.ai/#track-endpoints)
+      def track_moderation attrs
+        symbolize_keys! attrs
+
+        timestamp = attrs[:created_at] || Time.new
+        check_timestamp! timestamp
+        attrs[:created_at] = timestamp.to_f
+
+        handle_response(Request.new(path: '/track/moderation').post(@auth, attrs))
+
+        true
+      end
+
+      private
+
+      # private: Checks that the auth is properly initialized
+      def check_auth!
+        fail ArgumentError, 'Auth must be initialized' if @auth.nil?
+      end
+
+      # private: Ensure response is valid
+      def handle_response(response)
+        unless response.valid?
+          if response.status >= 400 && response.status < 500
+            raise ArgumentError.new("Invalid request: #{response.body}")
+          elsif response.status >= 500 && response.status < 600
+            raise RuntimeError.new(response.body)
+          else
+            raise RuntimeError.new("Unaccepted http code: #{response.status}")
+          end
+        end
+
+        response
+      end
+
+      # private: Checks the timstamp option to make sure it is a Time.
+      def check_timestamp!(timestamp)
+        fail ArgumentError, 'Timestamp must be a Time' unless timestamp.is_a? Time
+      end
+    end
+  end
+end

data/lib/koko/tracker/defaults.rb

@@ -0,0 +1,17 @@
+module Koko
+  class Tracker
+    module Defaults
+      module Request
+        class << self
+          attr_accessor :host, :port, :path, :ssl, :headers
+        end
+
+        self.host = 'api.koko.ai'
+        self.port = 443
+        self.path = '/'
+        self.ssl = true
+        self.headers = { :accept => 'application/json' }
+      end
+    end
+  end
+end

data/lib/koko/tracker/logging.rb

@@ -0,0 +1,35 @@
+require 'logger'
+
+module Koko
+  class Tracker
+    module Logging
+      class << self
+        def logger
+          @logger ||= if defined?(Rails)
+                        Rails.logger
+                      else
+                        logger = Logger.new STDOUT
+                        logger.progname = 'Koko::Tracker'
+                        logger
+                      end
+        end
+
+        def logger= logger
+          @logger = logger
+        end
+      end
+
+      def self.included base
+        class << base
+          def logger
+            Logging.logger
+          end
+        end
+      end
+
+      def logger
+        Logging.logger
+      end
+    end
+  end
+end

data/lib/koko/tracker/request.rb

@@ -0,0 +1,79 @@
+require 'koko/tracker/defaults'
+require 'koko/tracker/utils'
+require 'koko/tracker/response'
+require 'koko/tracker/logging'
+require 'net/http'
+require 'net/https'
+require 'json'
+
+module Koko
+  class Tracker
+    class Request
+      include Koko::Tracker::Utils
+      include Koko::Tracker::Logging
+
+      attr_reader :http
+
+      # public: Creates a new request object to send analytics batch
+      #
+      def initialize(options = {})
+        options[:host] ||= Defaults::Request.host
+        options[:port] ||= Defaults::Request.port
+        options[:ssl] ||= Defaults::Request.ssl
+        options[:headers] ||= Defaults::Request.headers
+        @path = options[:path] || Defaults::Request.path
+
+        http = Net::HTTP.new(options[:host], options[:port])
+        http.use_ssl = options[:ssl]
+        http.read_timeout = 8
+        http.open_timeout = 4
+
+        @http = http
+      end
+
+      # public: Posts the write key and batch of messages to the API.
+      #
+      # returns - Response of the status and error if it exists
+      def post(auth, body)
+        status = nil
+        headers = { 'Content-Type' => 'application/json' }
+
+        begin
+          payload = JSON.generate body
+          request = Net::HTTP::Post.new(@path, headers)
+          request['authorization'] = auth
+
+          response = nil
+
+          if self.class.stub
+            status = 200
+            logger.debug "stubbed request to #{@path}: auth = #{auth}, payload = #{payload}"
+          else
+            res = @http.request(request, payload)
+            status = res.code.to_i
+            if status < 500
+              response = JSON.parse(res.body)
+            else
+              response = res.body
+            end
+          end
+        rescue Exception => e
+          logger.error e.message
+          e.backtrace.each { |line| logger.error line }
+          status = -1
+          response = "Connection error: #{e}"
+        end
+
+        Response.new status, response
+      end
+
+      class << self
+        attr_accessor :stub
+
+        def stub
+          @stub || ENV['STUB']
+        end
+      end
+    end
+  end
+end

data/lib/koko/tracker/response.rb

@@ -0,0 +1,20 @@
+module Koko
+  class Tracker
+    class Response
+      attr_reader :status, :body
+
+      # public: Simple class to wrap responses from the API
+      #
+      #
+      def initialize(status = 200, body = nil)
+        @status = status
+        @body  = body
+      end
+
+      def valid?
+        @status >= 200 && @status < 300
+      end
+    end
+  end
+end
+

data/lib/koko/tracker/utils.rb

@@ -0,0 +1,88 @@
+require 'securerandom'
+
+module Koko
+  class Tracker
+    module Utils
+      extend self
+
+      # public: Return a new hash with keys converted from strings to symbols
+      #
+      def symbolize_keys(hash)
+        hash.inject({}) { |memo, (k,v)| memo[k.to_sym] = v; memo }
+      end
+
+      # public: Convert hash keys from strings to symbols in place
+      #
+      def symbolize_keys!(hash)
+        hash.replace symbolize_keys hash
+      end
+
+      # public: Return a new hash with keys as strings
+      #
+      def stringify_keys(hash)
+        hash.inject({}) { |memo, (k,v)| memo[k.to_s] = v; memo }
+      end
+
+      # public: Returns a new hash with all the date values in the into iso8601
+      #         strings
+      #
+      def isoify_dates(hash)
+        hash.inject({}) { |memo, (k, v)|
+          memo[k] = datetime_in_iso8601(v)
+          memo
+        }
+      end
+
+      # public: Converts all the date values in the into iso8601 strings in place
+      #
+      def isoify_dates!(hash)
+        hash.replace isoify_dates hash
+      end
+
+      # public: Returns a uid string
+      #
+      def uid
+        arr = SecureRandom.random_bytes(16).unpack("NnnnnN")
+        arr[2] = (arr[2] & 0x0fff) | 0x4000
+        arr[3] = (arr[3] & 0x3fff) | 0x8000
+        "%08x-%04x-%04x-%04x-%04x%08x" % arr
+      end
+
+      def datetime_in_iso8601 datetime
+        case datetime
+        when Time
+            time_in_iso8601 datetime
+        when DateTime
+            time_in_iso8601 datetime.to_time
+        when Date
+          date_in_iso8601 datetime
+        else
+          datetime
+        end
+      end
+
+      def time_in_iso8601 time, fraction_digits = 3
+        fraction = if fraction_digits > 0
+                     (".%06i" % time.usec)[0, fraction_digits + 1]
+                   end
+
+        "#{time.strftime("%Y-%m-%dT%H:%M:%S")}#{fraction}#{formatted_offset(time, true, 'Z')}"
+      end
+
+      def date_in_iso8601 date
+        date.strftime("%F")
+      end
+
+      def formatted_offset time, colon = true, alternate_utc_string = nil
+        time.utc? && alternate_utc_string || seconds_to_utc_offset(time.utc_offset, colon)
+      end
+
+      def seconds_to_utc_offset(seconds, colon = true)
+        (colon ? UTC_OFFSET_WITH_COLON : UTC_OFFSET_WITHOUT_COLON) % [(seconds < 0 ? '-' : '+'), (seconds.abs / 3600), ((seconds.abs % 3600) / 60)]
+      end
+
+      UTC_OFFSET_WITH_COLON = '%s%02d:%02d'
+      UTC_OFFSET_WITHOUT_COLON = UTC_OFFSET_WITH_COLON.sub(':', '')
+    end
+  end
+end

data/lib/koko/tracker/version.rb

@@ -0,0 +1,5 @@
+module Koko
+  class Tracker
+    VERSION = '0.0.2'
+  end
+end

data/lib/koko/tracker.rb

@@ -0,0 +1,30 @@
+require 'koko/tracker/defaults'
+require 'koko/tracker/utils'
+require 'koko/tracker/version'
+require 'koko/tracker/client'
+require 'koko/tracker/request'
+require 'koko/tracker/response'
+require 'koko/tracker/logging'
+
+module Koko
+  class Tracker
+    def initialize options = {}
+      Request.stub = options[:stub] if options.has_key?(:stub)
+      @client = Koko::Tracker::Client.new options
+    end
+
+    def method_missing message, *args, &block
+      if @client.respond_to? message
+        @client.send message, *args, &block
+      else
+        super
+      end
+    end
+
+    def respond_to? method_name, include_private = false
+      @client.respond_to?(method_name) || super
+    end
+
+    include Logging
+  end
+end

data/lib/koko-ai-ruby.rb

@@ -0,0 +1 @@
+require 'koko'

data/lib/koko.rb

@@ -0,0 +1 @@
+require 'koko/tracker'

data/spec/koko/tracking/client_spec.rb

@@ -0,0 +1,126 @@
+require 'spec_helper'
+
+module Koko
+  class Tracker
+    describe Client do
+      let(:auth)        { 'secret' }
+      let(:client)      { Client.new :auth => auth }
+      let(:queue)       { client.instance_variable_get :@queue }
+      let(:body)        { JSON.generate({}) }
+      let(:status_code) { 200 }
+
+      before { stub_request(:post, /.*/).to_return(body: body, status: status_code) }
+      before { Timecop.freeze }
+
+      describe '#initialize' do
+        it 'errors if no auth is supplied' do
+          expect { Client.new }.to raise_error(ArgumentError)
+        end
+
+        it 'does not error if a auth is supplied' do
+          expect do
+            Client.new :auth => auth
+          end.to_not raise_error
+        end
+
+        it 'does not error if a auth is supplied as a string' do
+          expect do
+            Client.new 'auth' => auth
+          end.to_not raise_error
+        end
+      end
+
+      describe '#track_content' do
+        let(:body) { JSON.generate(Factory.behavorial_classification) }
+
+        context 'with a 400' do
+          let(:status_code) { 400 }
+
+          it 'raises an ArgumentError' do
+            expect { client.track_content(Factory.content) }.to raise_error(ArgumentError)
+          end
+        end
+
+        context 'with a 500' do
+          let(:status_code) { 500 }
+
+          it 'raises an RuntimeError' do
+            expect { client.track_content(Factory.content) }.to raise_error(RuntimeError)
+          end
+        end
+
+        it 'uses the current time if no timestamp is given' do
+          client.track_content(Factory.content.merge("created_at" => nil))
+
+          expected_body = JSON.generate(Factory.content.merge("created_at" => Time.now.to_f))
+          expect(WebMock).to have_requested(:post, "https://#{Defaults::Request.host}/track/content").with(body: expected_body)
+        end
+
+        it 'makes the correct request converting created_at time to float' do
+          client.track_content Factory.content
+
+          expected_body = JSON.generate(Factory.content.merge("created_at" => Factory.content["created_at"].to_f))
+          expect(WebMock).to have_requested(:post, "https://#{Defaults::Request.host}/track/content").with(body: expected_body)
+        end
+
+        it 'returns the parsed body if a block is passed' do
+          response_body = nil
+          client.track_content(Factory.content) do |response|
+            response_body = response
+          end
+          expect(response_body).to eq(JSON.load(body))
+        end
+      end
+
+      describe '#track_flag' do
+        context 'with a 400' do
+          let(:status_code) { 400 }
+
+          it 'raises an ArgumentError' do
+            expect { client.track_flag(Factory.flag) }.to raise_error(ArgumentError)
+          end
+        end
+
+        context 'with a 500' do
+          let(:status_code) { 500 }
+
+          it 'raises an RuntimeError' do
+            expect { client.track_flag(Factory.flag) }.to raise_error(RuntimeError)
+          end
+        end
+
+        it 'makes the correct request converting created_at time to float' do
+          client.track_flag Factory.flag
+
+          expected_body = JSON.generate(Factory.flag.merge("created_at" => Factory.flag["created_at"].to_f))
+          expect(WebMock).to have_requested(:post, "https://#{Defaults::Request.host}/track/flag").with(body: expected_body)
+        end
+      end
+
+      describe '#track_moderation' do
+        context 'with a 400' do
+          let(:status_code) { 400 }
+
+          it 'raises an ArgumentError' do
+            expect { client.track_moderation(Factory.moderation) }.to raise_error(ArgumentError)
+          end
+        end
+
+        context 'with a 500' do
+          let(:status_code) { 500 }
+
+          it 'raises an RuntimeError' do
+            expect { client.track_moderation(Factory.moderation) }.to raise_error(RuntimeError)
+          end
+        end
+
+        it 'makes the correct request converting created_at time to float' do
+          client.track_moderation Factory.moderation
+
+          expected_body = JSON.generate(Factory.moderation.merge("created_at" => Factory.moderation["created_at"].to_f))
+          expect(WebMock).to have_requested(:post, "https://#{Defaults::Request.host}/track/moderation").with(body: expected_body)
+        end
+      end
+    end
+  end
+end

data/spec/koko/tracking/request_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+
+module Koko
+  class Tracker
+    describe Request do
+      before do
+        # Try and keep debug statements out of tests
+        allow(subject.logger).to receive(:error)
+        allow(subject.logger).to receive(:debug)
+      end
+
+      describe '#initialize' do
+        let!(:net_http) { Net::HTTP.new(anything, anything) }
+
+        before do
+          allow(Net::HTTP).to receive(:new) { net_http }
+        end
+
+        it 'sets an initalized Net::HTTP read_timeout' do
+          expect(net_http).to receive(:use_ssl=)
+          described_class.new
+        end
+
+        it 'sets an initalized Net::HTTP read_timeout' do
+          expect(net_http).to receive(:read_timeout=)
+          described_class.new
+        end
+
+        it 'sets an initalized Net::HTTP open_timeout' do
+          expect(net_http).to receive(:open_timeout=)
+          described_class.new
+        end
+
+        it 'sets the http client' do
+          expect(subject.http).to_not be_nil
+        end
+
+        context 'no options are set' do
+          it 'sets a default path' do
+            expect(subject.instance_variable_get(:@path)).to eq(Defaults::Request.path)
+          end
+
+          it 'initializes a new Net::HTTP with default host and port' do
+            expect(Net::HTTP).to receive(:new).with(Defaults::Request.host, Defaults::Request.port)
+            described_class.new
+          end
+        end
+
+        context 'options are given' do
+          let(:path) { 'my/cool/path' }
+          let(:host) { 'http://www.example.com' }
+          let(:port) { 8080 }
+          let(:options) do
+            {
+              path: path,
+              host: host,
+              port: port
+            }
+          end
+
+          subject { described_class.new(options) }
+
+          it 'sets passed in path' do
+            expect(subject.instance_variable_get(:@path)).to eq(path)
+          end
+
+          it 'initializes a new Net::HTTP with passed in host and port' do
+            expect(Net::HTTP).to receive(:new).with(host, port)
+            described_class.new(options)
+          end
+        end
+      end
+
+      describe '#post' do
+        let(:subject) { Request.new(backoff: 0) }
+
+        let(:response_body) { {}.to_json }
+        let(:auth) { 'abcdefg' }
+        let(:body) { { some: 'value' } }
+
+        it 'makes a request with the correct headers and body' do
+          stub_request(:post, /#{subject.http.address}/).
+            with(body: body, headers: { 'Content-Type' => 'application/json', 'authorization' => auth }).
+            to_return(body: response_body)
+
+          response = subject.post(auth, body)
+
+          expect(response.body).to eq({})
+        end
+
+        context 'with a stub' do
+          before do
+            allow(described_class).to receive(:stub) { true }
+          end
+
+          it 'returns a 200 response' do
+            expect(subject.post(auth, body).status).to eq(200)
+          end
+
+          it 'logs a debug statement' do
+            expect(subject.logger).to receive(:debug).with(/stubbed request to/)
+            subject.post(auth, body)
+          end
+        end
+
+        context 'a real request' do
+          let(:status_code) { 200 }
+
+          before do
+            stub_request(:post, /.*/).
+            to_return(body: response_body, status: status_code)
+          end
+
+          context 'request is successful' do
+            let(:status_code) { 201 }
+
+            it 'returns a response code' do
+              expect(subject.post(auth, body).status).to eq(status_code)
+            end
+          end
+
+          context 'request results in 400 ' do
+            let(:error)       { 'this is an error' }
+            let(:status_code) { 400 }
+            let(:response_body) { { error: error }.to_json }
+
+            it 'returns the parsed error' do
+              expect(subject.post(auth, body).body).to eq({ "error" => error })
+            end
+          end
+
+          context 'request results in 500 ' do
+            let(:status_code)   { 500 }
+            let(:response_body) { "Something is wrong" }
+
+            it 'returns the body raw' do
+              expect(subject.post(auth, body).body).to eq("Something is wrong")
+            end
+          end
+        end
+
+        context 'request or parsing of response results in an exception' do
+          let(:response_body) { 'Malformed JSON ---' }
+
+          it 'has a connection error' do
+            expect(subject.post(auth, body).body).to match(/Connection error/)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/koko/tracking/response_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+module Koko
+  class Tracker
+    describe Response do
+      describe '#status' do
+        it { expect(subject).to respond_to(:status) }
+      end
+
+      describe '#body' do
+        it { expect(subject).to respond_to(:body) }
+      end
+
+      describe '#initialize' do
+        let(:status) { 404 }
+        let(:body)   { 'Oh No' }
+
+        subject { described_class.new(status, body) }
+
+        it 'sets the instance variable status' do
+          expect(subject.instance_variable_get(:@status)).to eq(status)
+        end
+
+        it 'sets the instance variable body' do
+          expect(subject.instance_variable_get(:@body)).to eq(body)
+        end
+      end
+
+      describe "#valid?" do
+        let(:status) { nil }
+        let(:body)   { '' }
+
+        subject { described_class.new(status, body) }
+
+        context 'with a valid response' do
+          let(:status) { 200 }
+
+          it 'returns true' do
+            expect(subject.valid?).to eq(true)
+          end
+        end
+
+        context 'with an invalid response' do
+          let(:status) { 400 }
+
+          it 'returns true' do
+            expect(subject.valid?).to eq(false)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,85 @@
+Bundler.require
+
+require 'active_support/time'
+require 'webmock/rspec'
+require 'timecop'
+require 'pry'
+
+# Setting timezone for ActiveSupport::TimeWithZone to UTC
+Time.zone = 'UTC'
+
+module Koko
+  class Tracker
+    module Factory
+      def self.content
+        {
+          "id" => "123",
+          "created_at" => Time.at(1498070225),
+          "user_id" => "123",
+          "type" => "post",
+          "context_id" => "123",
+          "content_type" => "text",
+          "content" => { "text" => "Some content" }
+        }.clone
+      end
+
+      def self.flag
+        {
+          "id" => "123",
+          "flagger_id" => "123",
+          "type" => "spam",
+          "created_at" => Time.at(1498070225),
+          "content" => { "id" => "123" }
+        }.clone
+      end
+
+      def self.moderation
+        {
+          "id" => "123",
+          "moderator_id" => "123",
+          "type" => "user_warned",
+          "created_at" => Time.at(1498070225),
+          "content" => { "id" => "123" }
+        }
+      end
+
+      def self.behavorial_classification
+        {
+          "behavorial_classification" => {
+            "id" =>  "123",
+            "classification": [
+              {
+                "label" => "crisis",
+                "confidence" => 0.95
+              }
+            ]
+          }
+        }
+      end
+    end
+  end
+end
+
+# usage:
+# it "should return a result of 5" do
+#   eventually(options: {timeout: 1}) { long_running_thing.result.should eq(5) }
+# end
+
+module AsyncHelper
+  def eventually(options = {})
+    timeout = options[:timeout] || 5 #seconds
+    interval = options[:interval] || 0.25 #seconds
+    time_limit = Time.now + timeout
+    loop do
+      begin
+        yield
+      rescue => error
+      end
+      return if error.nil?
+      raise error if Time.now >= time_limit
+      sleep interval
+    end
+  end
+end
+
+include AsyncHelper

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: koko-ai-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Koko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-06-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.1
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+description: The Koko AI ruby client library
+email: us@itskoko.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- History.md
+- Makefile
+- README.md
+- RELEASING.md
+- Rakefile
+- koko-ai.gemspec
+- lib/koko-ai-ruby.rb
+- lib/koko.rb
+- lib/koko/tracker.rb
+- lib/koko/tracker/client.rb
+- lib/koko/tracker/defaults.rb
+- lib/koko/tracker/logging.rb
+- lib/koko/tracker/request.rb
+- lib/koko/tracker/response.rb
+- lib/koko/tracker/utils.rb
+- lib/koko/tracker/version.rb
+- spec/koko/tracking/client_spec.rb
+- spec/koko/tracking/request_spec.rb
+- spec/koko/tracking/response_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/itskoko/koko-ai-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Koko AI Client
+test_files: []