twitter-ads 0.3.4

data/spec/twitter-ads/client_spec.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Client do
+
+  let!(:consumer_key) { Faker::Lorem.characters(15) }
+  let!(:consumer_secret) { Faker::Lorem.characters(40) }
+  let!(:access_token) { "123456-#{Faker::Lorem.characters(40)}" }
+  let!(:access_token_secret) { Faker::Lorem.characters(40) }
+
+  let(:client) do
+    Client.new(
+      consumer_key,
+      consumer_secret,
+      access_token,
+      access_token_secret
+    )
+  end
+
+  describe '#initialize' do
+
+    it 'requires a valid consumer_key' do
+      expect(client.consumer_key).not_to be_nil
+      expect(client.consumer_key).to eq(consumer_key)
+      expect {
+        Client.new(nil, consumer_secret, access_token, access_token_secret)
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'requires a valid consumer_secret' do
+      expect(client.consumer_secret).not_to be_nil
+      expect(client.consumer_secret).to eq(consumer_secret)
+      expect {
+        Client.new(consumer_key, nil, access_token, access_token_secret)
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'requires a valid access_token' do
+      expect(client.access_token).not_to be_nil
+      expect(client.access_token).to eq(access_token)
+      expect {
+        Client.new(consumer_key, consumer_secret, nil, access_token_secret)
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'requires a valid access_token_secret' do
+      expect(client.access_token_secret).not_to be_nil
+      expect(client.access_token_secret).to eq(access_token_secret)
+      expect {
+        Client.new(consumer_key, consumer_secret, access_token, nil)
+      }.to raise_error(ArgumentError)
+    end
+
+    it 'allows additional options' do
+      expect {
+        Client.new(consumer_key, consumer_secret, access_token, {})
+      }.not_to raise_error
+    end
+
+  end
+
+  describe '#inspect' do
+
+    it 'includes the object id value' do
+      expect(client.inspect).to include(client.object_id.to_s)
+    end
+
+    it 'includes the consumer_key value' do
+      expect(client.inspect).to include(client.consumer_key)
+    end
+
+    it 'includes the class.name value' do
+      expect(client.inspect).to include(client.class.name)
+    end
+
+  end
+
+  describe '#accounts' do
+
+    context 'when called with no arguments' do
+
+      before(:all) do
+        stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+      end
+
+      it 'returns a Cursor object' do
+        cursor = client.accounts
+        expect(cursor.class.name).to eq('TwitterAds::Cursor')
+        expect(cursor.size).to eq(5)
+        expect(cursor.first.class.name).to eq('TwitterAds::Account')
+      end
+
+    end
+
+    context 'when called with an account id' do
+
+      let!(:account_id) { '2iqph' }
+
+      before(:all) do
+        stub_fixture(:get, :accounts_load, /(.*\/0\/accounts\/)([a-zA-Z0-9]*)\z/)
+      end
+
+      it 'returns a specific Account object' do
+        cursor = client.accounts(account_id)
+        expect(cursor.class.name).to eq('TwitterAds::Account')
+        expect(cursor.id).to eq(account_id)
+      end
+
+    end
+
+  end
+
+end

data/spec/twitter-ads/creative/app_download_card_spec.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::AppDownloadCard do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id preview_url created_at updated_at deleted)
+
+  write = %w(
+    name
+    app_country_code
+    iphone_app_id
+    iphone_deep_link
+    ipad_app_id
+    ipad_deep_link
+    googleplay_app_id
+    googleplay_deep_link
+    app_cta
+    custom_icon_media_id
+    custom_app_description
+  )
+
+  include_examples 'object property check', read, write
+
+end

data/spec/twitter-ads/creative/image_app_download_card_spec.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::ImageAppDownloadCard do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id preview_url created_at updated_at deleted)
+
+  write = %w(
+    name
+    app_country_code
+    iphone_app_id
+    iphone_deep_link
+    ipad_app_id
+    ipad_deep_link
+    googleplay_app_id
+    googleplay_deep_link
+    app_cta
+    wide_app_image_media_id
+  )
+
+  include_examples 'object property check', read, write
+
+end

data/spec/twitter-ads/creative/image_conversation_card_spec.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::ImageConversationCard do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id preview_url image deleted created_at updated_at)
+  write = %w(
+    name
+    title
+    first_cta
+    first_cta_tweet
+    second_cta
+    second_cta_tweet
+    thank_you_text
+    thank_you_url
+    image_media_id
+  )
+  include_examples 'object property check', read, write
+
+end

data/spec/twitter-ads/creative/lead_gen_card_spec.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::LeadGenCard do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id preview_url created_at updated_at deleted)
+
+  write = %w(
+    name
+    image_media_id
+    cta
+    fallback_url
+    privacy_policy_url
+    title
+    submit_url
+    submit_method
+    custom_destination_url
+    custom_destination_text
+    custom_key_screen_name
+    custom_key_name
+    custom_key_email
+  )
+
+  include_examples 'object property check', read, write
+
+end

data/spec/twitter-ads/creative/promoted_account_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::PromotedAccount do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id approval_status created_at updated_at deleted)
+  write = %w(line_item_id user_id paused)
+  include_examples 'object property check', read, write
+
+end

data/spec/twitter-ads/creative/promoted_tweet_spec.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::PromotedTweet do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id approval_status created_at updated_at deleted)
+  write = %w(line_item_id tweet_id paused)
+  include_examples 'object property check', read, write
+
+  describe '#save' do
+
+    it 'raises a client error when missing tweet_id' do
+      expect(subject).to receive(:validate).and_call_original
+      subject.line_item_id = '12345'
+      expect { subject.save }.to raise_error(TwitterAds::ClientError)
+    end
+
+    it 'raises a client error when missing line_item_id' do
+      expect(subject).to receive(:validate).and_call_original
+      subject.tweet_id = 99999999999999999999
+      expect { subject.save }.to raise_error(TwitterAds::ClientError)
+    end
+
+  end
+
+end

data/spec/twitter-ads/creative/video_app_download_card_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::VideoAppDownloadCard do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+  read  = %w(id preview_url video_url video_poster_url deleted created_at updated_at)
+  write = %w(
+    name
+    app_country_code
+    iphone_app_id
+    iphone_deep_link
+    ipad_app_id
+    ipad_deep_link
+    googleplay_app_id
+    googleplay_deep_link
+    app_cta
+    image_media_id
+    video_id
+  )
+  include_examples 'object property check', read, write
+
+end

data/spec/twitter-ads/creative/video_conversation_card_spec.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+# Copyright (C) 2015 Twitter, Inc.
+
+require 'spec_helper'
+
+describe TwitterAds::Creative::VideoConversationCard do
+
+  before(:each) do
+    stub_fixture(:get, :accounts_all, "#{ADS_API}/accounts")
+    stub_fixture(:get, :accounts_load, "#{ADS_API}/accounts/2iqph")
+  end
+
+  let(:client) do
+    Client.new(
+      Faker::Lorem.characters(15),
+      Faker::Lorem.characters(40),
+      "123456-#{Faker::Lorem.characters(40)}",
+      Faker::Lorem.characters(40)
+    )
+  end
+
+  let(:account) { client.accounts.first }
+
+  # check model properties
+  subject { described_class.new(account) }
+
+  read = %w(
+    id
+    preview_url
+    video_url
+    video_poster_url
+    deleted
+    created_at
+    updated_at
+  )
+
+  write = %w(
+    name
+    title
+    first_cta
+    first_cta_tweet
+    second_cta
+    second_cta_tweet
+    thank_you_text
+    thank_you_url
+    image_media_id
+    video_id
+  )
+
+  include_examples 'object property check', read, write
+
+end