agcod 0.0.2

data/.document

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

data/.gitignore

@@ -0,0 +1,9 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+features/support/app_root/config/agcod.yml
+log
+agcod_cucumber.log
+features/support/certification_requests

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Dan Pickett
+
+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.rdoc

@@ -0,0 +1,7 @@
+= agcod
+
+Description goes here.
+
+== Copyright
+
+Copyright (c) 2009 Dan Pickett. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,67 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "agcod"
+    gem.summary = %Q{A Wrapper for Amazon Gift Cards On Demand}
+    gem.email = "dpickett@enlightsolutions.com"
+    gem.homepage = "http://github.com/dpickett/agcod"
+    gem.authors = ["Dan Pickett"]
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo 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
+    test.rcov_opts << "-x /Gems/"
+  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
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+require File.join(File.dirname(__FILE__), "lib", "agcod", "tasks")
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "agcod #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/agcod.gemspec

@@ -0,0 +1,73 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{agcod}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dan Pickett"]
+  s.date = %q{2009-10-14}
+  s.email = %q{dpickett@enlightsolutions.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "agcod.gemspec",
+     "cucumber.yml",
+     "features/error_handling.feature",
+     "features/step_definitions/agcod_steps.rb",
+     "features/success_certification.feature",
+     "features/support/app_root/config/agcod.example.yml",
+     "features/support/env.rb",
+     "lib/agcod.rb",
+     "lib/agcod/cancel_gift_card.rb",
+     "lib/agcod/configuration.rb",
+     "lib/agcod/create_gift_card.rb",
+     "lib/agcod/error/configuration_error.rb",
+     "lib/agcod/error/invalid_parameter.rb",
+     "lib/agcod/health_check.rb",
+     "lib/agcod/option_validators.rb",
+     "lib/agcod/request.rb",
+     "lib/agcod/tasks.rb",
+     "lib/agcod/tasks/certification.rake",
+     "lib/agcod/void_gift_card_creation.rb",
+     "manual_features/cancel_claimed_giftcard.feature",
+     "manual_features/insufficient_funds.feature",
+     "manual_features/retry_and_http.feature",
+     "tasks/agcod.rake",
+     "test/agcod/configuration_test.rb",
+     "test/app_root/config/agcod.yml",
+     "test/macros/configuration.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/dpickett/agcod}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A Wrapper for Amazon Gift Cards On Demand}
+  s.test_files = [
+    "test/agcod/configuration_test.rb",
+     "test/macros/configuration.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/cucumber.yml

@@ -0,0 +1 @@
+default: "--require features/support/env.rb --require features/step_definitions/agcod_steps.rb"

data/features/error_handling.feature

@@ -0,0 +1,31 @@
+Feature: Error Handling
+  As a user of the agcod service
+  I want to correctly handle errors
+  So I can get certified
+
+  Background:
+    Given I have access to the AGCOD web service
+    And I am logging transactions
+
+  Scenario: #8 Error Handling E203
+    Given I specify response_id "AAAEPY26ZX1BSY"
+    And I want to cancel request "2"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #9 Error Handling E204
+    Given I specify response_id "A3REPY26ZX1BSY"
+    And I want to cancel request "2"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #10 Error Handling for no currency code
+    Given I specify the currency of "" 
+    And I want to send request "7"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #11 Error Handling with Max Limit
+    Given I want to send request "8"
+    When I send the request
+    Then I should not receive a successful response

data/features/step_definitions/agcod_steps.rb

@@ -0,0 +1,121 @@
+Given /^I have access to the AGCOD web service$/ do
+  Agcod::Configuration.load(File.join(File.dirname(__FILE__), "..", "support", "app_root"), "cucumber")
+  assert_not_nil Agcod::Configuration.access_key
+end
+
+Given /^I want to send request \"(.*)\"/ do |request_number|
+  req = get_request(request_number)
+  @options ||= {} 
+  @request = Agcod::CreateGiftCard.new(req.merge(@options))
+end
+
+Given /^I am logging transactions$/ do
+  @logger = Logger.new(File.join(FileUtils.pwd, "agcod_cucumber.log"))
+  Agcod::Configuration.logger = @logger
+end
+
+Given /^I want to send a health check request$/ do
+  @request = Agcod::HealthCheck.new
+end
+
+Given /^I've sent request \"(.*)\"$/ do |request_number|
+  req = get_request(request_number)
+  @prior_request = Agcod::CreateGiftCard.new("value" => req["value"].to_f,
+   "request_id" => req["request_id"])
+  @prior_request.submit
+  dump_request(@prior_request)
+end
+
+Given /^I want to cancel the gift card requested$/ do
+  @request = Agcod::CancelGiftCard.new("request_id" => @prior_request.request_id, 
+    "response_id" => @prior_request.response_id)
+end
+
+Given /^I want to void the gift card requested$/ do
+  @request = Agcod::VoidGiftCardCreation.new("request_id" => @prior_request.request_id)
+end
+
+
+Given /^the request was successful$/ do
+  assert @prior_request.successful?
+end
+
+Given /^I want to create a gift card with the same request id$/ do
+  @request = Agcod::CreateGiftCard.new("value" => 40, "request_id" => @prior_request.request_id)
+  @dont_dump_request = true
+end
+
+Given /^I want to cancel request "([^\"]*)"$/ do |req_num|
+  req = get_request(req_num)
+  @options ||= {}
+  @request = Agcod::CancelGiftCard.new(req.merge(@options))
+end
+
+Given /^I want to void request "([^\"]*)"$/ do |req_num|
+  req = get_request(req_num)
+  @options ||= {}
+  @request = Agcod::VoidGiftCardCreation.new(req.merge(@options))
+end
+
+
+Given /^I specify response_id "([^\"]*)"$/ do |response_id|
+  @options ||= {}
+  @options["response_id"] = response_id
+end
+
+Given /^I specify the currency of "([^\"]*)"$/ do |currency|
+  @options ||= {}
+  @options["currency_code"] = currency
+end
+
+
+
+Then /^I should not receive a successful response$/ do
+  assert !@request.successful?
+end
+
+When /^I send the request$/ do
+  @request.submit
+  dump_request(@request) if @request.is_a?(Agcod::CreateGiftCard) && !@dont_dump_request
+  @dont_dump_request = false if @dont_dump_request
+end
+
+Then /^I should receive a successful response$/ do
+  assert @request.successful?
+end
+
+Then /^I should get a response id$/ do
+  assert_not_nil @request.response_id
+end
+
+Then /^I should get a claim code$/ do
+  assert_not_nil @request.claim_code
+end
+
+
+def cert_fixture(req_num)
+  File.join(
+    File.dirname(__FILE__), "..", "support", "certification_requests", "#{req_num}.yml"
+  )
+end
+
+def get_request(req_num)
+  YAML.load(File.read(cert_fixture(req_num)))
+end
+
+def dump_request(req)
+  req_num = req.request_id[0..0]
+
+  
+  req_hash = {
+    "request_id" => req.request_id,
+    "value" => req.value,
+    "response_id" => req.response_id,
+    "claim_code" => req.claim_code
+  }
+
+  FileUtils.rm_f(cert_fixture(req_num))
+  File.open(cert_fixture(req_num), "w") do |f|
+    f.puts req_hash.to_yaml
+  end
+end

data/features/success_certification.feature

@@ -0,0 +1,47 @@
+Feature: Successful Cases for Certification 
+  As a user of the AGCOD api
+  I want to run certification tests that create successful responses
+  So that I can be authorized for production access
+ 
+  Background:
+    Given I have access to the AGCOD web service
+    And I am logging transactions
+
+  Scenario: #1 Successful Health Check
+    Given I want to send a health check request
+    When I send the request
+    Then I should receive a successful response
+  
+  Scenario: #2a Successful Creation of a Gift Card for $12
+    Given I want to send request "1"
+    When I send the request
+    Then I should receive a successful response
+    And I should get a claim code
+
+  Scenario: #2b Successful Creation of a Gift Card for $999
+    Given I want to send request "2"
+    When I send the request
+    Then I should receive a successful response
+    And I should get a claim code
+
+  Scenario: #3 Sending the same Gift Card Request ID
+    Given I've sent request "3"
+    And the request was successful
+    And I want to create a gift card with the same request id
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #4 Cancel a Gift Card Successfully
+    Given I've sent request "4"
+    And the request was successful
+    And I want to cancel the gift card requested
+    When I send the request
+    Then I should receive a successful response
+
+  Scenario: #5 Void a Gift Card Successfully
+    Given I've sent request "5"
+    And the request was successful
+    And I want to void the gift card requested
+    When I send the request
+    Then I should receive a successful response
+

data/features/support/app_root/config/agcod.example.yml

@@ -0,0 +1,6 @@
+test:
+  access_key: fadsfasdgt2434
+  secret_key: dfasdf
+  partner_id: SomebodyImportant
+  uri: https://agcws-gamma.amazon.com/
+  discount_percentage: 0.04

data/features/support/env.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+
+require 'test/unit/assertions'
+require "shoulda"
+
+require 'agcod'
+
+World(Test::Unit::Assertions)

data/lib/agcod.rb

@@ -0,0 +1,25 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+require "net/http"
+require "net/https"
+require 'rexml/document'
+
+require "uri"
+require "cgi"
+require "base64"
+require "hmac-sha1"
+require "digest/sha1"
+require "cgi"
+require "logger"
+
+require "agcod/error/invalid_parameter"
+require "agcod/error/configuration_error"
+require "agcod/option_validators"
+
+require "agcod/configuration"
+require "agcod/request"
+
+require "agcod/cancel_gift_card"
+require "agcod/create_gift_card"
+require "agcod/health_check"
+require "agcod/void_gift_card_creation"

data/lib/agcod/cancel_gift_card.rb

@@ -0,0 +1,21 @@
+module Agcod
+  class CancelGiftCard < Agcod::Request
+    include Agcod::OptionValidators
+
+    def initialize(options = {})
+      @action = "CancelGiftCard"
+      @required_options = ["request_id", "response_id"]
+      @options = options
+      @required_options.each do |r|
+        validate_length_of(r, "min" => 1, "max" => 19)
+      end
+
+      super
+
+      @parameters["gcCreationRequestId"] = Agcod::Configuration.partner_id.to_s + options["request_id"].to_s
+      @parameters["gcCreationResponseId"] = options["response_id"]
+
+    end
+  end
+  
+end

data/lib/agcod/configuration.rb

@@ -0,0 +1,76 @@
+module Agcod
+  class Configuration
+    REQUIRED_OPTIONS = ["access_key", 
+      "secret_key",
+      "partner_id",
+      "uri",
+      "discount_percentage"
+    ]    
+    
+    class << self
+      attr_reader :options
+      attr_accessor :logger
+
+      def load(app_root = nil, env = nil)
+        if app_root
+          @app_root = app_root
+        else
+          @app_root = RAILS_ROOT if defined?(RAILS_ROOT)
+        end
+        
+        if @app_root.nil? || 
+          !FileTest.exists?(config_filename = File.join(@app_root, 'config', 'agcod.yml'))
+          
+          raise Error::ConfigurationError, "Configuration for AGCOD not found" 
+        end
+
+        config_file = File.read(config_filename)
+
+        environment = RAILS_ENV if defined?(RAILS_ENV)
+        environment = env if env
+
+        @options = YAML.load(config_file)[environment]
+        validate_options
+        @options
+      end
+
+      def set(opt = {})
+        @options ||= {}
+        @options.merge!(opt)
+
+        validate_options
+        @options
+      end
+     
+      def access_key
+        @options["access_key"]
+      end
+
+      def secret_key
+        @options["secret_key"]
+      end
+
+      def partner_id
+        @options["partner_id"]
+      end
+
+      def uri
+        @options["uri"]
+      end
+
+      def discount_percentage
+        @options["discount_percentage"]
+      end
+
+      private
+      
+      def validate_options
+        REQUIRED_OPTIONS.each do |opt|
+          if options[opt].nil? || options[opt] == ""
+            raise Error::ConfigurationError, "#{opt} was not specified" 
+          end
+        end    
+      end
+    end
+  end
+end

data/lib/agcod/create_gift_card.rb

@@ -0,0 +1,90 @@
+module Agcod
+  class CreateGiftCard < Agcod::Request
+    include Agcod::OptionValidators
+
+    def initialize(options = {})
+      @action = "CreateGiftCard"
+      super
+
+      validate_greater_than("value", 0)
+      validate_length_of("request_id", {"max" => 19, "min" => 1})
+
+      #can't have a nonexistant or 0 value for the gift card
+      @parameters["gcValue.amount"] = options["value"]
+
+      @value = options["value"]
+
+      #must have a unique identifier for the request
+      @parameters["gcCreationRequestId"]  = Agcod::Configuration.partner_id + options["request_id"].to_s
+
+      @parameters["gcValue.currencyCode"] = options["currency_code"] || "USD" 
+
+    end
+
+    def process_response
+      super
+      if self.successful?
+        @claim_code = self.xml_response.root.elements["gcClaimCode"].text
+        @response_id = self.xml_response.root.elements["gcCreationResponseId"].text
+      else
+        attempt_retry unless @sent_retry
+        if @sent_retry
+          void_on_resend
+        end
+      end
+    end
+
+    attr_reader :claim_code, :response_id, :value
+
+    def to_yaml(name)
+      {"response_id" => self.response_id, 
+        "request_id" => self.request_id, 
+        "claim_code" => self.claim_code,
+        "value" => self.value,
+        "timestamp" => self.timestamp
+      }.to_yaml(name)
+    end
+
+    protected
+    def send_request
+      begin
+        super
+      rescue SocketError, 
+        Timeout::Error, 
+        ActiveResource::TimeoutError, 
+        Errno::ECONNREFUSED, 
+        Errno::EHOSTDOWN, 
+        Errno::EHOSTUNREACH
+
+        attempt_to_void
+      end
+    end
+
+    def attempt_retry
+      #check for retry error
+      if self.xml_response.root.elements["Status/errorCode"] &&
+        self.xml_response.root.elements["Status/errorCode"].text == "E100" &&
+        !@sent_retry
+
+        @sent_retry = true
+        submit 
+      end
+    end
+
+    private
+    def void_on_resend
+      if self.xml_response.root.elements["Status/errorCode"] &&
+        self.xml_response.root.elements["Status/errorCode"].text == "E100" &&
+        !@resend_void_sent
+        
+        @resend_void_sent = true
+        attempt_to_void
+      end
+    end
+
+    def attempt_to_void
+      Agcod::VoidGiftCardCreation.new("request_id" => self.request_id).submit
+    end
+
+  end
+end

data/lib/agcod/error/configuration_error.rb

@@ -0,0 +1,7 @@
+module Agcod
+  module Error
+    class ConfigurationError < RuntimeError
+
+    end
+  end
+end

data/lib/agcod/error/invalid_parameter.rb

@@ -0,0 +1,7 @@
+module Agcod
+  module Error
+    class InvalidParameter < RuntimeError
+
+    end
+  end
+end

data/lib/agcod/health_check.rb

@@ -0,0 +1,8 @@
+module Agcod
+  class HealthCheck < Agcod::Request
+    def initialize
+      @action = "HealthCheck"
+      super
+    end
+  end
+end

data/lib/agcod/option_validators.rb

@@ -0,0 +1,33 @@
+module Agcod
+  module OptionValidators
+    def validate_timestamp
+      if @options["timestamp"].nil? || !@options["timestamp"].instance_of?(Time)
+        raise Agcod::Error::InvalidParameter, "Invalid Timestamp for record #{@options["record_id"]}"
+      end
+    end
+
+    private
+    def validate_presence_of(option_name)
+      if @options[option_name].nil? || @options[option_name].to_s.blank?
+        raise Agcod::Error::InvalidParameter, "#{option_name} not specified"
+      end
+    end
+
+    def validate_length_of(option_name, size_options)
+      size_options["min"] ||= 0
+      size_options["max"] ||= 10000
+      if @options[option_name].nil? || 
+          @options[option_name].to_s.size < size_options["min"] || 
+          @options[option_name].to_s.size > size_options["max"]
+
+        raise Agcod::Error::InvalidParameter, "#{option_name} has an invalid length"
+      end
+    end
+
+    def validate_greater_than(option_name, number)
+      if @options[option_name].nil? || @options[option_name].to_f <= number
+        raise Agcod::Error::InvalidParameter, "#{option_name} must be greater than #{number} for record #{@options["record_id"]}"
+      end
+    end
+  end
+end

data/lib/agcod/request.rb

@@ -0,0 +1,153 @@
+module Agcod
+  class Request
+    def initialize(options = {})
+      @request = ""
+      @response = ""
+      @status = ""
+      @parameters = {}
+      @options = options
+    end
+
+    def submit
+      #action must be specified so raise an exception if it has not been populated
+      if self.action.nil?
+        raise "Action not specified"
+      end
+
+      #form the request GET parameter string
+      @request = build_sorted_and_signed_request_string
+
+      send_request
+
+      if @response
+        process_response
+        log if Agcod::Configuration.logger
+      end
+    end
+
+    def successful?
+      self.sent && self.errors.size == 0 && self.status == "SUCCESS"
+    end
+
+    attr_reader :errors, :request_id, :sent, :action, :request, :parameters, :response, :xml_response, :status, :timestamp
+
+    def sign_string(string_to_sign)
+      #remove all the = and & from the serialized string
+      sanitized_string = string_to_sign.gsub(/=|&/, "")
+      # puts sanitized_string
+      sha1 = HMAC::SHA1::digest(Agcod::Configuration.secret_key, sanitized_string)
+
+      #Base64 encoding adds a linefeed to the end of the string so chop the last character!
+      CGI.escape(Base64.encode64(sha1).chomp)
+    end
+
+    def request_id
+      @options["request_id"]
+    end
+
+    def response_id
+      @response_id || @options["response_id"]
+    end
+
+    protected 
+
+    def process_response
+      parse_response
+
+
+      @errors = []
+
+      self.xml_response.root.elements.each("Error") do |e|
+        @errors << e.elements["Message"].text
+      end
+
+      @status = self.xml_response.root.elements["Status/statusCode"].text unless xml_response.root.elements["Status/statusCode"].nil?
+
+      #something happened before it got to ACGWS (most likely a signature problem)
+      @status = "FAILURE" if self.errors.size > 0 && self.status.blank?
+
+      @request_id = xml_response.root.elements["RequestID"].text unless xml_response.root.elements["RequestID"].nil?
+    end
+
+    def parse_response
+      @xml_response ||= REXML::Document.new(self.response)
+    end
+
+    def attempt_retry
+      #check for retry error
+      if self.xml_response.root.elements["Status/errorCode"] &&
+        self.xml_response.root.elements["Status/errorCode"].text == "E100" &&
+        !@sent_retry
+
+        @sent_retry = true
+        submit 
+      end
+    end
+
+    protected
+    def send_request
+      #send the request
+      uri = URI.parse(Agcod::Configuration.uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.read_timeout = 20
+      http.open_timeout = 20
+      http.use_ssl = true
+
+      net_response, @response = http.get(uri.path + "?" + self.request)
+
+      @sent = true
+    end
+
+    def default_parameters
+      @timestamp = Time.now.utc
+      {
+        "Action" => self.action,
+        "AWSAccessKeyId" => Agcod::Configuration.access_key,
+        "SignatureVersion" => "1",
+        "MessageHeader.recipientId" => "AMAZON",
+        "MessageHeader.sourceId" => Agcod::Configuration.partner_id,
+        "MessageHeader.retryCount" => "0",
+        "MessageHeader.contentVersion" => "2008-01-01",
+        "MessageHeader.messageType" => self.action + "Request",
+        "Timestamp" => @timestamp.strftime("%Y-%m-%dT%H:%M:%S") + ".000Z"
+      }
+    end
+
+    def build_sorted_and_signed_request_string
+      params_to_submit = default_parameters.merge(self.parameters)
+
+      unencoded_key_value_strings = []
+      encoded_key_value_strings = []
+      sort_parameters(params_to_submit).each do |p|
+        unencoded_key_value_strings << p[0].to_s + p[1].to_s
+
+        if p[0] =~ /Timestamp/i
+          encoded_value = p[1]
+        else
+          encoded_value = CGI.escape(p[1].to_s)
+        end
+        encoded_key_value_strings << p[0].to_s + "=" + encoded_value
+      end
+
+      signature = sign_string(unencoded_key_value_strings.join(""))
+      encoded_key_value_strings.insert(encoded_key_value_strings.index("SignatureVersion=1") + 1 , "Signature=" + signature)
+      encoded_key_value_strings.join("&")
+    end
+
+
+    def sort_parameters(params)
+      params.sort{|a, b| a[0].downcase <=> b[0].downcase }
+    end
+
+    def log
+      log_string = "[AGCOD] #{self.action} Request"
+      log_string << " \##{self.request_id}" if self.request_id
+      log_string << " received response #{self.response_id}" if self.response_id
+      if self.respond_to?(:claim_code) && self.claim_code
+        log_string << " received claim_code #{self.claim_code}" 
+      end
+      Agcod::Configuration.logger.debug log_string
+    end
+
+  end
+end

data/lib/agcod/tasks.rb

@@ -0,0 +1,3 @@
+Dir[File.join(File.dirname(__FILE__), 'tasks', '*.rake')].each do |f|
+  load f
+end

data/lib/agcod/tasks/certification.rake

@@ -0,0 +1,45 @@
+require "fileutils"
+
+namespace :agcod do
+  namespace :certification do
+    desc "generate a request manifest for certification"
+    task :generate_manifest do
+      puts "generating manifest"
+      i = 1
+      prices = [
+        12,
+        999,
+        100,
+        50.02,
+        999.99,
+        600,
+        70,
+        100000,
+        12,
+        12,
+        1
+      ]
+
+      path = File.join(FileUtils.pwd, "features", "support", "certification_requests")
+      FileUtils.rm_rf(path)
+      FileUtils.mkdir_p(path)
+
+      requests = []
+      prices.each do |p|
+        random_string_of_numbers = ""
+        12.times {random_string_of_numbers << rand(9).to_s}
+
+        request = {"value" => p, 
+          "request_id" => i.to_s + random_string_of_numbers}
+
+        File.open(File.join(path, "#{i}.yml"), 'w') do |manifest|
+          manifest.puts request.to_yaml
+        end
+        i += 1
+      end
+      
+      
+      puts "Manifest available at #{path}"
+    end
+  end
+end

data/lib/agcod/void_gift_card_creation.rb

@@ -0,0 +1,14 @@
+module Agcod
+  class VoidGiftCardCreation < Agcod::Request
+    include Agcod::OptionValidators
+
+    def initialize(options = {})
+      @action = "VoidGiftCardCreation"
+      super
+
+      validate_presence_of("request_id")
+
+      @parameters["gcCreationRequestId"] = Agcod::Configuration.partner_id.to_s + self.request_id.to_s
+    end
+  end  
+end

data/manual_features/cancel_claimed_giftcard.feature

@@ -0,0 +1,13 @@
+Feature: Cancel claimed Gift Card Error Handling
+  As a user of the agcod service
+  I want to handle when I attempt to cancel a claimed gift card
+  So I can get certified
+
+  Background:
+    Given I have access to the AGCOD web service
+    And I am logging transactions
+    
+  Scenario: Claimed Gift Card
+    Given I want to cancel request "1"
+    When I send the request
+    Then I should not receive a successful response

data/manual_features/insufficient_funds.feature

@@ -0,0 +1,13 @@
+Feature: Insufficient Funds
+  As a user of the agcod service
+  I want to handle when I have insufficient funds appropriately
+  So I can get certified
+
+  Background:
+    Given I have access to the AGCOD web service
+    And I am logging transactions
+    
+  Scenario: Insufficient Funds
+    Given I want to send request "6"
+    And I send the request
+    Then I should not receive a successful response

data/manual_features/retry_and_http.feature

@@ -0,0 +1,46 @@
+Feature: Retry responses and HTTP Errors
+  As a user of AGCOD
+  I want to properly handle retry responses and HTTP errors
+  So that I can get certified
+
+  Background:
+    Given I have access to the AGCOD web service
+    And I am logging transactions
+
+  Scenario: #12 RESEND creation request
+    Given I want to send request "9"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #13 RESEND cancel request
+    Given I want to cancel request "2"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #14 HTTP error
+    Given I want to send request "10"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #15 HTTP Void Error
+    Given I want to void request "10"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #16 HTTP Cancel Error
+    Given I want to cancel request "3"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #17 minimum amount
+    Given I want to send request "11"
+    When I send the request
+    Then I should not receive a successful response
+
+  Scenario: #17b $12 gift card
+    Given I want to send request "12"
+    When I send the request
+    Then I should receive a successful resposne
+
+
+

data/tasks/agcod.rake

@@ -0,0 +1 @@
+load File.join(File.dirname(__FILE__), "..", "lib", "agcod", "tasks.rb")

data/test/agcod/configuration_test.rb

@@ -0,0 +1,106 @@
+require "test_helper"
+
+class Agcod::ConfigurationTest < Test::Unit::TestCase
+  context "an agcod configuration" do
+    setup do
+      @valid_app_root = File.join(File.dirname(__FILE__), "..", "app_root")
+      @valid_options = {
+        "access_key" => "45127185235",
+        "secret_key" => "4321542523453454325j",
+        "partner_id" => "SomebodySpecial",
+        "uri"        => "https://agcws-gamma.amazon.com/",
+        "discount_percentage" => 0.04
+      }
+    end
+
+    should "raise an error if the configuration file isn't specified" do
+      assert_raise Agcod::Error::ConfigurationError do 
+        Agcod::Configuration.load
+      end
+    end
+
+    should "raise an error if the configuration file isn't found" do
+      assert_raise Agcod::Error::ConfigurationError do
+        Agcod::Configuration.load("/foo4258fast43")
+      end
+    end
+
+    should "read configuration from a supplied app root" do
+      Agcod::Configuration.load(File.join(File.dirname(__FILE__), "..", "app_root"), "test")
+      Agcod::Configuration::REQUIRED_OPTIONS.each do |opt|
+        assert_not_nil Agcod::Configuration.send(opt)
+      end
+    end
+    
+    should "allow me to set config options at runtime" do
+      Agcod::Configuration.set(@valid_options)
+      assert_equal Agcod::Configuration.access_key, @valid_options["access_key"]
+    end
+
+    should_require_config_options [
+      "access_key", 
+      "secret_key", 
+      "partner_id", 
+      "uri",
+      "discount_percentage"
+    ]
+  end
+
+  context "agcod logging" do
+    setup do
+      configure_with_valid_options
+      @log_path = File.join(File.dirname(__FILE__), "..", "log", "test.log")
+      FileUtils.touch(@log_path)
+      @logger = Logger.new(@log_path)
+      @logger.level = Logger::DEBUG
+
+      Agcod::Configuration.logger = @logger
+
+      FakeWeb.allow_net_connect = false
+      
+      @request = Agcod::CreateGiftCard.new("request_id" => 34234, "value" => 12)
+      @request.stubs(:response_id).returns(4323535)
+      @request.stubs(:send_request)
+      @request.stubs(:process_response)
+      @request.stubs(:claim_code).returns(342145)
+      @request.submit
+    end
+
+    teardown do
+      FileUtils.rm_f(@log_path) 
+    end
+
+    should "allow me to define a logger for logging requests" do
+      @logger = Logger.new(STDOUT)
+      Agcod::Configuration.logger =  @logger
+      assert_equal @logger, Agcod::Configuration.logger
+    end
+
+    should "log request operation names" do
+      assert_match /CreateGiftCard/, File.read(@log_path)
+    end
+
+    should "log request ids when applicable" do
+      assert_match /#{@request.request_id}/, File.read(@log_path)
+    end
+
+    should "log response ids when applicable" do
+      assert_match /#{@request.response_id}/, File.read(@log_path)
+    end
+
+    should "og claim code when applicable" do
+      assert_match /#{@request.claim_code}/, File.read(@log_path)
+    end
+  end
+
+  def configure_with_valid_options
+    @valid_options = {
+      "access_key" => "45127185235",
+      "secret_key" => "4321542523453454325j",
+      "partner_id" => "SomebodySpecial",
+      "uri"        => "https://agcws-gamma.amazon.com/",
+      "discount_percentage" => 0.04
+    }
+    Agcod::Configuration.set(@valid_options)
+  end
+end

data/test/app_root/config/agcod.yml

@@ -0,0 +1,6 @@
+test:
+  access_key: fadsfasdgt2434
+  secret_key: dfasdf
+  partner_id: SomebodyImportant
+  uri: https://agcws-gamma.amazon.com/
+  discount_percentage: 0.04

data/test/macros/configuration.rb

@@ -0,0 +1,24 @@
+class Test::Unit::TestCase
+  def self.should_require_config_options(options)
+    valid_options = {
+      "access_key" => "45127185235",
+      "secret_key" => "4321542523453454325j",
+      "partner_id" => "SomebodySpecial",
+      "uri"        => "https://agcws-gamma.amazon.com/",
+      "discount_percentage" => 0.04
+    }
+    
+    options = [options] unless options.is_a?(Array)
+
+    options.each do |option|
+      should "require #{option} as a configuration option" do
+        assert_raise Agcod::Error::ConfigurationError do
+          Agcod::Configuration.set(valid_options.merge({
+            option => ""                       
+          }))
+        end
+      end 
+    end
+          
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'fakeweb'
+require 'mocha'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'agcod'
+
+begin require "redgreen" rescue Exception; end
+
+FakeWeb.allow_net_connect = false
+
+require "macros/configuration"
+
+class Test::Unit::TestCase
+  def register_response(path, fixture)
+    
+  end
+
+  def xml_fixture_path(fixture)
+    File.join(File.dirname(__FILE__), "fixtures", "#{fixture}.xml")
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: agcod
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Dan Pickett
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-14 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: 
+email: dpickett@enlightsolutions.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- agcod.gemspec
+- cucumber.yml
+- features/error_handling.feature
+- features/step_definitions/agcod_steps.rb
+- features/success_certification.feature
+- features/support/app_root/config/agcod.example.yml
+- features/support/env.rb
+- lib/agcod.rb
+- lib/agcod/cancel_gift_card.rb
+- lib/agcod/configuration.rb
+- lib/agcod/create_gift_card.rb
+- lib/agcod/error/configuration_error.rb
+- lib/agcod/error/invalid_parameter.rb
+- lib/agcod/health_check.rb
+- lib/agcod/option_validators.rb
+- lib/agcod/request.rb
+- lib/agcod/tasks.rb
+- lib/agcod/tasks/certification.rake
+- lib/agcod/void_gift_card_creation.rb
+- manual_features/cancel_claimed_giftcard.feature
+- manual_features/insufficient_funds.feature
+- manual_features/retry_and_http.feature
+- tasks/agcod.rake
+- test/agcod/configuration_test.rb
+- test/app_root/config/agcod.yml
+- test/macros/configuration.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: http://github.com/dpickett/agcod
+licenses: []
+
+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"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A Wrapper for Amazon Gift Cards On Demand
+test_files: 
+- test/agcod/configuration_test.rb
+- test/macros/configuration.rb
+- test/test_helper.rb