musoni_ruby 0.0.01

data/lib/musoni_ruby/endpoints/savings_account.rb

@@ -0,0 +1,77 @@
+module Musoni
+	class SavingsAccount < Musoni::Endpoint
+		attr_writer :transactions, :payable_items
+		
+		class << self
+
+			# Musoni::SavingsAccount.all()
+			def all(offset:1,limit:100)
+				url = "/savingsaccounts"
+				Musoni::Fetch.get(url,query:{offset:offset,limit:limit}).pageItems
+			end
+
+			# Musoni::SavingsAccount.find(savingsaccount_id)
+			def find(savingsaccount_id,fetch:true)
+				url = "/savingsaccounts/#{savingsaccount_id}?associations=all"
+				response = Musoni::Fetch.get(url) if fetch
+				savingsaccount = new(id:savingsaccount_id,response:response)
+			end
+
+			# account_attributes =  {:clientId=>"1",:productId=>"1",:submittedOnDate=>"13-05-2015",:fieldOfficerId=>"1",:charges=>[],:allowOverdraft=>false}
+			# Musoni::SavingsAccount.create(account_attributes)
+			def create(options={})
+				url = "/savingsaccounts"
+				response = Musoni::Fetch.post(url,options)
+				new(options.merge!(id:response.savingsId ,response:response)) rescue response
+			end	
+
+		end
+
+		# # date = {:approvedOnDate=>"13-05-2015"}
+		# # account.activate(date)
+		%w{approve activate}.each do |m|
+			define_method m do |options={}|
+				options[:"#{m}dOnDate"] ||= Time.now.strftime("%d-%m-%Y") 
+				url = "/savingsaccounts/#{self.id}?command=#{m}"
+				response = Musoni::Fetch.post(url,options)
+				new(options.merge!(id:response.savingsId ,response:response)) rescue response
+			end
+		end
+
+		# transaction = {:transactionDate=>"15-05-2015",:transactionAmount=>"100",:receiptNumber=>"ABC",:paymentTypeId=>"177"}
+		# # account.activate(date)
+		%w{deposit withdrawal}.each do |m|
+			define_method m do |options={}|
+				options[:transactionDate] ||= Time.now.strftime("%d-%m-%Y") 
+				url = "/savingsaccounts/#{self.id}/transactions?command=#{m}"
+				response = Musoni::Fetch.post(url,options)
+				new(options.merge!(id:response.savingsId ,response:response)) rescue response
+			end
+		end
+		
+		# # savingsaccount.update(name:new_name)
+		# def update(options)
+		# 	url = "/savingsaccounts/#{self.id}"
+		# 	response = Musoni::Fetch.put(url,options)
+		# 	self.response = response
+		# end
+
+
+		# # Musoni::SavingsAccount.find(26, fetch:false).transactions(offset:1,limit:100)
+		# def transactions(offset:1,limit:100)
+		# 	find_all(offset:offset,limit:limit)
+		# end
+
+		# # Musoni::SavingsAccount.find(26, fetch:false).payable_items(offset:1,limit:100)
+		# def payable_items(offset:1,limit:100)
+		# 	find_all(offset:offset,limit:limit)
+		# end
+
+		protected
+
+		def after_initialize
+	    @endpoint = 'savingsaccounts'
+		end
+
+	end
+end

data/lib/musoni_ruby/fetch.rb

@@ -0,0 +1,53 @@
+module Musoni
+	class Fetch
+		include HTTParty
+
+		base_uri "https://demo.musonisystem.com:8443/api/v1"
+    parser proc {|data| Hashie::Mash.new(response: (JSON.parse(data) rescue {data:data}.to_json)  ).response}
+    format :json
+    headers 
+
+		class << self
+			def headers
+				Musoni.configuration.header.merge!(super)
+			end
+
+			%w(get put post delete).each do |m|
+				define_method m do |path, options={}, &block|
+					# body = date_parameters(options).merge!(options)
+					options = {body: date_parameters(options).merge!(options).to_json}
+
+					res = perform_request Net::HTTP::Put, path, options, &block if m == 'put'
+					res = perform_request Net::HTTP::Get, path, options, &block if m == 'get'
+					res = perform_request Net::HTTP::Post, path, options, &block if m == 'post'
+					res = perform_request Net::HTTP::Delete, path, options, &block if m == 'delete'
+					save_json(res) if load_json?
+					res
+				end
+			end
+
+			def save_json(response)
+				request_method = response.request.http_method.name.split('::').last.upcase
+				file_path = response.request.path.to_s
+				slash,model,*file_name = file_path.split('?')[0].split(/\/|\?/)
+				file_location = "lib/musoni_ruby/support/fake_musoni/#{model}/#{request_method}_#{file_name.join('_')}.json"
+				File.write(file_location, response.body)
+			end
+
+			def load_json?
+				# load JSON if WebMock is off while testing and only in local env with load musoni turned on
+				defined?(WebMock).nil? and ENV['CI_TEST'].nil? and defined?(Minitest) and ENV['LOAD_MUSONI'] == "true"
+			end
+
+			def date_parameters(options)
+				# bp
+				if options.map{|k,v| k.to_s }.grep(/Date/).any?
+					{dateFormat:"dd-MM-yyyy", locale:"en_GB"}
+				else
+					{}
+				end
+			end
+		end
+
+	end
+end

data/lib/musoni_ruby/support/fake_musoni.rb

@@ -0,0 +1,25 @@
+require 'sinatra/base'
+require 'tilt/erb'
+
+class FakeMusoni < Sinatra::Base
+
+  [ :get, :post, :put, :delete ].each do |method|
+    send method, /.*/ do 
+    #   if (request.env['HTTP_X_WSSE'].empty? rescue true)
+    #     [200, {}, [{base:["Authentication Failed"]}.to_json]]
+    #   else
+        slash,api,v,model,*path = request.path_info.split('?')[0].split(/\/|\?/)
+        json_response 200, "#{model}/#{request.request_method}_#{path.join('_')}.json"
+      # end
+    end
+  end
+
+  private
+
+  def json_response(response_code, file_name)
+    content_type :json
+    status response_code
+    headers "content-type"=>["application/json; charset=utf-8"]
+    erb File.open(File.dirname(__FILE__) + '/fake_musoni/' + file_name, 'rb').read
+  end
+end

data/lib/musoni_ruby/support/test_helper.rb

@@ -0,0 +1,173 @@
+module Musoni::TestHelper
+	def create_musoni_client
+		client_attributes = {:officeId=>"2",
+			:firstname=> Faker::Name.first_name,
+			:staffId=>"1",
+			:lastname=> Faker::Name.last_name,
+			:middlename=> Faker::Name.first_name,
+			:externalId=>rand(100000),
+			:mobileNo=>"07234#{rand(10000)}",
+			:submittedOnDate=>"11-05-2015",
+			:active=>"true",
+			:activationDate=> Time.now.strftime("%d-%m-%Y")
+		}
+		@@musoni_client ||= Musoni::Client.create(client_attributes)
+	end
+
+	def create_musoni_loan
+		loan_options = {
+			:submittedOnDate=>"13-05-2015",
+			:clientId=>"3",
+			:productId=>"1",
+			:loanOfficerId=>"1",
+			:loanPurposeId=>"37",
+			:principal=>"10,000.00",
+			:loanTermFrequency=>"1",
+			:loanTermFrequencyType=>"2",
+			:numberOfRepayments=>"1",
+			:repaymentEvery=>"1",
+			:repaymentFrequencyType=>"2",
+			:transactionProcessingStrategyId=>"1",
+			:interestRatePerPeriod=>"5",
+			:expectedDisbursementDate=>"13-05-2015",
+			:amortizationType=>"1",
+			:interestType=>"1",
+			:interestCalculationPeriodType=>"1",
+			:inArrearsTolerance=>"0",
+			:interestChargedFromDate=>"13-05-2015",
+			:repaymentsStartingFromDate=>"13-06-2015",
+			:charges=>[],
+			:loanType=>"individual",
+			:linkAccountId=>"",
+			:graceOnPrincipalPayment=>"0",
+			:graceOnInterestCharged=>"0",
+			:graceOnInterestPayment=>"0",
+			:fundId=>"1",
+			:createStandingInstructionAtDisbursement=>false
+		}
+		@@musoni_loan ||= Musoni::Loan.create(loan_options)
+	end
+
+	def create_musoni_savings_account
+		account_options =  {
+			:clientId=>"1",
+			:productId=>"1",
+			:submittedOnDate=>"13-05-2015",
+			:fieldOfficerId=>"1",
+			:charges=>[],
+			:allowOverdraft=>false
+		}
+		@@musoni_savings_account ||= Musoni::SavingsAccount.create(account_options)
+	end
+
+	[
+		:ml_client_details, 
+		:cct_Borrower_Details, 
+		:cct_TransUnion, 
+		:cct_First_Access_Score
+	]
+
+
+	def create_client_datatable
+		client = create_musoni_client
+		datatable_attributes = {
+			:MaritalStatus_cv_maritalStatus=>"Single",
+			:dateOfBirth=> Faker::Date.backward(10000).strftime("%d-%m-%Y"),
+			:Email=> Faker::Internet.email,
+			# :Password=> Faker::Internet.password,
+			:Client_Type=>"Lender",
+			:dateFormat=>"DD-MM-YYYY",
+			:locale=>"en_GB"
+		}
+		@@musoni_client_datatable ||= Musoni::Datatable.create(:ml_client_details,client.id,datatable_attributes)
+	end
+
+	def create_borrower_datatable
+		client = create_musoni_client
+		datatable_attributes = {
+			:town=>"Nairobi",
+			:address=>"Waiyaki Way",
+			:MaritalStatus_cv_maritalStatus=>"Single",
+			:dateOfBirth=>"01-01-1900",
+			:state=>"state",
+			:E_mail_address=> Faker::Internet.email,
+			:Password=> Faker::Internet.password,
+			:Sector=>"Sector1",
+			:occupation=>"Something",
+			:children_present=>"yes",
+			:household_size=>"10",
+			:dependants_no=>"5",
+			:household_assets=>"None",
+			:monthly_expense_food=>"100",
+			:monthly_expense_housing=>"500",
+			:monthly_expense_school=>"150",
+			:monthly_expense_medical=>"200",
+			:monthly_expense_tranport=>"230",
+			:monthly_expense_health=>"320",
+			:business_ownership=>"Yes",
+			:business_experience=>"10",
+			:book_keeping=>"yes",
+			:monthly_reorder_level=>"10",
+			:current_inventory_level=>"10",
+			:active_savings_devices=>"m-shwari,something else,3rd option",
+			:savings_emergency=>"1001",
+			:savings_school=>"1001",
+			:savings_asset=>"100",
+			:savings_entertainment=>"200",
+			:savings_medical=>"400",
+			:savings_business=>"500",
+			:savings_other=>"100",
+			:credit_limit_mshwari=>"100000000",
+			:saving_frequency=>"None",
+			:remittance_amount=>"1000",
+			:remittance_location=>"Yaya",
+			:remittance_frequency=>"daily",
+			:mobile_use=>"yes",
+			:last_mmoney_out=>"today",
+			:last_mmoney_in=>"yesterday",
+			:phones_owned=>"10",
+			:language_use=>"English,Dutch",
+			:data_mpesa=>"Mledger BLOB",
+			:income_weekly=>10000,
+			:survey_id=>123,
+			:dateFormat=>"dd-MM-yyyy",
+			:locale=>"en_GB"
+		}
+		@@musoni_borrower_datatable ||= Musoni::Datatable.create(:cct_Borrower_Details,client.id,datatable_attributes)
+	end
+
+	def create_transunion_datatable
+		client = create_musoni_client
+		datatable_attributes =  {
+			:Credit_History=>"24",
+			:NPA_Accounts=>"1",
+			:NPA_Closed_Accounts=>"1",
+			:NPA_Open_Accounts=>"0",
+			:PA_Accounts=>"11",
+			:PA_Closed_Accounts=>"10",
+			:PA_Open_Accounts=>"1",
+			:Response_Statuscode=>"300",
+			:dateFormat=>"dd-MM-yyyy",
+			:locale=>"en_GB",
+			:submittedon_date=>"27-05-2015",
+			:submittedon_userid=>1
+		}
+		@@musoni_transunion_datatable ||= Musoni::Datatable.create(:cct_TransUnion,client.id,datatable_attributes)
+	end
+
+	def create_firstaccess_datatable
+		client = create_musoni_client
+		datatable_attributes = {
+			:Status=>"Approved",
+			:Risk_Bucket=>"Very Low",
+			:Loan_Size=>"10000",
+			:Interest_Rate=>"10.05",
+			:dateFormat=>"dd-MM-yyyy",
+			:locale=>"en_GB",
+			:submittedon_date=>"27-05-2015",
+			:submittedon_userid=>1
+		}
+		@@musoni_firstaccess_datatable ||= Musoni::Datatable.create(:cct_First_Access_Score,client.id,datatable_attributes)
+	end
+
+end

data/lib/musoni_ruby/version.rb

@@ -0,0 +1,3 @@
+module Musoni
+  VERSION = "0.0.01"
+end

data/lib/musoni_ruby.rb

@@ -0,0 +1,54 @@
+require "httparty"
+require "hashie"
+require "musoni_ruby/version"
+require "musoni_ruby/configuration"
+require "musoni_ruby/fetch"
+require "musoni_ruby/endpoints/_endpoint"
+require "musoni_ruby/endpoints/client"
+require "musoni_ruby/endpoints/datatable"
+require "musoni_ruby/endpoints/loan"
+require "musoni_ruby/endpoints/run_report"
+require "musoni_ruby/endpoints/savings_account"
+
+# begin
+#   require "pry"
+# 	require "pry-alias"
+# rescue LoadError
+# end
+
+module Musoni
+	class << self
+		attr_writer :configuration
+
+		def configuration
+			@configuration ||= Configuration.new
+		end
+
+		def reset
+			@configuration = Configuration.new
+		end
+
+		def setup
+			yield(configuration)
+		end
+
+		# Musoni.authenticate(user:'username',password:"98497927493")
+		def authenticate(user:nil,password:nil,tenant:nil)
+			# bp
+			url = "/authentication?username=#{user}&password=#{password}&tenantIdentifier=#{tenant}"
+			request = Musoni::Fetch.post(url)
+			if (request.authenticated rescue false)
+				@configuration = Configuration.new(tenant:tenant, token:request.base64EncodedAuthenticationKey)
+				# @configuration.tenant = tenant
+				# @configuration.token = request.base64EncodedAuthenticationKey
+				# Musoni.setup do |config|
+				# 	config.tenant = tenant
+				# 	config.token = request.base64EncodedAuthenticationKey
+				# end
+			end
+			request
+		end
+	end
+
+end
+

data/musoni_ruby.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'musoni_ruby/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "musoni_ruby"
+  spec.version       = Musoni::VERSION
+  spec.authors       = ["Kariuki Gathitu"]
+  spec.email         = ["kgathi2@gmail.com"]
+
+  spec.summary       = %q{Ruby Client for interfacing with Musoni systems API}
+  spec.description   = %q{Railsesque may to integrate with Musoni systems}
+  spec.homepage      = "https://bitbucket.org/kgathi2/musoni_ruby"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+  # else
+  #   raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  # end
+
+  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.required_ruby_version = '~> 2.0'
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "guard", "~> 2.12"
+  spec.add_development_dependency "minitest", "~> 5.6"
+  spec.add_development_dependency "guard-minitest", "~> 2.4"
+  spec.add_development_dependency "minitest-reporters", "~> 1.0"
+  spec.add_development_dependency "pry", "~> 0.10"
+  spec.add_development_dependency "pry-nav", "~> 0.2"
+  spec.add_development_dependency "pry-alias", "~> 0.0"
+  spec.add_development_dependency "coveralls", '~> 0.8'
+  spec.add_development_dependency "webmock", '~> 1.21'
+  spec.add_development_dependency "sinatra", '~> 1.4'
+  spec.add_development_dependency "faker", '~> 1.4'
+
+  spec.add_dependency 'httparty', "~> 0.13"
+  spec.add_dependency 'hashie', "~> 3.4"
+end