banker 0.0.3

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+kyle.rb
+chuck.rb
+coverage
+*.un~
+*.log

data/.rvmrc

@@ -0,0 +1,2 @@
+rvm use ruby-1.9.2@banker --create
+rvm use ruby-1.9.3@banker --create

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+script: rspec

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in banker.gemspec
+gemspec
+
+gem 'guard-rspec'
+gem "cane", "~> 1.1.0"

data/Guardfile

@@ -0,0 +1,10 @@
+guard 'rspec', :notification => true, :version => 2, :cli => "--colour", :run_all => {:cli => '--profile'} do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec/" }
+end
+
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2012 BritRuby LTD
+
+MIT License
+
+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,79 @@
+# Banker [![CI Build Status](https://secure.travis-ci.org/BritRuby/Banker.png?branch=master)][travis] [![Dependency Status](https://gemnasium.com/BritRuby/Banker.png?travis)][gemnasium]
+
+[travis]:http://travis-ci.org/BritRuby/Banker
+[gemnasium]:https://gemnasium.com/BritRuby/Banker
+
+A collection of strategies to access online bank accounts to obtain balance 
+and transaction details.
+
+## Supported Institutes
+
+* Barclay's Bank => Barclays
+* Barclaycard UK => BarclaycardUK
+* Capital One UK => CapitalOneUK
+* Lloyds TSB UK => LloydsTSBUK
+
+####Extras
+
+* Credit Expert UK => CreidtExpertUK
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'squeegee'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install squeegee
+
+## Example Usage
+
+
+
+	user_params = {
+		surname: "Bloggs",
+		username: "Bloggs123",
+		password: "password",
+		memorable_word: "superduper",
+		card_number: 4111111111111111,
+		date_of_birth: Date.parse('2012-01-01')
+	}
+
+Get the balance in pennies of the account.
+
+    # Barclays Bank
+    Banker::Barclays.new(user_params).accounts.first
+    # => <Banker::Account @name="Barclays Bank", @uid="cdd5f8e1c6e441fd9aac2786ca38c835", @amount=130000, @limit=-150000, @currency="GBP">
+
+
+Extra strategies
+
+    # Credit Expert UK
+    Banker::CreditExpertUK.new(user_params).score #=> 800
+
+
+## Dependancies
+
+* Mechanize
+* OFX
+
+## Alternate Languages
+
+* Python [Bank Scraper](https://github.com/MoneyToolkit/Bank-Scraper) from MoneyToolKit
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+This library is distributed under the MIT license.  Please see the [LICENSE](https://github.com/BritRuby/Banker/LICENSE.md) file.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/banker.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/banker/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors     = ['Kyle Welsby', 'Chuck Hardy']
+  gem.email       = ['app@britishruby.com']
+  gem.homepage    = 'https://github.com/BritRuby/Banker'
+  gem.description = %q{A collection of strategies to access online bank accounts to obtain balance and transaction details.}
+  gem.summary     = gem.description
+
+  gem.add_runtime_dependency 'mechanize'
+  gem.add_runtime_dependency 'ofx'
+
+  gem.add_development_dependency "gem-release"
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'webmock'
+  gem.add_development_dependency 'simplecov'
+
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.name          = "banker"
+  gem.require_paths = ['lib']
+  gem.version       = Banker::VERSION
+end

data/lib/banker.rb

@@ -0,0 +1,14 @@
+require 'ofx'
+require 'csv'
+require 'digest/md5'
+require 'mechanize'
+require 'logger'
+require 'banker/version'
+require 'banker/base'
+require 'banker/error'
+require 'banker/account'
+require 'banker/barclays'
+require 'banker/lloyds_tsb_uk'
+require 'banker/capital_one_uk'
+require 'banker/barclaycard_uk'
+require 'banker/credit_expert_uk'

data/lib/banker/account.rb

@@ -0,0 +1,16 @@
+module Banker
+  class Account
+    attr_accessor :name, :uid, :amount, :limit, :currency
+    def initialize(args = {})
+      raise Banker::Error::InvalidParams, "missing attribute `name`" unless args.has_key?(:name)
+      raise Banker::Error::InvalidParams, "missing attribute `uid`" unless args.has_key?(:uid)
+      raise Banker::Error::InvalidParams, "missing attribute `amount`" unless args.has_key?(:amount)
+
+      @name = args[:name]
+      @uid = args[:uid]
+      @amount = args[:amount]
+      @limit = args[:limit]
+      @currency = args[:currency]
+    end
+  end
+end

data/lib/banker/barclaycard_uk.rb

@@ -0,0 +1,96 @@
+module Banker
+  # This class allows the retrieval of account data
+  # for Barcalycard UK
+  #
+  # == Examples
+  #
+  # Get OFX from Barcalycard UK
+  #
+  #     bank = Banker::BarcalycardUK.new(:username => "joe"
+  #     :password => '123456',
+  #     :memorable_word => 'superduper')
+  #
+  #     bank.accounts.first.balance #=> 410010
+  #
+  class BarclaycardUK < Base
+    attr_accessor :username, :password, :memorable_word, :accounts, :page
+
+    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'
+    FIELDS = {
+      username: 'username',
+      password: 'password',
+      memorable_word: [
+        'firstAnswer',
+        'secondAnswer'
+      ]
+    }
+
+    def initialize(args = {})
+      @keys = [:username, :password, :memorable_word]
+      params(args)
+      @username = args[:username]
+      @password = args[:password]
+      @memorable_word = args[:memorable_word]
+
+      @accounts = []
+
+      authenticate!
+
+      get_data
+    end
+    private
+
+    def authenticate!
+      page = get(LOGIN_ENDPOINT)
+      form = page.form_with(:action => '/ecom/as2/initialLogon.do')
+
+      form[FIELDS[:username]] = @username
+      form[FIELDS[:password]] = @password
+
+      @page = @agent.submit(form, form.buttons.last)
+      step2(@page)
+    end
+
+    def step2(page)
+
+      form = page.form_with(:action => '/ecom/as2/validateMemorableWord.do')
+
+      first_letter = page.at("label[for='lettera']").content.
+        scan(/\d+/).first.to_i
+      second_letter = page.at("label[for='letterb']").content.
+        scan(/\d+/).first.to_i
+
+      form[FIELDS[:memorable_word][0]] = get_letter(@memorable_word,
+                                                    first_letter).upcase
+      form[FIELDS[:memorable_word][1]] = get_letter(@memorable_word,
+                                                    second_letter).upcase
+
+      @page = @agent.submit(form, form.buttons.first)
+      @limit = -@page.at(".panelSummary .limit .figure").content.
+        gsub(/\D/,'').to_i
+    end
+
+    def get_data
+      ofx = get(EXPORT_ENDPOINT)
+      ofx = ofx.body.gsub('VERSION="202"','VERSION="200"')
+
+      @ofx = OFX(ofx)
+
+      resource = StringIO.new(ofx)
+      html = Nokogiri::HTML.parse(
+        Iconv.conv("UTF-8", "LATIN1//IGNORE",resource.read)
+      )
+      account_id = html.search("ccacctfrom > acctid").inner_text
+      currency = html.search("ccstmtrs > curdef").inner_text
+
+      uid = Digest::MD5.hexdigest("Barclayard#{@username}#{account_id}")
+      @accounts << Banker::Account.new(uid: uid,
+                          name: "Barclaycard",
+                          amount: @ofx.account.balance.amount_in_pennies,
+                          currency: currency,
+                          limit: @limit
+                         )
+    end
+  end
+end

data/lib/banker/barclays.rb

@@ -0,0 +1,89 @@
+module Banker
+  class Barclays < Base
+
+    LOGIN_URL = "https://bank.barclays.co.uk/olb/auth/LoginLink.action"
+    EXPORT_URL = "https://bank.barclays.co.uk/olb/balances/ExportDataStep1.action"
+
+    attr_accessor :accounts, :ofx
+
+    FIELD = {
+      surname: "surname",
+      membership_number: "membershipNumber",
+      passcode: 'passcode',
+      memorable_word: [
+        'firstMemorableCharacter',
+        'secondMemorableCharacter'
+      ]
+    }
+
+    def initialize(args={})
+      @keys = %w(surname membership_number passcode memorable_word)
+
+      params(args)
+      @surname = args.delete(:surname)
+      @membership_number = args.delete(:membership_number)
+      @passcode = args.delete(:passcode)
+      @memorable_word = args.delete(:memorable_word)
+
+      @accounts = []
+
+      authenticate!
+      delivery(download!)
+    end
+
+  private
+
+    def authenticate!
+      page = get(LOGIN_URL)
+      form = page.form_with(action: 'LoginLink.action')
+
+      form[FIELD[:surname]] = @surname
+      form[FIELD[:membership_number]] = @membership_number
+
+      page = @agent.submit(form, form.buttons.first)
+
+      form = page.form_with(action: 'LoginStep1i.action')
+      form.radiobuttons.first.check
+      page = @agent.submit(form, form.buttons.first)
+
+      form = page.form_with(action: 'LoginStep2.action')
+      letters = memorable_required(page).delete_if { |v| v if v == 0 }
+
+      form[FIELD[:passcode]] = @passcode
+      form[FIELD[:memorable_word][0]] = get_letter(@memorable_word, letters[0])
+      form[FIELD[:memorable_word][1]] = get_letter(@memorable_word, letters[1])
+
+      @agent.submit(form, form.buttons.first)
+    end
+
+    def memorable_required(page)
+      page.labels.collect { |char| cleaner(char.to_s).to_i }
+    end
+
+    def cleaner(str)
+      str.gsub(/[^\d+]/, '')
+    end
+
+    def download!
+      page = get(EXPORT_URL)
+      form = page.form_with(action: "/olb/balances/ExportDataStep1.action")
+      form['reqSoftwarePkgCode'] = '6'
+      form['productIdentifier'] = 'All'
+      page = @agent.submit(form, form.buttons.first)
+      form = page.form_with(:action => "/olb/balances/ExportDataStep2All.action")
+      file = @agent.submit(form, form.buttons.last)
+      return OFX(file.body)
+    end
+
+    def delivery(ofx)
+      amount = ofx.account.balance.amount_in_pennies
+      uid = Digest::MD5.hexdigest("Barclays#{@membership_number}")
+
+      @accounts << Banker::Account.new(uid: uid,
+                                       name: "Barclays",
+                                       amount: amount
+                                      )
+    end
+
+  end
+end

data/lib/banker/base.rb

@@ -0,0 +1,28 @@
+module Banker
+  class Base
+    attr_writer :keys
+    def params(args)
+      missing_keys = []
+      return unless defined? @keys
+      @keys.each do |key|
+        missing_keys << key unless args.has_key?(key.to_sym)
+      end
+      if missing_keys.any?
+        raise Error::InvalidParams,
+          "missing parameters #{missing_keys.map {|key| "`#{key}` "}.join}"
+      end
+    end
+
+    def get(url)
+      @agent ||= Mechanize.new
+      @agent.log = Logger.new 'banker.log'
+      @agent.user_agent = "Mozilla/5.0 (Banker)"
+      @agent.force_default_encoding = "utf8"
+      @agent.get(url)
+    end
+
+    def get_letter(value,index)
+      value.to_s[index-1]
+    end
+  end
+end

data/lib/banker/capital_one_uk.rb

@@ -0,0 +1,88 @@
+module Banker
+  # This class allows the data retrieval of account balaces
+  # for Capital One UK
+  #
+  # == Examples
+  #
+  # Make a new connection
+  #
+  #     bank = Banker::CapitalOneUK.new(:username => "Joe", :password => "password")
+  #
+  #     bank.accounts.first.balance.amount #=> 4100.10
+  #
+  class CapitalOneUK < Base
+    attr_accessor :username, :password, :accounts
+    attr_reader :page
+
+    LOGIN_ENDPOINT = "https://www.capitaloneonline.co.uk/CapitalOne_Consumer/Login.do"
+    FIELD = {
+      username: 'username',
+      password: [
+        'password.randomCharacter0',
+        'password.randomCharacter1',
+        'password.randomCharacter2'
+      ]
+    }
+
+    def initialize(args = {})
+      @keys = ['username', 'password']
+      params(args)
+      @username = args[:username]
+      @password = args[:password]
+
+      @accounts = []
+
+      authenticate!
+      get_data
+    end
+
+    private
+
+    def authenticate!
+      page = get(LOGIN_ENDPOINT)
+
+      form = page.form_with(name: 'logonForm')
+
+      form[FIELD[:username]] = @username
+      letters_html = page.at("#sign_in_box .password").content
+      letters = letters_html.scan(/(\d)/).collect { |letter| letter[0].to_i }
+
+      form[FIELD[:password][0]] = get_letter(@password, letters[0])
+      form[FIELD[:password][1]] = get_letter(@password, letters[1])
+      form[FIELD[:password][2]] = get_letter(@password, letters[2])
+
+      @page = @agent.submit(form, form.buttons.first)
+    end
+
+    #def letters
+      #html = page.search('#sign_in_box .password').content
+    #end
+
+    def get_data
+      limit = -@page.at("table[summary='account summary'] tr:nth-child(1) td.normalText:nth-child(2)").content.gsub(/\D/,'').to_i
+      amount = -@page.at("table[summary='account summary'] tr:nth-child(2) td.normalText:nth-child(2)").content.gsub(/\D/,'').to_i
+      account_number = @page.at("table:first-child tr:nth-child(5) td b").
+        content.to_i
+
+      uid = Digest::MD5.hexdigest("CapitalOneUK#{account_number}")
+
+      @accounts << Banker::Account.new(name: "Capital Account",
+                                       amount: amount,
+                                       limit: limit,
+                                       uid: uid,
+                                       currency: "GBP"
+                                      )
+
+      #form = page.form('DownLoadTransactionForm')
+
+      #form.downloadType = 'csv'
+
+      #csv_data = @agent.submit(form, form.buttons.first)
+
+      #csv = csv_data.body.gsub(/,\s*/, ',')
+
+      #@transactions = CSV.parse(csv, :headers => true)
+    end
+
+  end
+end