stefl-chargify 0.3.3

data/.gitignore

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

data/.rspec

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

data/Gemfile

@@ -0,0 +1,20 @@
+source 'http://rubygems.org'
+
+group :runtime do
+  gem 'httparty', '~> 0.6.1'
+  gem 'hashie', '~> 0.4.0'
+  gem 'json'
+  gem 'activesupport', '~> 3.0.0'
+  gem 'i18n'
+end
+
+group :test do
+  gem 'jeweler'
+  gem 'rake'
+  gem 'fakeweb',  '>= 1.3.0'
+  gem 'mocha',    '~> 0.9.8'
+  gem 'rspec',    '~> 2.0.0.beta.22'
+  gem 'autotest'
+end
+
+# vim: ft=ruby

data/Gemfile.lock

@@ -0,0 +1,51 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.0)
+    autotest (4.4.0)
+    crack (0.1.8)
+    diff-lcs (1.1.2)
+    fakeweb (1.3.0)
+    gemcutter (0.6.1)
+    git (1.2.5)
+    hashie (0.4.0)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    i18n (0.4.1)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json (1.4.6)
+    json_pure (1.4.6)
+    mocha (0.9.8)
+      rake
+    rake (0.8.7)
+    rspec (2.0.0.beta.22)
+      rspec-core (= 2.0.0.beta.22)
+      rspec-expectations (= 2.0.0.beta.22)
+      rspec-mocks (= 2.0.0.beta.22)
+    rspec-core (2.0.0.beta.22)
+    rspec-expectations (2.0.0.beta.22)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.0.beta.22)
+      rspec-core (= 2.0.0.beta.22)
+      rspec-expectations (= 2.0.0.beta.22)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (~> 3.0.0)
+  autotest
+  fakeweb (>= 1.3.0)
+  hashie (~> 0.4.0)
+  httparty (~> 0.6.1)
+  i18n
+  jeweler
+  json
+  mocha (~> 0.9.8)
+  rake
+  rspec (~> 2.0.0.beta.22)

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Wynn Netherland, Justin Smestad
+
+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.markdown

@@ -0,0 +1,46 @@
+# jsmestad-chargify
+
+Ruby wrapper for the Chargify SAAS and billing API
+
+### Important Notice
+
+This fork breaks all compatibility with previous versions (< 0.3.0)
+
+## Installation
+
+### Production Version
+    gem install jsmestad-chargify
+    
+### Bleeding Edge
+    gem install jsmestad-chargify --pre
+    
+## Example Usage
+
+### Create, cancel, then reactivate subscription
+    attributes   = { :product_handle => 'basic' ... }
+    subscription = Chargify::Subscription.create(attributes)
+    Chargify::Subscription.cancel(subscription[:id], "Canceled due to bad customer service.") 
+    Chargify::Subscription.reactivate(subscription[:id]) #Made him an offer he couldn't refuse!
+
+## Rails Usage
+
+### config/initializers/chargify.rb
+    Chargify::Config.setup do |config|
+      config[:subdomain] = 'xxx-test'
+      config[:api_key]   = 'InDhcXAAAAAg7juDD'
+    end
+
+## Contributing (requires Bundler >= 0.9.26):
+
+    $ git clone git://github.com/jsmestad/chargify.git
+    $ cd chargify
+    $ bundle install
+    $ bundle exec rake
+    
+## More Info
+
+Wiki: http://wiki.github.com/jsmestad/chargify/
+
+### Copyright
+
+See LICENSE for details.

data/Rakefile

@@ -0,0 +1,33 @@
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "stefl-chargify"
+    gem.summary = %Q{Ruby wrapper for the Chargify API}
+    gem.email = "justin.smestad@gmail.com"
+    gem.homepage = "http://github.com/stefl/chargify"
+    gem.authors = ["Wynn Netherland", "Justin Smestad"]
+
+    gem.add_dependency('httparty', '~> 0.6.1')
+    gem.add_dependency('hashie', '~> 0.4.0')
+    gem.add_dependency('json')
+    gem.add_dependency('activesupport', '>= 3.0.0')
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Run all examples using rcov"
+RSpec::Core::RakeTask.new :rcov => :cleanup_rcov_files do |t|
+  t.rcov = true
+  t.rcov_opts =  %[-Ilib -Ispec --exclude "mocks,expectations,gems/*,spec/resources,spec/lib,spec/spec_helper.rb,db/*,/Library/Ruby/*,config/*"]
+  t.rcov_opts << %[--no-html --aggregate coverage.data]
+end
+
+task :default => :spec
+

data/VERSION

@@ -0,0 +1 @@
+0.3.3

data/changelog.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.3.3 October 01, 2010
+* ProductFamily support (.find, .all, .find_by_handle, .components)
+
+## 0.3.2 September 2010
+* Support for Customer.find_or_create method
+
+## 0.3.0.pre July 08, 2010
+* Complete API Rewrite, please view wiki for API documentation
+
+## 0.2.6 May 27, 2010
+* Fix #charge_subscription to submit it's body as json [@will](http://github.com/will) and [@ignat](http://github.com/ignat)
+* API coverage for quantity components [@will](http://github.com/will)
+* API coverage for site and subscription transactions [@ignat](http://github.com/ignat)
+
+## 0.2.5 May 24, 2010
+* Require fix from [@will](http://github.com/will)
+
+## 0.2.4 May 20, 2010
+
+* Substantial new API coverage from [@miksago](http://twitter.com/miksago)
+
+## 0.2.0 January 26, 2010
+
+* Substantial fixes and convenience enhancements from [@nkabbara](http://github.com/nkabbara)
+
+## 0.1.0 November 18, 2009
+
+* Initial version

data/lib/chargify/base.rb

@@ -0,0 +1,89 @@
+module Chargify
+  class Base
+    include HTTParty
+
+    parser Chargify::Parser
+    headers 'Content-Type' => 'application/json'
+    headers 'User-Agent' => 'Chargify Ruby Client'
+
+    class << self
+
+      def api_request(type, path, options={})
+        self.base_uri "https://#{Chargify::Config.subdomain}.chargify.com"
+
+        # This is to allow bang methods
+        raise_errors = options.delete(:raise_errors)
+        
+        # Build options hash for HTTParty
+        options[:body] = options[:body].to_json if options[:body]
+        options[:basic_auth] = {:username => Chargify::Config.api_key, :password => 'x'}
+    
+        Chargify::Config.logger.debug("[CHARGIFY] Sending #{self.base_uri}#{path} a payload of #{options[:body]}") if Chargify::Config.debug
+
+        begin
+          response = self.send(type.to_s, path, options)
+        rescue SocketError
+          raise(Chargify::Error::ConnectionFailed.new, "Failed to connect to payment gateway.")
+        end
+
+
+        case response.code.to_i
+        when 401
+          raise(Chargify::Error::AccessDenied.new(response), response.body)
+        when 403
+          raise(Chargify::Error::Forbidden.new(response), response.body)
+        when 422
+          raise(Chargify::Error::BadRequest.new(response), response.body)
+        when 404
+          raise(Chargify::Error::NotFound.new(response), response.body)
+        when 500
+          raise(Chargify::Error::ServerError.new(response), response.body)
+        when 504
+          raise(Chargify::Error::GatewayTimeout.new(response), response.body)
+        end
+        
+        Chargify::Config.logger.debug("[CHARGIFY] Response from #{self.base_uri}#{path} was #{response.code}: #{response.body}") if Chargify::Config.debug
+
+        response
+      end
+
+    end
+
+    attr_reader :errors
+
+    def initialize(options={})
+      Chargify::Config.api_key = options[:api_key] if options[:api_key]
+      Chargify::Config.subdomain = options[:subdomain] if options[:subdomain]
+
+      @errors = []
+      self.attributes = attrs
+    end
+
+    def attributes=(attrs)
+      attrs.each do |k, v|
+        self.send(:"#{k}=", v) if self.respond_to?(:"#{k}=")
+      end
+    end
+
+    def api_request(type, path, options={})
+      @errors = []
+      begin
+        self.class.api_request(type, path, options)
+      rescue Chargify::Error::Base => e
+        if e.response.is_a?(Hash)
+          if e.response.has_key?("errors")
+            @errors = [*e.response["errors"]["error"]]
+          else
+            @errors = [e.response.body]
+          end
+        else
+          @errors = [e.message]
+        end
+        raise
+      end
+    end
+
+
+  end
+end
+

data/lib/chargify/config.rb

@@ -0,0 +1,86 @@
+require 'pp'
+module Chargify
+  module Config
+    class << self
+
+      # the configuration hash itself
+      def configuration
+        @configuration ||= defaults
+      end
+
+      def defaults
+        {
+          :logger     => defined?(Rails.logger) ? Rails.logger : Logger.new(STDOUT),
+          :debug      => false,
+          :subdomain  => "your-site-name",
+          :api_key    => "your-api-key"
+        }
+      end
+
+      def [](key)
+        configuration[key]
+      end
+
+      def []=(key, val)
+        configuration[key] = val
+      end
+
+      # remove an item from the configuration
+      def delete(key)
+        configuration.delete(key)
+      end
+
+      # Return the value of the key, or the default if doesn't exist
+      #
+      # ==== Examples
+      #
+      # Chargify::Config.fetch(:monkey, false)
+      # => false
+      #
+      def fetch(key, default)
+        configuration.fetch(key, default)
+      end
+
+      def to_hash
+        configuration
+      end
+
+      # Yields the configuration.
+      #
+      # ==== Examples
+      #   Chargify::Config.use do |config|
+      #     config[:debug]    = true
+      #     config.something  = false
+      #   end
+      #
+      def setup
+        yield self
+        nil
+      end
+
+      def clear
+        @configuration = {}
+      end
+
+      def reset
+        @configuration = defaults
+      end
+
+      # allow getting and setting properties via Chargify::Config.xxx
+      #
+      # ==== Examples
+      # Chargify::Config.debug
+      # Chargify::Config.debug = false
+      #
+      def method_missing(method, *args)
+        if method.to_s[-1,1] == '='
+          configuration.send(:[]=, method.to_s.tr('=','').to_sym, *args) 
+        else
+          configuration[method]
+        end
+      end
+
+    end
+  end
+end
+

data/lib/chargify/customer.rb

@@ -0,0 +1,101 @@
+module Chargify
+  class Customer < Base
+
+    class << self
+
+      # options: page
+      def all(options={})
+        customers = api_request(:get, '/customers.json', :query => options)
+        customers.map{|c| Hashie::Mash.new c['customer']}
+      end
+
+      def find!(id)
+        return all if id == :all
+
+        request = api_request(:get, "/customers/#{id}.json")
+        response = Hashie::Mash.new(request)
+        response
+      end
+      
+      def find(id)
+        find!(id)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+
+      # def find!(id)
+        # request = api_request(:get, "/customers/#{id}.json", :raise_errors => true)
+        # response = Hashie::Mash.new(request).customer
+      # end
+
+      def lookup!(reference_id)
+        request = api_request(:get, "/customers/lookup.json?reference=#{reference_id}")
+        response = Hashie::Mash.new(request)
+        response.customer
+      end
+      
+      def lookup(reference_id)
+        lookup!(reference_id)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+
+      #
+      # * first_name (Required)
+      # * last_name (Required)
+      # * email (Required)
+      # * organization (Optional) Company/Organization name
+      # * reference (Optional, but encouraged) The unique identifier used within your own application for this customer
+      #
+      def create!(info={})
+        result = api_request(:post, "/customers.json", :body => {:customer => info})
+        created = true if result.code == 201
+        response = Hashie::Mash.new(result)
+        (response.customer || response).update(:success? => created)
+      end
+      
+      def create(info={})
+        create!(info)
+      rescue Chargify::Error::Base => e
+        return false
+      end
+      
+      def find_or_create(info={})
+        info.symbolize_keys!
+        self.lookup!(info[:reference])
+      rescue Chargify::Error::NotFound => e
+        self.create!(info)
+      end
+
+      #
+      # * first_name (Required)
+      # * last_name (Required)
+      # * email (Required)
+      # * organization (Optional) Company/Organization name
+      # * reference (Optional, but encouraged) The unique identifier used within your own application for this customer
+      #
+      def update!(info={})
+        info.stringify_keys!
+        chargify_id = info.delete('id')
+        result = api_request(:put, "/customers/#{chargify_id}.json", :body => {:customer => info})
+
+        response = Hashie::Mash.new(result)
+        return response.customer unless response.customer.to_a.empty?
+        response
+      end
+      
+      def update(info={})
+        update!(info)
+      rescue Chargify::Error::Base => e
+        return false
+      end
+
+      def subscriptions(id)
+        subscriptions = api_request(:get, "/customers/#{id}/subscriptions.json")
+        subscriptions.map{|s| Hashie::Mash.new s['subscription']}
+      end
+
+    end
+
+  end
+end

data/lib/chargify/error.rb

@@ -0,0 +1,24 @@
+module Chargify
+  module Error
+
+    class Base < StandardError
+      attr_reader :response
+
+      def initialize(response=nil)
+        @response  = response
+      end
+    end
+
+    class AccessDenied        < Base; end # 401 errors
+    class Forbidden           < Base; end # 403 errors
+    class BadRequest          < Base; end # 422 errors
+    class NotFound            < Base; end # 404 errors
+    class ServerError         < Base; end # 500 errors
+    class GatewayTimeout      < Base; end # 504 errors
+    class ConnectionFailed    < Base; end
+    
+    class UnexpectedResponse  < Base; end
+
+  end
+end
+

data/lib/chargify/parser.rb

@@ -0,0 +1,13 @@
+module Chargify
+  class Parser < HTTParty::Parser
+
+    def parse
+      begin
+        Crack::JSON.parse(body)
+      rescue => e
+        raise(Chargify::Error::UnexpectedResponse.new(e.message), body)
+      end
+    end
+
+  end
+end

data/lib/chargify/product.rb

@@ -0,0 +1,38 @@
+module Chargify
+  class Product < Base
+
+    class << self
+
+      def all
+        result = api_request(:get, "/products.json")
+        result.map{|p| Hashie::Mash.new p['product']}
+      end
+
+      def find!(id)
+        return all if id == :all
+
+        result = api_request(:get, "/products/#{id}.json")
+        Hashie::Mash.new(result).product
+      end
+      
+      def find(id)
+        find!(id)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+      
+      def find_by_handle(handle)
+        find_by_handle!(handle)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+
+      def find_by_handle!(handle)
+        result = api_request(:get, "/products/handle/#{handle}.json")
+        Hashie::Mash.new(result).product
+      end
+
+    end
+
+  end
+end

data/lib/chargify/product_family.rb

@@ -0,0 +1,47 @@
+module Chargify
+  class ProductFamily < Base
+    class << self
+
+      def all
+        result = api_request(:get, "/product_families.json")
+        result.map {|p| Hashie::Mash.new p['product_family']}
+      end
+
+      def find!(id)
+        return all if id == :all
+
+        result = api_request(:get, "/product_families/#{id}.json")
+        Hashie::Mash.new(result).product_family
+      end
+
+      def find(id)
+        find!(id)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+
+      def find_by_handle!(handle)
+        result = api_request(:get, "/product_families/lookup.json?handle=#{handle}")
+        Hashie::Mash.new(result).product_family
+      end
+
+      def find_by_handle(handle)
+        find_by_handle!(handle)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+
+      def components!(product_family_id)
+        result = api_request(:get, "/product_families/#{product_family_id}/components.json")
+        result.map {|p| Hashie::Mash.new p['component']}
+      end
+
+      def components(product_family_id)
+        components!(product_family_id)
+      rescue Chargify::Error::Base => e
+        return nil
+      end
+
+    end
+  end
+end