mrkt 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3002468b0ce903416cfff2fa51ef03940cf35252
+  data.tar.gz: 410bed015b4ecc50ef564c63a72aafdb528fff68
+SHA512:
+  metadata.gz: ccfddbff9633674fd87973063e3cff57fda750cb28d2087b334c2d17a536f9fb73032cd69edcf3f0be6e0fbb264cf4e2f8376b6f6cfa2fc2f2ad0d699f97816c
+  data.tar.gz: d4ff3f1a12d64609f3dab730c30f7bfc8b6e6767e6e527524c0cfc6441033c2c3ae5bee757182c92d26f5d0fb56b9f25ba865b7a320c4c63ebed6560a41e72d4

data/.gitignore

@@ -0,0 +1,9 @@
+/.rspec-local
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.5
+  - 2.2.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mkto_rest.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,68 @@
+PATH
+  remote: .
+  specs:
+    mrkt (0.4.0)
+      faraday_middleware (~> 0.9.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.8)
+    byebug (4.0.5)
+      columnize (= 0.9.0)
+    coderay (1.1.0)
+    columnize (0.9.0)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    faraday (0.9.1)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.9.1)
+      faraday (>= 0.7.4, < 0.10)
+    json (1.8.2)
+    method_source (0.8.2)
+    multipart-post (2.0.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    pry-byebug (3.1.0)
+      byebug (~> 4.0)
+      pry (~> 0.10)
+    rake (10.1.1)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.2)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    safe_yaml (1.0.4)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    webmock (1.21.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  mrkt!
+  pry-byebug (~> 3.1.0)
+  rake (~> 10.0)
+  rspec (~> 3.2)
+  simplecov (~> 0.10.0)
+  webmock (~> 1.21.0)

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 jalemieux@gmail.com
+
+MIT License
+
+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/README.md

@@ -0,0 +1,87 @@
+# Mrkt
+
+[![Build Status](https://secure.travis-ci.org/raszi/mrkt.png)](http://travis-ci.org/raszi/mrkt)
+[![Gem Version](https://badge.fury.io/rb/mrkt.png)](http://badge.fury.io/rb/mrkt)
+
+This gem provides some level of abstraction to Marketo REST APIs. Please note that this gem is alpha quality. 
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mrkt'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mrkt
+
+
+## Prerequisites
+
+Get the following from your Marketo admin:
+
+* hostname, i.e. `'123-abc-123.mktorest.com'`
+* client id, e.g. `'4567e1cdf-0fae-4685-a914-5be45043f2d8'`
+* client secret, e.g. `'7Gn0tuiHZiDHnzeu9P14uDQcSx9xIPPt'`
+
+
+## Usage
+
+### Create a client and authenticate
+
+```ruby
+client = Mrkt::Client.new(
+  host: '123-abc-123.mktorest.com', 
+  client_id:  '4567e1cdf-0fae-4685-a914-5be45043f2d8', 
+  client_secret: '7Gn0tuiHZiDHnzeu9P14uDQcSx9xIPPt')
+```
+
+If you need verbosity during troubleshooting, set the client to debug mode
+
+```ruby
+client.debug = true
+```
+
+### Get leads matching an email, print their id and email
+    
+```ruby
+response = client.get_leads :email, 'sammy@acme.com'
+response.body[:result].each do |result|
+  p "id: #{result[:id]}, email: #{result[:email]}"
+end
+```
+
+### Create/Update leads
+
+```ruby
+response = client.createupdate_leads([ email: 'sample@example.com', firstName: 'John' ], lookup_field: :email)
+response.body[:result].each do |result|
+  p "id: #{result[:id]}, email: #{result[:email]}"
+end
+```
+
+
+## Run Tests
+
+    $ bundle exec rspec
+
+
+## Examples
+
+Examples are in the `spec/` directory.
+
+
+## Contributing
+
+1. Fork it ( https://github.com/raszi/mrkt/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |s|
+  s.rspec_opts = '-f d -c'
+  s.pattern = 'spec/**/*_spec.rb'
+end
+
+task default: :spec

data/lib/mrkt.rb

@@ -0,0 +1,38 @@
+require 'mrkt/version'
+require 'mrkt/errors'
+
+require 'mrkt/concerns/connection'
+require 'mrkt/concerns/authentication'
+require 'mrkt/concerns/crud_leads'
+require 'mrkt/concerns/import_leads'
+
+module Mrkt
+  class Client
+    include Connection
+    include Authentication
+    include CrudLeads
+    include ImportLeads
+
+    attr_accessor :debug
+
+    def initialize(options = {})
+      @host = options.fetch(:host)
+
+      @client_id = options.fetch(:client_id)
+      @client_secret = options.fetch(:client_secret)
+
+      @options = options
+    end
+
+    %i(get post delete).each do |http_method|
+      define_method(http_method) do |path, payload = {}, &block|
+        authenticate!
+
+        connection.send(http_method, path, payload) do |req|
+          add_authorization(req)
+          block.call(req) unless block.nil?
+        end
+      end
+    end
+  end
+end

data/lib/mrkt/concerns/authentication.rb

@@ -0,0 +1,37 @@
+module Mrkt
+  module Authentication
+    def authenticate!
+      authenticate unless authenticated?
+      fail Mrkt::Errors::AuthorizationError, 'Client not authenticated' unless authenticated?
+    end
+
+    def authenticated?
+      @token && valid_token?
+    end
+
+    def valid_token?
+      @valid_until && Time.now < @valid_until
+    end
+
+    def authenticate
+      params = {
+        grant_type: 'client_credentials',
+        client_id: @client_id,
+        client_secret: @client_secret
+      }
+
+      connection.get('/identity/oauth/token', params).tap do |response|
+        data = response.body
+
+        @token = data.fetch(:access_token)
+        @token_type = data.fetch(:token_type)
+        @valid_until = Time.now + data.fetch(:expires_in)
+        @scope = data.fetch(:scope)
+      end
+    end
+
+    def add_authorization(req)
+      req.headers[:authorization] = "Bearer #{@token}"
+    end
+  end
+end

data/lib/mrkt/concerns/connection.rb

@@ -0,0 +1,24 @@
+require 'mrkt/faraday_middleware'
+
+module Mrkt
+  module Connection
+    def connection
+      @connection ||= init_connection
+    end
+
+    def init_connection
+      Faraday.new(url: "https://#{@host}") do |conn|
+        conn.request :multipart
+        conn.request :url_encoded
+
+        conn.response :logger if @debug
+        conn.response :mkto, content_type: /\bjson$/
+
+        conn.options.timeout = @options[:read_timeout] if @options.key?(:read_timeout)
+        conn.options.open_timeout = @options[:open_timeout] if @options.key?(:open_timeout)
+
+        conn.adapter Faraday.default_adapter
+      end
+    end
+  end
+end

data/lib/mrkt/concerns/crud_leads.rb

@@ -0,0 +1,48 @@
+module Mrkt
+  module CrudLeads
+    def get_leads(filter_type, filter_values, fields: nil, batch_size: nil, next_page_token: nil)
+      params = {
+        filterType: filter_type,
+        filterValues: filter_values.join(',')
+      }
+      params[:fields] = fields if fields
+      params[:batchSize] = batch_size if batch_size
+      params[:nextPageToken] = next_page_token if next_page_token
+
+      get('/rest/v1/leads.json', params)
+    end
+
+    def createupdate_leads(leads, action: 'createOrUpdate', lookup_field: nil, partition_name: nil)
+      post('/rest/v1/leads.json') do |req|
+        params = {
+          action: action,
+          input: leads
+        }
+        params[:lookupField] = lookup_field if lookup_field
+        params[:partitionName] = partition_name if partition_name
+
+        json_payload(req, params)
+      end
+    end
+
+    def delete_leads(leads)
+      delete('/rest/v1/leads.json') do |req|
+        json_payload(req, input: leads.map { |lead_id| { id: lead_id } })
+      end
+    end
+
+    def json_payload(req, payload)
+      req.headers[:content_type] = 'application/json'
+      req.body = JSON.generate(payload)
+    end
+
+    def associate_lead(id, cookie)
+      params = Faraday::Utils::ParamsHash.new
+      params[:cookie] = cookie
+
+      post("/rest/v1/leads/#{id}/associate.json?#{params.to_query}") do |req|
+        json_payload(req, {})
+      end
+    end
+  end
+end

data/lib/mrkt/concerns/import_leads.rb

@@ -0,0 +1,27 @@
+module Mrkt
+  module ImportLeads
+    def import_lead(file, format = 'csv', lookup_field = nil, list_id: nil, partition_name: nil)
+      params = {
+        format: format,
+        file: Faraday::UploadIO.new(file, 'text/csv')
+      }
+      params[:lookupField] = lookup_field if lookup_field
+      params[:listId] = list_id if list_id
+      params[:partitionName] = partition_name if partition_name
+
+      post('/bulk/v1/leads.json', params)
+    end
+
+    def import_lead_status(id)
+      get("/bulk/v1/leads/batch/#{id}.json")
+    end
+
+    def import_lead_failures(id)
+      get("/bulk/v1/leads/batch/#{id}/failures.json")
+    end
+
+    def import_lead_warnings(id)
+      get("/bulk/v1/leads/batch/#{id}/warnings.json")
+    end
+  end
+end

data/lib/mrkt/errors.rb

@@ -0,0 +1,52 @@
+class Mrkt::Errors
+  class Error < StandardError
+  end
+
+  def self.create_class
+    Class.new(Error)
+  end
+
+  Unknown = create_class
+  EmptyResponse = create_class
+  AuthorizationError = create_class
+
+  RESPONSE_CODE_TO_ERROR = {
+    413  => 'RequestEntityTooLarge',
+    600  => 'EmptyAccessToken',
+    601  => 'AccessTokenInvalid',
+    602  => 'AccessTokenExpired',
+    603  => 'AccessDenied',
+    604  => 'RequestTimedOut',
+    605  => 'HTTPMethodNotSupported',
+    606  => 'MaxRateLimit',
+    607  => 'DailyQuotaReached',
+    608  => 'APITemporarilyUnavailable',
+    609  => 'InvalidJSON',
+    610  => 'RequestedResourceNotFound',
+    611  => 'System',
+    612  => 'InvalidContentType',
+    703  => 'DisabledFeature',
+    1001 => 'TypeMismatch',
+    1002 => 'MissingParamater',
+    1003 => 'UnspecifiedAction',
+    1004 => 'LeadNotFound',
+    1005 => 'LeadAlreadyExists',
+    1006 => 'FieldNotFound',
+    1007 => 'MultipleLeadsMatching',
+    1008 => 'PartitionAccessDenied',
+    1009 => 'PartitionNameUnspecified',
+    1010 => 'PartitionUpdateDenied',
+    1011 => 'FieldNotSupported',
+    1012 => 'InvalidCookieValue',
+    1013 => 'ObjectNotFound',
+    1014 => 'FailedToCreateObject'
+  }
+
+  RESPONSE_CODE_TO_ERROR.values.each do |class_name|
+    const_set(class_name, create_class)
+  end
+
+  def self.find_by_response_code(response_code)
+    const_get(RESPONSE_CODE_TO_ERROR.fetch(response_code, 'Error'))
+  end
+end

data/lib/mrkt/faraday_middleware.rb

@@ -0,0 +1,11 @@
+require 'faraday'
+
+module Mrkt
+  module FaradayMiddleware
+    autoload :Response, 'mrkt/faraday_middleware/response'
+  end
+
+  if Faraday::Middleware.respond_to? :register_middleware
+    Faraday::Response.register_middleware mkto: -> { Mrkt::FaradayMiddleware::Response }
+  end
+end

data/lib/mrkt/faraday_middleware/request.rb

@@ -0,0 +1,58 @@
+require 'faraday_middleware'
+
+module Mrkt
+  module FaradayMiddleware
+    class Request < Faraday::Middleware
+      def initialize(app, client_id, client_secret)
+        super(app)
+
+        @client_id = client_id
+        @client_secret = client_secret
+      end
+
+      def call(env)
+        authenticate(env) unless authenticated? || env[:authentication]
+
+        env.request_headers[:authorization] = "Bearer #{@token}"
+        @app.call(env)
+      end
+
+      def authenticated?
+        @token && token_valid?
+      end
+
+      def token_valid?
+        @valid_until && Time.now < @valid_until
+      end
+
+      def authenticate(orig_env)
+        env = Faraday::Env.from(orig_env)
+
+        body = env[:body]
+        params = Faraday::Utils::ParamsHash.new
+        params.update(
+          grant_type: 'client_credentials',
+          client_id: @client_id,
+          client_secret: @client_secret
+        )
+        env[:authentication] = true
+        env[:method] = :get
+
+        env[:url] = env[:url].dup
+        env[:url].path = '/identity/oauth/token'
+        env[:url].query = params.to_query
+
+        orig_env[:body] = body
+
+        response = @app.call(env)
+        data = response.body
+
+        @token = data[:access_token]
+        @token_type = data[:token_type]
+        @expires_in = data[:expires_in]
+        @valid_until = Time.now + data[:expires_in]
+        @scope = data[:scope]
+      end
+    end
+  end
+end

data/lib/mrkt/faraday_middleware/response.rb

@@ -0,0 +1,29 @@
+require 'faraday_middleware'
+
+module Mrkt
+  module FaradayMiddleware
+    class Response < ::FaradayMiddleware::ParseJson
+      define_parser do |body|
+        JSON.parse(body, symbolize_names: true) unless body.strip.empty?
+      end
+
+      def process_response(env)
+        super
+
+        data = env[:body]
+
+        fail Mrkt::Errors::EmptyResponse if data.nil?
+        fail Mrkt::Errors::Error, data[:error_description] if data.key?(:error)
+
+        handle_errors!(data[:errors]) unless data.fetch(:success, true)
+      end
+
+      def handle_errors!(errors)
+        error = errors.first
+
+        fail Mrkt::Errors::Unknown if error.nil?
+        fail Mrkt::Errors.find_by_response_code(error[:code].to_i), error[:message]
+      end
+    end
+  end
+end

data/lib/mrkt/version.rb

@@ -0,0 +1,3 @@
+module Mrkt
+  VERSION = '0.4.0'
+end

data/mrkt.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mrkt/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'mrkt'
+  spec.version       = Mrkt::VERSION
+  spec.authors       = ['KARASZI István', 'Jacques Lemieux']
+  spec.email         = ['github@spam.raszi.hu', 'jalemieux@gmail.com']
+  spec.description   = 'Marketo REST API Facade'
+  spec.summary       = ''
+  spec.homepage      = ''
+  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 = %w(lib)
+
+  spec.required_ruby_version = '~> 2.0'
+
+  spec.add_dependency 'faraday_middleware', '~> 0.9.1'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.2'
+  spec.add_development_dependency 'webmock', '~> 1.21.0'
+  spec.add_development_dependency 'simplecov', '~> 0.10.0'
+  spec.add_development_dependency 'pry-byebug', '~> 3.1.0'
+end

data/spec/concerns/authentication_spec.rb

@@ -0,0 +1,38 @@
+describe Mrkt::Authentication do
+  include_context 'initialized client'
+
+  describe '#authenticate' do
+    subject { client.authenticate }
+
+    context 'on a successful response' do
+      it { is_expected.to be_success }
+    end
+
+    context 'when the token is invalid' do
+      let(:authentication_stub) do
+        {
+          error: 'invalid_client',
+          error_description: 'Bad client credentials'
+        }
+      end
+
+      it 'should raise an Error' do
+        expect { subject }.to raise_error(Mrkt::Errors::Error, 'Bad client credentials')
+      end
+    end
+  end
+
+  describe '#authenticated?' do
+    subject { client.authenticated? }
+
+    context 'before authentication' do
+      it { is_expected.to be_falsey }
+    end
+
+    context 'after authentication' do
+      before { client.authenticate }
+
+      it { is_expected.to be_truthy }
+    end
+  end
+end

data/spec/concerns/crud_leads_spec.rb

@@ -0,0 +1,151 @@
+describe Mrkt::CrudLeads do
+  include_context 'initialized client'
+
+  describe '#get_leads' do
+    let(:filter_type) { 'email' }
+    let(:filter_values) { %w(user@example.com) }
+    let(:response_stub) do
+      {
+        requestId: 'c245#14cd6830ae2',
+        result: [
+          {
+            id: 1,
+            firstName: 'John',
+            lastName: 'Snow',
+            email: 'sample@exmaple.com',
+            updatedAt: '2015-04-20 05:46:13',
+            createdAt: '2015-04-20 05:46:13'
+          }
+        ],
+        success: true
+      }
+    end
+    subject { client.get_leads(filter_type, filter_values) }
+
+    before do
+      stub_request(:get, "https://#{host}/rest/v1/leads.json")
+        .with(query: { filterType: filter_type, filterValues: filter_values.join(',') })
+        .to_return(json_stub(response_stub))
+    end
+
+    it { is_expected.to be_success }
+  end
+
+  describe '#createupdate_leads' do
+    let(:leads) do
+      [
+        firstName: 'John',
+        lastName: 'Snow',
+        email: 'sample@example.com'
+      ]
+    end
+    let(:request_body) do
+      {
+        action: 'createOrUpdate',
+        input: [
+          {
+            firstName: 'John',
+            lastName: 'Snow',
+            email: 'sample@example.com'
+          }
+        ],
+        lookupField: 'email'
+      }
+    end
+    let(:response_stub) do
+      {
+        requestId: 'c245#14cd6830ae2',
+        success: true,
+        result: [
+          {
+            id: 1,
+            status: 'created'
+          }
+        ]
+      }
+    end
+    subject { client.createupdate_leads(leads, lookup_field: :email) }
+
+    before do
+      stub_request(:post, "https://#{host}/rest/v1/leads.json")
+        .with(json_stub(request_body))
+        .to_return(json_stub(response_stub))
+    end
+
+    it { is_expected.to be_success }
+  end
+
+  describe '#delete_leads' do
+    let(:leads) { [1] }
+    let(:request_body) do
+      {
+        input: [
+          { id: 1 }
+        ]
+      }
+    end
+    let(:response_stub) do
+      {
+        requestId: 'c245#14cd6830ae2',
+        result: [
+          { id: 4098, status: 'deleted' }
+        ],
+        success: true
+      }
+    end
+    subject { client.delete_leads(leads) }
+
+    before do
+      stub_request(:delete, "https://#{host}/rest/v1/leads.json")
+        .with(json_stub(request_body))
+        .to_return(json_stub(response_stub))
+    end
+
+    it { is_expected.to be_success }
+  end
+
+  describe '#associate_lead' do
+    let(:id) { 1 }
+    let(:cookie) { 'id:561-HYG-937&token:_mch-marketo.com-1427205775289-40768' }
+    let(:request_stub) { {} }
+
+    subject { client.associate_lead(id, cookie) }
+
+    before do
+      stub_request(:post, "https://#{host}/rest/v1/leads/#{id}/associate.json?#{URI.encode_www_form(cookie: cookie)}")
+        .with(json_stub(request_stub))
+        .to_return(json_stub(response_stub))
+    end
+
+    context 'with an existing lead id' do
+      let(:response_stub) do
+        {
+          requestId: 'c245#14cd6830ae2',
+          result: [],
+          success: true
+        }
+      end
+
+      it { is_expected.to be_success }
+    end
+
+    context 'with a non-existing lead id' do
+      let(:response_stub) do
+        {
+          requestId: 'c245#14cd6830ae2',
+          success: false,
+          errors: [
+            {
+              code: "1004",
+              message: "Lead '1' not found"
+            }
+          ]
+        }
+      end
+
+      it 'should raise an Error' do
+        expect { subject }.to raise_error(Mrkt::Errors::LeadNotFound)
+      end
+    end
+  end
+end

data/spec/concerns/import_leads_spec.rb

@@ -0,0 +1,98 @@
+require 'csv'
+require 'tempfile'
+
+describe Mrkt::ImportLeads do
+  include_context 'initialized client'
+
+  describe '#import_lead' do
+    let(:tempfile) { Tempfile.new(['import-leads', 'csv']) }
+    let(:response_stub) do
+      {
+        requestId: 'c245#14cd6830ae2',
+        success: true,
+        result: [
+          {
+            batchId: 1,
+            status: 'Importing'
+          }
+        ]
+      }
+    end
+    subject { client.import_lead(tempfile) }
+
+    before do
+      CSV.open(tempfile, 'wb') do |csv|
+        csv << %w(email firstName lastName)
+        csv << %w(sample@example.com John Snow)
+      end
+
+      stub_request(:post, "https://#{host}/bulk/v1/leads.json")
+        .with(headers: { content_type: %r{multipart/form-data; boundary=\S+} })
+        .to_return(json_stub(response_stub))
+    end
+
+    after do
+      tempfile.unlink
+    end
+
+    it { is_expected.to be_success }
+  end
+
+  describe '#import_lead_status' do
+    let(:id) { 1 }
+    let(:response_stub) do
+      {
+        requestId: 'c245#14cd6830ae2',
+        result: [
+          {
+            batchId: id,
+            status: 'Importing',
+            numOfLeadsProcessed: 4,
+            numOfRowsFailed: 1,
+            numOfRowsWithWarning: 0,
+            message: 'Import completed with errors, 4 records imported (4 members), 1 failed'
+          }
+        ],
+        success: true
+      }
+    end
+    subject { client.import_lead_status(1) }
+
+    before do
+      stub_request(:get, "https://#{host}/bulk/v1/leads/batch/#{id}.json")
+        .to_return(json_stub(response_stub))
+    end
+
+    it { is_expected.to be_success }
+  end
+
+  describe '#import_lead_failures' do
+    let(:id) { 1 }
+    let(:respose_stub) do
+
+    end
+    subject { client.import_lead_failures(1) }
+
+    before do
+      stub_request(:get, "https://#{host}/bulk/v1/leads/batch/#{id}/failures.json")
+        .to_return(headers: { content_length: 0 })
+    end
+
+    it { is_expected.to be_success }
+  end
+
+  describe '#import_lead_warnings' do
+    let(:id) { 1 }
+    let(:respose_stub) do
+
+    end
+    subject { client.import_lead_warnings(1) }
+
+    before do
+      stub_request(:get, "https://#{host}/bulk/v1/leads/batch/#{id}/warnings.json")
+        .to_return(headers: { content_length: 0 })
+    end
+
+    it { is_expected.to be_success }
+  end
+end

data/spec/errors_spec.rb

@@ -0,0 +1,21 @@
+describe Mrkt::Errors do
+  describe '.find_by_response_code' do
+    subject { described_class.find_by_response_code(code) }
+
+    context 'when the code is' do
+      context 'known' do
+        let(:code) { 413 }
+
+        it 'should return the mapped error class' do
+          is_expected.to eq(Mrkt::Errors::RequestEntityTooLarge)
+        end
+      end
+
+      context 'unknown' do
+        let(:code) { 7331 }
+
+        it { is_expected.to eq(Mrkt::Errors::Error) }
+      end
+    end
+  end
+end

data/spec/mkto_rest_spec.rb

@@ -0,0 +1,5 @@
+describe Mrkt do
+  include_context 'initialized client'
+
+  it { is_expected.to respond_to(:get, :post, :delete) }
+end

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+if ENV['COVERAGE']
+  require 'simplecov'
+  SimpleCov.start
+end
+
+require 'bundler/setup'
+Bundler.setup
+
+require 'mrkt'
+
+Dir[File.expand_path('spec/support/**/*.rb')].each { |f| require f }
+
+RSpec.configure do |config|
+  config.default_formatter = :doc if config.files_to_run.one?
+
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.order = :random
+  Kernel.srand config.seed
+
+  config.expect_with :rspec do |expectations|
+    expectations.syntax = :expect
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.syntax = :expect
+    mocks.verify_partial_doubles = true
+  end
+end

data/spec/support/initialized_client.rb

@@ -0,0 +1,19 @@
+require 'securerandom'
+require 'json'
+
+shared_context 'initialized client' do
+  let(:host) { '0-KBZ-0.mktorest.com' }
+  let(:client_id) { SecureRandom.uuid }
+  let(:client_secret) { SecureRandom.hex }
+  let(:authentication_stub) do
+    { access_token: SecureRandom.uuid, token_type: 'bearer', expires_in: 2241, scope: 'RestClient' }
+  end
+
+  subject(:client) { Mrkt::Client.new(host: host, client_id: client_id, client_secret: client_secret) }
+
+  before do
+    stub_request(:get, "https://#{host}/identity/oauth/token")
+      .with(query: { client_id: client_id, client_secret: client_secret, grant_type: 'client_credentials' })
+      .to_return(json_stub(authentication_stub))
+  end
+end

data/spec/support/webmock.rb

@@ -0,0 +1,10 @@
+require 'webmock/rspec'
+
+RSpec.configure do
+  def json_stub(content_stub)
+    {
+      headers: { content_type: 'application/json' },
+      body: JSON.generate(content_stub)
+    }
+  end
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: mrkt
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+platform: ruby
+authors:
+- KARASZI István
+- Jacques Lemieux
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+description: Marketo REST API Facade
+email:
+- github@spam.raszi.hu
+- jalemieux@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/mrkt.rb
+- lib/mrkt/concerns/authentication.rb
+- lib/mrkt/concerns/connection.rb
+- lib/mrkt/concerns/crud_leads.rb
+- lib/mrkt/concerns/import_leads.rb
+- lib/mrkt/errors.rb
+- lib/mrkt/faraday_middleware.rb
+- lib/mrkt/faraday_middleware/request.rb
+- lib/mrkt/faraday_middleware/response.rb
+- lib/mrkt/version.rb
+- mrkt.gemspec
+- spec/concerns/authentication_spec.rb
+- spec/concerns/crud_leads_spec.rb
+- spec/concerns/import_leads_spec.rb
+- spec/errors_spec.rb
+- spec/mkto_rest_spec.rb
+- spec/spec_helper.rb
+- spec/support/initialized_client.rb
+- spec/support/webmock.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: ''
+test_files:
+- spec/concerns/authentication_spec.rb
+- spec/concerns/crud_leads_spec.rb
+- spec/concerns/import_leads_spec.rb
+- spec/errors_spec.rb
+- spec/mkto_rest_spec.rb
+- spec/spec_helper.rb
+- spec/support/initialized_client.rb
+- spec/support/webmock.rb