first_direct_latest_download 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fe94ab23c031d050d51852a86677c26161d90623
+  data.tar.gz: 28aa7f3946e7f30f21cca6da5d1a630c2e0c2eda
+SHA512:
+  metadata.gz: dc6470c4614239a6fd2f18f1a2bd3ab4676dd31a0fcddcfa3a43bf50454d7cdf2b4b641fb639e45563eebdbf4718581a181b4718775d564775098eb941af12f0
+  data.tar.gz: e090571c08fb932910f53d7a7604440c47808146d1242ea08f2280c0a42487a9503926955e698525e224617d7a5c6eb8caa859622841b66b4d2e552155da66f7

checksums.yaml.gz.sig

@@ -0,0 +1 @@
+V�b6����nvY|���V����/Re?���M�YG ^�o˴��

data.tar.gz.sig

@@ -0,0 +1,2 @@
+]A�K���2E(׌�����&�#8�|�zO/f(��?���Xd\�8.p��:��)�_���T�Q;.�r���&�����g�悩��_y�^V\4="��A�S�W���V0��?'�*IQ��$�
�}<��U���DƜ��`zy�F��;�
+@�5j�`�T��wvX����J���|!�O�޻�<�|��$�|���

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Matt Fawcett
+
+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,35 @@
+# FirstDirectLatestDownload
+
+A selenium script written in ruby to download latest transactional data as CSV from First Direct personal online banking.
+
+Use at own risk.
+
+## Installation
+
+### Basic installation
+
+    gem install first_direct_latest_download
+
+### To install with signature checks to ensure that the gem has not been tampered with
+
+    gem cert --add <(curl -Ls https://raw.githubusercontent.com/mattfawcett/first_direct_latest_download/master/certs/mattfawcett.pem)
+
+    gem install first_direct_latest_download -P MediumSecurity
+
+## Usage
+Example. Run with no arguments and you will be promted for username, memorable word, and password
+
+    first_direct_latest_download
+
+Example. Passing credentials like this is insecure. At minimum use [HISTCONTROL](http://www.linuxjournal.com/content/using-bash-history-more-efficiently-histcontrol)
+
+    first_direct_latest_download -u username -m memorableword -p password [-a optionalaccountname]
+
+Example using [password manager](https://www.passwordstore.org/)
+
+    first_direct_latest_download -u IB1234567890 -m `pass firstdirect.co.uk.memorable` -p `pass firstdirect.co.uk.password`
+
+## 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,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "first_direct_latest_download"
+
+# 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,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/certs/mattfawcett.pem

@@ -0,0 +1,22 @@
+-----BEGIN CERTIFICATE-----
+MIIDsDCCApigAwIBAgIBATANBgkqhkiG9w0BAQUFADBXMQ0wCwYDVQQDDARtYWls
+MR4wHAYKCZImiZPyLGQBGRYObWF0dGhld2Zhd2NldHQxEjAQBgoJkiaJk/IsZAEZ
+FgJjbzESMBAGCgmSJomT8ixkARkWAnVrMB4XDTE2MDczMTA5MTMyMloXDTE3MDcz
+MTA5MTMyMlowVzENMAsGA1UEAwwEbWFpbDEeMBwGCgmSJomT8ixkARkWDm1hdHRo
+ZXdmYXdjZXR0MRIwEAYKCZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJ1
+azCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMD79gWa1lNLhS4uyQdu
+W0a0wB7ovDJxVMbVWhXm086S9yi7Sb71NmpWZmaWB54eXS/IfBRFLiiJl9+7LEJ+
+xlpDXbOfQmHFHyt21ED0y5m9ixDBSpZux0HnWPEo3yDWwvg4jehuk7VpOsKCSpf9
+uX0GNDr4GsVZDp7KpVGVE5FjLdq+Scg0zCOY1kut5DOBw1sxbZC6xW7JjAlB8Rka
+NkMsFBA98sBAl1Pz+tn2e1Du7hV6OX72v3AncC5uchvLXO2SQxlhOxQxjqOaqogy
+yP8WLCN///eepc6ISpLemIUT4KHdRz9L8jKHErpuzaBiNtWIhcyv7MB7ZaMcrb8U
+Oh8CAwEAAaOBhjCBgzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU
+ScxklEbsSKSeOy+I+86Ccis1ggMwJAYDVR0RBB0wG4EZbWFpbEBtYXR0aGV3ZmF3
+Y2V0dC5jby51azAkBgNVHRIEHTAbgRltYWlsQG1hdHRoZXdmYXdjZXR0LmNvLnVr
+MA0GCSqGSIb3DQEBBQUAA4IBAQCipFpXBV8hjLb4dzeheyhQTooWL76WOXiUjipj
+ekBR82RzUlXx+YBJ3A+s9/lTsn70ravEK9tfpkDXGXIg/fF6aaVCX085PIaghAzJ
+gz8uuzaUp/kGrbhzYvyC5r3e8iugTylHkiftYF5w2Xn02l21yK/AubKYDUU/KinL
+w3lz0KwTmsyupgzc6y7yHW3jdCAFe8iXlPwhbfbqID2iSm8wuQwO6RzJn07Ejtus
+yJIQ7BnT75VQEqtWMfkSjOW64AVlWuD/LU/4NQykWZrh6sAaxKvhYBU/PiujaXyL
+rUw5QSvC1QClur/I5qvjk8o8/hbxgQuoy5zjq8/vPBuaVDJY
+-----END CERTIFICATE-----

data/exe/first_direct_latest_download

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+require "bundler/setup"
+require "first_direct_latest_download/download"
+
+options = {account_name: '1st Account'}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: first_direct_latest_download options"
+
+  opts.on("-u", "--username USERNAME", "Username. Eg IB123456789") do |u|
+    options[:username] = u
+  end
+
+  opts.on("-p", "--password PASSWORD", "Password") do |p|
+    options[:password] = p
+  end
+
+  opts.on("-m", "--memorable-answer MEMORABLE", "Memorable Phrase") do |m|
+    options[:memorable_answer] = m
+  end
+
+  opts.on("-a", "--account-name ACCOUNT_NAME", "Account name: Default '1st Account'") do |a|
+    options[:account_name] = a
+  end
+end.parse!
+
+unless options[:username]
+  puts "Enter Username:"
+  options[:username] = gets.chomp
+end
+
+unless options[:password]
+  puts "Enter Password"
+  options[:password] = gets.chomp
+end
+
+unless options[:memorable_answer]
+  puts "Enter Memorable Answer"
+  options[:memorable_answer] = gets.chomp
+end
+
+
+download = FirstDirectLatestDownload::Download.new(options)
+download.run!

data/first_direct_latest_download.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'first_direct_latest_download/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "first_direct_latest_download"
+  spec.version       = FirstDirectLatestDownload::VERSION
+  spec.authors       = ["Matt Fawcett"]
+  spec.email         = ["mail@matthewfawcett.co.uk"]
+
+  spec.summary       = %q{Download latest First Direct transactions as OFX}
+  spec.description   = %q{Download latest First Direct transactions as OFX}
+  spec.homepage      = "https://github.com/mattfawcett/first_direct_latest_download"
+  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.cert_chain  = ['certs/mattfawcett.pem']
+  spec.signing_key = File.expand_path("~/.ssh/gem-private_key.pem") if $0 =~ /gem\z/
+
+  spec.add_dependency "selenium-webdriver", "~> 2.53"
+
+  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/first_direct_latest_download.rb

@@ -0,0 +1,4 @@
+require "first_direct_latest_download/version"
+
+module FirstDirectLatestDownload
+end

data/lib/first_direct_latest_download/download.rb

@@ -0,0 +1,70 @@
+require "selenium-webdriver"
+
+module FirstDirectLatestDownload
+  class Download
+    FIRST_DIRECT_URL = 'https://www1.firstdirect.com/1/2/pib-service'
+
+    def initialize(options)
+      @options = options
+    end
+
+    def run!
+      driver = Selenium::WebDriver.for :chrome
+      driver.navigate.to FIRST_DIRECT_URL
+
+      element = driver.find_element(:name, 'userid')
+      element.send_keys @options[:username]
+      element.submit
+
+      wait = Selenium::WebDriver::Wait.new(:timeout => 10)
+      wait.until { driver.find_element(:partial_link_text =>  'Log on without your Secure Key') }
+
+      driver.find_element(partial_link_text: 'Log on without your Secure Key').click
+
+      driver.find_element(name: 'memorableAnswer').send_keys(@options[:memorable_answer])
+
+      (1..3).each { |n| fill_out_password_character(driver, n) }
+
+      driver.find_element(xpath: "//*[@type='submit']").click
+
+      wait.until { driver.find_element(:link_text =>  @options[:account_name]) }
+
+
+      driver.find_element(:link_text, @options[:account_name]).click
+      driver.find_element(:link_text, 'download').click
+
+      wait.until { driver.find_element(:name =>  'DownloadFormat') }
+
+      file_type = driver.find_element(:name, 'DownloadFormat')
+      file_type.find_elements(:tag_name => "option").find do |option|
+        option.text == ' Microsoft Excel '
+      end.click
+
+      driver.find_element(:link_text, 'download').click
+
+      sleep 10
+
+      driver.find_element(partial_link_text: 'log off').click
+      driver.find_element(partial_link_text: 'confirm').click
+      driver.quit
+    end
+
+    # field_number should be 1, 2 or 3
+    def fill_out_password_character(driver, field_number)
+      label = driver.find_element(id: "hiddenpasswordcharacterposition_#{field_number}-label")
+
+      character_number = label.attribute('innerText').scan(/\d|penultimate/).first
+
+      character = case character_number
+        when "penultimate"
+          @options[:password][@options[:password].length-2, 1]
+        else
+          @options[:password][character_number.to_i-1, 1]
+        end
+
+      field_id = label.attribute('for')
+
+      driver.find_element(:id, field_id).send_keys(character)
+    end
+  end
+end

data/lib/first_direct_latest_download/version.rb

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

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: first_direct_latest_download
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matt Fawcett
+autorequire: 
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDsDCCApigAwIBAgIBATANBgkqhkiG9w0BAQUFADBXMQ0wCwYDVQQDDARtYWls
+  MR4wHAYKCZImiZPyLGQBGRYObWF0dGhld2Zhd2NldHQxEjAQBgoJkiaJk/IsZAEZ
+  FgJjbzESMBAGCgmSJomT8ixkARkWAnVrMB4XDTE2MDczMTA5MTMyMloXDTE3MDcz
+  MTA5MTMyMlowVzENMAsGA1UEAwwEbWFpbDEeMBwGCgmSJomT8ixkARkWDm1hdHRo
+  ZXdmYXdjZXR0MRIwEAYKCZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJ1
+  azCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMD79gWa1lNLhS4uyQdu
+  W0a0wB7ovDJxVMbVWhXm086S9yi7Sb71NmpWZmaWB54eXS/IfBRFLiiJl9+7LEJ+
+  xlpDXbOfQmHFHyt21ED0y5m9ixDBSpZux0HnWPEo3yDWwvg4jehuk7VpOsKCSpf9
+  uX0GNDr4GsVZDp7KpVGVE5FjLdq+Scg0zCOY1kut5DOBw1sxbZC6xW7JjAlB8Rka
+  NkMsFBA98sBAl1Pz+tn2e1Du7hV6OX72v3AncC5uchvLXO2SQxlhOxQxjqOaqogy
+  yP8WLCN///eepc6ISpLemIUT4KHdRz9L8jKHErpuzaBiNtWIhcyv7MB7ZaMcrb8U
+  Oh8CAwEAAaOBhjCBgzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU
+  ScxklEbsSKSeOy+I+86Ccis1ggMwJAYDVR0RBB0wG4EZbWFpbEBtYXR0aGV3ZmF3
+  Y2V0dC5jby51azAkBgNVHRIEHTAbgRltYWlsQG1hdHRoZXdmYXdjZXR0LmNvLnVr
+  MA0GCSqGSIb3DQEBBQUAA4IBAQCipFpXBV8hjLb4dzeheyhQTooWL76WOXiUjipj
+  ekBR82RzUlXx+YBJ3A+s9/lTsn70ravEK9tfpkDXGXIg/fF6aaVCX085PIaghAzJ
+  gz8uuzaUp/kGrbhzYvyC5r3e8iugTylHkiftYF5w2Xn02l21yK/AubKYDUU/KinL
+  w3lz0KwTmsyupgzc6y7yHW3jdCAFe8iXlPwhbfbqID2iSm8wuQwO6RzJn07Ejtus
+  yJIQ7BnT75VQEqtWMfkSjOW64AVlWuD/LU/4NQykWZrh6sAaxKvhYBU/PiujaXyL
+  rUw5QSvC1QClur/I5qvjk8o8/hbxgQuoy5zjq8/vPBuaVDJY
+  -----END CERTIFICATE-----
+date: 2016-08-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: selenium-webdriver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.53'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.53'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Download latest First Direct transactions as OFX
+email:
+- mail@matthewfawcett.co.uk
+executables:
+- first_direct_latest_download
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- certs/mattfawcett.pem
+- exe/first_direct_latest_download
+- first_direct_latest_download.gemspec
+- lib/first_direct_latest_download.rb
+- lib/first_direct_latest_download/download.rb
+- lib/first_direct_latest_download/version.rb
+homepage: https://github.com/mattfawcett/first_direct_latest_download
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Download latest First Direct transactions as OFX
+test_files: []