conekta 0.3.0

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/CONTRIBUTORS

@@ -0,0 +1,9 @@
+Copyright (C) 2013 Conekta
+Leo Fischer
+Mauricio Murga
+
+Copyright (C) 2013 Stripe
+
+Greg Brockman <gdb@gregbrockman.com>
+Ross Boucher <rboucher@gmail.com>
+Bradley Grzesiak <brad@bendyworks.com>

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/Gemfile.lock

@@ -0,0 +1,57 @@
+PATH
+  remote: .
+  specs:
+    conekta (0.2.0)
+      multi_json (>= 1.0.4, < 2)
+      rest-client (~> 1.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    atomic (1.1.10)
+    bourne (1.5.0)
+      mocha (>= 0.13.2, < 0.15)
+    diff-lcs (1.2.4)
+    i18n (0.6.4)
+    metaclass (0.0.1)
+    mime-types (2.0)
+    minitest (4.7.5)
+    mocha (0.13.3)
+      metaclass (~> 0.0.1)
+    multi_json (1.7.7)
+    rake (10.1.0)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.2)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.1)
+    shoulda (3.4.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (~> 1.0, >= 1.4.1)
+    shoulda-context (1.1.4)
+    shoulda-matchers (1.5.6)
+      activesupport (>= 3.0.0)
+      bourne (~> 1.3)
+    thread_safe (0.1.1)
+      atomic
+    tzinfo (0.3.37)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  conekta!
+  rake
+  rspec
+  shoulda (~> 3.4.0)

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.1.0 2013-07-29
+
+* 1 major enhancement:
+  * Initial release

data/LICENSE

@@ -0,0 +1,23 @@
+The MIT License
+
+Copyright (c) 2013- Conekta (http://conekta.mx)
+
+Copyright (c) 2011-2013 Stripe, Inc. (https://stripe.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,22 @@
+= Conekta Ruby bindings
+
+== Installation
+
+You don't need this source code unless you want to modify the gem. If 
+you want to install the gem via bundler you should add this line to your gemfile:
+
+gem 'conekta', :git => 'git://github.com/conekta/conekta-ruby.git'
+
+If you want to build the gem from source:
+
+  gem build conekta.gemspec
+
+== Requirements
+
+* Ruby 1.8.7 or above. (Ruby 1.8.6 may work if you load
+  ActiveSupport.)
+* rest-client, multi_json
+
+== Development
+
+Test cases can be run with: `bundle exec rake test`

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rspec/core/rake_task'
+task :default => [:spec]
+
+
+RSpec::Core::RakeTask.new(:spec)
+
+
+#task :test do
+#  ret = true
+#  Dir["test/**/*.rb"].each do |f|
+#    ret = ret && ruby(f, '')
+#  end
+#  exit(ret)
+#   end

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/bin/conekta-console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/conekta.rb'}"
+puts "Loading conekta gem"
+exec "#{irb} #{libs} --simple-prompt"

data/conekta.gemspec

@@ -0,0 +1,27 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+
+require 'conekta/version'
+
+spec = Gem::Specification.new do |s|
+  s.name = 'conekta'
+  s.version = Conekta::VERSION
+  s.summary = 'Ruby bindings for the Conekta API'
+  s.description = 'Easy payments and shipping, see http://conekta.mx for details.'
+  s.authors = ['Leo Fischer', 'Mauricio Murga']
+  s.email = %w(leo@conekta.mx mauricio@conekta.com)
+  s.homepage = 'http://conekta.mx/doc'
+
+  s.add_dependency('rest-client', '~> 1.4')
+  s.add_dependency('multi_json', '>= 1.0.4', '< 2')
+
+#  s.add_development_dependency('mocha', '~> 0.13.2')
+  s.add_development_dependency('shoulda', '~> 3.4.0')
+#  s.add_development_dependency('test-unit')
+  s.add_development_dependency('rspec')
+  s.add_development_dependency('rake')
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- test/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+end

data/gemfiles/default-with-activesupport.gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+gemspec :path => File.join(File.dirname(__FILE__), "..")
+gem "activesupport", "~> 3.0"

data/gemfiles/json.gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+gemspec :path => File.join(File.dirname(__FILE__), "..")
+gem "json"
+gem "activesupport", "~> 3.0"

data/gemfiles/yajl.gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+gemspec :path => File.join(File.dirname(__FILE__), "..")
+gem "yajl-ruby"
+gem "activesupport", "~> 3.0"

data/lib/conekta.rb

@@ -0,0 +1,292 @@
+# Conekta Ruby bindings
+# API spec at https://conekta.io/docs/api
+require 'cgi'
+require 'set'
+require 'openssl'
+require 'rest_client'
+require 'multi_json'
+require 'base64'
+
+# Version
+require 'conekta/version'
+
+# API operations
+require 'conekta/api_operations/create'
+require 'conekta/api_operations/update'
+require 'conekta/api_operations/delete'
+require 'conekta/api_operations/list'
+
+# Resources
+require 'conekta/util'
+require 'conekta/json'
+require 'conekta/conekta_object'
+require 'conekta/api_resource'
+require 'conekta/singleton_api_resource'
+require 'conekta/account'
+require 'conekta/list_object'
+require 'conekta/charge'
+require 'conekta/event'
+require 'conekta/log'
+
+# Errors
+require 'conekta/errors/conekta_error'
+require 'conekta/errors/api_error'
+require 'conekta/errors/api_connection_error'
+require 'conekta/errors/card_error'
+require 'conekta/errors/resource_not_found_error'
+require 'conekta/errors/malformed_request_error'
+require 'conekta/errors/parameter_validation_error'
+require 'conekta/errors/authentication_error'
+
+module Conekta
+  @api_base = 'https://api.conekta.io'
+
+  @ssl_bundle_path  = File.dirname(__FILE__) + '/data/ca-certificates.crt'
+  @verify_ssl_certs = true
+
+  class << self
+    attr_accessor :api_key, :api_base, :verify_ssl_certs, :api_version
+  end
+
+  def self.api_url(url='')
+    url = @api_base + url
+    if not url.match(/\.json/)
+      url = url + '.json'
+    end
+    url
+  end
+
+  def self.request(method, url, api_key, params={}, headers={})
+    unless api_key ||= @api_key
+      raise AuthenticationError.new('No API key provided. ' +
+        'Set your API key using "Conekta.api_key = <API-KEY>". ' +
+        'You can generate API keys from the Conekta web interface. ' +
+        'See https://conekta.io/api for details, or email support@conekta.io ' +
+        'if you have any questions.')
+    end
+
+    if api_key =~ /\s/
+      raise AuthenticationError.new('Your API key is invalid, as it contains ' +
+        'whitespace. (HINT: You can double-check your API key from the ' +
+        'Conekta web interface. See https://conekta.io/api for details, or ' +
+        'email support@conekta.io if you have any questions.)')
+    end
+
+    request_opts = { :verify_ssl => false }
+
+    if ssl_preflight_passed?
+      request_opts.update(:verify_ssl => OpenSSL::SSL::VERIFY_PEER,
+                          :ssl_ca_file => @ssl_bundle_path)
+    end
+
+    params = Util.objects_to_ids(params)
+    url = api_url(url)
+
+    case method.to_s.downcase.to_sym
+    when :get, :head, :delete
+      # Make params into GET parameters
+      url += "#{URI.parse(url).query ? '&' : '?'}#{uri_encode(params)}" if params && params.any?
+      payload = nil
+    else
+      payload = params.to_json#uri_encode(params)
+      headers[:content_type] = 'application/json'
+    end
+
+    request_opts.update(:headers => request_headers(api_key).update(headers),
+                        :method => method, :open_timeout => 30,
+                        :payload => payload, :url => url, :timeout => 80)
+
+    begin
+      response = execute_request(request_opts)
+    rescue SocketError => e
+      handle_restclient_error(e)
+    rescue NoMethodError => e
+      # Work around RestClient bug
+      if e.message =~ /\WRequestFailed\W/
+        e = APIConnectionError.new('Unexpected HTTP response code')
+        handle_restclient_error(e)
+      else
+        raise
+      end
+    rescue RestClient::ExceptionWithResponse => e
+      if rcode = e.http_code and rbody = e.http_body
+        handle_api_error(rcode, rbody)
+      else
+        handle_restclient_error(e)
+      end
+    rescue RestClient::Exception, Errno::ECONNREFUSED => e
+      handle_restclient_error(e)
+    end
+
+    [parse(response), api_key]
+  end
+
+  private
+
+  def self.ssl_preflight_passed?
+    if !verify_ssl_certs && !@no_verify
+      $stderr.puts "WARNING: Running without SSL cert verification. " +
+        "Execute 'Conekta.verify_ssl_certs = true' to enable verification."
+
+      @no_verify = true
+
+    elsif !Util.file_readable(@ssl_bundle_path) && !@no_bundle
+      $stderr.puts "WARNING: Running without SSL cert verification " +
+        "because #{@ssl_bundle_path} isn't readable"
+
+      @no_bundle = true
+    end
+
+    !(@no_verify || @no_bundle)
+  end
+
+  def self.user_agent
+    @uname ||= get_uname
+    lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
+
+    {
+      :bindings_version => Conekta::VERSION,
+      :lang => 'ruby',
+      :lang_version => lang_version,
+      :platform => RUBY_PLATFORM,
+      :publisher => 'conekta',
+      :uname => @uname
+    }
+
+  end
+
+  def self.get_uname
+    `uname -a 2>/dev/null`.strip if RUBY_PLATFORM =~ /linux|darwin/i
+  rescue Errno::ENOMEM => ex # couldn't create subprocess
+    "uname lookup failed"
+  end
+
+  def self.uri_encode(params)
+    Util.flatten_params(params).
+      map { |k,v| "#{k}=#{Util.url_encode(v)}" }.join('&')
+  end
+
+  def self.request_headers(api_key)
+    headers = {
+      :user_agent => "Conekta RubyBindings/#{Conekta::VERSION}",
+      :authorization => "Basic #{Base64.encode64(api_key+':')}"
+    }
+
+    if api_version
+      headers.update(:accept=>"application/vnd.conekta-v#{api_version}+json")
+    else
+      headers.update(:accept=>"application/vnd.conekta-v0.3.0+json")
+    end
+
+    begin
+      headers.update(:conekta_client_user_agent => Conekta::JSON.dump(user_agent))
+    rescue => e
+      headers.update(:conekta_client_raw_user_agent => user_agent.inspect,
+                     :error => "#{e} (#{e.class})")
+    end
+  end
+
+  def self.execute_request(opts)
+    RestClient::Request.execute(opts)
+  end
+
+  def self.parse(response)
+    begin
+      # Would use :symbolize_names => true, but apparently there is
+      # some library out there that makes symbolize_names not work.
+      response = Conekta::JSON.load(response.body)
+    rescue MultiJson::DecodeError
+      raise general_api_error(response.code, response.body)
+    end
+
+    Util.symbolize_names(response)
+  end
+
+  def self.general_api_error(rcode, rbody)
+    APIError.new("Invalid response object from API: #{rbody.inspect} " +
+                 "(HTTP response code was #{rcode})", rcode, rbody)
+  end
+
+  def self.handle_api_error(rcode, rbody)
+    begin
+      error_obj = Conekta::JSON.load(rbody)
+      error_obj = Util.symbolize_names(error_obj)
+      error = error_obj or raise ConektaError.new # escape from parsing
+
+    rescue MultiJson::DecodeError, ConektaError
+      raise general_api_error(rcode, rbody)
+    end
+
+    case rcode
+    when 400
+      raise malformed_request_error error, rcode, rbody, error_obj
+    when 401
+      raise authentication_error error, rcode, rbody, error_obj
+    when 402
+      raise card_error error, rcode, rbody, error_obj
+    when 404
+      raise resource_not_found_error error, rcode, rbody, error_obj
+    when 422
+      raise parameter_validation_error error, rcode, rbody, error_obj
+    else
+      raise api_error error, rcode, rbody, error_obj
+    end
+
+  end
+
+  def self.resource_not_found_error(error, rcode, rbody, error_obj)
+    ResourceNotFoundError.new(error[:message], error[:param], rcode,
+                            rbody, error_obj)
+  end
+
+  def self.malformed_request_error(error, rcode, rbody, error_obj)
+    MalformedRequestError.new(error[:message], error[:param], rcode,
+                            rbody, error_obj)
+  end
+
+  def self.parameter_validation_error(error, rcode, rbody, error_obj)
+    ParameterValidationError.new(error[:message], error[:param], rcode,
+                            rbody, error_obj)
+  end
+
+  def self.authentication_error(error, rcode, rbody, error_obj)
+    AuthenticationError.new(error[:message], rcode, rbody, error_obj)
+  end
+
+  def self.card_error(error, rcode, rbody, error_obj)
+    CardError.new(error[:message], error[:param], error[:code],
+                  rcode, rbody, error_obj)
+  end
+
+  def self.api_error(error, rcode, rbody, error_obj)
+    APIError.new(error[:message], rcode, rbody, error_obj)
+  end
+
+  def self.handle_restclient_error(e)
+    case e
+    when RestClient::ServerBrokeConnection, RestClient::RequestTimeout
+      message = "Could not connect to Conekta (#{@api_base}). " +
+        "Please check your internet connection and try again. " +
+        "If this problem persists, you should check Conekta's service status at " +
+        "https://twitter.com/conektastatus, or let us know at support@conekta.io."
+
+    when RestClient::SSLCertificateNotVerified
+      message = "Could not verify Conekta's SSL certificate. " +
+        "Please make sure that your network is not intercepting certificates. " +
+        "(Try going to https://api.conekta.io/ in your browser.) " +
+        "If this problem persists, let us know at support@conekta.io."
+
+    when SocketError
+      message = "Unexpected error communicating when trying to connect to Conekta. " +
+        "You may be seeing this message because your DNS is not working. " +
+        "To check, try running 'host conekta.io' from the command line."
+
+    else
+      message = "Unexpected error communicating with Conekta. " +
+        "If this problem persists, let us know at support@conekta.io."
+
+    end
+
+    raise APIConnectionError.new(message + "\n\n(Network error: #{e.message})")
+  end
+end