chargify2 0.1.0

data/.document

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+gem 'httparty'
+gem 'addressable'
+gem 'hashie'
+gem 'hashery'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "yard", "~> 0.6.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+  gem "rcov", ">= 0"
+  gem "webmock"
+  gem "vcr"
+  gem "capybara"
+end

data/Gemfile.lock

@@ -0,0 +1,76 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.5)
+    capybara (0.4.1.2)
+      celerity (>= 0.7.9)
+      culerity (>= 0.2.4)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      selenium-webdriver (>= 0.0.27)
+      xpath (~> 0.1.3)
+    celerity (0.8.9)
+    childprocess (0.1.8)
+      ffi (~> 1.0.6)
+    crack (0.1.8)
+    culerity (0.2.15)
+    diff-lcs (1.1.2)
+    ffi (1.0.7)
+      rake (>= 0.8.7)
+    git (1.2.5)
+    hashery (1.4.0)
+    hashie (1.0.0)
+    httparty (0.7.4)
+      crack (= 0.1.8)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    json_pure (1.5.1)
+    mime-types (1.16)
+    nokogiri (1.4.4)
+    rack (1.2.2)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    rubyzip (0.9.4)
+    selenium-webdriver (0.1.4)
+      childprocess (>= 0.1.7)
+      ffi (>= 1.0.7)
+      json_pure
+      rubyzip
+    vcr (1.9.0)
+    webmock (1.6.2)
+      addressable (>= 2.2.2)
+      crack (>= 0.1.7)
+    xpath (0.1.3)
+      nokogiri (~> 1.3)
+    yard (0.6.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  addressable
+  bundler (~> 1.0.0)
+  capybara
+  hashery
+  hashie
+  httparty
+  jeweler (~> 1.5.2)
+  rcov
+  rspec (~> 2.3.0)
+  vcr
+  webmock
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Chargify, LLC
+
+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,23 @@
+Chargify V2 API Ruby Wrapper
+============================
+
+    chargify = Chargify2::Client.new(:api_id => "f43ee0a0-4356-012e-0f5f-0025009f114a", :api_password => 'direct777test', :base_uri => "http://app.chargify.local/api/v2")
+    call = chargify.calls.read("4dbc42ecc21d93ec8f9bb581346dd41c5c3c2cf5")
+
+Contributing to Chargify2
+-------------------------
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+Copyright
+---------
+
+Copyright (c) 2011 Chargify. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,39 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "chargify2"
+  gem.homepage = "http://github.com/chargify/chargify2"
+  gem.license = "MIT"
+  gem.summary = %Q{Chargify API V2 Ruby Wrapper}
+  gem.description = %Q{}
+  gem.email = "michael@webadvocate.com"
+  gem.authors = ["Michael Klett"]
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/chargify2/client.rb

@@ -0,0 +1,37 @@
+# chargify = Chargify::Client.new(:api_id => '123', :api_password => 'passwerd')
+#
+# call = chargify.calls.read(100)
+# call.id
+# # => 100
+#
+# calls = chargify.calls.list
+# calls.metadata
+#
+# chargify.direct
+module Chargify2
+  class Client
+    BASE_URI = "https://api.chargify.com/api/v2"
+
+    attr_reader :api_id
+    attr_reader :api_password
+    attr_reader :api_secret
+    attr_reader :base_uri
+    
+    def initialize(args = {})
+      options = args.symbolize_keys
+      
+      @api_id       = options[:api_id]
+      @api_password = options[:api_password]
+      @api_secret   = options[:api_secret]
+      @base_uri     = options[:base_uri] || BASE_URI
+    end
+    
+    def direct
+      Chargify2::Direct.new(self)
+    end
+    
+    def calls
+      Chargify2::CallResource.new(self)
+    end
+  end
+end

data/lib/chargify2/direct.rb

@@ -0,0 +1,137 @@
+module Chargify2
+  class Direct
+    attr_reader :client
+    
+    def initialize(client)
+      @client = client
+      validate_client
+    end
+    
+    def secure_parameters(params = {})
+      SecureParameters.new(params, client)
+    end
+
+    def result(params = {})
+      Result.new(params, client)
+    end
+
+    def self.signature(message, secret)
+      OpenSSL::HMAC.hexdigest(OpenSSL::Digest::Digest.new('sha1'), secret, message)
+    end
+    
+    private
+    
+    def validate_client
+      unless client.is_a?(Client)
+        raise ArgumentError.new("Direct.new requires a Client as an argument")
+      end
+    end
+
+    # There is no need to instantiate a SecureParameters instance directly.  Use Direct#secure_parameters
+    # instead.
+    class SecureParameters
+      attr_reader :api_id
+      attr_reader :timestamp
+      attr_reader :nonce
+      attr_reader :data
+      attr_reader :secret
+      
+      def initialize(hash, client)
+        args = hash.symbolize_keys
+        
+        @api_id     = client.api_id
+        @secret     = client.api_secret
+
+        @timestamp  = args[:timestamp]
+        @nonce      = args[:nonce]
+        @data       = args[:data]
+        
+        validate_args
+      end
+      
+      def to_form_inputs
+        output = []
+        output << %{<input type="hidden" name="secure[api_id]" value="#{h(api_id)}"/>}
+        output << %{<input type="hidden" name="secure[timestamp]" value="#{h(timestamp)}"/>} if timestamp?
+        output << %{<input type="hidden" name="secure[nonce]" value="#{h(nonce)}"/>} if nonce?
+        output << %{<input type="hidden" name="secure[data]" value="#{h(encoded_data)}"/>} if data?
+        output << %{<input type="hidden" name="secure[signature]" value="#{h(signature)}"/>}
+        output.join("\n")
+      end
+
+      %w(timestamp nonce data).each do |method|
+        define_method("#{method}?") do
+          value = self.send(method)
+          value && value.to_s.strip.length > 0
+        end
+      end
+      
+      def encoded_data
+        hash = data? ? data : {}
+        uri = Addressable::URI.new
+        uri.query_values = hash
+        uri.query
+      end
+      
+      def signature
+        message = "#{api_id}#{timestamp}#{nonce}#{encoded_data}"
+        Direct.signature(message, secret)
+      end
+      
+      private
+      
+      def h(s)
+        ERB::Util.html_escape(s)
+      end
+      
+      def validate_args
+        if data && !data.is_a?(Hash)
+          raise ArgumentError.new("The 'data' must be provided as a Hash (you passed a #{data.class})")
+        end
+        
+        unless api_id && secret && api_id.to_s.length > 0 && secret.to_s.length > 0
+          # raise ArgumentError
+        end
+      end
+    end
+    
+    # There is no need to instantiate a Result instance directly.  Use Direct#results instead.
+    class Result
+      attr_reader :api_id
+      attr_reader :status_code
+      attr_reader :result_code
+      attr_reader :call_id
+      attr_reader :secret
+      attr_reader :signature
+      
+      def initialize(params, client)
+        args = params.symbolize_keys
+        
+        @api_id       = client.api_id
+        @secret       = client.api_secret
+
+        @status_code  = args[:status_code]
+        @result_code  = args[:result_code]
+        @call_id      = args[:call_id]
+        @signature    = args[:signature]
+      end
+      
+      def verified?
+        message = "#{api_id}#{status_code}#{result_code}#{call_id}"
+        Direct.signature(message, secret) == signature
+      end
+      
+      def success?
+        status_code.to_s == '200'
+      end
+      
+      private
+      
+      def validate_args
+        if data && !data.is_a?(Hash)
+          raise ArgumentError.new("The 'data' must be provided as a Hash (you passed a #{data.class})")
+        end
+      end
+    end
+  end
+end

data/lib/chargify2/representations/call.rb

@@ -0,0 +1,30 @@
+module Chargify2
+  class Call < Hashie::Dash
+    property :id
+    property :api_id
+    property :timestamp
+    property :nonce
+    property :success
+    property :request
+    property :response
+    
+    def request
+      Request.new(self[:request] || {})
+    end
+    
+    def response
+      Response.new(self[:response] || {})
+    end
+    
+    def successful?
+      response.result.status_code.to_s == '200'
+    end
+    
+    def errors
+      (response.result.errors || []).map {|e| OpenCascade.new(e.symbolize_keys)}
+    end
+    
+    class Request < OpenCascade; end
+    class Response < OpenCascade; end
+  end
+end

data/lib/chargify2/resource.rb

@@ -0,0 +1,58 @@
+module Chargify2
+  # Resource orchestrates the connection from the Client to the Chargify API Resources, available
+  # at the Resource URIs.
+  #
+  # Resource implements CRUD operations on the Chargify API Resources: {Resource.create}, {Resource.read},
+  # {Resource.update}, {Resource.delete}, and {Resource.list}.
+  class Resource
+    include HTTParty
+
+    base_uri Chargify2::Client::BASE_URI
+    headers 'Content-Type' => 'application/json', 'Accept' => 'application/json'
+    format :json
+    
+    def self.path(resource_path)
+      @path = resource_path
+    end
+
+    def self.uri
+      if @path.nil? || @path.to_s.size == 0
+        raise ResourceError, "No path configured.  Please use a defined Resource."
+      end
+      "#{base_uri}/#{@path}"
+    end
+    
+    def uri
+      self.class.uri
+    end
+    
+    # Define the representation class for this resource
+    def self.representation(klass = nil)
+      unless klass.nil?
+        @@representation = klass
+      end
+      @@representation ||= nil
+    end
+    
+    def initialize(client)
+      @client = client
+      @username = client.api_id
+      @password = client.api_password
+      
+      self.class.base_uri(client.base_uri)
+      self.class.basic_auth(@username, @password)
+    end
+    
+    def self.read(id, query = {})
+      response = get("#{uri}/#{id}", :query => query.empty? ? nil : query)
+      response_hash = response.parsed_response[representation.to_s.downcase.split('::').last] || {}
+      representation.new(response_hash.symbolize_keys)
+    end
+    
+    def read(id, query = {})
+      self.class.read(id, query)
+    end
+  end
+  
+  class ResourceError < StandardError; end
+end

data/lib/chargify2/resources/call_resource.rb

@@ -0,0 +1,6 @@
+module Chargify2
+  class CallResource < Resource
+    path 'calls'
+    representation Call
+  end
+end

data/lib/chargify2/utils.rb

@@ -0,0 +1,16 @@
+module Chargify2
+  module Utils
+    module HashExtensions
+      # Symbolizes keys for flat or nested hashes (operates recursively on nested hashes)
+      def symbolize_keys
+        Hash[
+          self.map { |key, value|
+            k = key.to_sym
+            v = value.is_a?(Hash) ? value.symbolize_keys : value
+            [k,v]
+          }
+        ]
+      end
+    end
+  end
+end

data/lib/chargify2.rb

@@ -0,0 +1,8 @@
+require 'httparty'
+require 'addressable/uri'
+require 'hashie'
+require 'hashery/opencascade'
+
+Dir["#{File.dirname(__FILE__)}/chargify2/**/*.rb"].each {|f| require f}
+
+Hash.send(:include, Chargify2::Utils::HashExtensions)

data/spec/call_resource_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+module Chargify2
+  describe CallResource do
+    it "should have a URI of 'https://api.chargify.com/api/v2/calls'" do
+      CallResource.uri.should == 'https://api.chargify.com/api/v2/calls'
+    end
+
+    it "represents with the Call class" do
+      CallResource.representation.should == Call
+    end
+    
+    describe "#read" do
+      it "performs a GET request to 'https://api.chargify.com/api/v2/calls/123' (without authentication) when called with '123'" do
+        WebMock.stub_request(:get, 'https://api.chargify.com/api/v2/calls/123')
+        CallResource.read('123')
+        a_request(:get, 'https://api.chargify.com/api/v2/calls/123').should have_been_made.once
+      end
+      
+      it "returns a Call representation" do
+        WebMock.stub_request(:get, 'https://api.chargify.com/api/v2/calls/123')
+        CallResource.read('123').should be_a(Call)
+      end
+    end
+    
+    context "instance configured with a client and a non-standard base URI" do
+      it "has a URI of 'http://www.example.com/calls'" do
+        base_uri = 'http://www.example.com'
+        client = Client.new(valid_client_credentials.merge(:base_uri => base_uri))
+        CallResource.new(client).uri.should == 'http://www.example.com/calls'
+      end
+    end
+    
+    context "instance configured with a valid client" do
+      before(:each) do
+        @client = Client.new(valid_client_credentials)
+        @call_resource = CallResource.new(@client)
+      end
+      
+      it "performs a GET request to 'https://<api_login>:<api_password>@api.chargify.com/api/v2/calls/123' (with authentication) when called with '123'" do
+        WebMock.stub_request(:get, "https://#{@client.api_id}:#{@client.api_password}@api.chargify.com/api/v2/calls/123")
+        CallResource.read('123')
+        a_request(:get, "https://#{@client.api_id}:#{@client.api_password}@api.chargify.com/api/v2/calls/123").should have_been_made.once
+      end
+      
+      it "returns a Call representation" do
+        WebMock.stub_request(:get, "https://#{@client.api_id}:#{@client.api_password}@api.chargify.com/api/v2/calls/123")
+        CallResource.read('123').should be_a(Call)
+      end
+    end
+  end
+end

data/spec/client_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+module Chargify2
+  describe Client do
+    let(:client) { Client.new(valid_client_credentials) }
+    
+    it "holds an api_id when passed to .new in the 'api_id' key" do
+      client = Client.new('api_id' => "myid")
+      client.api_id.should == 'myid'
+    end
+
+    it "holds an api_id when passed to .new in the :api_id key" do
+      client = Client.new(:api_id => "myid")
+      client.api_id.should == 'myid'
+    end
+
+    it "holds an api_password when passed to .new in the 'api_password' key" do
+      client = Client.new('api_password' => "mypass")
+      client.api_password.should == 'mypass'
+    end
+
+    it "holds an api_password when passed to .new in the :api_password key" do
+      client = Client.new(:api_password => "mypass")
+      client.api_password.should == 'mypass'
+    end
+
+    it "holds an api_secret when passed to .new in the 'api_secret' key" do
+      client = Client.new('api_secret' => "mysecret")
+      client.api_secret.should == 'mysecret'
+    end
+
+    it "holds an api_secret when passed to .new in the :api_secret key" do
+      client = Client.new(:api_secret => "mysecret")
+      client.api_secret.should == 'mysecret'
+    end
+  
+    it "has a default base_uri of 'https://api.chargify.com/api/v2'" do
+      client = Client.new(valid_client_credentials)
+      client.base_uri.should == 'https://api.chargify.com/api/v2'
+    end
+    
+    it "allows the setting of a different base_uri via initialization params" do
+      client = Client.new(valid_client_credentials.merge(:base_uri => "http://example.com"))
+      client.base_uri.should == 'http://example.com'
+    end
+    
+    it "gives access to a pre-configured Direct instance through #direct" do
+      direct = client.direct
+      
+      direct.should be_a(Direct)
+      direct.client.should == client
+    end
+    
+    it "accesses a CallResource through #calls" do
+      calls = client.calls.should be_a(CallResource)
+    end
+  end
+end

data/spec/direct_secure_parameters_spec.rb

@@ -0,0 +1,195 @@
+require 'spec_helper'
+
+module Chargify2
+  describe Direct::SecureParameters do
+    let(:client) { Client.new(valid_client_credentials) }
+    
+    it "raises an argument error if data is provided but it is not in hash format" do
+      lambda {
+        Direct::SecureParameters.new({'data' => 'string'}, client)
+      }.should raise_error(ArgumentError)
+    end
+    
+    it "raises an argument error if it could not get an api_id and secret from the passed client" do
+      lambda {
+        Direct::SecureParameters.new({'data' => 'string'}, OpenCascade.new)
+      }.should raise_error(ArgumentError)
+    end
+    
+    describe "#timestamp?" do
+      it "returns true when a timestamp is provided via a string hash key" do
+        sp = Direct::SecureParameters.new({'timestamp' => '1234'}, client)
+        sp.timestamp?.should be_true
+      end
+      
+      it "returns true when a timestamp is provided via a symbol hash key" do
+        sp = Direct::SecureParameters.new({:timestamp => '1234'}, client)
+        sp.timestamp?.should be_true
+      end
+      
+      it "returns false when a timestamp key/value is not provided" do
+        sp = Direct::SecureParameters.new({}, client)
+        sp.timestamp?.should be_false
+      end
+
+      it "returns false when a timestamp key is provided but the value is nil" do
+        sp = Direct::SecureParameters.new({'timestamp' => nil}, client)
+        sp.timestamp?.should be_false
+      end
+
+      it "returns false when a timestamp key is provided but the value is blank" do
+        sp = Direct::SecureParameters.new({'timestamp' => ''}, client)
+        sp.timestamp?.should be_false
+      end
+    end
+
+    describe "#nonce?" do
+      it "returns true when a nonce is provided via a string hash key" do
+        sp = Direct::SecureParameters.new({'nonce' => '1234'}, client)
+        sp.nonce?.should be_true
+      end
+      
+      it "returns true when a nonce is provided via a symbol hash key" do
+        sp = Direct::SecureParameters.new({:nonce => '1234'}, client)
+        sp.nonce?.should be_true
+      end
+      
+      it "returns false when a nonce key/value is not provided" do
+        sp = Direct::SecureParameters.new({}, client)
+        sp.nonce?.should be_false
+      end
+
+      it "returns false when a nonce key is provided but the value is nil" do
+        sp = Direct::SecureParameters.new({'nonce' => nil}, client)
+        sp.nonce?.should be_false
+      end
+
+      it "returns false when a nonce key is provided but the value is blank" do
+        sp = Direct::SecureParameters.new({'nonce' => ''}, client)
+        sp.nonce?.should be_false
+      end
+    end
+
+    describe "#data?" do
+      it "returns true when data is provided via a string hash key" do
+        sp = Direct::SecureParameters.new({'data' => {'foo' => 'bar'}}, client)
+        sp.data?.should be_true
+      end
+      
+      it "returns true when data is provided via a symbol hash key" do
+        sp = Direct::SecureParameters.new({:data => {'foo' => 'bar'}}, client)
+        sp.data?.should be_true
+      end
+      
+      it "returns false when a data key/value is not provided" do
+        sp = Direct::SecureParameters.new({}, client)
+        sp.data?.should be_false
+      end
+
+      it "returns false when a data key is provided but the value is nil" do
+        sp = Direct::SecureParameters.new({'data' => nil}, client)
+        sp.data?.should be_false
+      end
+
+      it "returns false when a data key is provided but the value is an empty hash" do
+        sp = Direct::SecureParameters.new({'data' => {}}, client)
+        sp.data?.should be_false
+      end
+    end
+    
+    describe "#encoded_data" do
+      it "turns the data hash in to query string format" do
+        sp = Direct::SecureParameters.new({'data' => {'one' => 'two', 'three' => 'four'}}, client)
+        sp.encoded_data.should == "one=two&three=four"
+      end
+      
+      it "turns a nested data hash in to nested query string format" do
+        sp = Direct::SecureParameters.new({'data' => {'one' => {'two' => {'three' => 'four'}}, 'foo' => 'bar'}}, client)
+        sp.encoded_data.should == "foo=bar&one[two][three]=four"
+      end
+      
+      it "performs percent encoding on unsafe characters" do
+        sp = Direct::SecureParameters.new({'data' => {'redirect_uri' => 'http://www.example.com', 'sentence' => 'Michael was here!'}}, client)
+        sp.encoded_data.should == "redirect_uri=http%3A%2F%2Fwww.example.com&sentence=Michael%20was%20here%21"
+      end
+    end
+    
+    describe "#to_form_inputs" do
+      context "with no timestamp, nonce, nor data" do
+        it "outputs 2 hidden form inputs - one for the api_id and one for the signature" do
+          sp = Direct::SecureParameters.new({}, client)
+          form = Capybara::Node::Simple.new(sp.to_form_inputs)
+
+          form.should have_selector("input", :count => 2)
+          form.should have_selector("input[type='hidden'][name='secure[api_id]'][value='#{client.api_id}']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[signature]'][value='#{sp.signature}']", :count => 1)
+        end
+      end
+      
+      context "with a timestamp" do
+        it "outputs 3 hidden form inputs - one each for the api_id, timestamp, and signature" do
+          sp = Direct::SecureParameters.new({'timestamp' => '1234'}, client)
+          form = Capybara::Node::Simple.new(sp.to_form_inputs)
+
+          form.should have_selector("input", :count => 3)
+          form.should have_selector("input[type='hidden'][name='secure[api_id]'][value='#{client.api_id}']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[timestamp]'][value='1234']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[signature]'][value='#{sp.signature}']", :count => 1)
+        end
+      end
+
+      context "with a nonce" do
+        it "outputs 3 hidden form inputs - one each for the api_id, nonce, and signature" do
+          sp = Direct::SecureParameters.new({'nonce' => '1234'}, client)
+          form = Capybara::Node::Simple.new(sp.to_form_inputs)
+
+          form.should have_selector("input", :count => 3)
+          form.should have_selector("input[type='hidden'][name='secure[api_id]'][value='#{client.api_id}']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[nonce]'][value='1234']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[signature]'][value='#{sp.signature}']", :count => 1)
+        end
+      end
+
+      context "with data" do
+        it "outputs 3 hidden form inputs - one each for the api_id, nonce, and signature" do
+          sp = Direct::SecureParameters.new({'data' => {'foo' => 'bar'}}, client)
+          form = Capybara::Node::Simple.new(sp.to_form_inputs)
+
+          form.should have_selector("input", :count => 3)
+          form.should have_selector("input[type='hidden'][name='secure[api_id]'][value='#{client.api_id}']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[data]'][value='foo=bar']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[signature]'][value='#{sp.signature}']", :count => 1)
+        end
+      end
+
+      context "with timestamp, nonce, and data" do
+        it "outputs 3 hidden form inputs - one each for the api_id, nonce, and signature" do
+          sp = Direct::SecureParameters.new({'timestamp' => '1234', 'nonce' => '5678', 'data' => {'foo' => 'bar'}}, client)
+          form = Capybara::Node::Simple.new(sp.to_form_inputs)
+
+          form.should have_selector("input", :count => 5)
+          form.should have_selector("input[type='hidden'][name='secure[api_id]'][value='#{client.api_id}']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[timestamp]'][value='1234']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[nonce]'][value='5678']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[data]'][value='foo=bar']", :count => 1)
+          form.should have_selector("input[type='hidden'][name='secure[signature]'][value='#{sp.signature}']", :count => 1)
+        end
+      end
+    end
+
+    describe "#signature" do
+      it "correctly calculates the signature by taking the HMAC-SHA1 hash of the concatenation of the api_id, timestamp, nonce, and encoded_data" do
+        timestamp = '1234'
+        nonce = '5678'
+        data = {'one' => 'two', 'three' => {'four' => "http://www.example.com"}}
+        sp = Direct::SecureParameters.new({'timestamp' => timestamp, 'nonce' => nonce, 'data' => data}, client)
+        
+        # Used the generator here: http://hash.online-convert.com/sha1-generator
+        # ... with message: "1c016050-498a-012e-91b1-005056a216ab12345678one=two&three[four]=http%3A%2F%2Fwww.example.com"
+        # ... and secret: "p5lxQ804MYtwZecFWNOT"
+        # ... to get: "c57c36e619f575958221bcd4ce156c61347a3555"
+        sp.signature.should == "c57c36e619f575958221bcd4ce156c61347a3555"
+      end
+    end
+  end
+end

data/spec/direct_spec.rb

@@ -0,0 +1,132 @@
+require 'spec_helper'
+
+module Chargify2
+  describe Direct do
+    let(:client) { Client.new(valid_client_credentials) }
+
+    it "creates a creates a new instance when passed a Client" do
+      Direct.new(client).should be_a(Direct)
+    end
+    
+    it "raises an argument error when creating a new instance without a Client" do
+      lambda { Direct.new('foo') }.should raise_error(ArgumentError)
+    end
+    
+    describe "#secure_parameters" do
+      let(:direct) { Direct.new(client) }
+
+      context "with no arguments" do
+        it "returns a SecureParameters instance with only the defaults set" do
+          sp = direct.secure_parameters
+
+          sp.should be_a(Direct::SecureParameters)
+
+          sp.api_id.should_not     be_blank
+          sp.timestamp.should      be_blank
+          sp.nonce.should          be_blank
+          sp.data.should           be_blank
+          sp.signature.should_not  be_blank
+        end
+      end
+      
+      it "sets the api_id and secret values on the SecureParameters instance from the client" do
+        sp = direct.secure_parameters
+        
+        sp.api_id.should == client.api_id
+        sp.secret.should == client.api_secret
+      end
+      
+      it "allows the setting of secure parameters via the arguments hash" do
+        timestamp = "1234"
+        nonce = "7890"
+        data = {'redirect_uri' => 'http://www.example.com'}
+        
+        sp = direct.secure_parameters('timestamp' => timestamp, 'nonce' => nonce, 'data' => data)
+        
+        sp.timestamp.should == timestamp
+        sp.nonce.should     == nonce
+        sp.data.should      == data.symbolize_keys
+      end
+    end
+
+    describe ".signature" do
+      it "generates an HMAC-SHA1 hash from the given +message+ and +secret+" do
+        message = "this is the message to hash"
+        secret = "foobarjones"
+      
+        # Used the HMAC-SHA1 generator here: http://hash.online-convert.com/sha1-generator
+        Direct.signature(message, secret).should == "459cceb1ad074a9082daba5c0788f12fdd6cdbd6"
+      end
+    end
+
+    describe "#result" do
+      let(:direct) { Direct.new(client) }
+      
+      it "generates a new Result instance given a hash of result params" do
+        direct.result({}).should be_a(Direct::Result)
+      end
+    end
+    
+    describe Direct::Result do
+      describe "#verified?" do
+        it "returns true when the calculated signature of the result params matches the received signature" do
+          api_id = '1c016050-498a-012e-91b1-005056a216ab'
+          status_code = '200'
+          result_code = '2000'
+          call_id = '1234'
+          
+          # Used the generator here: http://hash.online-convert.com/sha1-generator
+          # ... with message: "1c016050-498a-012e-91b1-005056a216ab20020001234"
+          # ... and secret: "p5lxQ804MYtwZecFWNOT"
+          # ... to get: "9d1b9139d6c49720faa0b2b6207c95060e6695d4"
+          signature = "9d1b9139d6c49720faa0b2b6207c95060e6695d4"
+          
+          r = Direct::Result.new({
+            'api_id' => api_id,
+            'status_code' => status_code,
+            'result_code' => result_code,
+            'call_id' => call_id,
+            'signature' => signature}, client)
+          
+          r.verified?.should be_true
+        end
+        
+        it "returns false when the calculated signature of the result params is different from the received signature" do
+          r = Direct::Result.new({
+            'api_id' => client.api_id,
+            'status_code' => '2',
+            'result_code' => '3',
+            'call_id' => '4',
+            'signature' => '5'}, client)
+          
+          r.verified?.should be_false
+        end
+        
+        it "returns false when the calculated signature is correct but the api_id does not match the client's'" do
+          api_id = '1c016050-498a-012e-91b1-005056a216ab'
+          status_code = '200'
+          result_code = '2000'
+          call_id = '1234'
+          
+          # Used the generator here: http://hash.online-convert.com/sha1-generator
+          # ... with message: "1c016050-498a-012e-91b1-005056a216ab20020001234"
+          # ... and secret: "p5lxQ804MYtwZecFWNOT"
+          # ... to get: "9d1b9139d6c49720faa0b2b6207c95060e6695d4"
+          signature = "9d1b9139d6c49720faa0b2b6207c95060e6695d4"
+
+          client_credentials = valid_client_credentials
+          client_credentials[:api_id] = '1234'
+          different_client = Client.new(client_credentials)
+          r = Direct::Result.new({
+            'api_id' => api_id,
+            'status_code' => status_code,
+            'result_code' => result_code,
+            'call_id' => call_id,
+            'signature' => signature}, different_client)
+          
+          r.verified?.should be_false
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'chargify2'
+require 'webmock/rspec'
+require 'capybara/rspec'
+require 'vcr'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.include SpecHelperMethods
+  config.extend VCR::RSpec::Macros
+end
+
+VCR.config do |c|
+  c.cassette_library_dir     = 'spec/cassettes'
+  c.stub_with                :webmock
+  c.default_cassette_options = { :record => :new_episodes }
+end

data/spec/support/spec_helper_methods.rb

@@ -0,0 +1,9 @@
+module SpecHelperMethods
+  def valid_client_credentials
+    {
+      :api_id => '1c016050-498a-012e-91b1-005056a216ab',
+      :api_password => 'myapipassword',
+      :api_secret => 'p5lxQ804MYtwZecFWNOT'
+    }
+  end
+end

metadata

@@ -0,0 +1,268 @@
+--- !ruby/object:Gem::Specification 
+name: chargify2
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Michael Klett
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-18 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: httparty
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: addressable
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: hashie
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: hashery
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id004
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rspec
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  requirement: *id005
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: yard
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  requirement: *id006
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: bundler
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id007
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: jeweler
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
+  requirement: *id008
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: rcov
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id009
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: webmock
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id010
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: vcr
+  version_requirements: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id011
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :development
+  name: capybara
+  version_requirements: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id012
+description: ""
+email: michael@webadvocate.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.md
+files: 
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- lib/chargify2.rb
+- lib/chargify2/client.rb
+- lib/chargify2/direct.rb
+- lib/chargify2/representations/call.rb
+- lib/chargify2/resource.rb
+- lib/chargify2/resources/call_resource.rb
+- lib/chargify2/utils.rb
+- spec/call_resource_spec.rb
+- spec/client_spec.rb
+- spec/direct_secure_parameters_spec.rb
+- spec/direct_spec.rb
+- spec/spec_helper.rb
+- spec/support/spec_helper_methods.rb
+has_rdoc: true
+homepage: http://github.com/chargify/chargify2
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Chargify API V2 Ruby Wrapper
+test_files: 
+- spec/call_resource_spec.rb
+- spec/client_spec.rb
+- spec/direct_secure_parameters_spec.rb
+- spec/direct_spec.rb
+- spec/spec_helper.rb
+- spec/support/spec_helper_methods.rb