vitalish-chargify_api_ares 0.3.9

data/samples/customers.rb

@@ -0,0 +1,51 @@
+$: << File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'chargify_api_ares'
+
+# You could load your credentials from a file...
+chargify_config = YAML::load_file(File.join(File.dirname(__FILE__), '..', 'config', 'chargify.yml'))
+
+Chargify.configure do |c|
+  c.subdomain = chargify_config['subdomain']
+  c.api_key   = chargify_config['api_key']
+end
+
+
+# Retrieve a list of all your customers
+Chargify::Customer.find(:all)
+# => [#<Chargify::Customer:0x102d0cef8 @prefix_options={}, @attributes={"reference"=>"moklett", "updated_at"=>Mon Nov 16 23:19:25 UTC 2009, "id"=>325, "first_name"=>"Michael", "organization"=>"Chargify", "last_name"=>"Klett", "email"=>"moklett@example.com", "created_at"=>Mon Nov 16 23:19:25 UTC 2009}>]
+
+
+customer = Chargify::Customer.find(325)
+
+customer.first_name
+# => Michael
+
+customer.last_name
+# => Klett
+
+# Update a customer - success!
+customer.first_name = "Miguel"
+customer.save
+# => true
+
+customer.first_name
+# => Miguel
+
+# Update a customer - fail!
+customer.first_name = ""
+customer.save
+# => false
+
+customer.errors.full_messages.inspect
+# => ["First name: cannot be blank."]
+
+
+# Create a new customer - success!
+Chargify::Customer.create(
+  :first_name   => "Charlie",
+  :last_name    => "Bull",
+  :email        => "charlie@example.com",
+  :organization => "Chargify"
+)
+# => #<Chargify::Customer:0x102c27970 @prefix_options={}, @attributes={"reference"=>nil, "updated_at"=>Mon Nov 16 23:43:33 UTC 2009, "id"=>327, "organization"=>"Chargify", "first_name"=>"Charlie", "last_name"=>"Bull", "created_at"=>Mon Nov 16 23:43:33 UTC 2009, "email"=>"charlie@example.com"}>

data/samples/metered_components.rb

@@ -0,0 +1,35 @@
+$: << File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'chargify_api_ares'
+
+# You could load your credentials from a file...
+chargify_config = YAML::load_file(File.join(File.dirname(__FILE__), '..', 'config', 'chargify.yml'))
+
+Chargify.configure do |c|
+  c.subdomain = chargify_config['subdomain']
+  c.api_key   = chargify_config['api_key']
+  if chargify_config['site']
+    c.site = chargify_config['site']
+  end
+end
+
+#
+# This assumes you have a product family with a metered component setup
+#
+product_family = Chargify::ProductFamily.find(:first)
+component =  Chargify::Component.find(:first, :params => {:product_family_id => product_family.id})
+subscription = Chargify::Subscription.find(:first)
+
+
+u = Chargify::Usage.new
+u.subscription_id = subscription.id
+u.component_id = component.id
+u.quantity = 5
+d = DateTime.now.to_s
+u.memo = d
+puts d
+u.save
+
+
+x = Chargify::Usage.find(:last, :params => {:subscription_id => subscription.id, :component_id => component.id})
+puts x.memo == d

data/samples/products.rb

@@ -0,0 +1,24 @@
+$: << File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'chargify_api_ares'
+
+# You could load your credentials from a file...
+chargify_config = YAML::load_file(File.join(File.dirname(__FILE__), '..', 'config', 'chargify.yml'))
+
+Chargify.configure do |c|
+  c.subdomain = chargify_config['subdomain']
+  c.api_key   = chargify_config['api_key']
+end
+
+
+# Retrieve a list of all your products
+products = Chargify::Product.find(:all)
+# => [#<Chargify::Product:0x102cdcac8 @prefix_options={}, @attributes={"name"=>"Chargify API Ares Test", "price_in_cents"=>0, "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x102cdbad8 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>78, "accounting_code"=>nil}>, "id"=>152, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>]
+
+# Find a single product by id
+product = Chargify::Product.find(products.first.id)
+# => #<Chargify::Product:0x102ce7540 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x102ce6ca8 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>78, "accounting_code"=>nil}>, "id"=>152, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>
+
+# Find a single product by its handle
+product = Chargify::Product.find_by_handle(products.first.handle)
+# => #<Chargify::Product:0x102c7a828 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x102c798b0 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>78, "accounting_code"=>nil}>, "id"=>152, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>

data/samples/subscriptions.rb

@@ -0,0 +1,53 @@
+$: << File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'chargify_api_ares'
+
+# You could load your credentials from a file...
+chargify_config = YAML::load_file(File.join(File.dirname(__FILE__), '..', 'config', 'chargify.yml'))
+
+Chargify.configure do |c|
+  c.subdomain = chargify_config['subdomain']
+  c.api_key   = chargify_config['api_key']
+end
+
+
+# Retrieve a list of all your customers
+subscription = Chargify::Subscription.find(:all)
+# => [#<Chargify::Subscription:0x1020fff70 @prefix_options={}, @attributes={"cancellation_message"=>nil, "activated_at"=>Tue Nov 17 15:51:42 UTC 2009, "expires_at"=>nil, "updated_at"=>Tue Nov 17 15:51:41 UTC 2009, "credit_card"=>#<Chargify::Subscription::CreditCard:0x1020f24d8 @prefix_options={}, @attributes={"card_type"=>"bogus", "expiration_year"=>2015, "masked_card_number"=>"XXXX-XXXX-XXXX-2", "first_name"=>"Michael", "expiration_month"=>1, "last_name"=>"Klett"}>, "product"=>#<Chargify::Product:0x1020f5a70 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x1020f48f0 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>79, "accounting_code"=>nil}>, "id"=>153, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>, "trial_ended_at"=>nil, "id"=>328, "current_period_ends_at"=>Thu Dec 17 15:51:41 UTC 2009, "trial_started_at"=>nil, "customer"=>#<Chargify::Customer:0x1020f6d80 @prefix_options={}, @attributes={"reference"=>"moklett", "updated_at"=>Tue Nov 17 15:51:02 UTC 2009, "id"=>331, "first_name"=>"Michael", "organization"=>"Chargify", "last_name"=>"Klett", "email"=>"moklett@example.com", "created_at"=>Tue Nov 17 15:51:02 UTC 2009}>, "balance_in_cents"=>0, "current_period_started_at"=>Tue Nov 17 15:51:41 UTC 2009, "state"=>"canceled", "created_at"=>Tue Nov 17 15:51:41 UTC 2009}>]]
+
+
+# Create a subscription from a customer reference
+subscription = Chargify::Subscription.create(
+  :customer_reference => 'moklett',
+  :product_handle => 'chargify-api-ares-test',
+  :credit_card_attributes => {
+    :first_name => "Michael",
+    :last_name => "Klett",
+    :expiration_month => 1,
+    :expiration_year => 2020,
+    :full_number => "1"
+  }
+)
+# => #<Chargify::Subscription:0x1020ed4b0 @prefix_options={}, @attributes={"cancellation_message"=>nil, "activated_at"=>Tue Nov 17 16:00:17 UTC 2009, "expires_at"=>nil, "updated_at"=>Tue Nov 17 16:00:17 UTC 2009, "credit_card"=>#<Chargify::Subscription::CreditCard:0x102046b10 @prefix_options={}, @attributes={"card_type"=>"bogus", "expiration_year"=>2020, "masked_card_number"=>"XXXX-XXXX-XXXX-1", "first_name"=>"Michael", "expiration_month"=>1, "last_name"=>"Klett"}>, "product"=>#<Chargify::Product:0x10204a2d8 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x1020490b8 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>79, "accounting_code"=>nil}>, "id"=>153, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>, "credit_card_attributes"=>#<Chargify::Subscription::CreditCardAttributes:0x1020ecab0 @prefix_options={}, @attributes={"expiration_year"=>2020, "full_number"=>"1", "first_name"=>"Michael", "expiration_month"=>1, "last_name"=>"Klett"}>, "trial_ended_at"=>nil, "id"=>331, "current_period_ends_at"=>Thu Dec 17 16:00:17 UTC 2009, "product_handle"=>"chargify-api-ares-test", "trial_started_at"=>nil, "customer"=>#<Chargify::Customer:0x10204b688 @prefix_options={}, @attributes={"reference"=>"moklett", "updated_at"=>Tue Nov 17 15:51:02 UTC 2009, "id"=>331, "first_name"=>"Michael", "organization"=>"Chargify", "last_name"=>"Klett", "email"=>"moklett@example.com", "created_at"=>Tue Nov 17 15:51:02 UTC 2009}>, "balance_in_cents"=>0, "current_period_started_at"=>Tue Nov 17 16:00:17 UTC 2009, "state"=>"active", "created_at"=>Tue Nov 17 16:00:17 UTC 2009, "customer_reference"=>"moklett"}>
+
+
+# Lookup up existing Subscription using the Customer's reference
+Subscription.find_by_customer_reference('moklett')
+# => #<Chargify::Subscription:0x1020ed4b0 @prefix_options={}, @attributes={"cancellation_message"=>nil, "activated_at"=>Tue Nov 17 16:00:17 UTC 2009, "expires_at"=>nil, "updated_at"=>Tue Nov 17 16:00:17 UTC 2009, "credit_card"=>#<Chargify::Subscription::CreditCard:0x102046b10 @prefix_options={}, @attributes={"card_type"=>"bogus", "expiration_year"=>2020, "masked_card_number"=>"XXXX-XXXX-XXXX-1", "first_name"=>"Michael", "expiration_month"=>1, "last_name"=>"Klett"}>, "product"=>#<Chargify::Product:0x10204a2d8 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x1020490b8 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>79, "accounting_code"=>nil}>, "id"=>153, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>, "trial_ended_at"=>nil, "id"=>331, "current_period_ends_at"=>Thu Dec 17 16:00:17 UTC 2009, "product_handle"=>"chargify-api-ares-test", "trial_started_at"=>nil, "customer"=>#<Chargify::Customer:0x10204b688 @prefix_options={}, @attributes={"reference"=>"moklett", "updated_at"=>Tue Nov 17 15:51:02 UTC 2009, "id"=>331, "first_name"=>"Michael", "organization"=>"Chargify", "last_name"=>"Klett", "email"=>"moklett@example.com", "created_at"=>Tue Nov 17 15:51:02 UTC 2009}>, "balance_in_cents"=>0, "current_period_started_at"=>Tue Nov 17 16:00:17 UTC 2009, "state"=>"active", "created_at"=>Tue Nov 17 16:00:17 UTC 2009, "customer_reference"=>"moklett"}>
+
+
+# Update credit card information
+subscription.credit_card_attributes = {:full_number => "2", :expiration_year => "2015"}
+subscription.save
+# => #<Chargify::Subscription:0x1020ed4b0 @prefix_options={}, @attributes={"cancellation_message"=>nil, "activated_at"=>Tue Nov 17 16:00:17 UTC 2009, "expires_at"=>nil, "updated_at"=>Tue Nov 17 16:00:17 UTC 2009, "credit_card"=>#<Chargify::Subscription::CreditCard:0x1023ba878 @prefix_options={}, @attributes={"card_type"=>"bogus", "expiration_year"=>2015, "masked_card_number"=>"XXXX-XXXX-XXXX-2", "first_name"=>"Michael", "expiration_month"=>1, "last_name"=>"Klett"}>, "product"=>#<Chargify::Product:0x1023baa80 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x1023c04d0 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>79, "accounting_code"=>nil}>, "id"=>153, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>, "credit_card_attributes"=>{:full_number=>"2", :expiration_year=>"2015"}, "trial_ended_at"=>nil, "id"=>331, "current_period_ends_at"=>Thu Dec 17 16:00:17 UTC 2009, "product_handle"=>"chargify-api-ares-test", "customer"=>#<Chargify::Customer:0x1023bae40 @prefix_options={}, @attributes={"reference"=>"moklett", "updated_at"=>Tue Nov 17 15:51:02 UTC 2009, "id"=>331, "first_name"=>"Michael", "organization"=>"Chargify", "last_name"=>"Klett", "email"=>"moklett@example.com", "created_at"=>Tue Nov 17 15:51:02 UTC 2009}>, "trial_started_at"=>nil, "balance_in_cents"=>0, "current_period_started_at"=>Tue Nov 17 16:00:17 UTC 2009, "state"=>"active", "created_at"=>Tue Nov 17 16:00:17 UTC 2009, "customer_reference"=>"moklett"}>
+
+
+# Perform a one-time charge against an existing subscription
+subscription.charge(:amount => 10.00, :memo => 'Extra service')
+# => #<Net::HTTPCreated>
+
+
+# Cancel a subscription
+subscription.cancel
+subscription.reload
+# => #<Chargify::Subscription:0x1020ed4b0 @prefix_options={}, @attributes={"cancellation_message"=>nil, "activated_at"=>Tue Nov 17 16:00:17 UTC 2009, "expires_at"=>nil, "updated_at"=>Tue Nov 17 16:00:17 UTC 2009, "credit_card"=>#<Chargify::Subscription::CreditCard:0x10234f168 @prefix_options={}, @attributes={"card_type"=>"bogus", "expiration_year"=>2015, "masked_card_number"=>"XXXX-XXXX-XXXX-2", "first_name"=>"Michael", "expiration_month"=>1, "last_name"=>"Klett"}>, "product"=>#<Chargify::Product:0x10234f370 @prefix_options={}, @attributes={"price_in_cents"=>0, "name"=>"Chargify API Ares Test", "handle"=>"chargify-api-ares-test", "product_family"=>#<Chargify::Product::ProductFamily:0x102354708 @prefix_options={}, @attributes={"name"=>"Chargify API ARes Test", "handle"=>"chargify-api-ares-test", "id"=>79, "accounting_code"=>nil}>, "id"=>153, "accounting_code"=>nil, "interval_unit"=>"month", "interval"=>1}>, "credit_card_attributes"=>{:full_number=>"2", :expiration_year=>"2015"}, "trial_ended_at"=>nil, "id"=>331, "current_period_ends_at"=>Thu Dec 17 16:00:17 UTC 2009, "product_handle"=>"chargify-api-ares-test", "customer"=>#<Chargify::Customer:0x10234f730 @prefix_options={}, @attributes={"reference"=>"moklett", "updated_at"=>Tue Nov 17 15:51:02 UTC 2009, "id"=>331, "first_name"=>"Michael", "organization"=>"Chargify", "last_name"=>"Klett", "email"=>"moklett@example.com", "created_at"=>Tue Nov 17 15:51:02 UTC 2009}>, "trial_started_at"=>nil, "balance_in_cents"=>0, "current_period_started_at"=>Tue Nov 17 16:00:17 UTC 2009, "state"=>"canceled", "created_at"=>Tue Nov 17 16:00:17 UTC 2009, "customer_reference"=>"moklett"}>

data/samples/transactions.rb

@@ -0,0 +1,17 @@
+$: << File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'chargify_api_ares'
+
+# You could load your credentials from a file...
+chargify_config = YAML::load_file(File.join(File.dirname(__FILE__), '..', 'config', 'chargify.yml'))
+
+Chargify.configure do |c|
+  c.subdomain = chargify_config['subdomain']
+  c.api_key   = chargify_config['api_key']
+end
+
+
+# Retrieve a list of all your customers
+subscription = Chargify::Subscription.find(:all).first
+
+transactions = subscription.transactions

data/spec/base_spec.rb

@@ -0,0 +1,10 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Chargify::Base do
+  
+  it 'parses element names' do
+    Chargify::Base.stub!(:name).and_return("Test::Namespace::ElementName")
+    Chargify::Base.element_name.should eql('element_name')
+  end
+  
+end

data/spec/components_spec.rb

@@ -0,0 +1,48 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Chargify::Component do
+  describe "Recording usage" do
+    before do
+      @subscription = Factory(:subscription)
+      @component = Factory(:component)
+      @now = DateTime.now.to_s
+    end
+    
+    it "should create a usage record" do
+      u = Chargify::Usage.new
+      u.subscription_id = @subscription.id
+      u.component_id = @component.id
+      u.quantity = 5
+      u.memo = @now
+      u.save
+      
+      component = Chargify::Usage.find(:last, :params => {:subscription_id => @subscription.id, :component_id => @component.id})
+      component.memo.should == @now
+      component.quantity.should == 5
+    end
+  end
+  
+  describe "Listing usages" do
+    before do
+      @subscription = Factory(:subscription)
+      @component = Factory(:component)
+      @now = DateTime.now.to_s
+      create_usage
+    end
+    
+    it "should return all usages for a component and subscription" do
+      component = Chargify::Usage.find(:last, :params => {:subscription_id => @subscription.id, :component_id => @component.id})
+      component.quantity.should == 5
+    end
+  end
+  
+  def create_usage
+    u = Chargify::Usage.new
+    u.subscription_id = @subscription.id
+    u.component_id = @component.id
+    u.quantity = 5
+    u.memo = @now
+    u.save
+  end
+end
+  

data/spec/customer_spec.rb

@@ -0,0 +1,23 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Chargify::Customer do
+  
+  context 'find by reference' do
+    before do
+      @reference = 'ref0123'
+      @existing_customer = Factory(:customer, :reference => @reference, :id => Factory.next(:customer_id))
+      FakeWeb.register_uri(:get, "#{test_domain}/customers/lookup.xml?reference=#{@existing_customer.reference}", :body => @existing_customer.attributes.to_xml)
+    end
+    
+    it 'finds the correct customer by reference' do
+      customer = Chargify::Customer.find_by_reference(@reference)
+      customer.should eql(@existing_customer)
+    end
+    
+    it 'is an instance of Chargify::Customer' do
+      customer = Chargify::Customer.find_by_reference(@reference)
+      customer.should be_instance_of(Chargify::Customer)
+    end
+  end
+  
+end

data/spec/factories.rb

@@ -0,0 +1,62 @@
+Factory.sequence :email do |n|
+  "customer#{n}@example.com"
+end
+
+Factory.sequence :customer_id do |n|
+  n
+end
+
+Factory.define :customer, :class => Chargify::Customer do |c|
+  c.first_name { Faker::Name.first_name }
+  c.last_name { Faker::Name.last_name }
+  c.email { Factory.next(:email) }
+  c.organization { Faker::Company.name }
+  c.created_at { 2.days.ago }
+  c.updated_at { 1.hour.ago }
+end
+
+
+Factory.sequence :product_id do |n|
+  n
+end
+
+Factory.sequence :product_name do |n|
+  "Product #{n}"
+end
+
+Factory.define :product, :class => Chargify::Product do |p|
+  p.name { Factory.next(:product_name) }
+end
+
+Factory.sequence :subscription_id do |n|
+  n
+end
+
+Factory.define :subscription, :class => Chargify::Subscription do |s|
+  s.balance_in_cents 500
+  s.current_period_ends_at 3.days.from_now
+end
+
+Factory.define :subscription_with_extra_attrs, :parent => :subscription do |swea|
+  swea.customer Chargify::Customer.new
+  swea.product Chargify::Product.new
+  swea.credit_card "CREDIT CARD"
+end
+
+Factory.define :component, :class => Chargify::Component do |f|
+  f.name { Faker::Company.bs }
+  f.unit_name 'unit'
+end
+
+Factory.define :quantity_based_component, :class => Chargify::Component do |f|
+  f.name { Faker::Company.bs }
+  f.unit_name 'unit'
+  f.pricing_scheme 'tiered'
+  f.component_type 'quantity_based_component'
+end
+
+Factory.define :subscriptions_component, :class => Chargify::Subscription::Component do |f|
+  f.name { Faker::Company.bs }
+  f.unit_name 'unit'
+  f.component_type 'quantity_based_component'
+end

data/spec/mocks/fake_resource.rb

@@ -0,0 +1,82 @@
+# Taken from https://gist.github.com/238158/487a411c392e1fb2a0c00347e32444320f5cdd49
+require 'FakeWeb'
+ 
+module ActiveResource
+ 
+  #
+  # The FakeResource fakes ActiveResources so that no real resources are transferred. It catches the creation methods
+  # and stores the resources internally instead of sending to a remote service and responds these resources back on
+  # request.
+  #
+  # Additionally it adds a save! method and can be used in conjunction with Cucumber/Pickle/FactoryGirl to fully
+  # fake a back end service in the BDD cycle
+  #
+  module FakeResource
+ 
+    @@fake_resources = []
+ 
+    def self.clean
+      FakeWeb.clean_registry
+      @@fake_resources = []
+    end
+ 
+    def self.included(base)
+      base.class_eval do
+ 
+        def save
+          @@fake_resources << self
+          update_fake_responses
+        end
+ 
+        def destroy
+          @@fake_resources.delete(self)
+          update_fake_responses
+        end
+ 
+        def self.delete(id, options = {})
+          puts "delete"
+          @@fake_resources.delete_if {|r| r.id == id }
+          #update_fake_responses
+        end
+ 
+        def self.exists?(id, options = {})
+          not @@fake_resources.select {|r| r.id == id}.blank?
+        end
+ 
+      end
+    end
+ 
+    def save!
+      save
+    end
+    
+    def save
+      super
+    end
+ 
+    private
+ 
+      def update_fake_responses
+        FakeWeb.clean_registry
+ 
+        @@fake_resources.each do |r|
+          FakeWeb.register_uri(:get, element_uri, :body => r.to_xml)
+        end
+ 
+        FakeWeb.register_uri(:get, collection_uri, :body => @@fake_resources.to_xml)
+      end
+ 
+      def element_uri
+        "#{base_uri}#{element_path}"
+      end
+ 
+      def collection_uri
+        "#{base_uri}#{collection_path}"
+      end
+ 
+      def base_uri
+        "#{connection.site.scheme}://#{connection.user}:#{connection.password}@#{connection.site.host}:#{connection.site.port}"
+      end
+ 
+    end
+end

data/spec/product_spec.rb

@@ -0,0 +1,23 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Chargify::Product do
+  
+  context 'find by handle' do
+    before do
+      @handle = 'handle1'
+      @existing_product = Factory(:product, :handle => @handle, :id => Factory.next(:product_id))
+      FakeWeb.register_uri(:get, "#{test_domain}/products/lookup.xml?handle=#{@existing_product.handle}", :body => @existing_product.attributes.to_xml)
+    end
+
+    it 'finds the correct product by handle' do
+      product = Chargify::Product.find_by_handle(@handle)
+      product.should eql(@existing_product)
+    end
+    
+    it 'is an instance of Chargify::Product' do
+      product = Chargify::Product.find_by_handle(@handle)
+      product.should be_instance_of(Chargify::Product)
+    end  
+  end
+
+end

data/spec/remote/remote_spec.rb

@@ -0,0 +1,514 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+if run_remote_tests?
+  describe "Remote" do
+    before(:all) do
+      clear_site_data
+      setup_plans
+      setup_customer
+    end
+    
+    describe "creating a new subscription to a product with a trial" do
+      context "when providing valid attributes for the customer and the payment profile" do
+        before(:each) do
+          @subscription = create_once(:subscription) do
+            Chargify::Subscription.create(
+              :product_handle => @@basic_plan.handle,
+              :customer_attributes => valid_customer_attributes,
+              :payment_profile_attributes => good_payment_profile_attributes
+            )
+          end
+        end
+        
+        it "successfully creates the subscription" do
+          @subscription.should be_a(Chargify::Subscription)
+        end
+        
+        it "sets the current_period_started_at attribute to now" do
+          @subscription.current_period_started_at.utc.should be_close(now.utc, approximately)
+        end
+        
+        it "sets the current_period_ends_at attribute to 1 month from now" do
+          @subscription.current_period_ends_at.utc.should be_close(one_month_from_now.utc, approximately)
+        end
+        
+        it "is in the trialing state" do
+          @subscription.state.should == 'trialing'
+        end
+      end
+    end
+    
+    describe "creating a new subscription to a product without a trial" do
+      context "when providing an existing customer reference and valid payment profile attributes" do
+        before(:each) do
+          @subscription = create_once(:subscription) do
+            Chargify::Subscription.create(
+              :product_handle => @@pro_plan.handle,
+              :customer_reference => @@johnadoe.reference,
+              :payment_profile_attributes => good_payment_profile_attributes
+            )
+          end
+        end
+        
+        it "successfully creates the subscription" do
+          @subscription.should be_a(Chargify::Subscription)
+        end
+        
+        it "sets the current_period_started_at attribute to now" do
+          @subscription.current_period_started_at.utc.should be_close(now.utc, approximately)
+        end
+        
+        it "sets the current_period_ends_at attribute to 1 month from now" do
+          @subscription.current_period_ends_at.utc.should be_close(one_month_from_now.utc, approximately)
+        end
+        
+        it "is in the active state" do
+          @subscription.state.should == 'active'
+        end
+        
+        it "belongs to the existing customer" do
+          @subscription.customer.should == @@johnadoe
+        end
+      end
+
+      context "when providing an existing customer reference and an existing payment profile" do
+        before(:each) do
+          @subscription = create_once(:subscription) do
+            Chargify::Subscription.create(
+              :product_handle => @@pro_plan.handle,
+              :customer_reference => @@johnadoe.reference,
+              :payment_profile_id => @@johnadoes_credit_card.id.to_s
+            )
+          end
+        end
+        
+        it "successfully creates the subscription" do
+          @subscription.should be_a(Chargify::Subscription)
+        end
+        
+        it "is in the active state" do
+          @subscription.state.should == 'active'
+        end
+        
+        it "belongs to the existing customer" do
+          @subscription.customer.should == @@johnadoe
+        end
+        
+        it "uses the provided credit card" do
+          expected_card = Chargify::PaymentProfile.find(@@johnadoes_credit_card.id)
+          @subscription.payment_profile.id.should == @@johnadoes_credit_card.id
+          @subscription.payment_profile.attributes.should == expected_card.attributes
+        end
+      end
+
+      context "when providing valid attributes for the customer and attributes for a credit card that cannot be stored" do
+        before(:each) do
+          @customer_attributes = valid_customer_attributes.dup
+          @subscription = create_once(:subscription) do
+            Chargify::Subscription.create(
+              :product_handle => @@basic_plan.handle,
+              :customer_attributes => @customer_attributes,
+              :payment_profile_attributes => unstorable_payment_profile_attributes
+            )
+          end
+        end
+        
+        it "does not create the subscription" do
+          @subscription.should_not be_valid
+        end
+      
+        it "does not create the customer" do
+          lambda {
+            Chargify::Customer.find_by_reference(@customer_attributes[:reference])
+          }.should raise_error(ActiveResource::ResourceNotFound)
+        end
+      end
+
+    end
+    
+    describe "importing a subscription to a product with a trial and a next billing date 10 days from now" do
+      context "when giving valid attributes for the customer and the payment profile" do
+        before(:each) do
+          @subscription = create_once(:subscription) do
+            Chargify::Subscription.create(
+              :product_handle => @@basic_plan.handle,
+              :customer_attributes => valid_customer_attributes,
+              :payment_profile_attributes => pretokenized_card_attributes,
+              :next_billing_at => ten_days_from_now.utc
+            )
+          end
+        end
+        
+        it "successfully creates the subscription" do
+          @subscription.should be_a(Chargify::Subscription)
+        end
+        
+        it "sets the current_period_started_at attribute to now" do
+          @subscription.current_period_started_at.utc.should be_close(now.utc, approximately)
+        end
+    
+        it "sets the current_period_ends_at attribute to 1 month from now" do
+          @subscription.current_period_ends_at.utc.should be_close(ten_days_from_now.utc, approximately)
+        end
+        
+        it "is in the active state" do
+          @subscription.state.should == 'active'
+        end
+      end
+    end
+
+    describe "creating failed subscriptions" do
+      context "due to providing payment profile attribtues for a card that will be declined" do
+        before(:each) do
+          @customer_attributes = valid_customer_attributes.dup
+          @subscription = create_once(:subscription) do
+            Chargify::Subscription.create(
+              :product_handle => @@pro_plan.handle,
+              :customer_attributes => @customer_attributes,
+              :payment_profile_attributes => declined_payment_profile_attributes
+            )
+          end
+        end
+      
+        it "does not create the subscription" do
+          @subscription.should_not be_valid
+        end
+      
+        it "does not create the customer" do
+          lambda {
+            Chargify::Customer.find_by_reference(@customer_attributes[:reference])
+          }.should raise_error(ActiveResource::ResourceNotFound)
+        end
+      end
+    end
+    
+    describe "cancelling a subscription" do
+      before(:each) do
+        @subscription = create_once(:subscription) do
+          Chargify::Subscription.create(
+            :product_handle => @@pro_plan.handle,
+            :customer_reference => @@johnadoe.reference,
+            :payment_profile_attributes => good_payment_profile_attributes
+          )
+        end
+        @subscription.cancel
+      end
+      
+      it "is in the canceled state" do
+        Chargify::Subscription.find(@subscription.id).state.should == 'canceled'
+      end
+    end
+    
+    describe "reactivating a subscriptions" do
+      before(:each) do
+        @subscription = create_once(:subscription) do
+          Chargify::Subscription.create(
+            :product_handle => @@pro_plan.handle,
+            :customer_reference => @@johnadoe.reference,
+            :payment_profile_attributes => good_payment_profile_attributes
+          )
+        end
+        @subscription.cancel
+        @subscription.reload.state.should == 'canceled'
+        @subscription.reactivate
+      end
+      
+      it "puts it in the active state" do
+        @subscription.reload.state.should == 'active'
+      end
+    end
+    
+    describe "adding a one time charge" do
+      before(:each) do
+        @subscription = create_once(:subscription) do
+          Chargify::Subscription.create(
+            :product_handle => @@pro_plan.handle,
+            :customer_reference => @@johnadoe.reference,
+            :payment_profile_attributes => good_payment_profile_attributes
+          )
+        end
+      end
+      it "creates a charge and payment" do
+        lambda{
+          @subscription.charge(:amount => 7, :memo => 'One Time Charge')
+        }.should change{@subscription.reload.transactions.size}.by(2)
+        @subscription.transactions.first.amount_in_cents.should == 700
+      end
+    end
+    
+    describe "adding a credit" do
+      before(:each) do
+        @subscription = create_once(:subscription) do
+          Chargify::Subscription.create(
+            :product_handle => @@pro_plan.handle,
+            :customer_reference => @@johnadoe.reference,
+            :payment_profile_attributes => good_payment_profile_attributes
+          )
+        end
+      end
+      
+      it "creates a credit" do
+        lambda{
+          @subscription.credit(:amount => 7, :memo => 'credit')
+        }.should change{@subscription.reload.transactions.size}.by(1)
+        @subscription.transactions.first.amount_in_cents.should == -700
+      end
+    end
+    
+    describe "adding a refund" do
+      before(:each) do
+        @subscription = create_once(:subscription) do
+          Chargify::Subscription.create(
+            :product_handle => @@pro_plan.handle,
+            :customer_reference => @@johnadoe.reference,
+            :payment_profile_attributes => good_payment_profile_attributes
+          )
+        end
+
+        @subscription.charge(:amount => 7, :memo => 'One Time Charge')
+        @subscription.reload
+      end
+
+      it "creates a refund" do
+        lambda{
+          @subscription.refund :payment_id => @subscription.transactions[0].id, :amount => 7, 
+            :memo => 'Refunding One Time Charge'
+        }.should change{@subscription.reload.transactions.size}.by(1)
+        @subscription.transactions.first.amount_in_cents.should == 700
+        @subscription.transactions.first.transaction_type.should == 'refund'
+      end
+
+      context "via subscription payment (Chargify::Subscription::Transaction)" do
+        before :each do
+          @payment = @subscription.transactions.first
+        end
+
+        it "creates a refund" do
+          lambda{
+            @payment.refund :amount => 7, :memo => 'Refunding One Time Charge'
+          }.should change{@subscription.reload.transactions.size}.by(1)
+          @subscription.transactions.first.amount_in_cents.should == 700
+          @subscription.transactions.first.transaction_type.should == 'refund'
+        end
+
+        it "creates a full refund" do
+          lambda{
+            @payment.full_refund :memo => 'Refunding One Time Charge'
+          }.should change{@subscription.reload.transactions.size}.by(1)
+          @subscription.transactions.first.amount_in_cents.should == 700
+          @subscription.transactions.first.transaction_type.should == 'refund'
+        end
+      end
+
+      context "via site payment (Chargify::Transaction)" do
+        before :each do
+          @site_payment = Chargify::Transaction.find(:first)
+        end
+
+        it "creates a refund" do
+          lambda{
+            @site_payment.refund :amount => 7, :memo => 'Refunding One Time Charge'
+          }.should change{@subscription.reload.transactions.size}.by(1)
+          @subscription.transactions.first.amount_in_cents.should == 700
+          @subscription.transactions.first.transaction_type.should == 'refund'
+        end
+
+        it "creates a full refund" do
+          lambda{
+            @site_payment.full_refund :memo => 'Refunding One Time Charge'
+          }.should change{@subscription.reload.transactions.size}.by(1)
+          @subscription.transactions.first.amount_in_cents.should == 700
+          @subscription.transactions.first.transaction_type.should == 'refund'
+        end
+      end
+    end
+    
+    def already_cleared_site_data?
+      @@already_cleared_site_data ||= nil
+      @@already_cleared_site_data == true
+    end
+    
+    def cleared_site_data!
+      @@already_cleared_site_data = true
+    end
+    
+    def clear_site_data
+      return if already_cleared_site_data?
+      begin
+        Chargify::Site.clear_data!
+        cleared_site_data!
+      rescue ActiveResource::ForbiddenAccess
+        raise StandardError.new("Remote specs may only be run against a site in test mode")
+      end
+    end
+
+    # Create Basic and Pro products in the Acme Projects family
+    def setup_plans
+      begin
+        @@acme_projects ||= Chargify::ProductFamily.find_by_handle('acme-projects')
+      rescue ActiveResource::ResourceNotFound
+        @@acme_projects = Chargify::ProductFamily.new(
+          :name => "Acme Projects"
+        )
+        result = @@acme_projects.save
+        result.should be_true
+      end
+      
+      begin
+        @@basic_plan ||= Chargify::Product.find_by_handle('basic')
+      rescue ActiveResource::ResourceNotFound
+        @@basic_plan = Chargify::Product.new(
+          :product_family_id => @@acme_projects.id,
+          :name => "Basic Plan",
+          :handle => "basic",
+          :price_in_cents => 1000,
+          :interval => 1,
+          :interval_unit => 'month',
+          :trial_interval => 1,
+          :trial_interval_unit => 'month',
+          :trial_price_in_cents => 0
+        )
+        result = @@basic_plan.save
+        result.should be_true
+      end
+
+      begin
+        @@pro_plan ||= Chargify::Product.find_by_handle('pro')
+      rescue ActiveResource::ResourceNotFound
+        @@pro_plan = Chargify::Product.new(
+          :product_family_id => @@acme_projects.id,
+          :name => "Pro Plan",
+          :handle => "pro",
+          :price_in_cents => 5000,
+          :interval => 1,
+          :interval_unit => 'month'
+        )
+        result = @@pro_plan.save
+        result.should be_true
+      end
+    end
+
+    def setup_customer
+      # Create a customer
+      begin
+        @@johnadoe ||= Chargify::Customer.find_by_reference('a')
+      rescue ActiveResource::ResourceNotFound
+        @@johnadoe = Chargify::Customer.new(valid_customer_attributes)
+        result = @@johnadoe.save
+        result.should be_true
+        
+        @@johnadoes_credit_card = Chargify::PaymentProfile.new(
+          good_payment_profile_attributes.merge(:customer_id => @@johnadoe.id)
+        )
+        result = @@johnadoes_credit_card.save
+        result.should be_true
+      end
+    end
+    
+    def now
+      Time.now
+    end
+  
+    def one_month_from_now
+      Time.now + 1.month
+    end
+  
+    def ten_days_from_now
+      10.days.from_now
+    end
+  
+    # Gives a reasonable range for time comparisons
+    def approximately
+      @approximately ||= 5.minutes
+    end
+  
+    def valid_customer_attributes
+      initial = next_customer_initial
+      {
+        :first_name => "John #{initial.upcase}",
+        :last_name => "Doe",
+        :email => "john.#{initial}.doe@example.com",
+        :reference => initial
+      }
+    end
+  
+    def good_payment_profile_attributes
+      {
+        :full_number => '1',
+        :expiration_month => '12',
+        :expiration_year => Time.now.year + 1
+      }
+    end
+
+    def declined_payment_profile_attributes
+      {
+        :full_number => '2',
+        :expiration_month => '12',
+        :expiration_year => Time.now.year + 1
+      }
+    end
+
+    def unstorable_payment_profile_attributes
+      {
+        :full_number => '3',
+        :expiration_month => '12',
+        :expiration_year => Time.now.year + 1
+      }
+    end
+
+    def expired_payment_profile_attributes
+      {
+        :full_number => '1',
+        :expiration_month => '12',
+        :expiration_year => Time.now.year - 1
+      }
+    end
+  
+    def pretokenized_card_attributes
+      {
+        :vault_token => '1',
+        :current_vault => 'bogus',
+        :expiration_month => '12',
+        :expiration_year => Time.now.year + 1,
+        :last_four => '1234',
+        :card_type => 'visa'
+      }
+    end
+  
+    # Don't create more than 26 customers until we add more initials :)
+    def next_customer_initial
+      @@customer_initial_index ||= 0
+      initial = customer_initials[@@customer_initial_index]
+      @@customer_initial_index += 1
+      initial
+    end
+  
+    # An array of intials
+    def customer_initials
+      @customer_initials ||= ('a'..'z').to_a
+    end
+
+    # Allows us to create remote resources once per spec hierarchy
+    def create_once(type, &block)
+      hierarchy = example_group_hierarchy.collect(&:object_id).to_s
+
+      unless resource(type, hierarchy)
+        register_resource(type, hierarchy, block.call)
+      end
+      resource(type, hierarchy)
+    end
+  
+    def resource(type, hierarchy)
+      @@resources ||= {}
+      @@resources[type] ||= {}
+      @@resources[type][hierarchy]
+    end
+  
+    def register_resource(type, hierarchy, resource)
+      @@resources ||= {}
+      @@resources[type] ||= {}
+      @@resources[type][hierarchy] = resource
+    end
+
+  end
+end