Initial commit.

Author: Juan Rossi

.gems

@@ -0,0 +1,3 @@
+rest-client -v 1.7.2
+cutest -v 1.2.2
+mocha -v 1.1.0

.gitignore

@@ -0,0 +1,3 @@
+.env
+/.gs
+mango-*.gem

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Mango Payments Inc.
+
+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.

README.md

@@ -0,0 +1,81 @@
+Mango
+=====
+
+Ruby wrapper for Mango API
+
+
+## Description
+
+API to interact with Mango
+https://getmango.com/
+
+
+## Installation
+
+As usual, you can install it using rubygems.
+
+```
+$ gem build mango-ruby.gemspec
+```
+
+```
+$ gem install ./mango-ruby-0.0.1.gem
+```
+
+Note: We'll be uploading the gem to [RubyGems](https://rubygems.org) in the next couple of days.
+
+
+## Usage
+
+```
+require 'mango-ruby'
+
+Mango.api_key = ENV['MANGO_SECRET_KEY']
+
+params = {
+  email: "[email protected]",
+  name: "John Doe"
+}
+
+begin
+  customer = Mango::Customer.create params
+rescue Mango::Error => e
+  e.each {|code, message| ... }
+end
+```
+
+You can set a global API_KEY (`Mango.api_key`) or override it on each request
+
+
+## API
+
+All the requests go through:
+```
+Mango.request(method, url, api_key=nil, params={}, headers={})
+```
+
+But you can use CRUD methods on `Mango::Card`, `Mango::Customer`...
+```
+def create params={}, api_key=nil
+def list params={}, api_key=nil
+def retrieve uid, params={}, api_key=nil
+def delete uid, params={}, api_key=nil
+def update uid, params={}, api_key=nil
+```
+
+So this two are equivalent:
+```
+customer = Mango::Customer.create params
+customer = Mango.request :post, '/customers/', api_key, params
+```
+
+This are the operations available for each resource:
+
+|Resource|list|create|retrieve|update|delete|delete_all|
+|-|:-:|:-:|:-:|:-:|:-:|:-:|
+|Card         | x | x | x | x | x |   |
+|Charge       | x | x | x |   |   |   |
+|Customer     | x | x | x | x | x |   |
+|Installment  |   |   | x |   |   |   |
+|Queue        | x | x | x |   | x | x |
+|Refund       | x | x | x |   |   |   |

bin/mango

@@ -0,0 +1 @@
+#!/usr/bin/env ruby

lib/mango-ruby.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + '/mango'

lib/mango.rb

@@ -0,0 +1,71 @@
+require 'rest_client'
+require 'json'
+require_relative 'mango/resources'
+
+module Mango
+
+  class Error < StandardError
+    include Enumerable
+    attr_accessor :errors
+
+    def initialize message, errors={}
+      super message
+      @errors = errors
+    end
+
+    # Yield [error_code, message] pairs
+    def each
+      @errors.each { |e| yield *e.first }
+    end
+  end
+
+  @api_base = 'https://api.getmango.com/v1'
+
+  class << self
+    attr_accessor :api_key, :api_base
+  end
+
+  def self.request(method, url, api_key=nil, params={}, headers={})
+    method = method.to_sym
+
+    url = @api_base + url
+
+    unless api_key ||= @api_key
+      raise Error.new('No API key provided')
+    end
+
+    payload = JSON.generate(params) if method == :post || method == :patch
+
+    headers = {
+      :content_type => 'application/json'
+    }.merge(headers)
+
+    options = {
+      :headers => headers,
+      :user => api_key,
+      :method => method,
+      :url => url,
+      :payload => payload
+    }
+
+    begin
+      response = execute_request(options)
+      return {} if response.code == 204 and method == :delete
+      JSON.parse(response.body, :symbolize_names => true)
+    rescue RestClient::Exception => e
+      handle_errors e
+    end
+  end
+
+  private
+
+  def self.execute_request(options)
+    RestClient::Request.execute(options)
+  end
+
+  def self.handle_errors exception
+    body = JSON.parse exception.http_body
+    raise Error.new(exception.to_s, body['errors'])
+  end
+
+end

lib/mango/operations.rb

@@ -0,0 +1,44 @@
+module Mango
+  module Operations
+    module ClassMethods
+
+      private
+
+      def create params={}, api_key=nil
+        Mango.request :post, url, api_key, params
+      end
+
+      def list params={}, api_key=nil
+        Mango.request :get, url, api_key, params
+      end
+
+      def retrieve uid, params={}, api_key=nil
+        require_uid uid
+        Mango.request :get, url(uid), api_key, params
+      end
+
+      def update uid, params={}, api_key=nil
+        require_uid uid
+        Mango.request :patch, url(uid), api_key, params
+      end
+
+      def delete uid, params={}, api_key=nil
+        require_uid uid
+        Mango.request :delete, url(uid), api_key, params
+      end
+
+      def delete_all params={}, api_key=nil
+        Mango.request :delete, url, api_key, params
+      end
+
+      def require_uid uid
+        raise Error.new('UID is required') if uid.nil? || uid == ''
+      end
+
+    end
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+  end
+end

lib/mango/resources.rb

@@ -0,0 +1,37 @@
+require_relative 'operations'
+
+module Mango
+  class Resource
+    include Operations
+
+    def self.url id=nil
+      resource_name = self.name.split('::').last.downcase
+      id ? "/#{resource_name}/#{id}/" : "/#{resource_name}/"
+    end
+  end
+
+  class Customers < Resource
+    public_class_method :create, :retrieve, :list, :update, :delete
+  end
+
+  class Charges < Resource
+    public_class_method :create, :retrieve, :list
+  end
+
+  class Refunds < Resource
+    public_class_method :create, :retrieve, :list
+  end
+
+  class Cards < Resource
+    public_class_method :create, :retrieve, :list, :update, :delete
+  end
+
+  class Queue < Resource
+    public_class_method :create, :retrieve, :list, :delete, :delete_all
+  end
+
+  class Installments < Resource
+    public_class_method :retrieve
+  end
+
+end

mango-ruby.gemspec

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+Gem::Specification.new do |s|
+  s.name              = "mango-ruby"
+  s.version           = "0.0.1"
+  s.summary           = "Ruby wrapper for Mango API"
+  s.description       = "API to interact with Mango\nhttps://getmango.com/"
+  s.authors           = ["Joaquín Vicente"]
+  s.email             = ["[email protected]"]
+  s.homepage          = "https://getmango.com/"
+  s.files             = []
+
+  s.license           = "MIT"
+  s.executables.push("mango")
+  s.add_dependency('rest-client', '~> 1.7')
+  s.add_development_dependency('cutest', '~> 1.2')
+  s.add_development_dependency('mocha', '~> 1.1')
+
+  s.files = %w{
+    bin/mango
+    lib/mango.rb
+    lib/mango-ruby.rb
+    lib/mango/resources.rb
+    lib/mango/operations.rb
+  }
+
+  s.test_files = %w{
+    test/mango_test.rb
+    test/test_helper.rb
+  }
+
+end