mambu 0.1.0

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem install bundler -v 1.10.3

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mambu.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 netguru.co
+
+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,96 @@
+# Mambu
+
+Wrapper for Mambu Cloud Banking Platform REST API
+
+https://developer.mambu.com/
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mambu'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mambu
+
+## Usage
+    # create api connection
+    connection = Mambu::Connection.new('username', 'password', 'tenant.sandbox')
+### API models
+##### #find_all
+    Mambu::LoanProduct.find_all(connection)
+    # or
+    connection.loan_product.find_all
+##### #find
+    Mambu::LoanProduct.find('product_id', connection)
+    # or
+    connection.loan_product.find('product_id')
+
+#### Implemented models:
+Mambu::LoanProduct https://developer.mambu.com/customer/portal/articles/1616164-loan-products-api
+
+
+## Development
+
+#### Gem development
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+#### Mambu::ApiModel
+Adding new api models is extremely easy. Model fields (accessors) are set dynamically based on json content. To add User model you have to:
+
+    # create user class (lib/mambu/user.rb) that inherits from Mambu::ApiModel
+
+    module Mambu
+      class User < ApiModel
+      end
+    end
+
+    # require this class in lib/mambu.rb
+    require 'mambu/user'
+
+Api endpoint is created from connection and model class name. For Mambu::User is is users. You can override this by setting class method api_uri
+
+    module Mambu
+      class User < ApiModel
+        def self.api_uri
+        'endpoint'
+      end
+      end
+    end
+
+You can also override accessor if you want to change how json data is converted into api model. For example:
+
+    module Mambu
+      class LoanProduct < ApiModel
+        attr_accessor :loan_fees
+
+        def loan_fees=(data)
+          @loan_fees = data.map { |hash_fee| Mambu::LoanFee.new(hash_fee) }
+        end
+      end
+    end
+
+#### Mambu::Response
+Every response is wrapped in Mambu::Response. This class converts json body to ruby hash with symbolized, snake_cased keys. It also reads mambu #error_code and #error_status from failed response body.
+
+#### Mambu::Error
+Mambu error has message, code and status. It can be generated from failed Mambu::Response by calling #error method. Message is humanized mambu error status.
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/netguru/mambu-api-ruby.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "mambu"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/circle.yml

@@ -0,0 +1,8 @@
+dependencies:
+  pre:
+    - gem install bundler --pre
+deployment:
+  master:
+    branch: master
+    commands:
+      - curl -L https://raw.githubusercontent.com/netguru/review/master/check.rb | ruby

data/lib/mambu.rb

@@ -0,0 +1,22 @@
+require "active_support/all"
+require "faraday"
+require "json"
+require "mambu/version"
+require "mambu/finders"
+require "mambu/error"
+require "mambu/response"
+require "mambu/connection"
+require "mambu/api_model"
+require "mambu/loan_product"
+require "mambu/loan_fee"
+require "mambu/loan_schedule"
+require "mambu/repayment"
+begin
+  require "pry"
+rescue LoadError
+end
+
+
+module Mambu
+  # Your code goes here...
+end

data/lib/mambu/api_model.rb

@@ -0,0 +1,18 @@
+module Mambu
+  class ApiModel
+    def initialize(data)
+      data.each do |method_name, value|
+        self.class.send(:attr_accessor, method_name) unless self.class.method_defined?(method_name)
+        send("#{method_name}=", value)
+      end
+    end
+
+    def self.endpoint(connection)
+      "#{connection.api_url}/#{api_uri}"
+    end
+
+    def self.api_uri
+      name.demodulize.downcase.pluralize
+    end
+  end
+end

data/lib/mambu/connection.rb

@@ -0,0 +1,44 @@
+module Mambu
+  class Connection
+    def initialize(username, password, tenant)
+      @username = username
+      @password = password
+      @tenant = tenant
+      fail Mambu::Error, 'Insufficient credentials' unless valid?
+    end
+
+    def get(url, options = {})
+      request(:get, url, options)
+    end
+
+    def post(url, options = {})
+      request(:post, url, options)
+    end
+
+    def request(method, url, options)
+      Mambu::Response.new(connection.send(method, url, options))
+    end
+
+    def connection
+      conn = Faraday.new
+      conn.basic_auth(@username, @password)
+      conn
+    end
+
+    def api_url
+      "https://#{@tenant}.mambu.com/api"
+    end
+
+    def valid?
+      @username.present? && @password.present? && @tenant.present?
+    end
+
+    def loan_product(id)
+      Mambu::LoanProduct.find(id, self)
+    end
+
+    def loan_products
+      Mambu::LoanProduct.find_all(self)
+    end
+  end
+end

data/lib/mambu/error.rb

@@ -0,0 +1,11 @@
+module Mambu
+  class Error < StandardError
+    attr_reader :code, :status
+
+    def initialize(message, code = nil, status = nil)
+      super(message)
+      @code = code
+      @status = status
+    end
+  end
+end

data/lib/mambu/finders.rb

@@ -0,0 +1,15 @@
+module Mambu
+  module Finders
+    def find(id, connection)
+      response = connection.get("#{endpoint(connection)}/#{id}")
+      fail response.error unless response.success?
+      new(response.body)
+    end
+
+    def find_all(connection)
+      response = connection.get(endpoint(connection))
+      fail response.error unless response.success?
+      response.body.map { |data| new(data) }
+    end
+  end
+end

data/lib/mambu/loan_fee.rb

@@ -0,0 +1,4 @@
+module Mambu
+  class LoanFee < ApiModel
+  end
+end

data/lib/mambu/loan_product.rb

@@ -0,0 +1,10 @@
+module Mambu
+  class LoanProduct < ApiModel
+    extend Mambu::Finders
+    attr_accessor :loan_fees
+
+    def loan_fees=(data)
+      @loan_fees = data.map { |hash_fee| Mambu::LoanFee.new(hash_fee) }
+    end
+  end
+end

data/lib/mambu/loan_schedule.rb

@@ -0,0 +1,37 @@
+module Mambu
+  class LoanSchedule < ApiModel
+    attr_accessor :repayments
+
+    def repayments=(data)
+      @repayments = data.map { |hash_fee| Mambu::Repayment.new(hash_fee) }
+    end
+
+    def self.find(loan_product, options, connection)
+      response = connection.get(
+        "#{endpoint(connection)}/#{loan_product.id}/schedule",
+        camelize_hash(options)
+      )
+      handle_error(response)
+      new(response.body)
+    end
+
+    def self.api_uri
+      Mambu::LoanProduct.api_uri
+    end
+
+    def self.handle_error(response)
+      return if response.success?
+      error = response.error
+      if error.status == 'INTERNAL_SERVER_ERROR'
+        error = Mambu::Error.new(
+          'Known mambu issue. Please grant administrator permissions to api user.'
+        )
+      end
+      fail error
+    end
+
+    def self.camelize_hash(options)
+      Hash[options.map { |k, v| [k.to_s.camelize(:lower).to_sym, v] }]
+    end
+  end
+end

data/lib/mambu/repayment.rb

@@ -0,0 +1,4 @@
+module Mambu
+  class Repayment < ApiModel
+  end
+end

data/lib/mambu/response.rb

@@ -0,0 +1,52 @@
+module Mambu
+  class Response
+    attr_reader :http_status, :body, :faraday_response, :error_code, :error_status
+
+    def initialize(faraday_response)
+      @faraday_response = faraday_response
+      @http_status = faraday_response.status
+      @body = parse_body(faraday_response.body)
+      return self if success?
+      @error_code = @body[:return_code]
+      @error_status = @body[:return_status]
+    end
+
+    def success?
+      @faraday_response.success?
+    end
+
+    def error?
+      !success?
+    end
+
+    def error_message
+      error_status.humanize
+    end
+
+    def error
+      return nil if success?
+      Mambu::Error.new(error_message, error_code, error_status)
+    end
+
+    private
+
+    def parse_body(json_body)
+      begin
+        convert_hash_keys(JSON.parse(json_body))
+      rescue JSON::ParserError
+        { return_code: -1, return_status: 'INTERNAL_SERVER_ERROR' }
+      end
+    end
+
+    def convert_hash_keys(value)
+      case value
+      when Array
+        value.map(&method(:convert_hash_keys))
+      when Hash
+        Hash[value.map { |k, v| [k.to_s.underscore.to_sym, convert_hash_keys(v)] }]
+      else
+        value
+      end
+    end
+  end
+end

data/lib/mambu/version.rb

@@ -0,0 +1,3 @@
+module Mambu
+  VERSION = "0.1.0"
+end

data/mambu.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mambu/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mambu"
+  spec.version       = Mambu::VERSION
+  spec.authors       = ["Netguru"]
+  spec.email         = ["netguru@netguru.co"]
+
+  spec.summary       = "mambu.com REST API wrapper"
+  spec.description   = "mambu.com REST API wrapper"
+  spec.homepage      = "http://github.com/netguru/mambu-api-ruby"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "awesome_print"
+  spec.add_development_dependency "pry"
+
+  spec.add_dependency "activesupport"
+  spec.add_dependency "faraday"
+end