adcloud 0.7.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.gitignore

@@ -0,0 +1,69 @@
+# rcov generated
+coverage
+coverage.data
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+#*.swp
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc
+=======
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+TestCalls

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.9.3
+source_key: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFb3dJQkFBS0NBUUVBN1hBMHRGckl4T3djazZIdTlBMStDUzRUMEx3ZjA5OEo1aWRDM2J2SWorWW1KMU80CmtNaTl0blVYOHM2UHpMUHFKbFdCWnRFdEpzNWl3bXBycE9lQ0NjOUNQZ2lhRllwREgxZldNN3lwdWg0a1QyRWMKTTFsaUQxOTVLZ0JVUEYrc2JFQUJLYW5OVklnWFRNdW1aNlp1WStUcEtLMi9aczVEdnc5bzJkOUhJQUlDeFJ4Mgoxam5KL1R6cmpuWGZTK0pnOWY0TWdvTFIwd0ZMLytxb1V4K08zZnoySThyTGJyTmZtK0JicGJtTEo3QTZaZzJJCjBJSTh5bUdXK2ZpYStVeEVNSG1tZ21WTEhHWDR3ZlpDYm11RnhuZlhvZG5ydG5hbDZkdWJqVUgwSEd5U0krY3MKYjNIdjhOU0RIMWFuekY3dkEydys3b0o0WUFOU0pSMnFDUWxpY3dJREFRQUJBb0lCQVFEQ0J5WmFsN0ZuRXBkTApvVkcyaCt3TnJtU3M5MzUrMGMyeUVUVllJeU1EVEl5ektId3pmSWRqT1k2bmNWc2JhWTZYWXRwSzNmYXF0bzhICjFwVStmWnpMVFY0UmVWQUkrQ0pmMDVTTVZNalIrZDJzTEd3eUhnRy9GRUxjS3NhclMzZUlRa2x3OVh5QWJuR3oKNU51SDZmNWRqV3RuUFl5aWd6M2pQTUZ2QVVHTENlYXN3dTVFMkU0UExtUzFNdnJvVVF4N3IrelVLc1ZGVTJWaApHdkxTNmZJZUJzN25GSXo4NHVZNEU5eG9GQmVVRVlqRjRobS9yOE9qeFcyUlh1RWRGc3pRV3NqMFhvZllDRUFvClVvNThPZVd2MmpKOXF2YkNXa002b3U0bTQxbnlmemxsRXZXeHJ5N2xtRm9pYjRabEx2NEplYkc5M0JvUFhvaEIKanZUNlBneUpBb0dCQVBlZEVGekhOWVhNSWFTR0RsSCtIR3NnZ2JxU1NDaThEaHZzTnlsVWUyNll6RDlnWHBsWgpoeTR2M1FnOFhvU3JYaTVTb1N6MFhPcG5zMHhGa0t3QUFyRmxQNndyWXFCZEZlcVVuVGVqcE5lU041MUJPNjVjCm1UR3RDL2Y5VU9LV1M0ckxvM2NkNnVkWGRTQVViYUlmOXNDT3RLWUtzSG0ybjRETEkxc1pkTDZYQW9HQkFQVjYKNnVPb00reThxa2FTTSsrQ25QS2RCb2orMm4zZ2RVR3hzb0wvRHQ3ODluektXei91OWZaQ0lrVWtwTUErM3hFTwpCYmVBT2VZVEhYMk1FdWxuc3dZS3g3N2VtTGdYTzdYUmhKK2dtV0psclpKcDdFRVFUYkdOZzJnSUI5RmhUQnBkCkRxalRMTURUbEQ4encweFVlcmFHWXNYU0RhUkRLTDhuTUJaSkdsS0ZBb0dBVDRCY2FvMkRmOHdFMlVBNWhOWGoKNWZsdjdhbGVCY1lyZVlla1JsN2JxcXpnbDFDbnp2RFIyR0NCeFUwc3c4Z0oyekdva2poN1JMKzY3N2crTlJ0agp3ZlZTTmtOUHpWRlY0aFdKVFAzN3hVTXJIQkIveXdIc0plajd1TW5hbUlYTkIybE91TVlnVDlyaXZrUVExMGNRCkFNOVE3U2J0ZG9iT081bjlaaGlNUlUwQ2dZQWJPeVZ2VjZ0YTZacmg5VG41cWIyTFZFdnpTb0ltVUkzeFdhcjUKeVIxM013eU16MDNNQzlBUkgwajU3cFN3RnNsYjlQaEJZT0lMV2JkOXc5b2ROam12dytaZ2tBVFU5dzdTbm9sZAp3ODBBRTFOcjJJQXl2NEkrM2ZuanduQkxrOFdEYnlzL0l4M2x6aEsxNkNJVUI1TU5TRjhRbnJxUXJEcUs2ZWYxCnNPcFFtUUtCZ0U1RWNoZ3o1MjNmOE1BbUM0OW1LNWJxT2FwUkZRMlgxSXpFODBxTU54TVliVFc5cm5LNEdEN0EKbnh2NTdKZU8zU3pjMy9jR0lNN2h6VWJhN1JPbzVqUXE2M2V2ZnJhTFk5dHQ4aUZXNHNtQXlneDlJSUYwV1cwMAplaytBZWRiUHVqR0RadDVFcjdRbzE3WnpueE9xZFdwYUpseC9GcFlsMzZ1QWpDUlUvOVprCi0tLS0tRU5EIFJTQSBQUklWQVRFIEtFWS0tLS0tCg==

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,50 @@
+PATH
+  remote: .
+  specs:
+    adcloud (0.1.0)
+      activesupport (~> 3.2.6)
+      faraday
+      faraday_middleware
+      virtus
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.2.6)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    addressable (2.3.2)
+    backports (2.6.2)
+    crack (0.3.1)
+    faraday (0.8.1)
+      multipart-post (~> 1.1)
+    faraday_middleware (0.8.8)
+      faraday (>= 0.7.4, < 0.9)
+    i18n (0.6.0)
+    metaclass (0.0.1)
+    minitest (3.4.0)
+    mocha (0.12.4)
+      metaclass (~> 0.0.1)
+    multi_json (1.3.6)
+    multipart-post (1.1.5)
+    rake (0.9.2.2)
+    simplecov (0.6.4)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    virtus (0.5.1)
+      backports (~> 2.6.1)
+    webmock (1.8.9)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  adcloud!
+  minitest (~> 3.4.0)
+  mocha (~> 0.12.4)
+  rake
+  simplecov
+  webmock

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Jan Kus
+
+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,221 @@
+adcloud-api
+===========
+
+A little wrapper for the adcloud API. It provides all the required classes and
+configuration options to access the adcloud API and interact with it. Moreover,
+you can use it to post-process incoming callbacks (implemented via http webhooks).
+
+This is the official ruby gem for the adcloud API. If you have any problems or
+requests please contact api@adcloud.com
+
+__Warning__
+
+* API does not yet support Campaign Updates
+* API might change until it goes public, so expect changes!
+
+
+Installation
+------------
+
+In order to install the gem, run
+
+    gem install adcloud-api
+
+or if you are using bundler, add the following to your Gemfile
+
+    gem 'adcloud-api'
+
+
+Configuration
+-------------
+
+You always need to provide your adcloud client id and secret. Contact
+info@adcloud.com to get an account and credentials.
+
+    Adcloud.configure do |c|
+      c.client_id = '1234567890'
+      c.client_secret = '09876543'
+    end
+
+Enable debug mode to log http requests and setup logging
+
+    Adcloud.configure do |c|
+      c.debug = true # default false
+      c.logger = Logger.new # defaults to STDOUT or Rails.logger if available
+    end
+
+Authentication
+--------------
+
+Usually you wont need to do this, as the gem authenticates against the api by
+itself. But if you wanna play with the API yourself, this might come in handy to
+get a valid auth token.
+
+    adcloud_auth = Adcloud::Authentication.new(
+      :client_id => Adcloud.config.client_id,
+      :client_secret => Adcloud.config.client_secret)
+    adcloud_auth.authenticate!
+    adcloud_auth.token # returns an oauth access_token
+
+Advertisement
+-------------
+
+Read all advertisement objects
+
+    Adcloud::Advertisement.all
+
+Filtering
+
+    Adcloud::Advertisement.all({ active: true })
+
+Available filter keys are:
+
+* campaign
+* product
+* active
+
+Pagination
+
+    Adcloud::Advertisement.all(nil, 2, 10)
+
+Read/Find a advertisement
+
+    Adcloud::Advertisement.find_by_id(42)
+
+Create/Write a new advertisement
+
+    advertisement = Adcloud::Advertisement.new({ your: 'attributes' })
+    advertisement.create
+
+Campaign
+--------
+
+### Fetch campaigns list
+
+Read all campaigns which belong to your account
+
+    Adcloud::Campaign.all
+
+If the list gets too long, you can paginate and filter it. Provide a hash of
+filter criteria as the first parameter:
+
+    Adcloud::Campaign.all({ filter_key: 'filter value' })
+
+Available filter keys are:
+
+    company, country, customer, delivery_type, destination, managed, name,
+    product, status, type
+
+Optionally set the page and page size as second and third parameter
+
+    Adcloud::Campaign.all({ status: 'online' })
+    Adcloud::Campaign.all({ status: 'online' }, 2, 10)
+
+Creating a New Campaign Object
+
+    campaign = Adcloud::Campaign.new({ your: 'attributes' })
+
+### Read a single campaign
+
+    Adcloud::Campaign.find_by_id(42)
+
+### Validate a campaign
+
+    campaign = Adcloud::Campaign.new({ your: 'attributes' })
+    campaign.valid? # returns true/false
+
+### Create a new campaign
+
+Create a campaign by calling ```create``` on an initialized object. It will
+return true when the campaign was created successfully and sets the id on the
+object. Otherwise ```errors``` would provide you with the reason why it failed.
+
+    campaign = Adcloud::Campaign.new({ your: 'attributes' })
+    campaign.create # returns a boolean
+    campaign.errors
+
+Alternatively, you could use the static method
+
+    campaign = Adcloud::Campaign.create({ your: 'attributes' })
+
+Customer
+--------
+
+Get all customers
+
+    Customer.all
+
+Get a customer object
+
+    Customer.find(42)
+
+Create a customer object
+
+    Customer.create({ name: 'AdKlaus' })
+
+Media Files
+-----------
+
+Create a new media file with
+
+    Adcloud::MediaFile.create(
+      uploaded_file: 'http://yourhost.com/yourfile.ext'
+      product_id: 123,
+      ad_id: 456,
+      flash: false,
+      display: false
+    end
+
+where ```uploaded_file``` is a publicly accessible url to an image file.
+
+Product
+-------
+
+Get all products
+
+    Adcloud::Product.all
+
+Get a single product
+
+    Adcloud::Product.find(123)
+
+Create a new product
+
+    product = Adcloud::Product.create(name: 'Product name', customer_id: 123)
+    # or
+    product = Adcloud::Product.new(name: 'Product name', customer_id: 123)
+    if product.create
+        # ...
+    else
+        puts product.errors.inspect
+    end
+
+
+Topic
+-----
+
+Read all topics
+
+    topics = Adcloud::Topic.all
+
+And a single topic
+
+    topic = Adcloud::Topic.find(123)
+
+Topics provide their name in various languages
+
+    topic.names['en_gb'] # english name
+    topic.names['de_de'] # german name
+    ...
+
+Prices, reach, discounts are provided for each country
+
+    topic.discounts['gb'] # Values for England
+    topic.discounts['de'] # Values for Germany
+
+Authors
+-------
+
+[Jan Kus](http://github.com/koos),
+[Maximilian Schulz](http://github.com/namxam),
+[Michael Bumann](http://github.com/bumi)

data/RELEASE_NOTES.md

@@ -0,0 +1,14 @@
+Release Notes
+=============
+
+### 0.7 _First public release_
+
+* Enable configuration
+* Find and create advertisements
+* Find, create, validate campaigns
+* Find and create customers
+* Create media files
+* Find and create products
+* Fetch report data by day
+* Find and create topics
+* Parse webhooks and call configured code blocks

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+task :default => :test

data/adcloud.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/adcloud/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ['Jan Kus', 'Max Schulz']
+  gem.email         = ['jan@railslove.com', 'm.schulz@kulturfluss.de']
+  gem.summary       = %Q{Wrapper for adcloud API}
+  gem.description   = %Q{This is the official adcloud API gem. If you have any problems or requests please contact api@adcloud.com.}
+  gem.homepage      = 'http://adcloud.com/'
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = 'adcloud'
+  gem.require_paths = ['lib']
+  gem.version       = Adcloud::VERSION
+
+  gem.add_development_dependency 'minitest', '~> 3.4.0'
+  gem.add_development_dependency 'mocha', '~> 0.12.4'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'simplecov'
+  gem.add_development_dependency 'webmock'
+
+  gem.add_dependency 'virtus'
+  gem.add_dependency 'activesupport', "~>3.2.6"
+  gem.add_dependency 'faraday'
+  gem.add_dependency 'faraday_middleware'
+end

data/lib/adcloud.rb

@@ -0,0 +1,62 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'adcloud/response_error_handler'
+require 'logger'
+require 'active_support/configurable'
+require 'active_support/inflector'
+require 'virtus'
+
+module Adcloud
+
+  include ActiveSupport::Configurable
+
+  autoload :Ad, "adcloud/ad"
+  autoload :Advertisement, "adcloud/advertisement"
+  autoload :ApiError, "adcloud/api_error"
+  autoload :Authentication, "adcloud/authentication"
+  autoload :Campaign, "adcloud/campaign"
+  autoload :Connection, "adcloud/connection"
+  autoload :Customer, "adcloud/customer"
+  autoload :Entity, "adcloud/entity"
+  autoload :ExceptionRaiser, "adcloud/exception_raiser"
+  autoload :MediaFile, "adcloud/media_file"
+  autoload :Product, "adcloud/product"
+  autoload :Report, "adcloud/report"
+  autoload :ReportEntry, "adcloud/report_entry"
+  autoload :Topic, "adcloud/topic"
+  autoload :TopicDiscount, "adcloud/topic_discount"
+  autoload :Webhook, "adcloud/webhook"
+  autoload :WebhookConfig, "adcloud/webhook_config"
+  autoload :WebhookEvent, "adcloud/webhook_event"
+
+  module AdcloudSucks; class InvalidApiResponse < StandardError; end; end
+  class BadRequestError < ApiError; end
+  class NotFoundError < ApiError; end
+  class ServerError < ApiError; end
+  class Unauthorized < ApiError; end
+
+  class << self
+    # Access the logger instance
+    def logger
+      @@logger ||= (defined?(Rails) && Rails.logger) || Adcloud.config.logger || Logger.new(STDOUT)
+    end
+
+    # Allow to override the logger
+    def logger=(input)
+      @@logger = input
+    end
+  end
+
+end
+
+Adcloud.configure do |c|
+  c.port = 443
+  c.protocol = 'https'
+  c.host = 'api.adcloud.com'
+  c.api_version = "v2"
+  c.http_open_timeout = 5
+  c.http_read_timeout = 10
+  c.debug = false
+  c.webhooks = Adcloud::WebhookConfig.new
+  c.webhooks.filter_tests = true
+end