douaparale 0.0.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3afcd5bb83630e8ab3f342b09591ff531b9f6fa3
+  data.tar.gz: 54a7ca4290dd988f2ba6412c4e2f4a9c05f469bf
+SHA512:
+  metadata.gz: 171ec04d36bd6c6efdd3a181486770e9b1c66d1452b792d1d298fdaf8a1d10447f2516ae0443d367f741c432da0c4029162d2400c70a85280716f751fc4a9b95
+  data.tar.gz: 36d057aaa6f131df6d454573efc76ebb737ba277754f57888709d186d7908ddb22cacf0cb12a26e22424572f69600180a611a21835934e480636390ec07b6c10

data/.document

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

data/.gitignore

@@ -0,0 +1,22 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+lib/test.rb

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Andrei Bocan
+
+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,55 @@
+# 2Performant Ruby API
+
+The API allows you to integrate any 2Performant network in your application.
+
+Its goal is to make sure developers can implement anything that can be done via the web interface using API functions.
+
+The API is RESTful XML over HTTP using all four verbs (GET/POST/PUT/DELETE).
+
+The current implementation is a straight port of the PHP library, so the documentation applies, for the most part, to both libraries.
+
+API documentation can be found at:
+http://help.2performant.com/API
+
+
+## Some Examples
+
+Interacting with 2Performant networks is very easy.
+
+
+To initialize the object using simple authentication
+  
+    session = TwoPerformant.new(:simple, {
+      :user => 'user',
+      :pass => 'password',
+    }, 'http://api.yournetwork.com')
+
+To use oauth
+
+    tp = TwoPerformant.new(:oauth, {
+      :consumer_token => 'consumer_token',
+      :consumer_secret => 'consumer_secret',
+      :access_token => 'access_token',
+      :access_secret => 'access_secret'
+    }, 'http://api.yournetwork.com')
+
+
+Afterwards you can call any function from the TPerformant class:
+
+    # display the last 6 received messages
+    p session.received_messages_list
+
+For details about each API function the documentation can be found at:
+http://help.2performant.com/API
+
+
+## Advanced Applications
+
+You can build advanced applications using the 2Performant API and have them distributed over 2Performant App Store. 
+
+Get Started at: http://apps.2performant.com and http://help.2performant.com/Developers-Area
+
+## Reporting Problems
+
+If you encounters any problems don't hesitate to contact us at:
+support (at) 2performant.com

data/Rakefile

@@ -0,0 +1,55 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "douaparale"
+    gem.summary = %Q{Library for the 2Parale API}
+    gem.description = %Q{Library for the 2Parale API}
+    gem.email = "gems@2parale.ro"
+    gem.homepage = "http://github.com/2performant/2Performant"
+    gem.authors = ["2Parale"]
+    gem.add_dependency "httparty"
+    gem.add_dependency "oauth"
+    gem.add_development_dependency "shoulda", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "2Parale #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.8

data/douaparale.gemspec

@@ -0,0 +1,61 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{douaparale}
+  s.version = "0.0.8"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["2Parale"]
+  s.date = %q{2010-07-26}
+  s.description = %q{Library for the 2Performant API}
+  s.email = %q{gems@2parale.ro}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.md"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "douaparale.gemspec",
+     "LICENSE",
+     "README.md",
+     "Rakefile",
+     "VERSION",
+     "lib/douaparale.rb",
+     "lib/douaparale/oauth.rb",
+     "test/helper.rb",
+     "test/test_2performant.rb"
+  ]
+  s.homepage = %q{http://github.com/2performant/2Performant}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Library for the 2Performant API}
+  s.test_files = [
+    "test/helper.rb",
+     "test/test_2performant.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0"])
+      s.add_runtime_dependency(%q<oauth>, [">= 0"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0"])
+      s.add_dependency(%q<oauth>, [">= 0"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0"])
+    s.add_dependency(%q<oauth>, [">= 0"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+  end
+end
+

data/lib/douaparale.rb

@@ -0,0 +1,715 @@
+require 'httparty'
+require 'douaparale/oauth'
+
+class DouaParale
+  include HTTParty
+  format :xml
+  headers 'Content-Type' => 'text/xml'
+
+  attr_accessor :user, :pass, :host, :version, :auth_type, :oauth, :oauth_request
+
+  def initialize(auth_type, auth_obj, host)
+    if auth_type == :simple
+      self.class.basic_auth auth_obj[:user], auth_obj[:pass]
+    elsif auth_type == :oauth
+      self.oauth = TwoPerformant::OAuth.new(auth_obj, host)
+    else
+      return false
+    end
+
+    self.version = "v1.0"
+    self.auth_type = auth_type
+    self.host = host
+    self.class.base_uri host
+  end
+
+  # =======
+  #  Users
+  # =======
+  def user_show(user_id)
+    self.hook("/users/#{user_id}.xml", "user");
+  end
+
+
+  #  Display public information about the logged in user
+  def user_loggedin
+    self.hook("/users/loggedin.xml", "user");
+  end
+
+  # ===========
+  #  Campaigns
+  # ===========
+
+  #  List campaigns. Displays the first 6 entries by default.
+  def campaigns_list(category_id=nil, page=1, perpage=6)
+    request = {
+      'category_id'  => category_id,
+      'page'         => page,
+      'perpage'      => perpage
+    }
+
+    self.hook("/campaigns.xml", "campaign", request, 'GET')
+  end
+
+  #  Search for campaigns
+  def campaigns_search(search, page = 1, perpage = 6)
+    request = {
+      'page'    => page,
+      'perpage' => perpage,
+      'search'  => search
+    }
+
+    self.hook("/campaigns/search.xml", "campaign", request, 'GET')
+  end
+
+  #  Display public information about a campaign
+  def campaign_show(campaign_id)
+    self.hook("/campaigns/#{campaign_id}.xml", "campaign")
+  end
+
+  #  Affiliates: List campaigns which have the logged in user accepted
+  def campaigns_listforaffiliate
+    self.hook("/campaigns/listforaffiliate.xml", "campaign")
+  end
+
+  #  Merchants: List all campaigns created by the logged in user
+  def campaigns_listforowner
+    self.hook("/campaigns/listforowner.xml", "campaign")
+  end
+
+  #  Merchants: Display complete information about a campaign (only available to owner)
+  def campaign_showforowner(campaign_id)
+    self.hook("/campaigns/#{campaign_id}/showforowner.xml", "campaign")
+  end
+
+  #  Merchants: Update a campaign
+  def campaign_update(campaign_id, campaign)
+    request = {
+      'campaign' => campaign
+    }
+    self.hook("/campaigns/#{campaign_id}.xml", "campaign", request, 'PUT')
+  end
+
+  #  Create a Deep Link. This method was created so it wouldn't make a request for every Quick Link.
+  #  You may need to get some data before using it.
+  def campaign_quicklink(campaign_id, aff_code, redirect)
+    url = "#{self.host}/events/click?ad_type=quicklink&aff_code=#{aff_code}&unique=#{campaign_id}&redirect_to=#{redirect}"
+
+    if (self.auth_type == :oauth)
+      url << "&app=#{self.oauth}"
+    end
+
+    url
+  end
+
+  # ============
+  #  Sales
+  # ============
+
+  def sale_create(campaign_id, sale)
+    request = {
+      'sale' => sale
+    }
+
+    self.hook("/campaigns/#{campaign_id}/sales.xml", "sale", request, "POST")
+  end
+
+  # ============
+  #  Leads
+  # ============
+
+  def lead_create(campaign_id, lead)
+    request = {
+      'lead' => lead
+    }
+
+    self.hook("/campaigns/#{campaign_id}/leads.xml", "lead", request, "POST")
+  end
+
+  # ============
+  #  Affiliates
+  # ============
+
+  #  Search for affiliates
+  def affiliates_search(search, page=1, perpage=6)
+    request = {
+      'page'    => page,
+      'perpage' => perpage,
+      'search'  => search
+    }
+
+    self.hook("/affiliates/search.xml", "user", request, 'GET')
+  end
+
+  #  Merchants: List affiliates approved in campaigns
+  def affiliates_listformerchant(campaign_id=nil)
+    request = {
+      'campaign_id' => campaign_id
+    }
+    self.hook("/affiliates/listformerchant.xml", "user", request, 'GET')
+  end
+
+  # =============
+  #  Commissions
+  # =============
+
+  #  Search for commissions.  Month: 01 to 12; Year: 20xx. Status: accepted, pending or rejected. nil if empty search.
+  def commissions_search(options, campaign_id=nil, month=nil, year=nil, page=1, perpage=6)
+    request = {
+      'campaign_id' => campaign_id,
+      'month'       => month,
+      'year'        => year,
+      'page'        => page,
+      'perpage'     => perpage
+    }
+
+    request = request.merge(options)
+
+    self.hook("/commissions/search.xml", "commission", request, 'GET')
+  end
+
+  #  Merchants: List commissions on campaigns. Month: 01 to 12; Year: 20xx.
+  def commissions_listformerchant(campaign_id, month, year)
+    request = {
+      'campaign_id' => campaign_id,
+      'month'       => month,
+      'year'        => year
+    }
+
+    self.hook("/commissions/listformerchant.xml", "campaign", request, 'GET')
+  end
+
+  #  Affiliates: List commissions on campaigns. Month: 01 to 12; Year: 20xx.
+  def commissions_listforaffiliate(campaign_id, month, year)
+    request = {
+      'campaign_id' => campaign_id,
+      'month'       => month,
+      'year'        => year
+    }
+
+    self.hook("/commissions/listforaffiliate.xml", "commission", request, 'GET')
+  end
+
+  #  Merchant Campaign Owner or Affiliate Commission Owner: Show information about a commission
+  def commission_show(commission_id)
+    self.hook("/commissions/#{commission_id}.xml", "commission")
+  end
+
+  #  Merchant: Update a commission
+  def commission_update(commission_id, commission)
+    request = {
+      'commission' => commission
+    }
+    self.hook("/commissions/#{commission_id}.xml", "commission", request, 'PUT')
+  end
+
+  # =======
+  #  Sites
+  # =======
+
+  #  List sites. Displays the first 6 entries by default.
+  def sites_list(category_id=nil, page=1, perpage=6)
+    request = {
+      'category_id' => category_id,
+      'page'        => page,
+      'perpage'     => perpage
+    }
+
+    self.hook("/sites.xml", "site", request)
+  end
+
+  #  Display information about a site
+  def site_show(site_id)
+    self.hook("/sites/#{site_id}.xml", "site")
+  end
+
+  #  Search for sites
+  def sites_search(search, page=1, perpage=6)
+    request = {
+      'page'    => page,
+      'perpage' => perpage,
+      'search'  => search
+    }
+
+    self.hook("/sites/search.xml", "site", request, 'GET')
+  end
+
+  #  Affiliates: List all sites created by the logged in user
+  def sites_listforowner
+    self.hook("/sites/listforowner.xml", "site")
+  end
+
+  #  Affiliates: Update a site
+  def site_update(site_id, site)
+    request = {
+      'site' => site
+    }
+    self.hook("/sites/#{site_id}.xml", "site", request, 'PUT')
+  end
+
+
+  #  Affiliates: Destroy a site
+  def site_destroy(site_id)
+    self.hook("/sites/#{site_id}.xml", "site", request, 'DELETE')
+  end
+
+  # ============
+  #  Text Links
+  # ============
+
+  #  List text links from a campaign. Displays the first 6 entries by default.
+  def txtlinks_list(campaign_id, page=1, perpage=6)
+    request = {
+      'page'    => page,
+      'perpage' => perpage
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtlinks.xml", "txtlink", request, 'GET')
+  end
+
+  #  Display information about a text link
+  def txtlink_show(campaign_id, txtlink_id)
+    self.hook("/campaigns/#{campaign_id}/txtlinks/#{txtlink_id}.xml", "txtlink")
+  end
+
+  #  Search for text links in a campaign
+  def txtlinks_search(campaign_id, search, page=1, perpage=6, sort='date')
+    request = {
+      'page'    => page,
+      'perpage' => perpage,
+      'search'  => search,
+      'sort'    => sort,
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtlinks/search.xml", "txtlink", request, 'GET')
+  end
+
+  #
+  # Merchants: Create Text Link.
+  #
+  # Txtlink must be a hash of:
+  #   { "title" => "title",
+  #     "url" => "url",
+  #     "help" => "help"
+  #   },  where "help" is optional
+
+  def txtlink_create(campaign_id, txtlink)
+    request = {
+      'txtlink' => txtlink
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtlinks.xml", "txtlink", request, 'POST')
+  end
+
+  #  Merchants: Update a text link
+  def txtlink_update(campaign_id, txtlink_id, txtlink)
+    request = {
+      'txtlink' => txtlink
+    }
+    self.hook("/campaigns/#{campaign_id}/txtlinks/#{txtlink_id}.xml", "txtlink", request, 'PUT')
+  end
+
+  #  Merchants: Destroy a text link
+  def txtlink_destroy(campaign_id, txtlink_id)
+    self.hook("/campaigns/#{campaign_id}/txtlinks/#{txtlink_id}.xml", "txtlink", nil, 'DELETE')
+  end
+
+  # ============
+  #  Text Ads
+  # ============
+
+  #  List text ads from a campaign. Displays the first 6 entries by default.
+  def txtads_list(campaign_id, page=1, perpage=6)
+    request = {
+      'page'    => page,
+      'perpage' => perpage
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtads.xml", "txtad", request, 'GET')
+  end
+
+  #  Display information about a text ad
+  def txtad_show(campaign_id, txtad_id)
+    self.hook("/campaigns/#{campaign_id}/txtads/#{txtad_id}.xml", "txtad")
+  end
+
+  #  Search for text ads in a campaign
+  def txtads_search(campaign_id, search, page=1, perpage=6, sort='date')
+    request = {
+      'page'    => page,
+      'perpage' => perpage,
+      'search'  => search,
+      'sort'    => sort
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtads/search.xml", "txtad", request, 'GET')
+  end
+
+  #
+  # Merchants: Create Text Ad.
+  # Txtad must be a hash of:
+  #   { "title" => "title",
+  #     "content" => "content",
+  #     "url" => "url",
+  #     "help" => "help"
+  #   },  where "help" is optional
+  def txtad_create(campaign_id, txtad)
+    request = {
+      'txtad' => txtad
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtads.xml", "txtad", request, 'POST')
+  end
+
+
+  #  Merchants: Update a text ad
+  def txtad_update(campaign_id, txtad_id, txtad)
+    request = {
+      'txtad' => txtad
+    }
+
+    self.hook("/campaigns/#{campaign_id}/txtads/#{txtad_id}.xml", "txtad", request, 'PUT')
+  end
+
+  #  Merchants: Destroy a text ad
+  def txtad_destroy(campaign_id, txtad_id)
+    self.hook("/campaigns/#{campaign_id}/txtads/#{txtad_id}.xml", "txtad", nil, 'DELETE')
+  end
+
+  # =========
+  #  Banners
+  # =========
+
+  #  List banners from a campaign. Displays the first 6 entries by default.
+  def banners_list(campaign_id, page=1, perpage=6)
+    request = {
+      'page'    => page,
+      'perpage' => perpage
+    }
+
+    self.hook("/campaigns/#{campaign_id}/banners.xml", "banner", request, 'GET')
+  end
+
+  #  Display information about a banner
+  def banner_show(campaign_id, banner_id)
+    self.hook("/campaigns/#{campaign_id}/banners/#{banner_id}.xml", "banner")
+  end
+
+  #  Search for banners in a campaign
+  def banners_search(campaign_id, search, page=1, perpage=6, sort='date')
+    request = {
+      'page'    => page,
+      'perpage' => perpage,
+      'search'  => search,
+      'sort'    => sort
+    }
+
+    self.hook("/campaigns/#{campaign_id}/banners/search.xml", "banner", request, 'GET')
+  end
+
+  # Merchants: Create a banner
+  def banner_create(campaign_id, banner, banner_picture)
+    request = {
+      'banner' => banner,
+      'banner_picture' => banner_picture
+    }
+
+    self.hook("/campaigns/#{campaign_id}/banners.xml", "banner", request, 'POST')
+  end
+
+  #  Merchants: Update a banner
+  def banner_update(campaign_id, banner_id, banner)
+    request = {
+      'banner' => banner
+    }
+
+    self.hook("/campaigns/#{campaign_id}/banners/#{banner_id}.xml", "banner", request, 'PUT')
+  end
+
+  #  Merchants: Destroy a banner
+  def banner_destroy(campaign_id, banner_id)
+    self.hook("/campaigns/#{campaign_id}/banners/#{banner_id}.xml", "banner", nil, 'DELETE')
+  end
+
+  # ===============
+  #  Product Stores
+  # ===============
+
+  #  List Product Stores from a Campaign
+  def product_stores_list(campaign_id)
+    request = {
+      'campaign_id' => campaign_id
+    }
+
+    self.hook("/product_stores.xml", "product-store", request)
+  end
+
+  #  Show a Product Store
+  def product_store_show(product_store_id)
+    self.hook("/product_stores/#{product_store_id}.xml", "product-store")
+  end
+
+  #  Show Products from a Product Store
+  def product_store_showitems(product_store_id, category=nil, page=1, perpage=6, uniq_products=nil)
+    request = {
+      'category'      => category,
+      'page'          => page,
+      'perpage'       => perpage
+    }
+
+    request['uniq_products'] = uniq_products if (uniq_products)
+
+    self.hook("/product_stores/#{product_store_id}/showitems.xml", "product-store-data", request)
+  end
+
+  #  Show a Product from a Product Store
+  def product_store_showitem(product_store_id, product_id)
+    request = {
+      'product_id' => product_id
+    }
+
+    self.hook("/product_stores/#{product_store_id}/showitem.xml", "product-store-data", request)
+  end
+
+
+  #  Search for Products in a Product Store
+  def product_store_products_search(campaign_id, search, product_store_id='all', category=nil, page=1, perpage=6, sort='date', uniq_products=false)
+    request = {
+      'page'          => page,
+      'perpage'       => perpage,
+      'search'        => search,
+      'category'      => category,
+      'campaign_id'   => campaign_id,
+      'sort'          => sort
+    }
+
+    request['uniq_products'] = uniq_products if uniq_products
+
+    product_store_id = 'all' if !product_store_id
+
+    self.hook("/product_stores/#{product_store_id}/searchpr.xml", "product-store-data", request, 'GET')
+  end
+
+  #  Merchants: Update a Product Store
+  def product_store_update(product_store_id, product_store)
+    request = {
+      'product_store' => product_store
+    }
+
+    self.hook("/product_stores/#{product_store_id}.xml", "product-store", request, 'PUT')
+  end
+
+  #  Merchants: Destroy a Product Store
+  def product_store_destroy(product_store_id)
+    self.hook("/product_stores/#{product_store_id}.xml", "product-store", nil, 'DELETE')
+  end
+
+  #
+  # Merchants: Create a Product Store Product.
+  # Product Store Product must be a hash of:
+  #   { "title" => "title",
+  #     "description" => "desc",
+  #     "caption" => "caption",
+  #     "price" => "price(integer in RON)",
+  #     "promoted" => "promoted (0 or 1)",
+  #     "category" => "category",
+  #     "subcategory" => "subcategory",
+  #     "url" => "url",
+  #     "image_url" => "url to image location",
+  #     "prid" => "product id"
+  #   }
+  def product_store_createitem(product_store_id, product)
+    request = {
+      'product' => product
+    }
+
+    self.hook("/product_stores/#{product_store_id}/createitem.xml", "product-store-data", request, 'POST')
+  end
+
+  #  Merchants: Update a product
+  def product_store_updateitem(product_store_id, product_id, product)
+    request = {
+      'product'      => product,
+      'product_id'   => product_id
+    }
+
+    self.hook("/product_stores/#{product_store_id}/updateitem.xml", "product-store-data", request, 'PUT')
+  end
+
+  #  Merchants: Destroy a product
+  def product_store_destroyitem(product_store_id, product_id)
+    request = {
+      'pr_id' => product_id
+    }
+
+    self.hook("/product_stores/#{product_store_id}/destroyitem.xml", "product-store-data", request, 'DELETE')
+  end
+
+  # =====================
+  #  Affiliate Ad Groups
+  # =====================
+
+  #  Affiliates: List Ad Groups
+  def ad_groups_list
+    self.hook("/ad_groups.xml", "ad_group", nil, "GET")
+  end
+
+  #  Affiliates: Display information about an Ad Group
+  def ad_group_show(ad_group_id)
+    self.hook("/ad_groups/#{ad_group_id}.xml", "ad_group", nil, "GET")
+  end
+
+  # Affiliates: Add item to an Ad Group / Crate new Ad Group
+  def ad_group_createitem(group_id, tool_type, tool_id, new_group = nil)
+    request = {
+      'group_id' => group_id,
+      'new_group' => new_group,
+      'tool_type' => tool_type,
+      'tool_id' => tool_id
+    }
+
+    self.hook("/ad_groups/createitem.xml", "ad_group", request, 'POST')
+  end
+
+  #  Affiliates: Destroy an Ad Group
+  def ad_group_destroy(ad_group_id)
+    self.hook("/ad_groups/#{ad_group_id}.xml", "ad_group", nil, "DELETE")
+  end
+
+  #  Affiliates: Delete an Tool from a Group. tooltype is one of 'txtlink', 'txtad' or 'banner'.
+  def ad_group_destroyitem(ad_group_id, tool_type, tool_id)
+    request = {
+      'tool_type' => tool_type,
+      'tool_id'   => tool_id
+    }
+
+    self.hook("/ad_groups/#{ad_group_id}/destroyitem.xml", "ad_group", request, "DELETE")
+  end
+
+  #=================
+  # Affiliate Feeds
+  #=================
+
+  # Affiliates: List Feeds
+  def feeds_list()
+    self.hook("/feeds.xml", "feed", nil, "GET")
+  end
+
+  # Affiliates: Create a Feed
+  def feed_create(feed)
+    request = {
+      'feed' => feed
+    }
+
+    self.hook("/feeds.xml", "feed", request, 'POST')
+  end
+
+  # Affiliates: Update a Feed
+  def feed_update(feed_id, feed)
+    request = {
+      'feed' => feed
+    }
+
+    self.hook("/feeds/#{feed_id}.xml", "feed", request, 'PUT')
+  end
+
+
+  # Affiliates: Destroy a Feed
+  def feed_destroy(feed_id)
+    self.hook("/feeds/#{feed_id}.xml", "feed", nil, "DELETE")
+  end
+
+  # ==========
+  #  Messages
+  # ==========
+
+  #  List received messages. Displays the first 6 entries by default.
+  def received_messages_list(page=1, perpage=6)
+    request = {
+      'page'      => page,
+      'perpage'   => perpage
+    }
+
+    self.hook("/messages.xml", "message", nil, "GET")
+  end
+
+  #  List sent messages. Displays the first 6 entries by default.
+  def sent_messages_list(page=1, perpage=6)
+    request = {
+      'page'      => page,
+      'perpage'   => perpage
+    }
+
+    self.hook("/messages/sent.xml", "message", nil, "GET")
+  end
+
+  #  Display information about a message
+  def message_show(message_id)
+    self.hook("/messages/#{message_id}.xml", "message")
+  end
+
+  #  Destroy a message
+  def message_destroy(message_id)
+    self.hook("/messages/#{message_id}.xml", "message", nil, 'DELETE')
+  end
+
+
+  #=======
+  # Hooks 
+  #=======
+
+  # List Hooks 
+  def hooks_list(oauth_token_key = 'current')
+    hook("/oauth_clients/#{oauth_token_key}/hooks.xml", "hook", nil, 'GET')
+  end
+
+
+  # Create a Hook 
+  def hook_create(hook, oauth_token_key = 'current')
+    request = {
+      'hook' => hook
+    }
+
+    hook("/oauth_clients/#{oauth_token_key}/hooks.xml", "hook", request, 'POST')
+  end
+
+  # Destroy a Hook 
+  def hook_destroy(hook_id, oauth_token_key = 'current')
+    hook("/oauth_clients/#{oauth_token_key}/hooks/#{hook_id}.xml", "hook", nil, 'DELETE')
+  end
+
+  def hook(path, expected, send = nil, method = 'GET') #:nodoc:
+    params = normalize_params(send, method)
+
+    if self.oauth
+      result = self.oauth.send(method.downcase, "/#{version}#{path}", send, params)
+    else
+      result = self.class.send(method.downcase, "/#{version}#{path}", :body => params)
+    end
+
+    # scrap the container
+    if result.respond_to? :values
+      result.values.first
+    else
+      result
+    end
+  end
+
+  def normalize_params(params, method)
+    hash_to_xml(:request => params).to_s
+  end
+
+  def hash_to_xml(var, document = nil)
+    document = REXML::Document.new if document.nil?
+
+    if var.respond_to? :keys
+      var.keys.each do |key|
+        hash_to_xml(var[key], document.add_element(key.to_s))
+      end
+    else
+      document.add_text(var.to_s)
+    end
+
+    document
+  end
+end

data/lib/douaparale/oauth.rb

@@ -0,0 +1,34 @@
+require 'oauth'
+
+class DouaParale
+  class OAuth
+    attr_accessor :access_token, :consumer
+
+    def initialize(options, host)
+      consumer = ::OAuth::Consumer.new(options[:consumer_token], options[:consumer_secret], {:site => host})
+      @access_token = ::OAuth::AccessToken.new(consumer, options[:access_token], options[:access_secret])
+      @headers = { 'Accept' => 'application/xml', 'Content-Type' => 'application/xml' }
+    end
+
+    def get(path, params_hash, params_xml) 
+      params_hash ||= {}
+      response = access_token.get("#{path}?#{params_hash.to_params}")
+      Crack::XML.parse(response.body)
+    end
+
+    def post(path, params_hash, params_xml) 
+      response = access_token.post(path, params_xml, @headers)
+      Crack::XML.parse(response.body)
+    end
+
+    def put(path, params_hash, params_xml) 
+      response = access_token.put(path, params_xml, @headers)
+      Crack::XML.parse(response.body)
+    end
+
+    def delete(path, params) 
+      response = access_token.delete("#{path}?#{params.to_params}")
+      Crack::XML.parse(response.body)
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require '2performant'
+
+class Test::Unit::TestCase
+end

data/test/test_2performant.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class Test2performant < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification
+name: douaparale
+version: !ruby/object:Gem::Version
+  version: 0.0.8
+platform: ruby
+authors:
+- 2Parale
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2010-07-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Library for the 2Performant API
+email: gems@2parale.ro
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- .document
+- .gitignore
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- douaparale.gemspec
+- lib/douaparale.rb
+- lib/douaparale/oauth.rb
+- test/helper.rb
+- test/test_2performant.rb
+homepage: http://github.com/2performant/2Performant
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+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.2.2
+signing_key: 
+specification_version: 3
+summary: Library for the 2Performant API
+test_files:
+- test/helper.rb
+- test/test_2performant.rb