banker 0.0.3

data/lib/banker/credit_expert_uk.rb

@@ -0,0 +1,112 @@
+module Banker
+  # This class allows the retrieval of credit score data
+  # for Credit Expert UK
+  #
+  # == Examples
+  #
+  # Get Score from Credit Expert UK
+  #
+  #     site = Banker::CreditExpertUK.new(:username => "joe",
+  #     :password => '123456',
+  #     :memorable_word => 'superduper')
+  #
+  #     site.score #=> 800
+  #
+  class CreditExpertUK
+    attr_accessor :username, :password, :memorable_word, :agent, :score
+
+    LOGIN_ENDPOINT = "https://www.creditexpert.co.uk/MCCLogin.aspx"
+
+    FIELDS = {
+      username: 'loginUser:txtUsername:ECDTextBox',
+      password: 'loginUser:txtPassword:ECDTextBox',
+      questions: [
+        'label span#loginUserMemorableWord_SecurityQuestionLetter1',
+        'label span#loginUserMemorableWord_SecurityQuestionLetter2'
+      ],
+      answers: [
+        'loginUserMemorableWord:SecurityQuestionUK1_SecurityAnswer1_ECDTextBox',
+        'loginUserMemorableWord:SecurityQuestionUK1_SecurityAnswer2_ECDTextBox'
+      ],
+      score: 'span#MCC_ScoreIntelligence_ScoreIntelligence_Dial1_MyScoreV31_pnlMyScore1_lblMyScore'
+    }
+
+    def initialize(args)
+      @username = args[:username]
+      @password = args[:password]
+      @memorable_word = args[:memorable_word]
+
+      @agent = Mechanize.new
+      @agent.log = Logger.new 'mech.log'
+      @agent.user_agent = 'Mozilla/5.0 (Banker)'
+
+      authenticate
+    end
+
+    private
+
+    def authenticate
+      @score = data
+=begin
+      page = @agent.get(LOGIN_ENDPOINT)
+
+      form = page.form_with(:action => 'MCCLogin.aspx')
+
+      form[FIELDS[:username]] = @username
+      form[FIELDS[:password]] = @password
+
+
+      page = @agent.submit(form, form.buttons.first)
+
+      form = page.form_with(:name => 'MasterPage')
+
+      first_letter = page.at(FIELDS[:questions][0]).content.scan(/\d+/).first.to_i
+      second_letter = page.at(FIELDS[:questions][1]).content.scan(/\d+/).first.to_i
+
+      form[FIELDS[:answers][0]] = get_letter(first_letter)
+
+      form[FIELDS[:answers][1]] = get_letter(second_letter)
+
+      page = @agent.submit(form, form.buttons.first)
+
+      @score = page.at(FIELDS[:score]).content.to_i
+=end
+    end
+
+    def start
+      page = @agent.get(LOGIN_ENDPOINT)
+
+      form = page.form_with(:action => 'MCCLogin.aspx')
+
+      form[FIELDS[:username]] = @username
+      form[FIELDS[:password]] = @password
+
+      @agent.submit(form, form.buttons.first)
+    end
+
+    def step1
+      page = start
+      form = page.form_with(name: 'MasterPage')
+
+      first_letter = extract_digit(page.at(FIELDS[:questions][0]).content)
+      second_letter = extract_digit(page.at(FIELDS[:questions][1]).content)
+
+      form[FIELDS[:answers][0]] = get_letter(first_letter)
+      form[FIELDS[:answers][1]] = get_letter(second_letter)
+
+      @agent.submit(form, form.buttons.first)
+    end
+
+    def data
+      step1.at(FIELDS[:score]).content.to_i
+    end
+
+    def extract_digit(content)
+      content.scan(/\d+/).first.to_i
+    end
+
+    def get_letter(index)
+      @memorable_word[index-1]
+    end
+  end
+end

data/lib/banker/error.rb

@@ -0,0 +1,5 @@
+module Banker
+  module Error
+    class InvalidParams < ArgumentError;end
+  end
+end

data/lib/banker/lloyds_tsb_uk.rb

@@ -0,0 +1,130 @@
+module Banker
+  # This class allows the data retrieval of accounts for Lloyds TSB UK
+  #
+  # == Examples
+  #
+  # Retrieve Account Balance
+  #
+  #     user_params = { username: 'Joe', password: 'password', memorable_word: 'superduper' }
+  #     lloyds = Banker::LloydsTSBUK.new(user_params)
+  #     lloyds.balance
+  #     # => [ {:current_account => { :balance => 160940,
+  #                                   :details => { :sort_code => "928277",
+  #                                                 :account_number => "92837592" }}},
+  #
+  #            {:savings_account => { :balance => 0.0,
+  #                                   :details => { :sort_code => "918260",
+  #                                                 :account_number=>"91850261" }}},
+  #
+  #            {:lloyds_tsb_platinum_mastercard => { :balance => 0.0,
+  #                                                  :details => { :card_number => "9284710274618391" }}}
+  #          ]
+  #
+  class LloydsTSBUK
+    attr_accessor :username, :password, :memorable_word, :balance, :agent
+
+    LOGIN_ENDPOINT = "https://online.lloydstsb.co.uk/personal/logon/login.jsp"
+
+    def initialize(args)
+      @username = args[:username]
+      @password = args[:password]
+      @memorable_word = args[:memorable_word]
+
+      @agent = Mechanize.new
+      @agent.log = Logger.new 'mech.log'
+      @agent.user_agent = 'Mozilla/5.0 (Banker)'
+      @agent.force_default_encoding = 'utf8'
+
+      @balance = authenticate
+    end
+
+    def get_memorable_word_letter(letter)
+      @memorable_word.to_s[letter.to_i - 1]
+    end
+
+    def cleaner(str)
+      str.gsub(/[^\d+]/, '')
+    end
+
+  private
+
+    def authenticate
+      page = @agent.get(LOGIN_ENDPOINT)
+
+      # Login Page
+      page = page.form('frmLogin') do |f|
+        f.fields[0].value = @username
+        f.fields[1].value = @password
+      end.click_button
+
+      # Memorable Word
+      form = page.form('frmentermemorableinformation1')
+      memorable_set(page, form)
+      page = @agent.submit(form, form.buttons.first)
+
+      # Accounts Page
+      return account_return(page)
+    end
+
+    def memorable_letters(page)
+      {
+        first: memorable_required(page)[0],
+        second: memorable_required(page)[1],
+        third: memorable_required(page)[2]
+      }
+    end
+
+    def memorable_set(page, form)
+      letters = memorable_letters(page)
+
+      form.fields[2].value = ' ' + get_memorable_word_letter(letters.fetch(:first))
+      form.fields[3].value = ' ' + get_memorable_word_letter(letters.fetch(:second))
+      form.fields[4].value = ' ' + get_memorable_word_letter(letters.fetch(:third))
+    end
+
+    def memorable_required(page)
+      page.labels.collect { |char| cleaner(char.to_s) }
+    end
+
+    def account_name(page)
+      page.search('div.accountDetails h2').collect {|a| a.content.downcase.gsub(/\s/, '_').to_sym }
+    end
+
+    def account_detail(page)
+      page.search('div.accountDetails p.numbers').collect {|n| n.content }
+    end
+
+    def account_balance(page)
+      page.search('div.balanceActionsWrapper p.balance').collect {|b| b.content }
+    end
+
+    def formatted_detail(page)
+      resp = account_detail(page).map { |detail| detail.split(',').map { |d| cleaner(d) } }
+      resp.map! do |r|
+        if r.length == 2
+          { sort_code: r[0], account_number: r[1] }
+        elsif r.length == 1
+          { card_number: r[0] }
+        else
+          STDERR.puts "[Error] It seems we got account details that we did not expect! - #{r.inspect}"
+        end
+      end
+    end
+
+    def formatted_balance(page)
+      account_balance(page).map do |b|
+        resp = cleaner(b)
+        resp.empty? ? 0.00 : resp.to_i
+      end
+    end
+
+    def account_return(page)
+      resp = []
+      account_name(page).zip(formatted_balance(page), formatted_detail(page)).each_with_index do |acc, index|
+        resp << { acc[0] => { balance: acc[1], details: acc[2] } }
+      end
+      resp
+    end
+
+  end
+end

data/lib/banker/version.rb

@@ -0,0 +1,3 @@
+module Banker
+  VERSION = "0.0.3"
+end

data/spec/banker/account_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Banker::Account do
+  let(:attr){{
+    name:'',
+    uid:'',
+    amount:'',
+    limit:''
+  }}
+  subject {Banker::Account}
+
+  it {subject.new(attr).should respond_to(:name)}
+  it {subject.new(attr).should respond_to(:uid)}
+  it {subject.new(attr).should respond_to(:amount)}
+  it {subject.new(attr).should respond_to(:limit)}
+
+  it "validates presence of name" do
+    expect{
+      subject.new
+    }.to raise_error(ArgumentError, "missing attribute `name`")
+  end
+  it "validates presence of uid" do
+    expect{
+      subject.new(name:'')
+    }.to raise_error(ArgumentError, "missing attribute `uid`")
+  end
+  it "validates presence of amount" do
+    expect{
+      subject.new(name:'',uid:'')
+    }.to raise_error(ArgumentError, "missing attribute `amount`")
+  end
+end

data/spec/banker/barclaycard_uk_spec.rb

@@ -0,0 +1,167 @@
+require 'spec_helper'
+
+describe Banker::BarclaycardUK do
+  let(:support_files) {File.expand_path('../../support/barclaycard_uk/',__FILE__)}
+
+  LOGIN_ENDPOINT = 'https://bcol.barclaycard.co.uk/ecom/as2/initialLogon.do'
+  EXPORT_ENDPOINT = 'https://bcol.barclaycard.co.uk/ecom/as2/export.do?doAction=processRecentExportTransaction&type=OFX_2_0_2&statementDate=&sortBy=transactionDate&sortType=Dsc'
+
+  let(:mechanize) {mock('mechanize').as_null_object}
+  let(:node) {mock('node').as_null_object}
+  let(:form) {mock('form').as_null_object}
+  let(:button) {mock('button').as_null_object}
+  let(:ofx) {
+    f = File.open(File.expand_path('data.ofx',support_files), 'r:iso-8859-1')
+    f.read
+  }
+
+  subject { Banker::BarclaycardUK }
+
+  before do
+    subject.any_instance.stub(:params)
+    subject.any_instance.stub(:authenticate!)
+    subject.any_instance.stub(:get_data)
+  end
+
+  it {subject.new.should respond_to(:accounts)}
+
+  context "Parameters" do
+    before do
+      subject.any_instance.unstub(:params)
+    end
+
+    it "raises InvalidParams when username is missing" do
+      expect{
+        subject.new
+      }.to raise_error(Banker::Error::InvalidParams,
+                       "missing parameters `username` `password` `memorable_word` ")
+    end
+
+    it "raises InvalidParams when password is missing" do
+      expect{
+        subject.new(username: "joe")
+      }.to raise_error(Banker::Error::InvalidParams,
+                       "missing parameters `password` `memorable_word` ")
+    end
+
+    it "raises InvalidParams when memorable_word is missing" do
+      expect{
+        subject.new(username: "joe", password: "123456")
+      }.to raise_error(Banker::Error::InvalidParams,
+                       "missing parameters `memorable_word` ")
+
+    end
+
+    it "accepts username, password and memorable_word" do
+      expect{
+
+        subject.new(username: "joe", password: "123456",
+                    memorable_word: "superduper")
+      }.to_not raise_error
+    end
+  end
+
+  context "calls" do
+    it "calls params" do
+      subject.any_instance.should_receive(:params)
+      subject.new
+    end
+    it "calls authenticate!" do
+      subject.any_instance.should_receive(:authenticate!)
+      subject.new
+    end
+    it "calls get_data" do
+      subject.any_instance.should_receive(:get_data)
+      subject.new
+    end
+  end
+
+  context "private" do
+    before do
+      Mechanize.stub(:new).and_return(mechanize)
+      mechanize.stub(:get).and_return(mechanize)
+      mechanize.stub(:form_with).and_return(form)
+      mechanize.stub(:at).and_return(node)
+      mechanize.stub(:submit).and_return(mechanize)
+    end
+
+    describe "#authenticate!" do
+      before do
+        subject.any_instance.unstub(:authenticate!)
+        subject.any_instance.stub(:get_letter).and_return("A")
+      end
+      it "gets #{LOGIN_ENDPOINT}" do
+        mechanize.should_receive(:get).
+          with("https://bcol.barclaycard.co.uk/ecom/as2/initialLogon.do").
+          and_return(mechanize)
+        subject.new
+      end
+      it "finds by form action" do
+        mechanize.should_receive(:form_with).
+          with(action: "/ecom/as2/initialLogon.do").
+          and_return(form)
+        subject.new
+      end
+      it "fills in form inputs" do
+        mechanize.should_receive(:at).
+          with("label[for='lettera']").
+          and_return(node)
+
+        mechanize.should_receive(:at).
+          with("label[for='letterb']").
+          and_return(node)
+
+
+        node.should_receive(:content).
+          at_least(:twice).
+          and_return("1")
+
+        subject.any_instance.unstub(:get_letter)
+
+        form.should_receive(:[]=).with("username", "joe")
+        form.should_receive(:[]=).with("password", "123456")
+        form.should_receive(:[]=).with("firstAnswer", "S")
+        form.should_receive(:[]=).with("secondAnswer", "S")
+
+
+        subject.new(username: "joe", password: "123456",
+                    memorable_word: "superduper")
+      end
+
+      it "submits form" do
+        form.should_receive(:buttons).
+          twice.
+          and_return([button])
+        mechanize.should_receive(:submit).
+          with(form,button)
+        subject.new
+      end
+
+      it "parses html for account limit" do
+        mechanize.should_receive(:at).
+          with(".panelSummary .limit .figure").
+          and_return(node)
+        subject.new
+      end
+
+    end
+
+    describe "#get_data" do
+      before do
+        subject.any_instance.unstub(:get_data)
+        mechanize.stub(get: stub(body: ofx))
+      end
+
+      it "gets #{EXPORT_ENDPOINT}" do
+         mechanize.should_receive(:get).
+          with(EXPORT_ENDPOINT).
+          and_return(stub(body: ofx))
+        subject.new
+      end
+      it "finds account balance" do
+
+      end
+      it "finds account limit"
+    end
+  end
+end